Por el equipo de DecaServer · Revisado el
La API de DecaServer permite conectar un ERP o software de transporte con contactos, vehículos y documentos DeCA. La integración se realiza en el subdominio de cada empresa con un token y sus capacidades autorizadas.
1. Acuerda el flujo antes de programar
Decide qué sistema prepara los datos, quién revisa antes de emitir y cómo llegará la copia vigente al conductor. Identifica también qué debe ocurrir si una petición falla o si cambia el servicio.
2. Utiliza el contrato de la API
Consulta la documentación API y su contrato OpenAPI descargable. Allí están los endpoints, esquemas, capacidades y errores. La dirección base utiliza el subdominio de empresa y el prefijo /api/v1.
Los catálogos operativos son contactos y vehículos. El documento admite cargador y transportista mediante contactos opcionales o datos manuales. Los lugares y las fechas de carga y descarga se envían estructurados según el contrato actual.
3. Prevé reintentos y validación
Usa la cabecera Idempotency-Key en las escrituras que la requieren y conserva la clave al reintentar la misma operación. Revisa las respuestas de validación antes de emitir. No incluyas tokens en URLs, capturas o registros compartidos.
4. Separa emisión, descarga y distribución
Crear el borrador, emitir, recuperar el PDF y distribuir por correo son operaciones distintas. Emitir o rectificar no envía correos automáticamente. La distribución necesita un destinatario explícito y no constituye un acuse de entrega al conductor.
5. Conserva las referencias de versión
Una rectificación genera otra versión con PDF y QR propios. Guarda las referencias devueltas y actualiza la copia que comparte tu ERP sin sobrescribir la trazabilidad anterior.
Consulta la solución de integración ERP o cuéntanos el flujo que necesitas conectar.