CTT — Controle de Transbordo e Transporte
Domínio responsável pela ingestão de dados de controle operacional de colheita: consumo de plantio/colheita mecanizados e rendimento por período.
Endpoint
POST /v1/integrations/{partnerId}/ctt
Autenticação: Authorization: Bearer {token} com role ctt.write
Campos
Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
idUsina |
number |
Identificador da Usina |
cdSafra |
string |
Safra agrícola (ex: "2023/2024") |
cdSetor |
string |
Código do Setor |
cdBloco |
string |
Código do Bloco |
cdFazenda |
string |
Código da Fazenda |
nrAreaTalhao |
number |
Área do Talhão (ha) |
dtDataColheita |
string |
Data da colheita — ISO 8601 (YYYY-MM-DD) |
nrAreaColheita |
number |
Área colhida (ha) |
nrConsumoPlantioMecanico |
number |
Consumo específico plantio mecanizado (L/t) |
nrConsumoColheitaMecanico |
number |
Consumo específico colheita mecanizada (L/t) |
nrRendimentoPlanioManual |
number |
Rendimento plantio manual (t/homem/dia) |
nrRendimentoPlantioMecanico |
number |
Rendimento plantio mecanizado (t/máquina/dia) |
Note
CTT não possui o campo idTalhao — a identificação é feita pelo conjunto
cdSetor + cdBloco + cdFazenda.
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2023/2024",
"cdSetor": "SETOR01",
"cdBloco": "BLOCO01",
"cdFazenda": "FAZ001",
"nrAreaTalhao": 15.75,
"dtDataColheita": "2024-01-15",
"nrAreaColheita": 14.5,
"nrConsumoPlantioMecanico": 2.5,
"nrConsumoColheitaMecanico": 1.8,
"nrRendimentoPlanioManual": 8.5,
"nrRendimentoPlantioMecanico": 450.0
}
]