---
description: >-
  Método permite manipular registro(s) de coleta(s) de uma determinada viagem.
  Suporta operações de alteração, inclusão e exclusão.
---

# Atualizar coleta

{% hint style="info" %}
## Método POST

http://app.milksrota.com.br/api/retaguardasync/writeColeta
{% endhint %}

## Requisição

### Dados da requisição

```javascript
{
    "conta_id": 999999,
    "token": "sxert0637r",
    "doc": "99.999.999/0009-90",
    "data": []
}

```

{% 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 coletas. Cada registro de coleta pode ser informando com a relação de propriedades detalhadas abaixo. Apenas os campos obrigatórios não podem ser ignorados.
{% endhint %}

### Propriedades da coleta

| Campo          | Descrição                                                                                    | Tipo           | Obrigatório                     |
| -------------- | -------------------------------------------------------------------------------------------- | -------------- | ------------------------------- |
| **viagem\_id** | identificador único da viagem registrado na plataforma Milk's.                               | Número Inteiro | Sim                             |
| **coleta\_id** | Identificador único do registro de coleta                                                    | Número Inteiro | Sim, para operação de alteração |
| **volume**     | Volume total que substituirá ou comporá o registro da coleta                                 | Número inteiro | Sim                             |
| **produtor**   | código do produtor comum ao sistema ERP e a Plataforma Milk's                                | Texto          | Sim                             |
| **fazenda**    | código do fazenda comum ao sistema ERP e a Plataforma Milk's                                 | Texto          | Sim                             |
| **tanque**     | código do tanque comum ao sistema ERP e a Plataforma Milk's                                  | Texto          | Não                             |
| **deleted**    | Indicador de operação: (0) - Indica inclusão ou alteração, (1) - indica exclusão do registro | Número         | Sim                             |

### Exemplo de requisição

```javascript
{
    "conta_id": 999999,
    "token": "sxert0637r",
    "doc": "99.999.999/0009-90",
    "data": [
        {
            "viagem_id": "1234567",            
            "coleta_id": "", 
            "volume": "999",
            "produtor": "000999",
            "fazenda": "F999",
            "tanque": "T999",
            "deleted": "0"
        }
    ]
}
```

## Resposta

### 200: Registros importados

```javascript
{
    "success": true,
    "message": "OK",
    "data": [
        "26454591": {
            "success": true,
            "coleta_id": "26454591", // Id da coleta alterada ou insrida 
            "visita_id": "18774601", // Id da visita alterada ou inserida
            "armazenamento_id": "20538290", // Id do armazenamento
            "monitoramentoVisita_id": "21027684" // Id do monitoramento
        }
    ],
    "monitor.time": 7.025467872619629, // Tempo de execução
    "server.date": "2024-07-19 17:09:41"
}
```

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

### 200: Processados com falhas

```javascript
{
    "succes": false,
    "message": "OK",
    "data": [1234567 // Falhas de importação
        {
            "Produtor 000999": "Não encontrado", // Código do produtor não localizado
            "Viagem 1234567": "Viagem não localizada", // Identificado da viagem não localizado
            
        }
    ],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="info" %}
Os registros foram enviados para a Plataforma Milk's e processados, 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 %}
