Skip to content

FASES DA SAFRA - API CAFE

Dados da Safra

Campo Valor
safraId 69b17da599f0050db59dfac0
safraCodigo SAFRA-2026-001
cultura CAFE
produtorId 69b1796699f0050db59dfabb (Alex Pereira de Lima)
proprietarioId 69b179e199f0050db59dfabc (Eurico Suarez Figueiredo)
propriedadeId 69b17d7c99f0050db59dfabd (Fazenda Almada - Rio de Janeiro)
baseUrl https://api-cafe-sandbox.rastreability.org
Projeto Postman de Exemplo json

Etapa 1 - Cadastro e Planejamento

Fase 1 - Plano de Cultivo

  • Endpoint: POST /cadastroPlanejamento/planoCultivo
  • Content-Type: application/json
  • ID Criado: 69b181ad99f0050db59dfac1
  • Metadados (dados):
Campo Tipo Valor Utilizado
CODIGO_ABS STRING "ABS-CAFE-2026-001"
AREA_CAFE FLOAT 15.5
ANO_PLANTIO INTEGER 2024
DENSIDADE_PLANTIO INTEGER 4500
TIPO_SOMBREAMENTO LIST ["Sombreamento parcial"]
DEFENSIVOS_UTILIZADOS LIST ["Fungicida cuprico", "Inseticida biologico"]
AREA_TOTAL FLOAT 25.0
COD_EST_RURAL STRING "RJ-001234"
NIRF STRING "1234567890"
INCRA STRING "INCRA-RJ-00123"
CCIR STRING "CCIR-2026-001"
ESPACAMENTO STRING "3.5m x 0.7m"
CULTIVAR LIST ["Catuai Vermelho", "Mundo Novo"]
SISTEMA_IRRIGACAO LIST ["Gotejamento"]
TIPO_FERTILIZACAO LIST ["Organica", "Quimica"]

Etapa 2 - Produção Agrícola

Fase 2 - Plantio e Manejo

  • Endpoint: POST /producaoAgricola/plantioManejo
  • Content-Type: application/json
  • ID Criado: 69b181c999f0050db59dfac2
  • Metadados (dados):
Campo Tipo Valor Utilizado
DATA_PLANTIO DATE "2026-03-15"
DATA_APLICACAO DATE "2026-03-20"
TIPO_PLANTIO LIST ["Plantio direto", "Replantio"]
INSUMOS_UTILIZADOS LIST ["Calcario dolomitico", "Superfosfato simples"]
QUANTIDADE_INSUMO FLOAT 250.0
RESPONSAVEL_APLICACAO STRING "Carlos Mendes"
MAO_DE_OBRA STRING "Equipe de 8 trabalhadores"
MONITORAMENTO_AMBIENTAL STRING "Monitoramento de solo e agua realizado"

Fase 3 - Aplicação de Insumo

  • Endpoint: POST /producaoAgricola/aplicacaoInsumo
  • Content-Type: application/json
  • ID Criado: 69b1828499f0050db59dfac3
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 4 - Mão de Obra

  • Endpoint: POST /producaoAgricola/maoDeObra
  • Content-Type: multipart/form-data
  • ID Criado: 69b1848899f0050db59dfac4
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})
  • Arquivos opcionais: comprovantePagamento (MultipartFile)

Fase 5 - Monitoramento Ambiental

  • Endpoint: POST /producaoAgricola/monitoramentoAmbiental
  • Content-Type: multipart/form-data
  • ID Criado: 69b1848999f0050db59dfac5
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})
  • Arquivos opcionais: consumoAgua, residuo, biodiversidade, dadosClimaticos (MultipartFile)

Etapa 3 - Colheita e Identificação da Produção

Fase 6 - Colheita

  • Endpoint: POST /colheitaIdentificacaoProducao/colheita
  • Content-Type: application/json
  • ID Criado: 69b1849699f0050db59dfac6
  • Metadados (dados):
