DeCA API
Infraestructura DeCA para integradores

Integra DeCA en tu software sin complicaciones

DeCA API está pensada para empresas de software, desarrolladores e integradores que necesitan incorporar la generación del Documento electrónico de Control Administrativo dentro de aplicaciones de escritorio, ERP, TMS o plataformas logísticas. En lugar de construir internamente la capa documental, tu sistema envía los datos del envío a la API, la plataforma genera el PDF nativo, incorpora los elementos exigidos para su explotación operativa y devuelve una URL preparada para que tu aplicación la consuma, la muestre o la asocie a sus propios flujos de trabajo.

Contacto Ver integración
Salida
PDF nativo + URL
Consumo
API para escritorio y web
Enfoque
Cumplimiento y automatización
Profesional revisando documentación logística en un entorno digital
Payload
{
    "referencia": "EXP-2026-00124",
    "cargador": {
      "nombre": "Logística Central",
      "nif": "B12345678",
      "domicilio": "Calle Mayor 12",
      "poblacion": "Madrid",
      "cpostal": "28001",
      "provincia": "Madrid",
      "contacto": "Ana Ruiz",
      "telefonos": "+34 600 000 000",
      "observaciones": "Carga prioritaria"
    },
    "transportista": {
      "nombre": "Transportes del Norte",
      "nif": "B87654321",
      "domicilio": "Avenida Europa 8",
      "poblacion": "Bilbao",
      "cpostal": "48001",
      "provincia": "Bizkaia",
      "contacto": "Carlos Vega",
      "telefonos": "+34 611 111 111",
      "observaciones": "Acceso por muelle 3"
    },
    "origen": "Madrid",
    "destino": "Valencia"
  }
Documento generado
PDF nativoQR + URL
Respuesta API
status: OK url: https://...
DeCA

Una integración útil empieza por entender bien la obligación documental que vas a resolver

Si desarrollas software para transporte o logística, no te basta con "emitir un PDF". Necesitas incorporar a tu producto una salida documental alineada con la regulación aplicable al Documento electrónico de Control Administrativo y con los criterios técnicos que afectan a su generación, disponibilidad y uso operativo. Por eso esta plataforma no se plantea como un simple motor de plantillas, sino como una capa técnica especializada que te permite externalizar una parte sensible del cumplimiento y ofrecerla como una capacidad integrada dentro de tu solución.

Para quien construye software, esto significa reducir alcance funcional dentro de la aplicación cliente y delegar en un servicio específico la construcción, publicación y devolución del documento. Si quieres contrastar la base normativa y técnica, puedes apoyarte en la Resolución de 5 de junio de 2026 publicada en el BOE, donde se establecen las características de los sistemas y documentos electrónicos de control, y en la página oficial del Ministerio de Transportes sobre el Documento electrónico de Control Administrativo (DeCA), que explica el marco general del servicio y su utilización administrativa.

  • Entrada estructurada de datos desde tu software.
  • Generación homogénea del documento sin maquetación local.
  • Publicación y devolución de una URL utilizable por tu sistema.
  • Base técnica reusable para múltiples clientes y productos.
Proceso

Un flujo pensado para integrarse rápido y mantenerse estable en producción

La plataforma está orientada a equipos que necesitan una integración comprensible, predecible y fácil de mantener. El objetivo no es solo generar un documento, sino ofrecer un circuito completo que puedas incorporar a tu producto sin introducir una carga innecesaria en el escritorio del cliente, en el backend de tu aplicación o en tu propio roadmap de mantenimiento documental.

01

Tu software construye el payload del envío

Desde tu aplicación generas una estructura de datos coherente con el envío, el cargador, el transportista, los datos de carga y descarga y los elementos operativos que ya manejas en tu flujo. No necesitas diseñar plantillas, maquetar PDFs ni programar una lógica documental paralela dentro de tu producto.

02

La API transforma esos datos en un documento explotable

La plataforma recibe la información, la valida, la normaliza y genera el documento final como salida documental centralizada. Ese resultado se produce en el formato PDF nativo que exige la normativa y queda preparado para que el transportista disponga de la copia que debe llevar a bordo del vehículo, ya sea en formato electrónico o impresa con su correspondiente código QR.

03

El documento queda listo para ser utilizado por tu aplicación

Una vez generado, el documento pasa a estar disponible para su consulta y consumo desde la lógica de negocio de tu sistema. Puedes mostrarlo en pantalla, guardarlo como referencia del expediente, adjuntarlo a flujos internos o vincularlo a otras pantallas operativas.

