Enviar produtores vinculados
Envia os registros de produtores participantes de tanques coletivos cadastrados no ERP para a Plataforma Milk's.
Método POSThttp://app.milksrota.com.br/api/retaguardasync/writeVinculado
Requisição
Dados da requisição
{
"conta_id": "DDDDD",
"token": "XXXX-XXXX-XXXX-XXXX",
"doc": "99.999.999/9999-99"
"data": [
// lista de registros de produtores participantes
]
}
Propriedades dos vínculos de tanques coletivos
Campo
Descrição
Tipo
Obrigatório
produtor
código produtor participante.
Texto
SIM
fazenda
código do registros de fazenda do produtor participante
Texto
SIM
tanque
código do tanque coletivo ao qual o registro será vinculado
Texto
SIM
proprietário
Indica se o produtor é o responsável pelo tanque coletivo (0) - NÃO, (1) - SIM
Texto
SIM
fornecedor
Indica se o produtor é fornecedor ou apenas participante no tanque coletivo (0) - NÃO, (1) - SIM
Texto
SIM (Default = 1)
porcentagem
Indica o percentual de participação no volume produzido para o participante. Aplicável em casos de tanques ajustados para divisão automática por percentual
Decimal (10,4)
NÃO
deleted
Se o registro deve ser excluído. Se enviar o valor 1 ele será excluído caso já exista na plataforma. Se for enviado 0 ele será reativado na plataforma.
Texto
SIM
Exemplo de requisição
{
"conta_id": 999999,
"token": "77d3-96a6-c1a3-c58e",
"doc": "99.999.999/9999-99",
"data": [
{
"tanque": "T-0001", // Código do tanque coletivo cadastrado na plataforma
"produtor": "000058", // Código do produtor vinculado
"fazenda": "907010", // Código da fazenda do produtor
"proprietário": "1", // somente 1 proprietário deve ser indicado para o conjunto.
"fornecedor": "0", // Indica que este participante não poderá receber lançamentos de volume.
"porcentagem": null,
"deleted": "0"
},
{
"tanque": "T-0001",
"produtor": "000059",
"fazenda": "907011",
"proprietário": "0",
"fornecedor": "1", // Este participante poderá receber lançamento de volumes.
"porcentagem": null,
"deleted": "0"
},
{
"tanque": "T-0001",
"produtor": "000060",
"fazenda": "907012",
"proprietário": "1",
"fornecedor": "1",
"porcentagem": null,
"deleted": "0"
}
]
}
Resposta
200: Importação realizada
{
"succes": true,
"message": "OK",
"data": [],
"monitor.time": 2.14737200737 // Tempo de execução
}
Os registros foram enviados para a plataforma Milk's e importados sem erro.
200: Importação com falhas
{
"succes": true,
"message": "OK",
"data": [ // Falhas de importação
{
"tanque": "T-0001", // Código do tanque não importado
"error_message": "proprietário não informado", // mensagem de erro
"error_code": 40003 // código do erro
}
],
"monitor.time": 2.14737200737 // Tempo de execução
}
404: Conta não localizada
{
"success": false,
"message": "Conta não localizada",
"data": [],
"monitor.time": 2.14737200737 // Tempo de execução
}
O que isso significa? Significa que o ID da conta não foi localizado na Plataforma Milk's.
403: Token inválido
{
"success": false,
"message": "Token inválido",
"data": [],
"monitor.time": 2.14737200737 // Tempo de execução
}
O que isso significa? Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.
Last updated