🇪🇸
Milk's API
Español
Español
  • Plataforma Milk's
  • Milk's Rota
    • Análisis de calidad
      • Registrar resultados
    • Conductores
      • Registrar conductores
      • Leer conductores
    • Fincas
      • Registrar fincas
      • Leer fincas
    • Grupos de rutas
      • Registrar Grupos de Rutas
      • Leer Grupos de Rutas
    • Rutas
      • Registrar Rutas
      • Leer Rutas
    • Análisis de laboratorio
      • Registrar indicadores
      • Leer Análisis
      • Baixar resultados
    • Itinerário
      • Registrar itinerário
      • Leer itinerário
    • Lineas
      • Registrar lineas
      • Leer lineas
    • Motivos de cancelacion
      • Registrar motivos
      • Leer motivos
    • Puntos de recogida
      • Registrar puntos de recogida
      • Leer puntos de recogida
    • Productores
      • Enviar productores
      • Leer productores
    • Calendario de recogida
      • Registrar calendario
      • Leer calendario
    • Tanques (Almacenamiento)
      • Registrar tanques
      • Leer tanques
    • Tanques (Colectivo)
      • Enviar productores vinculados
    • Técnico
      • Enviar técnicos
      • Leer técnicos
    • Vehículo
      • Enviar Vehículo
      • Leer Vehículo
    • Excursiones
      • Leer excursiones
      • Resumen de viaje
      • Colecciones de leche
      • Colecciones de leche (resumió)
      • Colecciones reales
      • Registrar descargar
      • Leer descargar
      • Enviar descarga
    • Métodos auxiliares
      • Status do integrador
      • Status viagem
Con tecnología de GitBook
En esta página
  • Método POST
  • Requisição:
  • Propriedades da tabela descarga
  • Exemplo de requisição
  • Resposta
  • 200: Registros importados
  • 200: Importação com falhas
  • 404: Conta não localizada
  • 403: Token inválido
  1. Milk's Rota
  2. Excursiones

Enviar descarga

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

AnteriorLeer descargarSiguienteMétodos auxiliares

Última actualización hace 2 años

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

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

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.

Código do depósito, cadastrado na plataforma Milk's

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