Transporte Logístico de Exportação - Documentação da Carga
🧩 Tipo de Entidade
📋 Registro Documental
📌 Descrição
Conjunto completo de documentos que acompanham a carga de exportação, incluindo certificados internacionais.
Diagrama de Classe
classDiagram
class DocumentacaoDaCargaExportacao {
+String notaFiscalExportacao
+File declaracaoSegregacao
+File certificadoOrigem
+File certificadoFitossanitario
+File certificadoCertificacao
}
🧬 Atributos
| Campo | Tipo | Descrição | Validação | Conformidades |
|---|---|---|---|---|
| notaFiscalExportacao | STRING | Nota fiscal de exportação | Obrigatório | DDS, RC |
| declaracaoSegregacao | FILE | Declaração de segregação | Obrigatório | DDS, RC |
| certificadoOrigem | FILE | Certificado de origem | Obrigatório | DDS, RC, IAV |
| certificadoFitossanitario | FILE | Certificado fitossanitário | Obrigatório | DDS, RC, IAV |
| certificadoCertificacao | FILE | Certificado de certificação (RTRS, ISCC, ProTerra) | Obrigatório | DDS, RC, IAV |
Legenda de Conformidades
- DDS: Due Diligence System
- RC: Rastreabilidade Completa
- GEO: Geolocalização
JSon para entrada de dados
{
"safraId": "string",
"safraCodigo": "SAFRA-SOJA-2025-01",
"dados": {
"notaFiscalExportacao": "Nota fiscal de exportação",
"declaracaoSegregacao": "Declaração de segregação",
"certificadoOrigem": "Certificado de origem",
"certificadoFitossanitario": "Certificado fitossanitário",
"certificadoCertificacao": "Certificado de certificação (RTRS, ISCC, ProTerra)"
}
}
Upload neste metodo
Este cadastro deve ser enviado como multipart/form-data no metodo POST /transporteLogisticoExportacao/documentacaoCargaExportacao.
- Envie o JSON do cadastro em uma parte de texto chamada
body. - Envie cada arquivo em uma parte separada, usando exatamente estes nomes:
declaracaoSegregacao,certificadoOrigem,certificadoFitossanitario,certificadoCertificacao. - Nao envie os arquivos dentro de
dados; se precisar manter outros campos, deixe apenas os campos nao-arquivo dentro dedados. - Os arquivos sao opcionais, mas, quando enviados, precisam respeitar o limite de
10MBe as extensoes permitidas:.pdf,.jpg,.jpeg,.png,.doc,.docx,.xls,.xlsx.
Exemplo:
curl --request POST "https://<url>/transporteLogisticoExportacao/documentacaoCargaExportacao" \
--header "X-API-ACCESS-KEY: <chave_de_acesso>" \
--header "X-API-SECRET-KEY: <chave_de_seguranca>" \
--form 'body={"safraId":"<id_safra>","safraCodigo":"<codigo_safra>","dados":{}}' \
--form "declaracaoSegregacao=@/caminho/arquivo.pdf" \
--form "certificadoOrigem=@/caminho/arquivo.pdf" \
--form "certificadoFitossanitario=@/caminho/arquivo.pdf" \
--form "certificadoCertificacao=@/caminho/arquivo.pdf"
Metadados Técnicos
{
"notaFiscalExportacao": {
"nome": "notaFiscalExportacao",
"label": "Nota fiscal de exportação",
"tipo": "STRING",
"fase": {
"nome": "SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC"
],
"tipoValidacao": "OBRIGATORIO"
},
"declaracaoSegregacao": {
"nome": "declaracaoSegregacao",
"label": "Declaração de segregação",
"tipo": "FILE",
"fase": {
"nome": "SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoOrigem": {
"nome": "certificadoOrigem",
"label": "Certificado de origem",
"tipo": "FILE",
"fase": {
"nome": "SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoFitossanitario": {
"nome": "certificadoFitossanitario",
"label": "Certificado fitossanitário",
"tipo": "FILE",
"fase": {
"nome": "SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoCertificacao": {
"nome": "certificadoCertificacao",
"label": "Certificado de certificação (RTRS, ISCC, ProTerra)",
"tipo": "FILE",
"fase": {
"nome": "SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
}
}
📋 Fase do Processo
Fase: SOJA_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA
Categoria: Transporte Logístico de Exportação
Cardinalidade: 1 por embarque