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 |
dtDataColheita |
string |
Data da colheita — ISO 8601 (YYYY-MM-DD) |
Opcionais
Quando presentes, devem ser do tipo informado (null é aceito).
| Campo | Tipo | Descrição |
|---|---|---|
idTalhao |
number \| null |
Identificador do Talhão |
nrAreaTalhao |
number \| null |
Área do Talhão (ha) |
nrAreaColheita |
number \| null |
Área colhida (ha) |
nrConsumoPlantioMecanico |
number \| null |
Consumo específico plantio mecanizado (L/t) |
nrConsumoColheitaMecanico |
number \| null |
Consumo específico colheita mecanizada (L/t) |
nrRendimentoPlantioManual |
number \| null |
Rendimento plantio manual (t/homem/dia) |
nrRendimentoPlantioMecanico |
number \| null |
Rendimento plantio mecanizado (t/máquina/dia) |
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2023/2024",
"cdSetor": "SETOR01",
"cdBloco": "BLOCO01",
"cdFazenda": "FAZ001",
"idTalhao": 42,
"nrAreaTalhao": 15.75,
"dtDataColheita": "2024-01-15",
"nrAreaColheita": 14.5,
"nrConsumoPlantioMecanico": 2.5,
"nrConsumoColheitaMecanico": 1.8,
"nrRendimentoPlantioManual": 8.5,
"nrRendimentoPlantioMecanico": 450.0
}
]