DECA — Documento Electrónico de Control Administrativo

¿Qué es DECA?

DECA implementa la Resolución de 22 de mayo de 2023 (BOE-A-2023-13582) de la Dirección General de Transporte Terrestre, que regula el Documento Electrónico de Control Administrativo para el transporte de mercancías.

El DECA puede crearse de forma independiente o vinculado a un eCMR existente. Soporta dos mecanismos de verificación pública:

• Sistema 1 — Código numérico: Código alfanumérico único por viaje
• Sistema 2 — Código QR: Acceso mediante código QR escaneable

1. Crear un DECA

Creación manual (sin eCMR)

POST /deca 📖
Content-Type: application/json
Authorization: Bearer <token>

{ "sistema": "qr", "cargador": { ... }, "transportista": { ... } }

Creación desde un eCMR existente

POST /deca/{service_code} 📖

Los datos del eCMR se usan como base para rellenar el DECA automáticamente.

2. Firma electrónica (Documenso PAdES)

El DECA requiere firma electrónica cualificada para ser válido ante el ministerio. El sistema integra Documenso (plataforma self-hosted de firma electrónica) para generar firmas PAdES.

Iniciar firma

POST /deca/{service_code}/signature 📖
{ "email": "firmante@empresa.com" }

Devuelve una signingUrl que puedes cargar en un iframe para la firma embebida.

Estados disponibles

GET /deca/{service_code}/signature/status 📖
GET /deca/{service_code}/signature/local-status 📖

Cadena de firmas y PDF

GET /deca/{service_code}/signature/chain 📖
GET /deca/{service_code}/signature/pdf 📖

3. Envío al ministerio

POST /deca/{service_code}/ministerio/submission 📖
GET /deca/{service_code}/ministerio/submissions 📖
GET /deca/ministerio/status 📖

4. Verificación pública

Cualquier persona puede verificar la validez de un DECA sin autenticación:

GET /deca/public/{service_code} 📖
# Verificación por código QR
GET /deca/public/validations/{codigo} 📖
# Verificación por código numérico (Sistema 1)

Referencias normativas

• BOE-A-2023-13582 — Resolución de 22 de mayo de 2023, Dirección General de Transporte Terrestre
• Real Decreto Legislativo 3/2015 — Ley de Ordenación del Transporte Terrestre (LOTT)

Resumen de endpoints DECA