Albaranes electrónicos en Serbia: cómo integrar su ERP o DMS por API
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.
Este artículo se escribió para empresas de Serbia y describe la normativa serbia. En otros países se aplican normas distintas.

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.
Arhivix tiene una integración lista con el portal: conecte su ERP a Arhivix, y este se comunica con el portal por usted.


