Integración API de albaranes electrónicos: Conectando su ERP/DMS al portal
Guía técnica para integrar su ERP o DMS con el portal de albaranes electrónicos vía API. Autenticación, endpoints, formatos y problemas comunes.
Por que la integración API es esencial
El portal tiene una interfaz web para la entrada manual, pero para empresas que envían mas de 5-10 albaranes diarios, la entrada manual es insostenible. La integración API permite la creación automática, confirmación de recepción y sincronización de estados.
Arquitectura del sistema
- Protocolo: HTTPS (TLS 1.2+)
- Formato: JSON
- Autenticación: Certificado electrónico cualificado (TLS mutuo) + clave API
- Documentación: Disponible en el portal tras el registro
Endpoints API principales
| Endpoint | Método | Descripción |
|---|---|---|
| /api/v1/delivery-notes | POST | Crear nuevo albarán electrónico |
| /api/v1/delivery-notes/{id} | GET | Ver un albarán |
| /api/v1/delivery-notes | GET | Listar albaranes (con filtros) |
| /api/v1/receipt-notes | POST | Crear acuse de recibo (confirmar recepción) |
| /api/v1/delivery-notes/{id}/status | GET | Estado del albarán |
| /api/v1/delivery-notes/{id}/pdf | GET | Versión PDF para impresión |
Integración con sistemas ERP populares
SAP
Use SAP PI/PO o SAP Integration Suite. Mapee desde el modulo SD (documento de Envio/Entrega) al formato API.
Microsoft Dynamics
Use Power Automate o conectores personalizados. Mapee desde Pedidos de Venta/Transferencia.
Sistemas ERP locales
La mayoría de las soluciones ERP locales (Pantheon, Lidder, Bild, 4D) están desarrollando o ya tienen módulos de albaranes electrónicos.
Problemas comunes de integración
- Certificado no configurado correctamente: debe estar en el servidor, no solo en la estación de trabajo
- Formato de fecha incorrecto: la API espera ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Campos obligatorios faltantes: la API devuelve 400 con lista de campos
- Destinatario no registrado: el destinatario debe existir en el sistema
- Timeout con envíos grandes: divida mas de 100 artículos en múltiples albaranes
Notificaciones webhook
El portal soporta webhooks para actualizaciones de estado en tiempo real: confirmación de recepción, aceptacion/rechazo, advertencias de plazos.
Conclusión
La integración API es el único enfoque sostenible para operaciones de alto volumen.
Docavelo tiene una integración lista con el portal: conecte su ERP a Docavelo, y este se comunica con el portal por usted.
