> 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/milks-pay/deducoes/enviar-categorias.md).

# Importar deduções

> ## Método POST
>
> <http://api.milksrota.com.br/pay/deducao/import>

## Requisição

### Dados da requisição

```javascript
{
    "token" : "XXXX-XXXX-XXXX-XXXX", 
    "conta_id" : "DDDDDD",
    "doc" : "99.999.999/9999-99",
    "clear": false, // true: Limpa todas as deduções de um produtor na folha, false: Não limpa deduções
    "data": [
        {
              "codigo_produtor": "P001", // código do produtor
              "folha": 1234 // ID da folha de pagamento a ser vinculada na despesa [OPCIONAL]
              "data": "2024-01-15", // data da dedução
              "valor": 150.00, // valor da dedução
              "descricao": "Desconto frete", // descrição da dedução
              "codigo_fazenda": "F002" // código da fazenda obrigatório se o pagamento for por fazenda
        },
        ...    
    ] // lista de deduções
}
```

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

**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.

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

**clear:** Deve enviar true ou false. Caso true seja enviado, todas as deduções do produtor no período da dedução a ser importada serão apagadas antes da nova inserção.
{% endhint %}

## Resposta

### 200: Registros localizados

### Exemplo de requisição

```javascript
{
  "processados": 1,
  "erros": [
    { "error": "Produtor não localizado: P001" }
  ]
}
```

{% hint style="success" %}
Retorna a quantidade de deduções processadas e sinaliza os registros de deduções que apresentaram erro.
{% endhint %}

### 400: Conta não localizada

```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 %}