Enviar descarga

Registra o procedimento de descarga na plataforma de recepção.

Método POST

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

Requisição:

{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99",
    "data": {
        "descargas": [           
             {
                "tipo": "P",  // Pesagem
                "inicio_descarga": "13-02-2022 00:00:35",
                "fim_descarga": "13-02-2022 00:55:35",
                "viagem": "99999",
                "tecnico": "001",
                "densidade": "1,032",
                "peso_entrada": "12.895,500",
                "peso_saida": "8.589,700",
                "volume_pesagem": "4.443,58",
                "medidor": "Nota a respeito do medidor utilizado",
                "parecer": "Observações a respeito da descarga",
                "armazenamento": [
                    {
                        "deposito": "GRP2121/3",
                        "volume": 400
                    },
                    {
                        "deposito": "VIG-002",
                        "volume": 4000
                    }
                  ]
              }
        ]
    }
}

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 descargas. Cada registro de descarga pode ser informando com a relação de propriedades detalhadas abaixo. Apenas os campos obrigatórios não podem ser ignorados.

Propriedades da tabela descarga

Campo	Descrição	Tipo
*tipo	Identifica o descarga quanto a seu tipo: V - Volumetria; P - Pesagem	Texto
inicio_descarga	Data e hora de início do procedimento de descarga no formato (AAAA-MM-DD hh:mm:ss)	Texto
fim_descarga	Data e hora de início do procedimento de descarga no formato (AAAA-MM-DD hh:mm:ss)	Texto
*viagem	Identificador único da viagem, gerado pela plataforma Milk's.	Numérico
*técnico	Código do técnico responsável pela descarga	Texto
medidor	Informações e identificação do medidor utilizado no processo de descarga	Texto
parecer	Observações sobre o processo de descarga	Texto
densidade	Densidade registrada para considerar a conversão peso/volume - Utilizado somente em caso de descargas por pesagem	Decimal
peso_entrada	Peso de entrada do veículo, quando carregado: Utilizado somente em caso de descargas por pesagem	Decimal
peso_saida	Peso líquido de saída do veículo: Utilizado somente em caso de descargas por pesagem	Decimal
volume_pesagem	Volume final calculado : Utilizado somente em caso de descargas por pesagem	Decimal
qtd_armazenado	Volume total armazenado : Utilizado somente em caso de descargas por volumetria	Float
*armazenamento	Objeto que representa os balões ou silos de destino do produto descarregado e seus respectivos volumes	Array

Propriedades do array de armazenamento

Campo	Descrição	Tipo
deposito	Código do depósito, cadastrado na plataforma Milk's Veja aqui	Texto
volume	Volume total armazenado no balão ou silo de destino.	Número inteiro

Exemplo de requisição

{
    "conta_id": 9999,
    "token": "sccv-tyu0-poy7-5678",
    "doc": "99.999.999/9999-99",
    "data": {
        "descargas": [           
            {
                "tipo": "V",
                "inicio_descarga": "13-02-2022 00:00:35",
                "fim_descarga": "13-02-2022 00:55:35",
                "viagem": "759260",
                "tecnico": "001",
                "medidor": "Nota a respeito do medidor utilizado",
                "parecer": "Observações a respeito da descarga",
                "armazenamento": [
                    {
                        "deposito": "GRP2121/3",
                        "volume": 15100
                    }
                ]
            }            
        ]
    }
}

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
        {
            "viagem":89776"
            "tecnico": "", // Código do técnico não localizado
            "error_message": "Técnico inválido", // mensagem de erro
            "error_code": 40003 // código do erro
        }
    ],
    "monitor.time": 2.14737200737 // Tempo de execução
}

Os registros foram enviados para a Plataforma Milk's e importados, 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.