API Digitaldocu.
Una API REST + JSON pensada para integrar Digitaldocu con tu ERP, tu intranet o cualquier sistema interno. Tres dominios especializados (Documentos, Facturas y Firma), un mismo modelo de autenticación y documentación oficial en PDF.
Cómo te conectas
Tres pasos para empezar a llamar a la API desde tu sistema.
Solicita tus credenciales
Cada cliente recibe un usuario de integración y una API Key exclusivos para autenticar las llamadas.
Cabeceras en cada petición
Incluye en todas las llamadas las cabeceras username y apikey. (Solo GetInvoices usa Bearer Token.)
Llama al endpoint
Toda la API parte de https://api.digitaldocu.com. Cada dominio (Document, Invoices, Signer) expone sus métodos.
curl -X POST https://api.digitaldocu.com/api/Document/UploadAndSave \
-H "username: integracion@tucliente.es" \
-H "apikey: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"documentName": "contrato.pdf",
"documentBase64": "JVBERi0xLjQK...",
"integrationDocumentLocation": {
"folderIntegrationCode": "Clientes",
"categoryIntegrationCode": "Contratos",
"typeIntegrationCode": "Servicios",
"year": 2026
}
}'Endpoints disponibles
Cambia entre dominios para ver todos los métodos disponibles.
| Método | Endpoint |
|---|---|
| POST | /api/Document/UploadAndSaveCrear y archivar un documento con metadatos completos. |
| PUT | /api/Document/{id}/UpdateActualizar metadatos o contenido del documento. |
| DELETE | /api/Document/{id}Eliminar un documento existente. |
| GET | /api/Document/{id}/InfoInformación básica del documento (nombre, ruta, año). |
| GET | /api/Document/{id}/KeywordsRecuperar todos los metadatos (simples y de grupo). |
| GET | /api/Document/{id}/RelatedDocumentos relacionados con el actual. |
| POST | /api/Document/RelatedCrear relación entre documentos. |
| POST | /api/Document/ConcatenateConcatenar varios documentos en uno. |
| GET | /api/Document/DocumentSameNameDetectar posibles duplicados por nombre. |
| GET | /api/Document/{id}/ShareLinkObtener un enlace de compartición. |
| POST | /api/Document/{id}/ShareCompartir el documento con usuarios o externos. |
| GET | /api/Document/{id}/ViewVisualizar el contenido del documento. |
| GET | /api/Document/{id}/AttachedListar adjuntos asociados. |
| PUT | /api/Document/{id}/AttachedAñadir o actualizar adjuntos. |
| GET | /api/Document/GetInboxFilesDocumentos pendientes en la bandeja de entrada. |
| POST | /api/Document/UploadDocumentSubir un documento directo a la bandeja. |
| POST | /api/Document/{id}/ArchiveArchivar un documento desde la bandeja. |
| PUT | /api/Document/{id}/RestartWorkflowReiniciar el workflow asociado al documento. |
| POST | /api/Document/{id}/CreateVersionCrear una nueva versión del documento. |
| GET | /api/Document/{id}/WorkflowStatusConsultar el estado del workflow. |
Casos de uso típicos
Lo que nuestros integradores hacen el primer día con la API.
Subir factura emitida desde el ERP
Tu ERP llama a /Invoices/UploadInvoice con el PDF y el XML FacturaE. Digitaldocu firma, inserta el QR y envía la factura al cliente por email.
Procesar facturas recibidas en lote
Cada noche tu integración llama a /Invoices/GetInvoices con un rango de fechas y vuelca las facturas validadas a la contabilidad. Marca cada una como descargada para no procesarla dos veces.
Enviar un contrato a firma con OTP
Llamada a /Signer/UploadAndSign con el PDF y los firmantes. Cada uno recibe un email y un SMS con código OTP. Al cerrar el proceso, descargas el documento probatorio.
Archivar documentación de un expediente
Tu intranet sube cada documento a /Document/UploadAndSave con sus metadatos. Si más adelante hay que actualizar uno, llamada a /Document/{id}/Update.
Bandeja de entrada que se archiva sola
El RPA deja los documentos en la bandeja con /Document/UploadDocument. Tu sistema consulta /Document/GetInboxFiles, los clasifica y llama a /Document/{id}/Archive.
Consultar el estado de un workflow
Llamada a /Document/{id}/WorkflowStatus desde tu panel interno para saber si el documento está aprobado, pendiente o rechazado, y reiniciarlo con /RestartWorkflow.
Especificaciones técnicas
Autenticación
Headers username + apikey en cada llamada. La API Key se entrega de forma exclusiva al cliente. El endpoint GetInvoices usa Bearer Token.
Formato
REST + JSON sobre HTTPS. UTF-8. Documentos en base64 dentro del cuerpo de la petición.
Facturación electrónica
Subida con XML FacturaE 3.2.2. Firma con certificado del cliente registrado en Digitaldocu. QR posicionable sobre el PDF.
Firma electrónica
Firma simple, firma OTP por SMS, firma con certificado digital del documento. Documento probatorio descargable cuando se completa el proceso.
Multientidad
Soporte multiempresa: las consultas de facturas pueden filtrarse por CIF de cada empresa registrada en el cliente.
Documentación oficial
Tres PDFs descargables: API General v2.0, API Facturas v1.7 y API Signer v1.0.1. Actualizada por nuestro equipo cada vez que cambian los métodos.