API DeCA

API para emitir, rectificar, consultar y descargar documentos españoles de control administrativo de transporte de mercancías. Para obtener un token, contacta con soporte de SERTEC PESAGE. Los tokens sk_test_ utilizan desarrollo y los tokens sk_live_ producción, con datos separados. La restricción por IP es opcional.

Cada credencial permite consultar y descargar sus documentos durante las 24 horas siguientes a su creación. La descarga por QR tiene una vigencia independiente. Las rectificaciones conservan el documento original.

El borrado lógico solo se permite durante las primeras 2 horas para errores de generación. La integración debe confirmar que el documento no se ha entregado al transportista ni utilizado en el transporte. Conserva el archivo y la trazabilidad, pero bloquea su acceso.

Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token. Utiliza únicamente datos ficticios. Cada página del PDF muestra SIN VALIDEZ junto al logo y una marca diagonal DEMO. Estos documentos no sirven para transportar mercancías ni como documentos administrativos válidos. La demo añade demo: true, expires_at, qr_url (alias de url) y pdf_url (alias de pdf_download_url). document_locale es el idioma elegido al solicitar el token (es por defecto). Los datos y PDF temporales quedan separados del archivo real y no se cifran como los documentos reales. La demo admite cuerpos de hasta 32 KiB y diez documentos por sesión. La emisión de tokens admite tres por minuto y diez por hora desde una misma IP; la creación, cinco por minuto y veinte por hora desde una misma IP. Los límites compartidos por red, región y carga global pueden aplicarse antes. Estas cifras corresponden a la configuración predeterminada.

Esquemas de seguridad
bearerAuth
Token de integración facilitado por soporte de SERTEC PESAGE. Enviar en Authorization: Bearer, exclusivamente mediante HTTPS. sk_test_ selecciona desarrollo y sk_live_ producción. Si el token tiene una lista de IP autorizadas, la petición debe proceder de una de ellas; una lista vacía permite cualquier IP. No enviar el token en la URL ni exponerlo en aplicaciones cliente. Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token. Utiliza únicamente datos ficticios. Cada página del PDF muestra SIN VALIDEZ junto al logo y una marca diagonal DEMO. Estos documentos no sirven para transportar mercancías ni como documentos administrativos válidos.
http
qrSecret
Secreto opaco del enlace QR; copiar exactamente el valor devuelto en url.
apiKey