Inspeção pré-embarque
Etapa: Exportação e Mercado Internacional
Diagrama de Classe
classDiagram
class INSPECAO_PRE_EMBARQUE {
+STRING nomeAgenciaInspetora
+STRING numeroRelatorioInspecao
+DATE dataInspecao
+STRING resultadoInspecao
+FILE naoConformidades
+List~String~ codigosLote
+FILE fotosInspecao
+FILE dadosAnaliseLaboratorial
}
🧬 Atributos
| Nome | Tipo | Descrição | Validações | Conformidades |
|---|---|---|---|---|
nomeAgenciaInspetora |
Texto | Nome da agência/autoridade inspetora | - | DDS, RC |
numeroRelatorioInspecao |
Texto | Número do relatório de inspeção | - | - |
dataInspecao |
Data (YYYY-MM-DD) | Data da inspeção | OBRIGATORIO | DDS, RC |
resultadoInspecao |
Texto | Resultado da inspeção (aprovado/reprovado) | - | - |
naoConformidades |
Arquivo anexado | não conformidades encontradas | - | - |
codigosLote |
Lista de elementos | Código(s) de lote(s) inspecionado(s) | OBRIGATORIO | DDS, RC |
fotosInspecao |
Arquivo anexado | Fotos da inspeção | - | - |
dadosAnaliseLaboratorial |
Arquivo anexado | Dados de análise laboratorial (se coletado amostra) | - | - |
JSon para entrada de dados
{
"safraId": "string",
"safraCodigo": "SAFRA-CAFE-2025-01",
"dados": {
"nomeAgenciaInspetora": "Bureau Veritas",
"numeroRelatorioInspecao": "INS-2025-00456",
"dataInspecao": "2025-09-01",
"resultadoInspecao": "aprovado",
"naoConformidades": "nenhuma.pdf",
"codigosLote": [
"LOTE-CAFE-2025-001",
"LOTE-CAFE-2025-002"
],
"fotosInspecao": "fotos_inspecao.zip",
"dadosAnaliseLaboratorial": "analise_lab.pdf"
}
}
Upload neste metodo
Este cadastro deve ser enviado como multipart/form-data no metodo POST /exportacao/inspecaoPreEmbarque.
- Envie o JSON do cadastro em uma parte de texto chamada
body. - Envie cada arquivo em uma parte separada, usando exatamente estes nomes:
naoConformidades,fotosInspecao,dadosAnaliseLaboratorial. - 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>/exportacao/inspecaoPreEmbarque" \
--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 "naoConformidades=@/caminho/arquivo.pdf" \
--form "fotosInspecao=@/caminho/arquivo.pdf" \
--form "dadosAnaliseLaboratorial=@/caminho/arquivo.pdf"
Metadados Técnicos
{
"nomeAgenciaInspetora": {
"nome": "nomeAgenciaInspetora",
"label": "Nome da agência/autoridade inspetora",
"tipo": "STRING",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
},
"conformidades": [
"DDS",
"RC"
]
},
"numeroRelatorioInspecao": {
"nome": "numeroRelatorioInspecao",
"label": "Número do relatório de inspeção",
"tipo": "STRING",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
}
},
"dataInspecao": {
"nome": "dataInspecao",
"label": "Data da inspeção",
"tipo": "DATE",
"tipoValidacao": "OBRIGATORIO",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
},
"conformidades": [
"DDS",
"RC"
]
},
"resultadoInspecao": {
"nome": "resultadoInspecao",
"label": "Resultado da inspeção (aprovado/reprovado)",
"tipo": "STRING",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
}
},
"naoConformidades": {
"nome": "naoConformidades",
"label": "não conformidades encontradas",
"tipo": "FILE",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
}
},
"codigosLote": {
"nome": "codigosLote",
"label": "Código(s) de lote(s) inspecionado(s)",
"tipo": "LIST",
"tipoValidacao": "OBRIGATORIO",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
},
"conformidades": [
"DDS",
"RC"
]
},
"fotosInspecao": {
"nome": "fotosInspecao",
"label": "Fotos da inspeção",
"tipo": "FILE",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
}
},
"dadosAnaliseLaboratorial": {
"nome": "dadosAnaliseLaboratorial",
"label": "Dados de análise laboratorial (se coletado amostra)",
"tipo": "FILE",
"fase": {
"nome": "CAFE_INSPECAO_PRE_EMBARQUE"
}
}
}
📋 Fase do Processo
Fase: CAFE_INSPECAO_PRE_EMBARQUE
Categoria: Exportação e Mercado Internacional
Cardinalidade: 1 por embarque