Skip to content

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 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>/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


FSTec Logo

© 2025 FSTec — Todos os direitos reservados.