Transporte Logístico Pós-Colheita - Documentação da Carga

🧩 Tipo de Entidade

📋 Registro Documental

📌 Descrição

Conjunto de documentos que acompanham a carga durante o transporte pós-colheita, incluindo notas fiscais e certificados.

Diagrama de Classe

classDiagram class DocumentacaoDaCargaPosColheita { +String notaFiscal +File declaracaoSegregacao +File certificadoOrigemLote +File certificadoFitossanitario +File certificadoCertificacao }

🧬 Atributos

Campo	Tipo	Descrição	Validação	Conformidades
notaFiscal	STRING	Nota Fiscal	-	-
declaracaoSegregacao	FILE	Declaração de segregação	-	DDS, RC
certificadoOrigemLote	FILE	Certificado de origem do lote	-	DDS, RC, IAV
certificadoFitossanitario	FILE	Certificado Fitossanitario	-	DDS, RC, IAV
certificadoCertificacao	FILE	certificado de certificação (RTRS, ISCC, ProTerra)	-	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": {
    "notaFiscal": "NF-12345",
    "notaFiscalExportacao": "NFEX-12345",
    "declaracaoSegregacao": "declaracao_segregacao_lote.pdf",
    "certificadoOrigemLote": "certificado_origem_lote_001.pdf",
    "certificadoFitossanitario": "certificado_fito_soja.pdf",
    "certificadoCertificacao": "certificado_rtrs_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, certificadoFitossanitario.
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 "certificadoFitossanitario=@/caminho/arquivo.pdf"

Metadados Técnicos

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

📋 Fase do Processo

Fase: SOJA_TRANSPORTE_LOGISTICO_DOCUMENTACAO_CARGA
Categoria: Transporte Logístico (Pós-Colheita)
Cardinalidade: 1 por transporte

🗺️ Navegação

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