Enviar descarga

Registra el procedimiento de descarga en la plataforma de recepción.

Método POST

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

CampoDescriçãoTipo

*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

CampoDescriçãoTipo

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.

Última actualización