Ordem de Serviço
Domínio responsável pela ingestão de dados de ordens de serviço agrícolas: aplicações de maturador, inibidor, irrigação, vinhaça, torta, calcário e gesso.
Endpoint
POST /v1/integrations/{partnerId}/os
Autenticação: Authorization: Bearer {token} com role order.write
Campos
Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
idUsina |
number ≥ 0 |
Identificador da Usina |
cdSafra |
string (YYYY) |
Safra agrícola — apenas o ano |
cdSetor |
string |
Código do Setor |
cdBloco |
string |
Código do Bloco |
cdFazenda |
string |
Código da Fazenda |
idTalhao |
number \| null |
Identificador do Talhão |
nrAreaTalhao |
number \| null |
Área do Talhão (ha) |
dsMaturador |
string |
Nome do produto maturador |
nrMaturador |
number \| null |
Dose de maturador aplicada |
dtMaturador |
string |
Data aplicação maturador (YYYY-MM-DD) |
dsInibidor |
string |
Nome do produto inibidor |
nrInibidor |
number ≥ 0 \| null |
Dose de inibidor aplicada |
dtInibidor |
string |
Data aplicação inibidor (YYYY-MM-DD) |
dsIrrigacaoSist |
string |
Sistema de irrigação |
dsIrrigacaoTipo |
string |
Tipo de irrigação |
nrIrrigacao |
number ≥ 0 \| null |
Lâmina de irrigação (mm) |
dtVinhaca |
string |
Data aplicação vinhaça (YYYY-MM-DD) |
nrVinhaca |
number ≥ 0 \| null |
Lâmina de vinhaça (mm) |
nrVinhacaK2O |
number ≥ 0 \| null |
K₂O aportado via vinhaça |
nrTorta |
number ≥ 0 \| null |
Dose de torta (t/ha) |
nrCalcario |
number ≥ 0 \| null |
Dose de calcário (t/ha) |
nrGesso |
number ≥ 0 \| null |
Dose de gesso (t/ha) |
blAreaRestricao |
boolean |
Área com restrição operacional/ambiental/agronômica |
dtDataIrrigacao |
string |
Data de realização da irrigação (YYYY-MM-DD) |
Formato de safra
O campo cdSafra aceita apenas o ano no formato YYYY (ex: "2025"),
diferente dos demais domínios que usam "YYYY/YYYY".
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2025",
"cdSetor": "A",
"cdBloco": "B01",
"cdFazenda": "FAZ001",
"idTalhao": 42,
"nrAreaTalhao": 15.5,
"dsMaturador": "ETHEPHON",
"nrMaturador": 0.5,
"dtMaturador": "2025-09-10",
"dsInibidor": "TRINEXAPAC",
"nrInibidor": 0.8,
"dtInibidor": "2025-09-10",
"dsIrrigacaoSist": "GOTEJAMENTO",
"dsIrrigacaoTipo": "SUBSUPERFICIAL",
"nrIrrigacao": 25.0,
"dtVinhaca": "2025-06-15",
"nrVinhaca": 80.0,
"nrVinhacaK2O": 12.5,
"nrTorta": 4.0,
"nrCalcario": 2.0,
"nrGesso": 1.5,
"blAreaRestricao": false,
"dtDataIrrigacao": "2025-07-20"
}
]