Enviar fazendas

Envia os registros de fazendas cadastradas no ERP para a Plataforma Milk's.

Método POST

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

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 produtores
    ]
}

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 fazenda

produtor: O campo produtor deverá ser preenchido com o mesmo código do produtor proprietário da fazenda já cadastrado na Plataforma Milk's. Caso seja informado um código de produtor não cadastrado, o registro da fazenda não será importado.

Exemplo de requisição

{
    "conta_id": "DDDDD",
    "token": "xxxx-xxxx-xxxx-xxxx",
    "doc": "99.99.999/9999-99",
    "data": [
        {
            "codigo": "10128/01",
            "nome": "SITIO FLOR DE MINAS",
            "logradouro": "SITIO FLOR DE MINAS",
            "numero": "SN",
            "bairro": "ZONA RURAL",
            "municipio": "MANTENA",
            "uf": "MG",
            "cep": "35296-000",
            "latitude": null,
            "longitude": null,
            "produtor": "10128",
            "filial": "2",
            "deleted": 1 // desativa o registro
        },
        {
            "codigo": "10129/01",
            "nome": "SITIO ESTRELA DA SILVA",
            "logradouro": "SITIO ESTRELA DA SILVA",
            "numero": "SN",
            "bairro": "ZONA RURAL",
            "municipio": "MANTENA",
            "uf": "MG",
            "cep": "35296-000",
            "latitude": -43.12312,
            "longitude": -19.1381231,
            "produtor": "10129",
            "filial": "2",
            "deleted": 0 // ativa o registro
        }
    ]
}

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

{
    "succes": true,
    "message": "OK",
    "data": [ // Falhas de importação
        {
            "codigo": "001", // Código da fazenda não importada
            "error_message": "Produtor não encontrado", // 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.