Esquemas

Vía e número do domicilio.

Código postal como texto para conservar os ceros iniciais.

Localidade do domicilio.

Código de país de dúas letras; normalízase a maiúsculas. O formato non comproba a pertenza ao catálogo ISO 3166-1.

Nome ou razón social.

Código de país de dúas letras; normalízase a maiúsculas. O formato non comproba a pertenza ao catálogo ISO 3166-1.

Identificador fiscal normalizado a maiúsculas sen espazos nin guións; a lonxitude compróbase tras normalizar. En España valídanse formato e carácter de control de DNI, NIE e NIF de entidades (CIF). Os NIF especiais K, L e M compróbanse só polo formato: prefixo, sete caracteres alfanuméricos e letra final. Para outros países esíxese formato alfanumérico sen verificar o control fiscal. Esta validación non acredita existencia nin alta censal.

Nome ou razón social.

Código de país de dúas letras; normalízase a maiúsculas. O formato non comproba a pertenza ao catálogo ISO 3166-1.

Identificador fiscal normalizado a maiúsculas sen espazos nin guións; a lonxitude compróbase tras normalizar. En España valídanse formato e carácter de control de DNI, NIE e NIF de entidades (CIF). Os NIF especiais K, L e M compróbanse só polo formato: prefixo, sete caracteres alfanuméricos e letra final. Para outros países esíxese formato alfanumérico sen verificar o control fiscal. Esta validación non acredita existencia nin alta censal.

Domicilio opcional do transportista. Se se envía, debe incluír todos os campos de Address; o artigo 6 non o esixe como dato mínimo.

Lugar real de carga ou descarga, identificable polo nome da instalación ou o enderezo. Con city e country debe permitir identificalo claramente; street e postal_code son opcionais. A identidade da empresa destinataria non é un dato mínimo obrigatorio.

Localidade.

O alcance inicial abrangue transportes interiores en España; non substitúe o CMR internacional.

Vía e número opcionais do lugar de carga ou descarga para precisar a súa localización.

Código postal opcional do lugar de carga ou descarga, como texto para conservar ceros iniciais.

Decimal positivo como string, con punto, sen coma nin notación científica. Ata 15 cifras enteiras e 6 decimais. A resposta elimina os ceros decimais finais.

Unidade explícita da magnitude, ata 255 caracteres.

Descrición da natureza da mercadoría.

Peso positivo en kg, como número JSON ou texto decimal. Ata 15 cifras enteiras e 6 decimais. A resposta normaliza a texto e conserva a precisión; o PDF mostra ata 3 decimais, con coma decimal e puntos de milleiros. Usa texto decimal para evitar perda de precisión en valores grandes.

Outra magnitude cando sexa difícil determinar o peso. Envía esta magnitude ou o peso, nunca ambas.

Código de país de dúas letras; normalízase a maiúsculas. O formato non comproba a pertenza ao catálogo ISO 3166-1.

Matrícula normalizada a maiúsculas e sen espazos nin guións. Para España admítense a matrícula ordinaria vixente, as provinciais anteriores e a serie especial E. Para outros países, entre 3 e 20 caracteres alfanuméricos.

Código de país de dúas letras; normalízase a maiúsculas. O formato non comproba a pertenza ao catálogo ISO 3166-1.

Matrícula do remolque ou semirremolque, normalizada como a do tractor. Para España esíxese a serie R. Para outros países, entre 3 e 20 caracteres alfanuméricos.

Número ou referencia da autorización.

Organismo emisor, se se informa.

Data real do transporte en formato YYYY-MM-DD; non é o instante de creación do PDF.

Cargador contractual; pode ser diferente do almacén de orixe e do cliente de DeCA.

Transportista que realiza efectivamente o transporte, incluído o subcontratado.

Natureza e peso da mercadoría, ou magnitude alternativa cando corresponda. Envía exactamente unha medida.

Vehículo efectivo; se hai remolque ou semirremolque, informa os dous campos xuntos.

Referencia propia opcional, única por organización e contorno e impresa no PDF. Identifica os reintentos e permite consultar por referencia. Non se libera ao eliminar o documento.

Autorización especial de circulación cando sexa necesaria. Omítea ou envía null se non procede.

Observacións que os intervenientes soliciten facer constar no documento.

Obxecto JSON opcional, conservado e devolto sen modificación semántica. Non se imprime no PDF. Máximo 16 KiB ao serializalo e 8 niveis de profundidade.

UUID do documento emitido.

Referencia do cliente ou null.

Instante orixinal de creación, en UTC.

URL HTTPS completa de descarga por QR, incluído o seu segredo. Non a rexistres nin publiques.

URL de descarga autenticada; require o Bearer da credencial propietaria dentro de 24 horas.

UUID rectificado ou null nunha emisión inicial.

A mesma metadata da petición; null se non se proporcionou.

Idioma do PDF escollido ao emitilo segundo a organización. Consérvase no resultado; cambiar o idioma da organización non modifica documentos existentes. Non cambia campos JSON nin mensaxes de erro da API.

Todos os erros independentes detectados; sen datos de petición, segredos nin trazas.

Data real do transporte en formato YYYY-MM-DD; non é o instante de creación do PDF.

Cargador contractual; pode ser diferente do almacén de orixe e do cliente de DeCA.

Transportista que realiza efectivamente o transporte, incluído o subcontratado.

Natureza e peso da mercadoría, ou magnitude alternativa cando corresponda. Envía exactamente unha medida.

Vehículo efectivo; se hai remolque ou semirremolque, informa os dous campos xuntos.

Referencia nova do documento rectificativo, opcional e única por organización e contorno. Non reutilices a referencia do documento identificado na URL.

Autorización especial de circulación cando sexa necesaria. Omítea ou envía null se non procede.

Observacións que os intervenientes soliciten facer constar no documento.

Obxecto JSON opcional, conservado e devolto sen modificación semántica. Non se imprime no PDF. Máximo 16 KiB ao serializalo e 8 niveis de profundidade.

Motivo do erro detectado ao xerar o documento.

Debe ser true para eliminar: confirma que non se entregou ao transportista nin ao condutor. false devolve 409 DOCUMENT_ALREADY_DELIVERED.

Debe ser true para eliminar: confirma que non se utilizou nun transporte. false devolve 409 DOCUMENT_ALREADY_USED.

Estado do documento. Non inclúe información do transporte, PDF, QR, metadata nin datas.

Podes solicitar un token sk_demo_ sen conta nin alta dunha organización. Dura 24 horas desde a súa emisión e só funciona desde a IP pública que o solicitou. Cambiar de rede ou de IP require solicitar outro token.

Caducidade do token en UTC. Todos os seus documentos e ligazóns vencen neste instante.

Idioma dos PDF deste token. Castelán por defecto.

UUID do documento emitido.

Referencia do cliente ou null.

Instante orixinal de creación, en UTC.

URL HTTPS completa de descarga por QR, incluído o seu segredo. Non a rexistres nin publiques.

Podes solicitar un token sk_demo_ sen conta nin alta dunha organización. Dura 24 horas desde a súa emisión e só funciona desde a IP pública que o solicitou. Cambiar de rede ou de IP require solicitar outro token.

UUID rectificado ou null nunha emisión inicial.

A mesma metadata da petición; null se non se proporcionou.

Idioma dos PDF deste token. Castelán por defecto.

Só na demo; sempre true. Non aparece en resultados de desenvolvemento ou produción.

Caducidade do token en UTC. Todos os seus documentos e ligazóns vencen neste instante.

Só na demo; alias de url.

Só na demo; alias de pdf_download_url. Require o token demo e a súa IP.