Por que la integracion API es esencial
El portal tiene una interfaz web para la entrada manual, pero para empresas que envian mas de 5-10 albaranes diarios, la entrada manual es insostenible. La integracion API permite la creacion automatica, confirmacion de recepcion y sincronizacion de estados.
Arquitectura del sistema
- Protocolo: HTTPS (TLS 1.2+)
- Formato: JSON
- Autenticacion: Certificado electronico cualificado (TLS mutuo) + clave API
- Documentacion: Disponible en el portal tras el registro
Endpoints API principales
| Endpoint | Metodo | Descripcion |
|---|---|---|
| /api/v1/delivery-notes | POST | Crear nuevo albaran electronico |
| /api/v1/delivery-notes/{id} | GET | Ver un albaran |
| /api/v1/delivery-notes | GET | Listar albaranes (con filtros) |
| /api/v1/receipt-notes | POST | Crear acuse de recibo (confirmar recepcion) |
| /api/v1/delivery-notes/{id}/status | GET | Estado del albaran |
| /api/v1/delivery-notes/{id}/pdf | GET | Version PDF para impresion |
Integracion 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 mayoria de las soluciones ERP locales (Pantheon, Lidder, Bild, 4D) estan desarrollando o ya tienen modulos de albaranes electronicos.
Problemas comunes de integracion
- Certificado no configurado correctamente -- debe estar en el servidor, no solo en la estacion 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 envios grandes -- divida mas de 100 articulos en multiples albaranes
Notificaciones webhook
El portal soporta webhooks para actualizaciones de estado en tiempo real -- confirmacion de recepcion, aceptacion/rechazo, advertencias de plazos.
Conclusion
La integracion API es el unico enfoque sostenible para operaciones de alto volumen.
Arhivix tiene una integracion lista con el portal -- conecte su ERP a Arhivix, y este se comunica con el portal por usted.
