Esquemas

Rua e número da morada.

Código postal como texto para preservar zeros iniciais.

Localidade da morada.

Código do país com duas letras; normalizado para maiúsculas. O formato não verifica a pertença ao catálogo ISO 3166-1.

Nome ou denominação social.

Código do país com duas letras; normalizado para maiúsculas. O formato não verifica a pertença ao catálogo ISO 3166-1.

Identificador fiscal normalizado para maiúsculas sem espaços nem hífenes; o comprimento é verificado após normalização. Em Espanha validam-se formato e caráter de controlo de DNI, NIE e NIF de entidades (CIF). Os NIF especiais K, L e M são verificados apenas pelo formato: prefixo, sete carateres alfanuméricos e letra final. Para outros países exige-se formato alfanumérico sem verificação do controlo fiscal. A validação não comprova existência nem registo fiscal.

Nome ou denominação social.

Código do país com duas letras; normalizado para maiúsculas. O formato não verifica a pertença ao catálogo ISO 3166-1.

Identificador fiscal normalizado para maiúsculas sem espaços nem hífenes; o comprimento é verificado após normalização. Em Espanha validam-se formato e caráter de controlo de DNI, NIE e NIF de entidades (CIF). Os NIF especiais K, L e M são verificados apenas pelo formato: prefixo, sete carateres alfanuméricos e letra final. Para outros países exige-se formato alfanumérico sem verificação do controlo fiscal. A validação não comprova existência nem registo fiscal.

Morada opcional do transportador. Se fornecida, exige todos os campos de Address; o artigo 6 não a exige como dado mínimo.

Local real de carga ou descarga, identificável pelo nome da instalação ou morada. Com city e country deve permitir identificá-lo claramente; street e postal_code são opcionais. A identidade da empresa destinatária não é um dado mínimo obrigatório.

Localidade.

O âmbito inicial abrange transportes internos em Espanha; não substitui o CMR internacional.

Rua e número opcionais do local de carga ou descarga para precisar a localização.

Código postal opcional do local de carga ou descarga, como texto para preservar zeros iniciais.

Decimal positivo como string, com ponto, sem vírgula nem notação científica. Até 15 algarismos inteiros e 6 decimais. A resposta elimina os zeros decimais finais.

Unidade explícita da grandeza, até 255 carateres.

Descrição da natureza da mercadoria.

Peso positivo em kg, como número JSON ou texto decimal. Até 15 algarismos inteiros e 6 decimais. A resposta normaliza para texto e conserva a precisão; o PDF apresenta até 3 decimais, com vírgula decimal e pontos para os milhares. Utilize texto decimal para evitar perda de precisão em valores elevados.

Outra grandeza quando for difícil determinar o peso. Envie esta grandeza ou o peso, nunca ambos.

Código do país com duas letras; normalizado para maiúsculas. O formato não verifica a pertença ao catálogo ISO 3166-1.

Matrícula normalizada para maiúsculas sem espaços nem hífenes. Em Espanha são admitidas a matrícula ordinária vigente, as provinciais anteriores e a série especial E. Para outros países, entre 3 e 20 carateres alfanuméricos.

Código do país com duas letras; normalizado para maiúsculas. O formato não verifica a pertença ao catálogo ISO 3166-1.

Matrícula do reboque ou semirreboque, normalizada como a do trator. Em Espanha exige-se a série R. Para outros países, entre 3 e 20 carateres alfanuméricos.

Número ou referência da autorização.

Organismo emissor, se indicado.

Data real do transporte em formato YYYY-MM-DD; não é o instante de criação do PDF.

Carregador contratual; pode diferir do armazém de origem e do cliente da DeCA.

Transportador que efetua realmente o transporte, incluindo o subcontratado.

Natureza e peso da mercadoria, ou grandeza alternativa quando aplicável. Envie exatamente uma medida.

Veículo efetivo; se houver reboque ou semirreboque, preencha os dois campos em conjunto.

Referência própria opcional, única por organização e ambiente e impressa no PDF. Identifica novas tentativas e permite consultar por referência. Não é libertada ao eliminar o documento.

Autorização especial de circulação quando necessária. Omita ou envie null se não se aplicar.

Observações cuja inclusão no documento seja pedida pelos intervenientes.

Objeto JSON opcional, conservado e devolvido sem alteração semântica. Não é impresso no PDF. Máximo de 16 KiB ao serializar e 8 níveis de profundidade.

UUID do documento emitido.

Referência do cliente ou null.

Instante original de criação, em UTC.

URL HTTPS completa de descarga por QR, incluindo o segredo. Não registe nem publique.

URL de descarga autenticada; requer Bearer da credencial proprietária no prazo de 24 horas.

UUID retificado ou null numa emissão inicial.

A mesma metadata do pedido; null se não foi fornecida.

Idioma do PDF escolhido na emissão segundo a organização. Conservado no resultado; alterar o idioma da organização não modifica documentos existentes. Não altera campos JSON nem mensagens de erro da API.

Todos os erros independentes detetados; sem dados do pedido, segredos nem rastos.

Data real do transporte em formato YYYY-MM-DD; não é o instante de criação do PDF.

Carregador contratual; pode diferir do armazém de origem e do cliente da DeCA.

Transportador que efetua realmente o transporte, incluindo o subcontratado.

Natureza e peso da mercadoria, ou grandeza alternativa quando aplicável. Envie exatamente uma medida.

Veículo efetivo; se houver reboque ou semirreboque, preencha os dois campos em conjunto.

Nova referência do documento retificativo, opcional e única por organização e ambiente. Não reutilize a referência do documento identificado na URL.

Autorização especial de circulação quando necessária. Omita ou envie null se não se aplicar.

Observações cuja inclusão no documento seja pedida pelos intervenientes.

Objeto JSON opcional, conservado e devolvido sem alteração semântica. Não é impresso no PDF. Máximo de 16 KiB ao serializar e 8 níveis de profundidade.

Motivo do erro detetado ao gerar o documento.

Deve ser true para eliminar: confirma que não foi entregue ao transportador nem ao condutor. false devolve 409 DOCUMENT_ALREADY_DELIVERED.

Deve ser true para eliminar: confirma que não foi utilizado num transporte. false devolve 409 DOCUMENT_ALREADY_USED.

Estado do documento. Não inclui informação do transporte, PDF, QR, metadata nem datas.

Podes pedir um token sk_demo_ sem uma conta nem o registo de uma organização. Dura 24 horas a partir da emissão e funciona apenas a partir do IP público que o pediu. Mudar de rede ou de IP exige outro token.

Data de expiração do token em UTC. Todos os seus documentos e ligações expiram neste instante.

Idioma dos PDF deste token. Espanhol por predefinição.

UUID do documento emitido.

Referência do cliente ou null.

Instante original de criação, em UTC.

URL HTTPS completa de descarga por QR, incluindo o segredo. Não registe nem publique.

Podes pedir um token sk_demo_ sem uma conta nem o registo de uma organização. Dura 24 horas a partir da emissão e funciona apenas a partir do IP público que o pediu. Mudar de rede ou de IP exige outro token.

UUID retificado ou null numa emissão inicial.

A mesma metadata do pedido; null se não foi fornecida.

Idioma dos PDF deste token. Espanhol por predefinição.

Apenas na demo; sempre true. Não aparece nos resultados de desenvolvimento ou produção.

Data de expiração do token em UTC. Todos os seus documentos e ligações expiram neste instante.

Apenas na demo; alias de url.

Apenas na demo; alias de pdf_download_url. Exige o token demo e o seu IP.