Atualizar coleta

Método permite manipular registro(s) de coleta(s) de uma determinada viagem. Suporta operações de alteração, inclusão e exclusão.

Método POST

http://app.milksrota.com.br/api/retaguardasync/writeColeta

Requisição

Dados da requisição

{
    "conta_id": 999999,
    "token": "sxert0637r",
    "doc": "99.999.999/0009-90",
    "data": []
}

conta_id: Deve ser informado o ID da conta que você encontra na tela "Sua conta" no menu principal no painel do Milk's Rota.

token: Deve ser informado o Token da conta, que você encontra na tela "Sua conta" no menu principal no painel do Milk's Rota.

doc: Deve ser informado o CNPJ da conta cadastra. Pode ser encontrado na tela "Sua conta" no menu principal do painel Milk's Rota.

data: Lista que deve conter um ou mais registros de coletas. Cada registro de coleta pode ser informando com a relação de propriedades detalhadas abaixo. Apenas os campos obrigatórios não podem ser ignorados.

Propriedades da coleta

Campo	Descrição	Tipo	Obrigatório
viagem_id	identificador único da viagem registrado na plataforma Milk's.	Número Inteiro	Sim
coleta_id	Identificador único do registro de coleta	Número Inteiro	Sim, para operação de alteração
volume	Volume total que substituirá ou comporá o registro da coleta	Número inteiro	Sim
produtor	código do produtor comum ao sistema ERP e a Plataforma Milk's	Texto	Sim
fazenda	código do fazenda comum ao sistema ERP e a Plataforma Milk's	Texto	Sim
tanque	código do tanque comum ao sistema ERP e a Plataforma Milk's	Texto	Não
deleted	Indicador de operação: (0) - Indica inclusão ou alteração, (1) - indica exclusão do registro	Número	Sim

Exemplo de requisição

{
    "conta_id": 999999,
    "token": "sxert0637r",
    "doc": "99.999.999/0009-90",
    "data": [
        {
            "viagem_id": "1234567",            
            "coleta_id": "", 
            "volume": "999",
            "produtor": "000999",
            "fazenda": "F999",
            "tanque": "T999",
            "deleted": "0"
        }
    ]
}

Resposta

200: Registros importados

{
    "success": true,
    "message": "OK",
    "data": [
        "26454591": {
            "success": true,
            "coleta_id": "26454591", // Id da coleta alterada ou insrida 
            "visita_id": "18774601", // Id da visita alterada ou inserida
            "armazenamento_id": "20538290", // Id do armazenamento
            "monitoramentoVisita_id": "21027684" // Id do monitoramento
        }
    ],
    "monitor.time": 7.025467872619629, // Tempo de execução
    "server.date": "2024-07-19 17:09:41"
}

Os registros foram enviados para a Plataforma Milk's e importados ou alterados sem erro.

200: Processados com falhas

{
    "succes": false,
    "message": "OK",
    "data": [1234567 // Falhas de importação
        {
            "Produtor 000999": "Não encontrado", // Código do produtor não localizado
            "Viagem 1234567": "Viagem não localizada", // Identificado da viagem não localizado
            
        }
    ],
    "monitor.time": 2.14737200737 // Tempo de execução
}

Os registros foram enviados para a Plataforma Milk's e processados, entretanto, alguns registros não puderam ser importados.

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.