🇧🇷
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 da programação
  • 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. Programação de coleta

Enviar programação

Envia os registros de programação cadastrados no ERP para a Plataforma Milks.

Método POST

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

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 programação
    ]
}

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

Propriedades da programação

Campo

Descrição

Tipo

Obrigatório

codigo

Código da rota

Texto

SIM

linha *

Código da linha de coleta

Texto

SIM

dt_vigencia_inicio

Data de vigência inicial da programação

Data e Hora

SIM

dt_vigencia_fim

Data da vigência final da programação

Data e hora

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

NÃO

codigo: O campo código deverá ser preenchido com o mesmo código já cadastrado no ERP, esta propriedade é utilizada para localizar os registros na base de dados da Plataforma Milk's e direcionar as operações CRUD.

  • linha: Esta propriedade é utilizada para associar a linha de coleta na tabela "linha" com com o registro da programação. Se registro de linha não for localizado, o registro de programação não será importado.

Exemplo de requisição

{
    "conta_id": "9999",
    "token": "s0637r",
    "doc": "99.999.999/9999-99",
    "data": [
        {
            "codigo": "P-0006",
            "linha":"BR250",
            "dt_vigencia_inicio": "2020-08-01 00:00:01",
            "dt_vigencia_fim": "2030-08-01 23:59:59",
            "deleted": "0"
        },
         {
            "codigo": "P-0007",
            "linha":"",
            "dt_vigencia_inicio": "2020-08-01 00:00:01",
            "dt_vigencia_fim": "2030-08-01 23:59:59",
            "deleted": "0"
        }
    ]
}

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
        {
            "codigo": "P-0007", // Código da programação não importada
            "error_message": "código do linha 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.

PreviousProgramação de coletaNextBaixar programação

Last updated 2 months ago