Campo Tipo Valor Utilizado
IDENTIFICACAO_LOTE STRING "LOTE-CAFE-2026-001"
LIMPEZA_EQUIPAMENTOS STRING "Equipamentos higienizados antes da colheita"
METODO_COLHEITA LIST ["Colheita seletiva", "Derrica manual"]
UMIDADE_GRAO FLOAT 12.5
DATA_COLHEITA DATE "2026-07-15"
QUANTIDADE_COLHIDA FLOAT 3500.0

Fase 7 - Identificação de Lote

  • Endpoint: POST /colheitaIdentificacaoProducao/identificacaoLote
  • Content-Type: application/json
  • ID Criado: 69b1849699f0050db59dfac7
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 8 - Limpeza de Colheita

  • Endpoint: POST /colheitaIdentificacaoProducao/limpezaColheita
  • Content-Type: application/json
  • ID Criado: 69b1849699f0050db59dfac8
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Etapa 4 - Pós-Colheita

Fase 9 - Secagem

  • Endpoint: POST /posColheita/secagem
  • Content-Type: application/json
  • ID Criado: 69b184b599f0050db59dfac9
  • Metadados (dados):
Campo Tipo Valor Utilizado
TIPO_BENEFICIAMENTO LIST ["Via seca"]
METODO_SECAGEM LIST ["Terreiro suspenso", "Secador mecanico"]
CLASSIFICACAO STRING "Tipo 2 - Bebida dura"
TIPO_CAFE STRING "Arabica"
TEMPO_SECAGEM FLOAT 120.0

Fase 10 - Beneficiamento

  • Endpoint: POST /posColheita/beneficiamento
  • Content-Type: application/json
  • ID Criado: 69b184b599f0050db59dfaca
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 11 - Limpeza Pós-Colheita

  • Endpoint: POST /posColheita/limpezaPosColheita
  • Content-Type: multipart/form-data
  • ID Criado: 69b184b699f0050db59dfacb
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Etapa 5 - Transporte Logístico

Fase 12 - Transporte

  • Endpoint: POST /transporteLogistico/transporte
  • Content-Type: application/json
  • ID Criado: 69b184c499f0050db59dfacc
  • Metadados (dados):
Campo Tipo Valor Utilizado
IDENTIFICACAO_TRANSPORTE STRING "Caminhao bau refrigerado - Placa ABC-1234"
DESTINO_CARGA STRING "Cooperativa de Cafe de Minas - Varginha/MG"
LIMPEZA_VEICULO STRING "Veiculo higienizado conforme protocolo"
DOCUMENTACAO_CARGA STRING "NF-e 000123456 e CTe emitido"

Fase 13 - Limpeza Veículo

  • Endpoint: POST /transporteLogistico/limpezaVeiculo
  • Content-Type: multipart/form-data
  • ID Criado: 69b184c599f0050db59dfacd
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})
  • Arquivos opcionais: verificacao (MultipartFile)

Fase 14 - Documentação de Carga

  • Endpoint: POST /transporteLogistico/documentacaoCarga
  • Content-Type: multipart/form-data
  • ID Criado: 69b184c599f0050db59dface
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})
  • Arquivos opcionais: declaracaoSegregacao, certificadoOrigemLote (MultipartFile)

Etapa 6 - Armazenamento

Fase 15 - Recebimento

  • Endpoint: POST /armazenamento/recebimento
  • Content-Type: application/json
  • ID Criado: 69b184e499f0050db59dfacf
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 16 - Armazenamento

  • Endpoint: POST /armazenamento/armazenamento
  • Content-Type: application/json
  • ID Criado: 69b184e499f0050db59dfad0
  • Metadados (dados):
Campo Tipo Valor Utilizado
CONDICOES_ARMAZENAMENTO STRING "Armazem com controle de temperatura e umidade"
LOCAL_ARMAZENAMENTO STRING "Armazem Central - Bloco B, Posicao 12"
CONTROLE_QUALIDADE STRING "Amostras coletadas para analise de umidade e defeitos"
LIMPEZA_ARMAZENAMENTO STRING "Limpeza e desinfeccao realizada antes da estocagem"
DATA_RECEBIMENTO DATE "2026-08-01"

