# Registrar resultados

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

## Solicitud de servicio web

### Datos&#x20;

```javascript
{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99",
    "data": [
        // lista de registros de resultados
    ]
}
```

{% 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 resultados de análisis obtenidos del laboratorio externo. 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 %}

### Propiedades de la tabla de resultados

| Campo           | Descrição                                                        | Tipo           | Obrigatório |
| --------------- | ---------------------------------------------------------------- | -------------- | ----------- |
| **conta**       | Código de registro de cuenta de empresa en la plataforma de Milk | Texto          | SIM         |
| **produtor**    | Código del productor de leche al que pertenece el resultado      | Texto          | SIM         |
| tanque          | Código del tanque del que se obtuvo la muestra para análisis     | Texto          | NÃO         |
| fazenda         | Código de la explotación donde se produce la muestra de leche    | Texto          | NÃO         |
| laboratorio     | Nombre del laboratorio donde se realizaron los análisis          | Texto          | NÃO         |
| codigo\_os      | Código de orden de servicio enviado al laboratorio               | Texto          | NAO         |
| codigo\_analise | Código de identificación del análisis                            | Texto          | NAO         |
| teor\_gordura   | indicador del contenido de grasa obtenido en el examen           | Decimal (10,2) | NÃO         |
| **ccs**         | Indicador CCS obtenido en el análisis                            | Decimal (10,2) | SIM         |
| **ufc**         | Indicador CFU (CPP) obtenido en el análisis                      | Decimal (10,2) | SIM         |
| proteinas       | Indicador proteico obtenido en el análisis                       | Decimal (10,2) | NÃO         |
| esd             | Indicador ESD obtenido en el análisis                            | Decimal (10,2) | NÃO         |
| lactose         | Indicador de lactosa obtenido en el análisis                     | Decimal (10,2) | NÃO         |
| solido          | Indicador de sólidos totales obtenidos en el análisis            | Decimal (10,2) | NÃO         |
| acidez          | Indicador de acidez obtenido en el análisis                      | Decimal (10,2) | NÃO         |
| densidade       | Indicador de densidad obtenido en el análisis                    | Decimal (10,2) | NÃO         |
| criscopia       | Indicador de crioscopia obtenido en el análisis                  | Decimal (10,2) | NÃO         |
| **dt\_coleta**  | Fecha de recogida de la muestra                                  | DateTime       | SIM         |
| **dt\_analise** | Fecha de realización del análisis                                | DateTime       | SIM         |

{% hint style="info" %}
**Importação direta dos laboratórios do RBQL**: Algunos laboratorios de la red cuentan con una API de integración que permite la importación directa de los resultados de las órdenes de servicio enviadas. La Plataforma de Leche tiene, hasta ahora, la rutina ya integrada para la Clínica do Leite (ESALQ) y CPA (Goiás). La interfaz del panel de monitoreo de la plataforma se puede utilizar para obtener e importar los resultados sin necesidad de escribir una rutina de alimentación desde el ERP.
{% endhint %}

## Ejemplo de requisición

```javascript
{
    "conta_id": 9999,
    "token": "s0637r",
    "doc": ".999/9999-90",
    "data": [
        {
            "produtor": "1152",
            "tanque": "",
            "fazenda": "",
            "dt_coleta": "2021-01-03 10:00:00",
            "dt_analise": "2021-01-10 14:00:00",
            "laboratorio": "EMBRAPA GADO DE LEITE",
            "codigo_os": "OS_9001/2021",
            "codigo_analise": "123456",
            "teor_gordura": "12.6",
            "ccs": "300",
            "ufc": "400",
            "proteinas": "3.9",
            "esd": "12.9",
            "lactose": "",
            "solido": "",
            "acidez": "",            
            "densidade": "",
            "crioscopia": "0.540"            
        }
    ]
}
```

## Respuesta

### 200: Importación realizada

```javascript
{
    "success": true,
    "message": "OK",
    "data": null,
    "monitor.time": 1.1079120636
}
```

{% 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": [ // Falhas de importação
        {
            "produtor": "1152", // Código do produtor não importado
            "error_message": "Valor de CCS inválido", // mensagem de erro
            "error_code": 40003 // código do erro
        }
    ],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% 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.
{% 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 %}
