# Registrar fincas

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

## 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 la granja
    ]
}
```

{% 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 de granja                                                                                                                                         | Texto    | SIM             |
| **produtor \*** | Código productor propietario de finca                                                                                                                    | Texto    | SIM             |
| **nome**        | nombre de la granja                                                                                                                                      | 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             |
| logradouro      | Nombre de la calle en la dirección de la granja                                                                                                          | Texto    | Não             |
| numero          | Número de dirección de la granja                                                                                                                         | Texto    | Não             |
| bairro          | Distrito de la dirección de la finca                                                                                                                     | Texto    | Não             |
| municipio       | Ciudad de la dirección de la granja                                                                                                                      | Texto    | Não             |
| uf              | Unidad federativa del domicilio de la finca                                                                                                              | Texto    | Não             |
| cep             | Código postal de la dirección de la granja                                                                                                               | Texto    | Não             |
| latitude        | Latitud de la coordenada geográfica de la finca                                                                                                          | Número   | Não             |
| longitude       | Longitud de la coordenada geográfica de la finca                                                                                                         | Número   | Não             |
| filial          | Código de afiliado de lácteos vinculado a la propiedad                                                                                                   | Texto    | Não             |

{% hint style="info" %}
**produtor**: El campo **produtor** debe ser llenado con el mismo código que el productor propietario de la finca ya registrado en la Plataforma de la Leche. Si se ingresa un código de productor no registrado, el registro de la finca no se importará.
{% endhint %}

## Ejemplo solicitud al servidor

```javascript
{
    "conta_id": "DDDDD",
    "token": "xxxx-xxxx-xxxx-xxxx",
    "doc": "99.99.999/9999-99",
    "data": [
        {
            "codigo": "10128/01",
            "nome": "SITIO FLOR DE MINAS",
            "logradouro": "SITIO FLOR DE MINAS",
            "numero": "SN",
            "bairro": "ZONA RURAL",
            "municipio": "MANTENA",
            "uf": "MG",
            "cep": "35296-000",
            "latitude": null,
            "longitude": null,
            "produtor": "10128",
            "filial": "2",
            "deleted": 1 // deshabilitar el registro
        },
        {
            "codigo": "10129/01",
            "nome": "SITIO ESTRELA DA SILVA",
            "logradouro": "SITIO ESTRELA DA SILVA",
            "numero": "SN",
            "bairro": "ZONA RURAL",
            "municipio": "MANTENA",
            "uf": "MG",
            "cep": "35296-000",
            "latitude": -43.12312,
            "longitude": -19.1381231,
            "produtor": "10129",
            "filial": "2",
            "deleted": 0 // activar el registro
        }
    ]
}
```

## 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": "001", // Código de granja no importado
            "error_message": "Produtor não encontrado", // 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.milksrota.com.br/espanol/milks-rota/fazenda/enviar-fazendas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.