🇧🇷
Milk's API
Português
Português
  • Plataforma Milk's
  • Milk's Rota
    • Análise de qualidade
      • Enviar resultados
    • Agente de coleta
      • Enviar agentes de coleta
      • Baixar agentes de coleta
    • Entrada Spot
      • Entrada de Leite Spot
    • Fazenda
      • Enviar fazendas
      • Baixar fazendas
    • Grupo de rota
      • Enviar grupos de rota
      • Baixar grupos de rota
    • Rota
      • Enviar rotas
      • Baixar rotas
    • Laboratório e Análise
      • Enviar indicadores
      • Baixar análise
      • Baixar resultados
    • Itinerário
      • Enviar itinerário
      • Baixar itinerário
    • Linha
      • Enviar linhas
      • Baixar linhas
    • Motivo de cancelamento
      • Enviar motivos
      • Baixar motivos
    • Ponto de coleta
      • Baixar pontos de coleta
      • Enviar pontos de coleta
    • Produtor
      • Enviar produtores
      • Baixar produtores
    • Programação de coleta
      • Enviar programação
      • Baixar programação
    • Rota
      • Enviar rota
      • Baixar rota
    • Transportadoras
      • Enviar transportadoras
      • Baixar transportadora
    • Tanque
      • Enviar tanques
      • Baixar tanques
    • Tanque coletivo
      • Enviar produtores vinculados
    • Técnico
      • Enviar técnicos
      • Baixar técnicos
    • Veículo
      • Enviar veículos
      • Baixar veículos
    • Viagens
      • Baixar viagem
      • Baixar viagem: TOTVS Datasul
      • Resumo de viagem
      • Atualizar coleta
      • Baixar coletas
      • Baixar visitas
      • Baixar visitas de uma viagem
      • Resumo de coleta
      • Coleta real
      • Enviar descarga
      • Baixar descarga
      • Baixar eventos coleta
    • Métodos auxiliares
      • Status do integrador
      • Status viagem
  • Milk's Camp
  • Milk's Farmer
    • *️⃣Categoria de produtos
      • Categorias de produtos
    • ⏺️Produtos
      • Enviar produtos
      • Baixar produtos
    • ⏹️Convênios
      • Enviar convênios
      • Baixar convênios
    • 🔡Produtos de um convênio
      • Enviar produtos do convênio
      • Baixar produtos do convênio
    • #️⃣Documentos
      • ⤴️Enviar documentos
  • Milk's Pay
    • 💱Folha
      • Listar folhas
      • Baixar folha
    • Nota fiscal
      • Registrar Nota Fiscal
Powered by GitBook
On this page
  • Requisição
  • Dados da requisição
  • Propriedades dos indicadores de qualidade
  • Exemplo de requisição
  • Resposta
  • 200: Importação realizada
  • 200: Importação com falhas
  • 404: Conta não localizada
  • 403: Token inválido
  1. Milk's Rota
  2. Laboratório e Análise

Enviar indicadores

Envia os registros de indicadores de qualidade para serem utilizados nos resultados de análises realizadas no laboratório interno do laticínio

Método POST

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

Requisição

Dados da requisição

{
    "conta_id": "DDDDD",
    "doc": "99.999.999/0009-99,
    "token": "XXXX-XXXX-XXXX-XXXX",
    "data": [
        // lista de registros de indicadores
    ]
}

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.

doc: Deve ser informado o CNPJ 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.

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

Propriedades dos indicadores de qualidade

Campo

Descrição

Tipo

Obrigatório

codigo

Código do indicador

Texto

SIM

descricao

Nome do indicador

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

tipo

Tipo de indicador de qualidade.

N = numéro;

L = Lista de opções.

Texto

SIM

valor_minimo

Informar o valor mínimo aceito para o indicador

Texto

Somente se o tipo for "N"

valor_maximo

Informar o valor máximo aceito para o indicador

Texto

Somente quando o tipo for "N"

opcao_referencia

Indica que opção da lista é utilizada como referência para o resultado da análise

Texto

Somente quando o tipo for "L"

  • opcoes_lista

lista de opções possíveis para o resultado do exame. Deve vir com os valores separados por (;) ponto e vírgula

Texto

Somente quando o tipo for "L"

ordem

ordem para apresentação no resultado

Texto

NÃO

Exemplo de requisição

{
    "conta_id": 40001,
    "token": "s0909r",
    "doc": "99.999.999/0001-99",
    "data": [
        {
            "codigo": "105",
            "descricao": "Acidez ºD",           
            "tipo": "N", // Numérico
            "valor_minimo": "14.000",
            "valor_maximo": "17.000",
            "opcao_referencia": null,
            "opcoes_lista": null,
            "ordem": "1",
            "deleted": "0"
        },
        {
            "codigo": "106",
            "descricao": "Alizarol 80 ºGL",           
            "tipo": "L", // Lista
            "valor_minimo": null,
            "valor_maximo": null,
            "opcao_referencia": "ESTÁVEL",
            "opcoes_lista": "ESTÁVEL; INSTÁVEL;NÃO SE APLICA",
            "ordem": "2",
            "deleted": "0"
        }
        
    ]
}

Resposta

200: Importação realizada

{
  "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

{
    "success": true,
    "message": "OK",
    "data": {
        "rejeitados": [
            [
                {
                    "codigo": "",
                    "descricao": "PARAMETRO VINDO DA API",
                    "Status": "Não importado, falta código do registro !"
                }
            ]
        ],
        "importados": {
            "total": 0
        },
        "apagados": {
            "total": 0
        },
        "reativados": {
            "total": 0
        },
        "atualizados": {
            "total": 1,
            "0": "110"
        }
    },
    "monitor.time": 1.33903503418
}

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.

PreviousLaboratório e AnáliseNextBaixar análise

Last updated 2 months ago