Usamos cookies técnicas propias, necesarias para que el sitio funcione. Solo si lo aceptas cargamos además cookies de medición publicitaria (Google Ads) para saber qué campañas traen clientes. Puedes rechazarlas y navegar igual. Política de privacidad.
Integración DeCA · Sage
Los ERP de Sage llevan décadas gestionando la facturación y la logística de las pymes españolas. La integración con DeCA aprovecha esa expedición ya registrada: una llamada por API en la salida de mercancía y el documento de control administrativo queda emitido.
API REST como add-on: 50 €/mes o 480 €/año sobre cualquier plan base, incluido Free · Incluida en el plan Enterprise
El DeCA es obligatorio desde el 5 de octubre de 2026, exclusivamente digital (Ley 9/2025, Disposición Transitoria 8ª), y emitirlo es responsabilidad del cargador (art. 7.2 de la Orden FOM/2861/2012). La sanción por ir sin él va de 401 a 600 € por transporte (LOTT, art. 141.17 y 143.1.d).
Si tu equipo expide desde Sage, los datos del envío ya están capturados una vez. La API de DeCA evita capturarlos dos veces: recibe la expedición, emite el documento y devuelve el PDF con su QR.
Como la API es REST estándar, encaja con los mecanismos de salida de los ERP de Sage (llamadas HTTP desde personalizaciones o procesos programados), sin depender de software intermedio.
1. Genera tu API key
Contrata el add-on API REST desde Mi Plan y genera la clave en Mi Cuenta → pestaña API. Viaja en la cabecera X-API-Key de cada petición y solo se muestra una vez.
2. Sage envía la expedición
Al confirmar la salida de mercancía, tu personalización envía a la API los datos del envío: referencia, origen, destino, partidas, transportista y matrícula. Con emit: true, el DeCA se emite al final de la misma llamada.
3. PDF y estado, de vuelta a tu sistema
La respuesta trae el identificador del expediente, el token público y la URL de descarga. Tu sistema archiva el PDF y puede consultar el estado de cierre del documento en cualquier momento.
Estos son los endpoints principales que usaría tu integración. Todos son REST sobre HTTPS, devuelven JSON y se autentican con la cabecera X-API-Key.
| Método | Ruta | Para qué sirve |
|---|---|---|
| POST | /api/v1/deca_requests | El comando completo: recogida, expediente y emisión en una llamada. |
| GET | /api/v1/addresses | Direcciones de tu cuenta (orígenes y destinos) para referenciarlas por ID. |
| POST | /api/v1/shipments | Recogidas con origen propio o de cliente y fecha prevista. |
| POST | /api/v1/regulatory_records/:id/emit | Emisión del DeCA con QR cuando el expediente está completo. |
| GET | /api/v1/regulatory_records/:id/pdf | Descarga del PDF del documento. |
| POST | /api/v1/transport_routes | Rutas con varias paradas: un DeCA agrupado con un solo QR. |
La documentación completa para integradores: app.deca.cangopal.com/docs/api (requiere iniciar sesión).
Salidas de mercancía de la gestión comercial
Cada albarán de salida que implica transporte por carretera dispara su DeCA. El documento queda emitido aunque el equipo de almacén no abra DeCA ni una vez al día.
Distribución con varios destinos
Una ruta con varias entregas se crea con sus paradas y emite un único DeCA agrupado, tal como admite la Resolución de 5 de junio de 2026 (apartado Sexto), consumiendo un solo cupo.
Colaboración con transportistas externos
Declaras el transportista efectivo por API; si opera con cuenta en DeCA, recibe la recogida y la confirma, y cierra el documento con el QR al entregar.
Cierre automático sin perseguir a nadie
Si el transportista no escanea el QR, el sistema cierra el DeCA al terminar el día de emisión y queda cubierto el registro de emisión (art. 7.1 de la Orden FOM/2861/2012).
Ventas con entrega a cliente
Al facturar o albaranar la venta, la integración emite el DeCA con los datos del cliente de entrega. El administrador ve en DeCA el mismo historial que en Sage, referenciado por tu número de documento.
La API se contrata como add-on API REST: 50 €/mes (o 480 €/año con el descuento anual) sobre cualquier plan base, incluido Free. En el plan Enterprise va incluida. Los DeCAs emitidos por API comparten el límite mensual de tu plan con los creados desde la web.
La integración no depende de la versión de tu ERP de Sage, sino de que algún proceso pueda hacer una llamada HTTPS con JSON. Si tu versión permite personalizaciones con llamadas HTTP salientes (o usas un middleware), funciona. Si prefieres que lo desarrollemos nosotros, pídenos presupuesto.
La llamada a la API no cambia: sigue siendo HTTPS con JSON hacia los mismos endpoints. Lo que puede requerir ajuste es el disparador dentro de tu Sage, y ese mantenimiento lo hace tu partner o nosotros si desarrollamos la integración.
La API es REST sobre HTTPS, devuelve JSON y se autentica con una cabecera X-API-Key: cualquier equipo de IT o integrador habitual de tu ERP puede conectarla. También podemos desarrollar la integración a medida para tu negocio: escríbenos a support@cangopal.com y lo presupuestamos.
Sí. Web y API comparten el mismo contador mensual. La emisión es atómica (si dos emisiones compiten por el último DeCA disponible, solo una entra) y el cupo se consume al emitir. En las rutas multi-parada, el DeCA agrupado consume una sola unidad, no una por parada.
Sí. Puedes dar de alta webhooks de salida que avisan a tu sistema de cada cambio de tus expedientes DeCA (deca.created, deca.emitted, deca.closed, deca.modified, deca.finalized, deca.cancelled y deca.superseded) y de la confirmación de tus recogidas (pickup.confirmed). Cada entrega es un POST firmado con HMAC-SHA256 (cabeceras X-DeCA-Event, X-DeCA-Delivery y X-DeCA-Signature) que se reintenta solo si tu endpoint falla o no responde en 10 s; cada intento queda registrado y se puede reintentar a mano. Los gestionas desde Mi Cuenta → Webhooks o por API REST (/api/v1/webhooks).
SAP
Si gestionas las expediciones en SAP, los datos que el DeCA exige —cargador, mercancía, or…
Odoo
Odoo ya gestiona tus ventas, tu inventario y tus albaranes de entrega. La integración con …
Microsoft Dynamics 365 Business Central
En Business Central la expedición ya existe como documento: pedido de venta, envío y trans…
API REST
DeCA funciona como motor de documentos: tu sistema (ERP, TMS, WMS, portal de cliente o inc…
Agentes de IA (MCP)
El MCP (Model Context Protocol) de DeCA permite que un agente de IA opere tu cuenta en len…
Crea tu cuenta, contrata el add-on API y empieza a emitir. Si prefieres que desarrollemos la integración por ti, cuéntanos qué ERP usas.