Enviar produtos

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

Método POST

http://api.milksrota.com.br/farmer/retaguarda/writeProduto

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

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

Propriedades do produto

Campo	Descrição	Tipo	Obrigatório
codigo *	Código do produto	Texto	SIM
produto *	Nome de identificação do produto	Texto	SIM
categoria *	Código da categoria que agrupa o produto	Texto	SIM
unidade *	Representação da unidade de peso e medida do produto	Texto	SIM
preco	Valor unitário do produto	Número(10,2)	NÃO
marca	Especificação da marca do produto	Texto	NÃO
modelo	modelo do produto	Texto	NÃO
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

Exemplo de requisição

{
    "conta_id": "DDDDD",
    "token": "xxxx-xxxx-xxxx-xxxx",
    "doc": "99.99.999/9999-99",
    "data": [
        {
            "codigo" : "001/01",
            "produto" : "Silagem de milho composto",
            "unidade" :"saco 60 Kg",            
            "categoria": "001",
            "preco": "145.90",
            "marca": "NUTRIPAR",
            "modelo": null,
            "deleted": 0 // Indica que o registro está ativo
        },
        {
            "codigo" : "002/01",
            "produto" : "Ração 105020",
            "unidade" :"saco 60 Kg",            
            "categoria": "001",
            "preco": "210.00",
            "marca": "CARTOLA II",
            "modelo": null,
            "deleted": 0 // Indica que o registro está ativo
        }        
    ]
}

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": "002/01", // Código do produto não importado
            "mensagem": "Código já cadastrado em outro registro ", // mensagem de 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.