Esquemas

Vía y número del domicilio.

Código postal como texto para conservar ceros iniciales.

Localidad del domicilio.

Código del país en dos letras; se normaliza a mayúsculas. El formato no comprueba la pertenencia al catálogo ISO 3166-1.

Nombre o razón social.

Código del país en dos letras; se normaliza a mayúsculas. El formato no comprueba la pertenencia al catálogo ISO 3166-1.

Identificador fiscal normalizado a mayúsculas y sin espacios ni guiones; la longitud se comprueba tras normalizar. En España se validan formato y carácter de control de DNI, NIE y NIF de entidades (CIF). Los NIF especiales K, L y M se comprueban solo por formato: prefijo, siete caracteres alfanuméricos y letra final. Para otros países se exige formato alfanumérico sin verificar su control fiscal. Esta validación no acredita existencia ni alta censal.

Nombre o razón social.

Código del país en dos letras; se normaliza a mayúsculas. El formato no comprueba la pertenencia al catálogo ISO 3166-1.

Identificador fiscal normalizado a mayúsculas y sin espacios ni guiones; la longitud se comprueba tras normalizar. En España se validan formato y carácter de control de DNI, NIE y NIF de entidades (CIF). Los NIF especiales K, L y M se comprueban solo por formato: prefijo, siete caracteres alfanuméricos y letra final. Para otros países se exige formato alfanumérico sin verificar su control fiscal. Esta validación no acredita existencia ni alta censal.

Domicilio opcional del transportista. Si se envía, debe incluir todos los campos de Address; el artículo 6 no lo exige como dato mínimo.

Lugar real de carga o descarga, identificable por nombre de la instalación o dirección. Junto con city y country debe permitir identificarlo claramente; street y postal_code son opcionales. No se exige identificar a la empresa destinataria como dato mínimo.

Localidad.

El alcance inicial cubre transportes interiores en España; no sustituye al CMR internacional.

Vía y número opcionales del lugar de carga o descarga para precisar su ubicación.

Código postal opcional del lugar de carga o descarga, como texto para conservar ceros iniciales.

Decimal positivo como string, con punto, sin coma ni notación científica. Hasta 15 cifras enteras y 6 decimales. La respuesta elimina los ceros decimales finales.

Unidad explícita de la magnitud, hasta 255 caracteres.

Descripción de la naturaleza de la mercancía.

Peso positivo en kg, como número JSON o texto decimal. Hasta 15 cifras enteras y 6 decimales. La respuesta normaliza a texto y conserva la precisión; el PDF muestra hasta 3 decimales, con coma decimal y puntos de miles. Usa texto decimal para evitar pérdida de precisión en valores grandes.

Otra magnitud cuando resulte difícil determinar el peso. Enviar esta magnitud o el peso, nunca ambas.

Código del país en dos letras; se normaliza a mayúsculas. El formato no comprueba la pertenencia al catálogo ISO 3166-1.

Matrícula normalizada a mayúsculas y sin espacios ni guiones. Para España se admite la matrícula ordinaria vigente, las provinciales anteriores y la serie especial E. Para otros países, entre 3 y 20 caracteres alfanuméricos.

Código del país en dos letras; se normaliza a mayúsculas. El formato no comprueba la pertenencia al catálogo ISO 3166-1.

Matrícula del remolque o semirremolque, normalizada como la del tractor. Para España se exige la serie R. Para otros países, entre 3 y 20 caracteres alfanuméricos.

Número o referencia de la autorización.

Organismo emisor, si se informa.

Fecha real del transporte en formato YYYY-MM-DD; no es el instante de creación del PDF.

Cargador contractual; puede ser distinto del almacén de origen y del cliente de DeCA.

Transportista que realiza efectivamente el transporte, incluido el subcontratado.

Naturaleza y peso de la mercancía, o magnitud alternativa cuando corresponda. Enviar exactamente una medida.

Vehículo efectivo; si hay remolque o semirremolque, informar sus dos campos juntos.

Referencia propia opcional, única por organización y entorno e impresa en el PDF. Identifica los reintentos y permite consultar por referencia. No se libera al eliminar el documento.

Autorización especial de circulación cuando sea necesaria. Omitir o enviar null si no procede.

Observaciones que los intervinientes soliciten hacer constar en el documento.

Objeto JSON opcional, conservado y devuelto sin modificación semántica. No se imprime en el PDF. Máximo 16 KiB al serializarlo y 8 niveles de profundidad.

UUID del documento emitido.

Referencia del cliente o null.

Instante original de creación, en UTC.

URL HTTPS completa de descarga por QR, incluido su secreto. No registrar ni publicar.

URL de descarga autenticada; requiere Bearer de la credencial propietaria dentro de 24 horas.

UUID rectificado o null en una emisión inicial.

La misma metadata de la petición; null si no se proporcionó.

Idioma del PDF elegido al emitirlo según la organización. Se conserva en el resultado; cambiar el idioma de la organización no modifica documentos existentes. No cambia campos JSON ni mensajes de error de la API.

Todos los errores independientes detectados; sin datos de petición, secretos ni trazas.

Fecha real del transporte en formato YYYY-MM-DD; no es el instante de creación del PDF.

Cargador contractual; puede ser distinto del almacén de origen y del cliente de DeCA.

Transportista que realiza efectivamente el transporte, incluido el subcontratado.

Naturaleza y peso de la mercancía, o magnitud alternativa cuando corresponda. Enviar exactamente una medida.

Vehículo efectivo; si hay remolque o semirremolque, informar sus dos campos juntos.

Referencia nueva del documento rectificativo, opcional y única por organización y entorno. No reutilizar la referencia del documento identificado en la URL.

Autorización especial de circulación cuando sea necesaria. Omitir o enviar null si no procede.

Observaciones que los intervinientes soliciten hacer constar en el documento.

Objeto JSON opcional, conservado y devuelto sin modificación semántica. No se imprime en el PDF. Máximo 16 KiB al serializarlo y 8 niveles de profundidad.

Motivo del error detectado al generar el documento.

Debe ser true para eliminar: confirma que no se ha entregado al transportista ni al conductor. false devuelve 409 DOCUMENT_ALREADY_DELIVERED.

Debe ser true para eliminar: confirma que no se ha utilizado en un transporte. false devuelve 409 DOCUMENT_ALREADY_USED.

Estado del documento. No incluye información del transporte, PDF, QR, metadata ni fechas.

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.

Caducidad del token en UTC. Todos sus documentos y enlaces vencen en este instante.

Idioma de los PDF de este token. Español por defecto.

UUID del documento emitido.

Referencia del cliente o null.

Instante original de creación, en UTC.

URL HTTPS completa de descarga por QR, incluido su secreto. No registrar ni publicar.

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.

UUID rectificado o null en una emisión inicial.

La misma metadata de la petición; null si no se proporcionó.

Idioma de los PDF de este token. Español por defecto.

Solo en la demo; siempre true. No aparece en resultados de desarrollo o producción.

Caducidad del token en UTC. Todos sus documentos y enlaces vencen en este instante.

Solo en la demo; alias de url.

Solo en la demo; alias de pdf_download_url. Requiere el token demo y su IP.