Registrar Rutas

Envía los registros de ruta registrados en el ERP a la Plataforma de Leche.

Método POST

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

Enviar solicitud al servidor

Datos

{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "data": [
        // lista de registros de rutas
    ]
}

conta_id: Se debe informar el ID de cuenta que encuentra en la pantalla "Su cuenta" en el menú principal del panel de Milk's Rota.

token: Se debe informar el Token de la cuenta, el cual puedes encontrar en la pantalla "Su cuenta" en el menú principal del panel de Milk's Rota.

doc: Se debe informar el RUC de la cuenta registrada. Se puede encontrar en la pantalla "Su cuenta" en el menú principal del tablero de Milk's Rota.

data: Lista que debe contener uno o más registros de rutas. Cada registro puede ser informado con la lista de propiedades que se detalla a continuación. Solo los campos obligatorios no se pueden omitir.

Propriedades

Campo	Descripción	Tipo	Obrigatório
codigo	código de ruta	Texto	SIM
nome	nombre de la ruta	Texto	SIM
deleted	Si se debe eliminar el registro. Si envía el valor 1, se eliminará si ya existe en la plataforma. Si se envía 0, se reactivará en la plataforma.	Número	SIM
tipo_descarga	Tipo de volcado predeterminado de la ruta. TP = Descarga por parte del técnico a través del panel web.	Texto	Não
grupo_rota*	código de grupo de ruta	Texto	Não

grupo_rota: El campo "grupo_rota" debe ser llenado con el mismo código de grupo de ruta ya registrado en la Plataforma Milk's. Si se ingresa un código de grupo de ruta no registrado, la ruta se registrará sin un enlace a un grupo de ruta.

Ejemplo solicitud al servidor

{
    "conta_id": XXXX, 
    "token": "0000-0000-0000-0000", 
    "data": [
        {
            "nome": "Rota MURIAE",
            "codigo": "105",
            "tipo_descarga": "TP",
            "grupo_rota": null,
            "deleted": "0"
        },    
        {
            "nome": "Rota MURIAE II ",
            "codigo": "106",
            "tipo_descarga": "TP",
            "grupo_rota": "100",
            "deleted": "1"
        }
    ]
}

Respuesta

200: Importación realizada

{
  "succes": true,
    "message": "OK",
    "data": [],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}  

Los registros fueron subidos a la Plataforma de Leche e importados sin error.

200: importación fallida

{
    "succes": true,
    "message": "OK",
    "data": [ // errores de importación
        {
            "codigo": "001", // Código de grupo de ruta no importado
            "error_message": "Nome não informado", // mensaje de error
            "error_code": 40003 // código de error
        }
    ],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}

Los registros se cargaron en la plataforma de Milk y se importaron; sin embargo, algunos registros no se pudieron importar.

404: Cuenta no encontrada

{    
    "success": false,
    "message": "Conta não localizada",
    "data": [],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}

Que significa eso? Significa que la identificación de la cuenta no se encontró en la Plataforma de Milk's.

403: Token no valido

{
    "success": false,
    "message": "Token inválido",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}

Que significa eso? Significa que el token informado en la solicitud no corresponde al token registrado para la cuenta.