Módulo Attachments (DocGes)
El módulo Attachments gestiona el almacenamiento, consulta y asociación de archivos y documentos digitales (planos, albaranes firmados, PDFs, fotos de obras, certificados de calidad) enlazados a las entidades de BaseGes ERP a través del motor DocGes.
Seguridad
Requiere autorización mediante cabecera HTTP:
X-Api-Key: {tu_clave_api}oAuthorization: Bearer {tu_token_jwt}
Endpoints Disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /attachments | Listado paginado de documentos con filtros por categoría y metadatos. |
| GET | /attachments/{id} | Descarga y consulta de metadatos de un archivo específico. |
| POST | /attachments | Subida de un nuevo archivo adjunto y vinculación a entidad. |
| DELETE | /attachments/{id} | Eliminación de un documento adjunto. |
Consulta de Documentos (GET)
GET /attachments
Parámetros de Consulta
| Parámetro | Tipo | Descripción |
|---|---|---|
categoriaSid | string | Identificador de la carpeta o categoría documental en DocGes. |
propietat | string | Filtro por propiedad o metadato asociado (ej. código de cliente, obra o factura). |
nom | string | Búsqueda por nombre de archivo o extensión. |
recursive | boolean | true para incluir subcarpetas (predeterminado: true). |
page | integer | Índice de página (predeterminado 1). |
pageSize | integer | Elementos por página (predeterminado 50, máx 100). |
Ejemplo de Petición
GET /attachments?propietat=OBR-2026-089&page=1&pageSize=10 HTTP/1.1
Host: localhost:5000
X-Api-Key: tu-api-key-secreta