> For the complete documentation index, see [llms.txt](https://docs.milksrota.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.milksrota.com.br/espanol/milks-rota/veiculos/enviar-veiculos.md).

# Enviar Vehículo

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

## Enviar solicitud al servidor

### Datos

```javascript
{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99",
    "data": [
        // lista de matriculación de vehículos
    ]
}
```

{% 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 productores. 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&#x20;

| Campo          | Descripción                                                                                                                                              | Tipo    | Obrigatório |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----------- |
| **codigo**     | codigo de vehiculo                                                                                                                                       | Texto   | SIM         |
| **placa**      | placa de identificación                                                                                                                                  | Texto   | SIM         |
| tipo           | Identifica el vehículo según su tipo: **V** - Vehículo simple; **R** - Remolque (Julieta)                                                                | Texto   | NÃO         |
| fabricante     | Nombre del fabricante del vehículo                                                                                                                       | Texto   | NÃO         |
| modelo         | Modelo de vehículo                                                                                                                                       | Texto   | NÃO         |
| cor            | color predominante                                                                                                                                       | Texto   | NÃO         |
| ano            | Año de fabricación/Modelo                                                                                                                                | Texto   | NÃO         |
| categoria\_cnh | Categoría mínima de licencia requerida para conducir el vehículo                                                                                         | Texto   | NÃO         |
| peso\_bruto    | Peso total del vehículo                                                                                                                                  | Decimal | NÃO         |
| peso\_liquido  | Peso neto del vehículo                                                                                                                                   | Decimal | NÃO         |
| bloqueado      | Indica si el registro debe bloquearse para actualizaciones a través de la API: **1 (uno) - Sí; 0 (cero) - no.**                                          | 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. | Texto   | SIM         |

{% hint style="info" %}
**código**: El campo **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**.&#x20;

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": "99999",
    "token": "b66c-78f2-fd62-e931",
    "doc": "99.999.999/9999-99",
    "data": [
        {
            "codigo": "5",
            "placa": "OPA-4421",
            "tipo": "V",
            "pesoBruto": "3100",
            "pesoLiquido": "17100",
            "capacidade": "14000",
            "deleted": "1"
        },
        {
            "codigo": "6",
            "placa": "AYJ-4801",
            "tipo": "V",
            "pesoBruto": "",
            "pesoLiquido": "",
            "capacidade": "",
            "deleted": "1"
        },
        {
            "codigo": "",
            "placa": "BCM-6572",
            "tipo": "V",
            "pesoBruto": "",
            "pesoLiquido": "",
            "capacidade": "",
            "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": "T-1030", // Código del vehículo no importado
            "error_message": "código do veículo inválido", // mensaje de error
            "error_code": 40003 // código de error        }
    ],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}
```

{% hint style="warning" %}
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 // Tiempo de ejecución
}
```

{% 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 // Tiempo de ejecución
}
```

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