Registrar conductores

Envía los registros de los agentes de cobranza (Conductores) registrados en el ERP a la Plataforma de Leche.

Método POST

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

Enviar solicitud al servidor

Datos

{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99",
    "data": [
        // lista de registros de agentes de cobranza (choferes)
    ]
}

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 conductores. 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	Descrição	Tipo	Obrigatório
codigo	Código do conductor	Texto	SIM
nome	Nombre do conductor	Texto	SIM
rg	Cocumento de identidad	Texto	NÃO
cpf	Inscripción individual	Texto	NÃO
cnh	Número da carteira de habilitação	Texto	NÃO
categoria_cnh	Licencia de conducir	Texto	NÃO
vencimento_cnh	Fecha de vencimiento de la licencia	Data	NÃO
telefone	Teléfono de contacto	Texto	NÃO
email	Correo electrónico de contacto del conductor	Texto	NÃO
transportadora	código de operador	Texto	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.	Texto	SIM

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": 9999,
    "token": "s0637r",
    "doc": "99.999.999/9999-90",
    "data": [
        {
            "codigo": "C-1010",
            "nome": "Coletor_C1010",
            "deleted": "0"
        },
        {
            "codigo": "C-1020",
            "nome": "Coletor_C1020",
            "deleted": "0"
        },
        {
            "codigo": "C-1030",
            "nome": "Coletor_C1030",
            "deleted": "0"
        },
        {
            "codigo": "C-1040",
            "nome": "",
            "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": "C-1040", // Código de agente no importado
            "error_message": "Nome 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 // Tempo de execução
}

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.