Registrar lineas

Envía los registros de las líneas de cobro registradas en el ERP a la Plataforma de Leche.

Método POST

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

Enviar solicitud al servidor

Datos

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

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 lineas. 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 línea	Texto	SIM
nome	nombre de línea	Texto	SIM
rota	Código de la ruta a la que está asociada la línea	Texto	SIM
distancia	Distancia total en KM desde la línea de recolección	Número	NÃO
km_adicional	Número de kilómetros (km) que el sistema debe agregar a la línea de recolección cuando el seguimiento está habilitado	Número	NÃO
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
bloqueado	Indica si el registro debe bloquearse para actualizaciones a través de la API: "1" (uno) - Sí; "0" (cero) - No.	Texto	NÃO

codigo: El campo de código debe ser llenado con el mismo código ya registrado en el ERP, esta propiedad se utiliza para ubicar registros en la base de datos de la Plataforma de Leche y dirigir operaciones CRUD.

La propiedad "Deleted" se utiliza para comandar el proceso de actualización, incluyendo o eliminando lógicamente el registro. Si su valor es "0" (cero) y no se ha encontrado el registro, se creará. Si se encuentra, el valor se actualizará y si el valor es "1" (uno), el contenido se excluirá lógicamente de la base de datos.

Ejemplo solicitud al servidor

{
"conta_id":99999,
"token":"s0637r",
"doc":"99.999.999/9999-99",
"data":[{
	"codigo":"L-2010",
	"rota":"002",
	"nome":"Linha_L2010" ,
	"deleted":"0"
	},
	{
	"codigo":"L-2020",
	"rota":"002",
	"nome":"Linha_L2020",
	"deleted":"0"
	},
	{
	"codigo":"L-2030",
	"rota":"",
	"nome":"Linha_L2030",
	"deleted":"0"
	}
	]
	
}

Respuesta

200: Importación realizada

{
  "succes": true,
    "message": "OK",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}  

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": "i-2030", // Código de linea no importado
            "error_message": "código da linha inválido", // 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 // Tiempo de ejecución
}

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