04

Recibes una URL que tu software puede tratar como un recurso más

La respuesta final simplifica el consumo aguas abajo: tu sistema recibe un estado y una URL. A partir de ahí, la integración es más sencilla para el equipo de desarrollo y más transparente para el usuario final del producto.

Puesto de trabajo con revisión digital de procesos y operaciones
Integración

Una API pensada para desarrolladores que necesitan claridad en entrada y salida

Cuando una empresa de software valora integrar un servicio externo, una de las primeras preguntas es si esa integración va a simplificar de verdad el producto o si va a introducir una dependencia difícil de sostener. Esta API está planteada para que el contrato sea evidente: tu sistema envía un conjunto de datos claramente mapeables desde tus entidades de negocio y recibe una respuesta pequeña, directa y utilizable desde cualquier cliente de escritorio, servicio web o panel de operación.

POST /api/documents/deca
Content-Type: application/json

{
  "referencia": "EXP-2026-00124",
  "cargador": {
    "nombre": "Logística Central",
    "nif": "B12345678",
    "domicilio": "Calle Mayor 12",
    "poblacion": "Madrid",
    "cpostal": "28001",
    "provincia": "Madrid",
    "contacto": "Ana Ruiz",
    "telefonos": "+34 600 000 000",
    "observaciones": "Carga prioritaria"
  },
  "transportista": {
    "nombre": "Transportes del Norte",
    "nif": "B87654321",
    "domicilio": "Avenida Europa 8",
    "poblacion": "Bilbao",
    "cpostal": "48001",
    "provincia": "Bizkaia",
    "contacto": "Carlos Vega",
    "telefonos": "+34 611 111 111",
    "observaciones": "Acceso por muelle 3"
  },
  "origen": "Madrid",
  "destino": "Valencia",
  "mercancia": "Palets de alimentación seca",
  "medidas": "120x80x160 cm",
  "bultos": "18",
  "fecha_carga": "2026-09-14",
  "hora_carga": "08:30",
  "hora_descarga": "13:45",
  "matricula": "1234MLK",
  "remolque": "R-9087-BBC"
}

200 OK
{
  "status": "OK",
  "url": "https://deca.example/doc/exp-2026-00124.pdf"
}

Entrada

El payload recoge la referencia del envío, la información del cargador y del transportista, los datos de origen y destino, la mercancía, medidas, bultos y la ventana temporal de carga y descarga, además de los identificadores del vehículo y remolque. La estructura está pensada para mapearse sin fricción desde modelos de datos ya habituales en software logístico.

Proceso

La plataforma actúa como una capa documental especializada. En vez de replicar esa lógica en cada instalación o en cada producto, concentras el tratamiento del DeCA en un punto único, lo que facilita la evolución técnica, las correcciones y la consistencia entre clientes.

Respuesta

La respuesta se mantiene deliberadamente simple: un estado y una URL. Eso reduce el trabajo de integración, facilita el testeo y permite incorporar el resultado a pantallas, informes, expedientes o acciones posteriores sin añadir ruido innecesario al contrato de la API.

Beneficios

La ventaja para tu empresa no es solo técnica: también es de producto y de mantenimiento

Para una empresa de software, integrar una plataforma como esta significa acotar mejor el alcance del desarrollo propio, evitar una funcionalidad documental frágil dentro del producto principal y disponer de una pieza reutilizable entre varios clientes, implantaciones o líneas de negocio. El beneficio no está solo en "tener DeCA", sino en cómo lo incorporas sin erosionar la sostenibilidad de tu solución.

Menos complejidad

Tu equipo no tiene que convertirse en especialista en salida documental

Separar la lógica del documento del núcleo de tu aplicación evita que la generación del DeCA condicione decisiones de arquitectura, interfaz o mantenimiento dentro del producto principal. Esa separación también facilita evolucionar el software sin arrastrar una capa de renderizado que rara vez aporta valor diferencial.

Más coherencia

Una sola integración puede servir a varios clientes y escenarios

Si distribuyes software a distintos operadores, cargadores o entornos logísticos, centralizar la generación documental te ayuda a mantener resultados consistentes, reducir excepciones y desplegar mejoras en un único punto en lugar de replicarlas en múltiples instalaciones.

Más velocidad

Tu producto puede ofrecer DeCA antes, con menos riesgo funcional y una salida más limpia para el usuario final

