Skip to content

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 de dados.
  • Os arquivos sao opcionais, mas, quando enviados, precisam respeitar o limite de 10MB e 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


FSTec Logo

© 2025 FSTec — Todos os direitos reservados.