Integraciones · ERP, TMS y API

Tu ERP ya sabe cuándo sale la mercancía. DeCA completa el documento.

Con la API REST de DeCA, cada expedición que tu sistema ya conoce se convierte en un documento de control administrativo emitido, con su QR verificable y su PDF. Sin doble captura de datos y sin depender de que alguien no se olvide.

API REST como add-on desde 50 €/mes sobre cualquier plan base, incluido Free · Incluida en el plan Enterprise

Elige tu sistema

Cómo es la integración por dentro

Una llamada REST con los datos de la expedición basta para emitir el documento completo. Después, tu sistema consulta el estado y descarga el PDF cuando quiera.

Diagrama del flujo: el ERP envía la expedición a la API de DeCA, que emite el documento con QR; el transportista lo cierra escaneando el QR, la inspección consulta el registro sellado y tu sistema consulta el estado por API

1. API key

Contratas el add-on API REST (50 €/mes, 480 €/año, o incluido en Enterprise) y generas tu clave en Mi Cuenta → pestaña API. La clave viaja en la cabecera X-API-Key.

2. Tu sistema envía la expedición

Una llamada POST con los datos que ya conoce tu ERP o TMS: referencia, origen, destino, mercancía, transportista y matrícula.

3. DeCA emitido con QR y PDF

Con emit: true, el documento se emite en la misma llamada: la respuesta trae el token público y la URL del PDF. El transportista cierra el DeCA con el QR.

El caso más simple: una llamada

Recogida, expediente y emisión en una sola petición, con reintento idempotente si la red falla (la pareja sistema-origen + referencia es única).

curl -X POST https://app.deca.cangopal.com/api/v1/deca_requests \
  -H "X-API-Key: TU_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "legal_shipper_id": "…", "reference": "EXP-2026-0043",
    "pickup_client_id": "…", "planned_pickup": "2026-10-05T09:30:00+02:00",
    "emit": true,
    "deca": {
      "locations": { "unloading_place": { "street": "ZAL 1, Muelle 4", "city": "Barcelona", "postal_code": "08040", "country": "ES" } },
      "transport_means": { "tractor_plate": "1234ABC" },
      "goods_items": [ { "description": "Componentes", "gross_weight_kg": 250, "quantity": 15, "package_type": "cajas" } ]
    }
  }'

La respuesta devuelve el identificador del expediente, el token público del documento y la URL de descarga del PDF.

Preguntas frecuentes

¿Qué necesito para integrar mi ERP con DeCA?

El add-on API REST: 50 €/mes (o 480 €/año) sobre cualquier plan base, incluido Free, e incluida en el plan Enterprise. Se activa desde Mi Plan y la API key se genera en Mi Cuenta → pestaña API.

¿Qué ERPs puedo integrar?

La API es REST estándar sobre HTTPS con JSON, así que puede integrarla cualquier sistema que haga llamadas HTTP: SAP, Odoo, Microsoft Dynamics 365 Business Central, Sage, TMS propios, WMS, portales a medida o automatizaciones ligeras.

¿Quién desarrolla la integración?

Tu equipo de IT o tu integrador habitual, con nuestra documentación para integradores. También podemos desarrollarla nosotros a medida: escríbenos a support@cangopal.com y te lo presupuestamos.

¿Los DeCAs por API consumen el cupo de mi plan?

Sí: web y API comparten el mismo contador mensual. La emisión es atómica y el cupo se consume al emitir. En las rutas multi-parada, el DeCA agrupado consume una sola unidad.

¿El DeCA emitido por API cumple la normativa?

Es el mismo documento: PDF con QR verificable, URL pública por token y registro de auditoría. El DeCA es obligatorio desde el 5 de octubre de 2026, exclusivamente digital (Ley 9/2025, Disposición Transitoria 8ª).

Empieza a emitir desde tu sistema

Crea tu cuenta gratis, contrata el add-on API y emite tu primer DeCA desde tu ERP esta misma semana.