Documentação da carga de exportação
Etapa: Transporte Logístico de Exportação
Diagrama de Classe
classDiagram
class DOCUMENTACAO_CARGA_EXPORTACAO {
+STRING notaFiscalExportacao
+FILE declaracaoSegregacao
+FILE certificadoOrigem
+FILE certificadoFitossanitario
+FILE certificadoCertificacao
}
🧬 Atributos
| Nome | Tipo | Descrição | Validações | Conformidades |
|---|---|---|---|---|
notaFiscalExportacao |
Texto | Nota fiscal de exportação | OBRIGATORIO | DDS, RC |
declaracaoSegregacao |
Arquivo anexado | Declaração de segregação | OBRIGATORIO | DDS, RC |
certificadoOrigem |
Arquivo anexado | Certificado de origem | OBRIGATORIO | DDS, RC, IAV |
certificadoFitossanitario |
Arquivo anexado | Certificado fitossanitário | OBRIGATORIO | DDS, RC, IAV |
certificadoCertificacao |
Arquivo anexado | Certificado de certificação (Rainforest, UTZ, 4C) | OBRIGATORIO | DDS, RC, IAV |
JSon para entrada de dados
{
"safraId": "string",
"safraCodigo": "SAFRA-CAFE-2025-01",
"dados": {
"notaFiscalExportacao": "NFEX-2025-001234",
"declaracaoSegregacao": "declaracao_segregacao.pdf",
"certificadoOrigem": "certificado_origem.pdf",
"certificadoFitossanitario": "certificado_fitossanitario.pdf",
"certificadoCertificacao": "certificado_rainforest_2025.pdf"
}
}
Upload neste metodo
Este cadastro deve ser enviado como multipart/form-data no metodo POST /logisticaExportacao/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>/logisticaExportacao/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": "CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC"
],
"tipoValidacao": "OBRIGATORIO"
},
"declaracaoSegregacao": {
"nome": "declaracaoSegregacao",
"label": "Declaração de segregação",
"tipo": "FILE",
"fase": {
"nome": "CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoOrigem": {
"nome": "certificadoOrigem",
"label": "Certificado de origem",
"tipo": "FILE",
"fase": {
"nome": "CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoFitossanitario": {
"nome": "certificadoFitossanitario",
"label": "Certificado fitossanitário",
"tipo": "FILE",
"fase": {
"nome": "CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
},
"certificadoCertificacao": {
"nome": "certificadoCertificacao",
"label": "Certificado de certificação (Rainforest, UTZ, 4C)",
"tipo": "FILE",
"fase": {
"nome": "CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA"
},
"conformidades": [
"DDS",
"RC",
"IAV"
],
"tipoValidacao": "OBRIGATORIO"
}
}
📋 Fase do Processo
Fase: CAFE_LOGISTICA_EXPORTACAO_DOCUMENTACAO_CARGA
Categoria: Transporte Logístico de Exportação
Cardinalidade: 1 por embarque