Enviar resultados

Envia os registros com os indicadores dos resultados de análise de qualidade

Método POST

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

Requisição

Dados da requisição

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

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 resultados de análise obtidos do laboratório externo. Cada registro pode ser informando com a relação de propriedades detalhadas abaixo. Apenas os campos obrigatórios não podem ser ignorados.

Propriedades do agente de coleta

Campo	Descrição	Tipo	Obrigatório
conta	Código de registro da conta da empresa na plataforma Milk's	Texto	SIM
produtor	Código do produtor a quem pertence o resultado	Texto	SIM
tanque	Código do tanque de onde foi obtida a amostra para análise	Texto	NÃO
fazenda	Código da fazenda onde se produz o leite da amostra	Texto	NÃO
laboratorio	Nome do laboratório onde foram feitas as análises	Texto	NÃO
codigo_os	Código da ordem de serviço enviada ao laboratório	Texto	NAO
codigo_analise	Código de identificação da análise	Texto	NAO
teor_gordura	indicador do teor de gordura obtido no exame	Decimal (10,2)	NÃO
ccs	Indicador de CCS obtido na análise	Decimal (10,2)	SIM
ufc	Indicador de UFC (CPP) obtido na análise	Decimal (10,2)	SIM
proteinas	Indicador de proteínas obtido na análise	Decimal (10,2)	NÃO
esd	Indicador de ESD obtido na análise	Decimal (10,2)	NÃO
lactose	Indicador de lactose obtido na análise	Decimal (10,2)	NÃO
solido	Indicador de sólidos totais obtido na análise	Decimal (10,2)	NÃO
acidez	Indicador de acidez obtido na análise	Decimal (10,2)	NÃO
densidade	Indicador de densidade obtido na análise	Decimal (10,2)	NÃO
criscopia	Indicador de crioscopia obtido na análise	Decimal (10,2)	NÃO
dt_coleta	Data da coleta da amostra	DateTime	SIM
dt_analise	Data de realização da análise	DateTime	SIM

Importação direta dos laboratórios do RBQL: Alguns laboratórios da rede possuem uma API de integração que permitem a importação direta dos resultados de ordens de serviço enviadas. A Plataforma Milk's tem, até o momento, a rotina já integrada para a Clínica do Leite (ESALQ) e CPA (Goiás). Pode-se utilizar a interface do painel de monitoramento da plataforma para obter e importar os resultados sem a necessidade de se escrever uma rotina de alimentação vinda do ERP.

Exemplo de requisição

{
    "conta_id": 9999,
    "token": "s0637r",
    "doc": "99.999.999/9999-90",
    "data": [
        {
            "produtor": "1152",
            "tanque": "",
            "fazenda": "",
            "dt_coleta": "2021-01-03 10:00:00",
            "dt_analise": "2021-01-10 14:00:00",
            "laboratorio": "EMBRAPA GADO DE LEITE",
            "codigo_os": "OS_9001/2021",
            "codigo_analise": "123456",
            "teor_gordura": "12.6",
            "ccs": "300",
            "ufc": "400",
            "proteinas": "3.9",
            "esd": "12.9",
            "lactose": "",
            "solido": "",
            "acidez": "",            
            "densidade": "",
            "crioscopia": "0.540"            
        }
    ]
}

Resposta

200: Importação realizada

{
    "success": true,
    "message": "OK",
    "data": null,
    "monitor.time": 1.1079120636
}

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
        {
            "produtor": "1152", // Código do produtor não importado
            "error_message": "Valor de CCS 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.