Fase 17 - Limpeza Pós-Processamento (Armazenamento)

  • Endpoint: POST /armazenamento/limpezaPosProcessamento
  • Content-Type: application/json
  • ID Criado: 69b1850199f0050db59dfad1
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 18 - Controle de Qualidade (Armazenamento)

  • Endpoint: POST /armazenamento/controleQualidade
  • Content-Type: multipart/form-data
  • ID Criado: 69b1851399f0050db59dfad2
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Etapa 7 - Processamento

Fase 19 - Processamento

  • Endpoint: POST /processamento/processamento
  • Content-Type: multipart/form-data
  • ID Criado: 69b1852599f0050db59dfad3
  • Metadados (dados):
Campo Tipo Valor Utilizado
PARAMETROS_PROCESSO STRING "Torrefacao media a 220C por 12 minutos"
REGISTRO_PRODUCAO STRING "Lote processamento PRC-2026-001"
REGISTRO_PROCESSAMENTO STRING "Processo de torra e moagem padrao exportacao"
CONTROLE_QUALIDADE_FINAL STRING "Prova de xicara aprovada - nota 85 SCA"
REGISTRO_LIMPEZA STRING "Equipamentos limpos conforme POP-003"
  • Arquivos opcionais: blendagem (MultipartFile)

Fase 20 - Limpeza Pós-Processamento

  • Endpoint: POST /processamento/limpezaPosProcessamento
  • Content-Type: application/json
  • ID Criado: 69b1853c99f0050db59dfad4
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 21 - Controle de Qualidade (Processamento)

  • Endpoint: POST /processamento/controleQualidade
  • Content-Type: multipart/form-data
  • ID Criado: 69b1853c99f0050db59dfad5
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})
  • Arquivos opcionais: analiseQualidade (MultipartFile)

Etapa 8 - Logística de Exportação

Fase 22 - Transporte Exportação

  • Endpoint: POST /logisticaExportacao/transporteExportacao
  • Content-Type: application/json
  • ID Criado: 69b1858399f0050db59dfad6
  • Metadados (dados):
Campo Tipo Valor Utilizado
LIMPEZA_CONTAINER STRING "Container higienizado e inspecionado"
IDENTIFICACAO_TRANSPORTE_EXPORT STRING "Container MSKU-1234567 - Navio MV Santos Express"
DOCUMENTACAO_CARGA_EXPORT STRING "BL e Packing List emitidos"

Fase 23 - Limpeza Exportação

  • Endpoint: POST /logisticaExportacao/limpezaExportacao
  • Content-Type: application/json
  • ID Criado: 69b1858399f0050db59dfad7
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 24 - Documentação de Carga Exportação

  • Endpoint: POST /logisticaExportacao/documentacaoCargaExportacao
  • Content-Type: multipart/form-data
  • ID Criado: 69b1858499f0050db59dfad8
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Etapa 9 - Exportação

Fase 25 - Documentação Aduaneira

  • Endpoint: POST /exportacao/documentacaoAduaneira
  • Content-Type: multipart/form-data
  • ID Criado: 69b1859499f0050db59dfad9
  • Metadados (dados):
Campo Tipo Valor Utilizado
CERTIFICADO_CONFORMIDADE STRING "Certificado ICO emitido - Nr. BR-2026-00456"
DOCUMENTACAO_ADUANEIRA STRING "DUE e RE registrados na Siscomex"
REGISTRO_AUDITORIA STRING "Auditoria interna concluida - Conforme"
INSPECAO_PRE_EMBARQUE STRING "Inspecao aprovada pelo MAPA"

Fase 26 - Certificado de Conformidade

  • Endpoint: POST /exportacao/certificadoConformidade
  • Content-Type: multipart/form-data
  • ID Criado: 69b1859499f0050db59dfada
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 27 - Auditoria

  • Endpoint: POST /exportacao/auditoria
  • Content-Type: multipart/form-data
  • ID Criado: 69b1859599f0050db59dfadb
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Fase 28 - Inspeção Pré-Embarque

  • Endpoint: POST /exportacao/inspecaoPreEmbarque
  • Content-Type: multipart/form-data
  • ID Criado: 69b1859599f0050db59dfadc
  • Metadados (dados): Sem metadados definidos (dados enviados vazio {})

