# Enviar descarga

## Método POST

{% embed url="<http://app.milksrota.com.br/api/retaguardasync/writeDescarga>" %}

### Requisição:

```
{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99",
    "data": {
        "descargas": [           
             {
                "tipo": "P",  // Pesagem
                "inicio_descarga": "13-02-2022 00:00:35",
                "fim_descarga": "13-02-2022 00:55:35",
                "viagem": "99999",
                "tecnico": "001",
                "densidade": "1,032",
                "peso_entrada": "12.895,500",
                "peso_saida": "8.589,700",
                "volume_pesagem": "4.443,58",
                "medidor": "Nota a respeito do medidor utilizado",
                "parecer": "Observações a respeito da descarga",
                "armazenamento": [
                    {
                        "deposito": "GRP2121/3",
                        "volume": 400
                    },
                    {
                        "deposito": "VIG-002",
                        "volume": 4000
                    }
                  ]
              }
        ]
    }
}
```

{% hint style="info" %}
**conta\_id**: Deve ser informado o ID da conta que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**token**: Deve ser informado o Token da conta, que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**doc:** Deve ser informado o CNPJ da conta cadastra. Pode ser encontrado na tela ***"Sua conta"*** no menu principal do painel Milk's Rota.

**data**: Lista que deve conter um ou mais registros de descargas. Cada registro de descarga pode ser informando com a relação de propriedades detalhadas abaixo. Apenas os campos obrigatórios não podem ser ignorados.
{% endhint %}

### Propriedades da tabela descarga

| Campo               | Descrição                                                                                                                                                      |   Tipo   |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------: |
| **\*tipo**          | Identifica o descarga quanto a seu tipo: **V -** Volumetri&#x61;**; P -** Pesagem                                                                              |   Texto  |
| inicio\_descarga    | Data e hora de início do procedimento de descarga no formato (AAAA-MM-DD hh:mm:ss)                                                                             |   Texto  |
| fim\_descarga       | Data e hora de início do procedimento de descarga no formato (AAAA-MM-DD hh:mm:ss)                                                                             |   Texto  |
| **\*viagem**        | Identificador único da viagem, gerado pela plataforma Milk's.                                                                                                  | Numérico |
| **\*técnico**       | Código do técnico responsável pela descarga                                                                                                                    |   Texto  |
| medidor             | Informações e identificação do medidor utilizado no processo de descarga                                                                                       |   Texto  |
| parecer             | Observações sobre o processo de descarga                                                                                                                       |   Texto  |
| densidade           | Densidade registrada para considerar a conversão peso/volume - **Utilizado somente em caso de descargas por pesagem**                                          |  Decimal |
| peso\_entrada       | Peso de entrada do veículo, quando carregado: **Utilizado somente em caso de descargas por pesagem**                                                           |  Decimal |
| peso\_saida         | Peso líquido de saída do veículo: **Utilizado somente em caso de descargas por pesagem**                                                                       |  Decimal |
| volume\_pesagem     | Volume final calculado : **Utilizado somente em caso de descargas por pesagem**                                                                                |  Decimal |
| **qtd\_armazenado** | Volume total armazenado : **Utilizado somente em caso de descargas por volumetria**                                                                            |   Float  |
| **\*armazenamento** | <mark style="color:red;background-color:yellow;">Objeto que representa os balões ou silos de destino do produto descarregado e seus respectivos volumes</mark> |   Array  |

#### Propriedades do array de armazenamento

| Campo        | Descrição                                                                                       | Tipo           |
| ------------ | ----------------------------------------------------------------------------------------------- | -------------- |
| **deposito** | <p>Código do depósito, cadastrado na plataforma Milk's<br><a href="../tanque">Veja aqui</a></p> | Texto          |
| **volume**   | Volume total armazenado no balão ou silo de destino.                                            | Número inteiro |

### Exemplo de requisição

```
{
    "conta_id": 9999,
    "token": "sccv-tyu0-poy7-5678",
    "doc": "99.999.999/9999-99",
    "data": {
        "descargas": [           
            {
                "tipo": "V",
                "inicio_descarga": "13-02-2022 00:00:35",
                "fim_descarga": "13-02-2022 00:55:35",
                "viagem": "759260",
                "tecnico": "001",
                "medidor": "Nota a respeito do medidor utilizado",
                "parecer": "Observações a respeito da descarga",
                "armazenamento": [
                    {
                        "deposito": "GRP2121/3",
                        "volume": 15100
                    }
                ]
            }            
        ]
    }
}
```

## Resposta

### 200: Registros importados

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

{% hint style="success" %}
Os registros foram enviados para a Plataforma Milk's e importados sem erro.
{% endhint %}

### 200: Importação com falhas

```javascript
{
    "succes": true,
    "message": "OK",
    "data": [ // Falhas de importação
        {
            "viagem":89776"
            "tecnico": "", // Código do técnico não localizado
            "error_message": "Técnico inválido", // mensagem de erro
            "error_code": 40003 // código do erro
        }
    ],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="info" %}
Os registros foram enviados para a Plataforma Milk's e importados, entretanto, alguns registros não puderam ser importados.
{% endhint %}

### 404: Conta não localizada&#x20;

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

{% hint style="danger" %}
**O que isso significa?** Significa que o ID da conta não foi localizado na Plataforma Milk's.
{% endhint %}

### 403: Token inválido

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

{% hint style="danger" %}
**O que isso significa?** Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.
{% endhint %}