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 |
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 |
idTalhao |
number |
Identificador do Talhão |
Opcionais
Quando presentes, devem ser do tipo informado (null é aceito). Campos de data devem seguir ISO 8601 (YYYY-MM-DD).
| Campo | Tipo | Descrição |
|---|---|---|
nrAreaTalhao |
number \| null |
Área do Talhão (ha) |
dsMaturador |
string \| null |
Nome do produto maturador |
nrMaturador |
number \| null |
Dose de maturador aplicada |
dtMaturador |
string \| null |
Data aplicação maturador (YYYY-MM-DD) |
dsInibidor |
string \| null |
Nome do produto inibidor |
nrInibidor |
number \| null |
Dose de inibidor aplicada |
dtInibidor |
string \| null |
Data aplicação inibidor (YYYY-MM-DD) |
dsIrrigacaoSist |
string \| null |
Sistema de irrigação |
dsIrrigacaoTipo |
string \| null |
Tipo de irrigação |
nrIrrigacao |
number \| null |
Lâmina de irrigação (mm) |
dtVinhaca |
string \| null |
Data aplicação vinhaça (YYYY-MM-DD) |
nrVinhaca |
number \| null |
Lâmina de vinhaça (mm) |
nrVinhacaK2O |
number \| null |
K₂O aportado via vinhaça |
nrTorta |
number \| null |
Dose de torta (t/ha) |
nrCalcario |
number \| null |
Dose de calcário (t/ha) |
nrGesso |
number \| null |
Dose de gesso (t/ha) |
blAreaRestricao |
boolean \| null |
Área com restrição operacional/ambiental |
dtDataIrrigacao |
string \| null |
Data de realização da irrigação (YYYY-MM-DD) |
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2024/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"
}
]