En términos comerciales, esto te permite responder antes a una necesidad real del mercado. En términos técnicos, te permite encapsular la complejidad y ofrecer una experiencia de uso simple: el usuario opera en tu software y recibe un documento accesible sin percibir toda la infraestructura que has evitado construir dentro del producto.

Casos de uso

Una plataforma útil para productos distintos, siempre que necesiten resolver DeCA desde software

La propuesta está dirigida a empresas tecnológicas que ya tienen un producto, una base instalada o un proceso de integración con clientes del sector transporte. La clave no es el tipo de interfaz que uses, sino que necesites incorporar la generación y entrega del documento dentro de un flujo digital ya existente.

Aplicaciones de escritorio para operación logística

Si tu producto está instalado en cliente y gestiona expediciones, órdenes o viajes, la API te permite añadir una salida documental moderna sin rehacer la arquitectura del programa ni cargar la estación local con responsabilidades que deberían estar centralizadas.

ERP, TMS y plataformas verticales

Cuando el documento es una pieza más dentro de un flujo mayor, una API externa especializada ayuda a mantener el ERP o el TMS enfocado en su dominio principal, dejando fuera la complejidad de construir, publicar y servir el DeCA desde la propia plataforma.

Desarrolladores que integran para terceros

Si trabajas implantando soluciones para clientes del sector, esta capa documental te permite acelerar proyectos, acotar mejor el alcance del desarrollo y ofrecer una respuesta clara a requisitos que de otro modo obligarían a construir componentes específicos para cada implantación.

Persona trabajando con software empresarial y documentación digital
FAQ

Preguntas habituales de empresas de software antes de integrar

Sí. La idea es que tu equipo no tenga que diseñar una capa propia para generar y publicar el DeCA dentro de cada aplicación cliente. Tu software conserva el control del flujo de negocio, pero delega en la plataforma la producción y entrega del documento final.

Encaja especialmente bien en programas de escritorio, porque permite añadir una capacidad documental moderna consumiendo un endpoint HTTP sin trasladar al puesto local la responsabilidad de generar, almacenar y servir el documento.

Sí. El diseño de la respuesta busca que el consumo sea directo y fácil de mapear. Si tu aplicación recibe un estado y una URL, puede incorporar el resultado al flujo de trabajo sin necesidad de procesar estructuras innecesariamente complejas.

Sí. Precisamente una de las ventajas del enfoque API es que puedes añadir la capacidad DeCA a una base instalada sin rediseñar por completo tu producto. La integración puede incorporarse como una salida adicional dentro de pantallas y procesos ya existentes.

No. La plataforma está pensada para evitar justamente eso. Tu software prepara los datos del envío y delega en la API la generación del PDF nativo, la incorporación del QR y la devolución de la URL final.

Sí. La plataforma está planteada para producir el documento en el formato PDF nativo con QR que exige la normativa, de manera que el resultado pueda entregarse al conductor para que lo lleve a bordo en formato digital o impreso. La resolución oficial del BOE establece que el PDF debe incluir un QR con la URL del documento y que debe entregarse al conductor antes del inicio del servicio para que lo lleve a bordo.

Sí. Una de las razones para externalizar esta capa es reutilizar la misma lógica documental entre distintas implantaciones, verticales o líneas de producto, reduciendo mantenimiento y mejorando la consistencia del resultado.

No. También encaja en soluciones pequeñas o medianas que necesitan incorporar DeCA sin construir desde cero una infraestructura documental propia. El valor está en simplificar el desarrollo, no en el tamaño del cliente.

Sí, porque exportar documentos no es lo mismo que resolver una salida documental normativa con publicación, QR y URL lista para consumo operativo. La integración permite añadir esa especialización sin distorsionar el núcleo del ERP o del TMS.

La propuesta combina ambas capas: una API para integrarse desde tu software y una infraestructura documental que se ocupa de generar el PDF, asociar la URL y dejar el recurso listo para su uso dentro de tu producto.

Te permite responder antes a una necesidad normativa real del mercado, ofrecer una funcionalidad documental avanzada sin aumentar demasiado el alcance del desarrollo propio y presentar una solución más completa a clientes del sector transporte y logístico.

Contacto

Integra DeCA en tu software con una infraestructura preparada para operar

Si estás construyendo una solución para transporte, logística o expediciones, este es el punto de contacto para explorar encaje técnico y comercial.

Equipo profesional reunido en una mesa de trabajo