Documentação da carga

Etapa: Transporte Logístico (para Armazenagem/Processamento Industrial)

Diagrama de Classe

classDiagram class DOCUMENTACAO_CARGA { +STRING notaFiscal +FILE declaracaoSegregacao +FILE certificadoOrigemLote +FILE certificadoFitossanitario +FILE certificadoCertificacao }

🧬 Atributos

Nome	Tipo	Descrição	Validações	Conformidades
`notaFiscal`	Texto	Nota Fiscal	-	-
`declaracaoSegregacao`	Arquivo anexado	Declaração de segregação	-	DDS, RC
`certificadoOrigemLote`	Arquivo anexado	Certificado de origem do lote	-	DDS, RC, IAV
`certificadoFitossanitario`	Arquivo anexado	Certificado Fitossanitario	-	DDS, RC, IAV
`certificadoCertificacao`	Arquivo anexado	certificado de certificação (Rainforest, UTZ, 4C)	-	DDS, RC, IAV

JSon para entrada de dados

{
  "safraId": "string",
  "safraCodigo": "SAFRA-CAFE-2025-01",
  "dados": {
    "notaFiscal": "NF-12345",
    "notaFiscalExportacao": "NFEX-12345",
    "declaracaoSegregacao": "declaracao_segregacao_lote.pdf",
    "certificadoOrigemLote": "certificado_origem_lote_001.pdf",
    "certificadoFitossanitario": "certificado_fito_cafe.pdf",
    "certificadoCertificacao": "certificado_rainforest_2025.pdf",
    "certificadoOrigem": "certificado_origem_lote_001.pdf"
  }
}

Upload neste metodo

Este cadastro deve ser enviado como multipart/form-data no metodo POST /transporteLogistico/documentacaoCarga.

Envie o JSON do cadastro em uma parte de texto chamada body.
Envie cada arquivo em uma parte separada, usando exatamente estes nomes: declaracaoSegregacao, certificadoOrigemLote.
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>/transporteLogistico/documentacaoCarga" \
  --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 "certificadoOrigemLote=@/caminho/arquivo.pdf"

Metadados Técnicos

{
  "notaFiscal": {
    "nome": "notaFiscal",
    "label": "Nota Fiscal",
    "tipo": "STRING",
    "fase": {
      "nome": "CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
    }
  },
  "declaracaoSegregacao": {
    "nome": "declaracaoSegregacao",
    "label": "Declaração de segregação",
    "tipo": "FILE",
    "fase": {
      "nome": "CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
    },
    "conformidades": [
      "DDS",
      "RC"
    ]
  },
  "certificadoOrigemLote": {
    "nome": "certificadoOrigemLote",
    "label": "Certificado de origem do lote",
    "tipo": "FILE",
    "fase": {
      "nome": "CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
    },
    "conformidades": [
      "DDS",
      "RC",
      "IAV"
    ]
  },
  "certificadoFitossanitario": {
    "nome": "certificadoFitossanitario",
    "label": "Certificado Fitossanitario",
    "tipo": "FILE",
    "fase": {
      "nome": "CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
    },
    "conformidades": [
      "DDS",
      "RC",
      "IAV"
    ]
  },
  "certificadoCertificacao": {
    "nome": "certificadoCertificacao",
    "label": "certificado de certificação (Rainforest, UTZ, 4C)",
    "tipo": "FILE",
    "fase": {
      "nome": "CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA"
    },
    "conformidades": [
      "DDS",
      "RC",
      "IAV"
    ]
  }
}

📋 Fase do Processo

Fase: CAFE_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA
Categoria: Transporte Logístico (para Armazenagem/Processamento Industrial)
Cardinalidade: 1 por transporte

🗺️ Navegação

⬅️ Voltar para Visão Geral
📊 Ver Modelo de Classes Navegável