Enviar rota
Envia os registros de rotas cadastradas no ERP para a Plataforma Milk's.
Método POSThttp://app.milksrota.com.br/api/retaguardasync/writeRota
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 rotas
]
}
Propriedades da rota
Campo
Descrição
Tipo
Obrigatório
codigo
Código da rota
Texto
SIM
nome
Nome da rota
Texto
SIM
tipo_descarga
Indica como será feito o procedimento de liberação e descarga das viagens executas em linhas de coleta vinculadas a esta rota:
TT = Descarga por tanque pelo técnico;
TC = Descarga por tanque pelo coletor;
TP = Descarga por tanque pela plataforma;
PT = Descarga por pesagem pelo técnico;
PC = Descarga por pesagem pelo coletor;
PP = Descarga por pesagem pela plataforma
Texto
SIM
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.
Número
SIM
grupo
Código do grupo de rotas ao qual esta rota está vinculada
Texto
NÃO
Exemplo de requisição
{
"conta_id": 99999,
"token": "aa4e-15c1-2f69-a734",
"data": [
{
"codigo": "01",
"gruporota": "01",
"nome": "GERAL",
"tipo_descarga": "TP",
"deleted": "0"
},
{
"codigo": "02",
"gruporota": "01",
"nome": "POSTO 1",
"tipo_descarga": "TP",
"deleted": "0"
},
{
"codigo": "03",
"gruporota": "",
"nome": "FAST COLETA TRANSPORTE",
"tipo_descarga": "TP",
"deleted": "0"
}
]
}
Resposta
200: Registros importados
{
"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
{
"codigo": "03", // Código da rota não importada
"error_message": "código do grupo de rotas inválido", // 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