# Registrar conductores

> ## Método POST
>
> <http://app.milksrota.com.br/api/retaguardasync/writeColetor>

## Enviar solicitud al servidor

### Datos&#x20;

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

{% hint style="info" %}
**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.
{% endhint %}

### 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         |

{% hint style="danger" %}
**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.
{% endhint %}

## Ejemplo solicitud al servidor

```javascript
{
    "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

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

{% hint style="success" %}
Los registros fueron subidos a la Plataforma de Leche e importados sin error.
{% endhint %}

### 200: importación fallida

```javascript
{
    "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
}
```

{% hint style="info" %}
Los registros se cargaron en la Plataforma de Milk y se importaron, sin embargo, algunos registros no se pudieron importar.
{% endhint %}

### 404: Cuenta no encontrada

```javascript
{    
    "success": false,
    "message": "Conta não localizada",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**Que significa eso?** Significa que la identificación de la cuenta no se encontró en la Plataforma de Milk's..
{% endhint %}

### 403: Token no valido

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

{% hint style="danger" %}
**Que significa eso?** Significa que el token informado en la solicitud no corresponde al token registrado para la cuenta.
{% endhint %}