Resumo de IDs Criados

# Fase Endpoint ID
1 Plano de Cultivo cadastroPlanejamento/planoCultivo 69b181ad99f0050db59dfac1
2 Plantio e Manejo producaoAgricola/plantioManejo 69b181c999f0050db59dfac2
3 Aplicação de Insumo producaoAgricola/aplicacaoInsumo 69b1828499f0050db59dfac3
4 Mão de Obra producaoAgricola/maoDeObra 69b1848899f0050db59dfac4
5 Monitoramento Ambiental producaoAgricola/monitoramentoAmbiental 69b1848999f0050db59dfac5
6 Colheita colheitaIdentificacaoProducao/colheita 69b1849699f0050db59dfac6
7 Identificação Lote colheitaIdentificacaoProducao/identificacaoLote 69b1849699f0050db59dfac7
8 Limpeza Colheita colheitaIdentificacaoProducao/limpezaColheita 69b1849699f0050db59dfac8
9 Secagem posColheita/secagem 69b184b599f0050db59dfac9
10 Beneficiamento posColheita/beneficiamento 69b184b599f0050db59dfaca
11 Limpeza Pós-Colheita posColheita/limpezaPosColheita 69b184b699f0050db59dfacb
12 Transporte transporteLogistico/transporte 69b184c499f0050db59dfacc
13 Limpeza Veículo transporteLogistico/limpezaVeiculo 69b184c599f0050db59dfacd
14 Documentação Carga transporteLogistico/documentacaoCarga 69b184c599f0050db59dface
15 Recebimento armazenamento/recebimento 69b184e499f0050db59dfacf
16 Armazenamento armazenamento/armazenamento 69b184e499f0050db59dfad0
17 Limpeza Armazenamento armazenamento/limpezaPosProcessamento 69b1850199f0050db59dfad1
18 Controle Qualidade Armazenamento armazenamento/controleQualidade 69b1851399f0050db59dfad2
19 Processamento processamento/processamento 69b1852599f0050db59dfad3
20 Limpeza Pós-Processamento processamento/limpezaPosProcessamento 69b1853c99f0050db59dfad4
21 Controle Qualidade Processamento processamento/controleQualidade 69b1853c99f0050db59dfad5
22 Transporte Exportação logisticaExportacao/transporteExportacao 69b1858399f0050db59dfad6
23 Limpeza Exportação logisticaExportacao/limpezaExportacao 69b1858399f0050db59dfad7
24 Doc. Carga Exportação logisticaExportacao/documentacaoCargaExportacao 69b1858499f0050db59dfad8
25 Documentação Aduaneira exportacao/documentacaoAduaneira 69b1859499f0050db59dfad9
26 Certificado Conformidade exportacao/certificadoConformidade 69b1859499f0050db59dfada
27 Auditoria exportacao/auditoria 69b1859599f0050db59dfadb
28 Inspeção Pré-Embarque exportacao/inspecaoPreEmbarque 69b1859599f0050db59dfadc

Notas Importantes

  1. Autenticação: Todas as requisições exigem os headers X-API-ACCESS-KEY e X-API-SECRET-KEY.
  2. Endpoints Multipart: As fases 4, 5, 11, 13, 14, 18, 19, 21, 24, 25, 26, 27 e 28 utilizam multipart/form-data. O JSON é enviado como uma part chamada dados.
  3. Metadados Validados: Apenas as fases que possuem metadados definidos validam os campos enviados em dados. As demais aceitam dados vazio.
  4. Arquivos: Os endpoints multipart possuem campos opcionais para upload de arquivos (comprovantes, documentos, laudos etc.).
  5. Estrutura do Body (JSON): json { "safraId": "69b17da599f0050db59dfac0", "safraCodigo": "SAFRA-2026-001", "dados": { /* campos específicos da fase */ } }
  6. Estrutura do Body (Multipart): A part dados contém o mesmo JSON acima como string.
FSTec Logo

© 2025 FSTec — Todos os direitos reservados.