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 · Dynamics 365
En Business Central la expedición ya existe como documento: pedido de venta, envío y transferencia. La integración con DeCA consiste en una llamada por API en el momento de la salida de mercancía, con los datos que el documento de control administrativo exige.
API REST como add-on: 50 €/mes o 480 €/año sobre cualquier plan base, incluido Free · Incluida en el plan Enterprise
Desde el 5 de octubre de 2026 el DeCA es obligatorio y exclusivamente digital (Ley 9/2025, Disposición Transitoria 8ª). El cargador es quien debe generarlo (art. 7.2 de la Orden FOM/2861/2012), y la multa por transporte sin documento va de 401 a 600 € por envío (LOTT, art. 141.17 y 143.1.d).
Un equipo que expide con Business Central no debería volver a teclear esos datos en otra web: la API de DeCA acepta la expedición completa en una llamada y devuelve el documento emitido con su QR y su PDF.
Al ser REST sobre HTTPS con JSON, se integra con los mecanismos habituales de Dynamics 365: llamadas HTTP desde extensiones AL, Power Automate o cualquier middleware que ya uses.
1. Genera tu API key
Contrata el add-on API REST en Mi Plan y crea la clave en Mi Cuenta → pestaña API. Se muestra una sola vez y se envía en la cabecera X-API-Key.
2. Business Central notifica la salida
Tu extensión o flujo envía a la API los datos del envío: referencia, origen, destino, partidas de mercancía, transportista efectivo y matrícula. Con emit: true, el DeCA sale emitido en la misma transacción.
3. Documento y estado en tu ERP
La respuesta devuelve el ID del expediente, el token público y la URL de descarga del PDF. Tu sistema guarda ambos y consulta el estado de cierre (GET /api/v1/regulatory_records/:id/status) cuando lo necesite.
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 | Emisión en una sola llamada desde la confirmación de envío. |
| POST | /api/v1/shipments | Recogidas con fecha prevista y referencia, por separado del expediente. |
| PATCH | /api/v1/regulatory_records/:id | Completar datos del expediente (destino, mercancía, vehículo, carrier). |
| POST | /api/v1/regulatory_records/:id/emit | Emitir el DeCA provisional con QR. |
| GET | /api/v1/regulatory_records/:id/efti | Consulta de la proyección eFTI del documento. |
| DELETE | /api/v1/regulatory_records/:id | Cancelar un expediente (registro regulatorio, sin borrado). |
La documentación completa para integradores: app.deca.cangopal.com/docs/api (requiere iniciar sesión).
Envíos y transferencias entre centros
Tanto las entregas a clientes como las transferencias de stock entre almacenes propios que se mueven en camión ajeno generan su DeCA desde el mismo flujo de Business Central.
Planificación diaria automatizada
Un job que recorre los envíos planificados del día y emite los DeCAs por la mañana: el almacén ya no depende de que alguien se acuerde de la web.
Carga mixta y partidas múltiples
Expediciones con varias mercancías se declaran como partidas (hasta 20 por expediente) con su naturaleza, peso y bultos, tal como exige el documento.
Trazabilidad para auditoría
Cada emisión queda registrada y consultable (GET /audit): la trazabilidad del documento la acreditas con el registro sellado de emisión (art. 7.1 de la Orden FOM/2861/2012).
Transferencias entre centros
Los traslados de mercancía entre tus almacenes también son transporte sujeto a DeCA cuando los realiza un tercero. La integración emite el documento desde el propio registro de transferencia, con el centro de destino como consignatario.
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 API de DeCA es independiente de tu versión: lo que necesita es que algún sistema llame por HTTPS con JSON. Business Central lo hace con extensiones AL o Power Automate; otros productos de Dynamics 365, con sus conectores HTTP habituales. Si tu caso necesita desarrollo, lo presupuestamos.
Para el flujo estándar, Power Automate con su conector HTTP cubre la llamada a la API sin desarrollar nada. Si tu flujo necesita lógica condicional compleja o rendimiento alto, una extensión AL es la vía más robusta. Las dos llegan a la misma API.
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 …
Sage
Los ERP de Sage llevan décadas gestionando la facturación y la logística de las pymes espa…
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.