API DECA v1
Contrato HTTP para crear y consultar documentos DECA desde cualquier lenguaje. Envía objetos JSON con campos públicos camelCase, como carrier.taxId y vehicle.plate. El cuerpo es application/json; las respuestas pueden ser application/json o application/xml.
La API, incluidas las consultas y el entorno de pruebas, requiere Pro activo en cada empresa. Crea un token en API e integraciones del panel. Los colaboradores necesitan acceso a la empresa y autorización en Permisos de colaboradores. En Authorize, introduce el secreto sin el prefijo Bearer.
Obtén el id de empresa mediante GET /companies: es un UUID v4 público y estable que debes usar como {company}. companyId contiene ese mismo UUID. Los documentos de producción tienen también un id UUID estable; en sandbox es null. Las rutas con IDs numéricos devuelven 404 y cada operación sigue comprobando el acceso a la empresa. reference y version conservan su significado documental.
Selecciona el entorno, abre una operación y consulta sus campos, ejemplos y respuestas. Los ejemplos HTTP incluyen cURL, JavaScript (fetch), PHP (extensión cURL), Python (urllib.request, biblioteca estándar), C# (HttpClient de .NET) y Java (HttpClient, Java 11 o posterior). La selección de lenguaje se aplica a toda la página.
Son ejemplos pequeños para usar desde consola, aplicaciones de escritorio o servicios, sin depender de un framework.
Al crear un documento, si faltan datos necesarios recibirás 201 con status: draft y pendingFields, sin generar ningún PDF. Un valor enviado inválido o un campo desconocido devuelve 422. Con los requisitos completos, la respuesta indica status: issued.
En producción, data.url es una URL pública directa para acceder y descargar el PDF: guarda los bytes de esa descarga. La respuesta incluye sus metadatos en data.pdf y no contiene base64. En sandbox emitido, url es null y el PDF de prueba está en pdf.content, codificado en base64.
La consulta de documentos muestra por defecto los últimos 30 días de creación en UTC, con filtros y paginación. Puedes elegir otro periodo de hasta 30 días inclusivos con from y to. El listado incluye datos parciales de los borradores y la última versión de los emitidos; no genera ni lee PDF y requiere Pro activo. Al bajar a Gratis, el archivo sigue disponible desde el panel. En sandbox, la lista siempre está vacía.
Sandbox no guarda documentos; un borrador de prueba tampoco genera PDF. En producción, envía un UUID en Idempotency-Key y reutilízalo al reintentar la misma operación: devuelve el documento existente sin consumir otra emisión. Sin clave, cada POST crea un documento nuevo; comprueba el archivo antes de repetir una petición cuyo resultado sea incierto. Los PDF emitidos en producción son documentos reales.