> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ar-online.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Colunas do CSV

> Colunas obrigatórias, colunas de canal e variáveis do modelo.

## Obrigatórias

Estas três precisam existir no cabeçalho e estar preenchidas em **todas** as linhas.

| Coluna              | O que é                                                                                       |
| ------------------- | --------------------------------------------------------------------------------------------- |
| `ASSUNTO`           | Assunto da comunicação                                                                        |
| `NOME_DESTINATARIO` | Nome do destinatário                                                                          |
| `MODELO`            | Nome do arquivo do modelo cadastrado na pasta de modelos da sua conta, com a extensão `.html` |

<Warning>
  `MODELO` é o nome do arquivo, não um apelido. Precisa bater exatamente com o modelo
  cadastrado — incluindo maiúsculas, minúsculas e a extensão `.html`.
</Warning>

<Note>
  **O cadastro de modelos de remessa é feito pela AR Online**, no setup da conta. Para
  incluir, alterar ou remover um modelo, entre em contato pelo e-mail [suporte@ar-online.com.br](mailto:suporte@ar-online.com.br).
</Note>

<Warning>
  Os modelos usados em remessa **não são** os mesmos de **Cadastros → Modelos** do portal.
  Aquela tela guarda modelos para o envio avulso pela tela de Novo AR. Um modelo criado lá
  não pode ser referenciado na coluna `MODELO` do CSV — a remessa falharia com modelo não
  encontrado.
</Warning>

## Colunas de canal

Cada linha precisa de **pelo menos uma** preenchida para gerar notificação. Uma linha sem
nenhum canal é aceita, mas não envia nada a ninguém.

| Coluna                           | Canal                          |
| -------------------------------- | ------------------------------ |
| `EMAIL_DESTINATARIO`             | AR-Email                       |
| `TELEFONE_DESTINATARIO`          | AR-SMS                         |
| `TELEFONE_DESTINATARIO_WHATSAPP` | AR-Whatsapp                    |
| `TELEFONE_DESTINATARIO_VOZ`      | AR-Voz                         |
| `ENVIA_CARTAS`                   | AR-Cartas — preencha com `SIM` |

Telefones em SMS devem ter 11 dígitos, com DDD.

### Colunas que acompanham cada canal

| Coluna              | Quando usar                                                                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `TIPO_ENVIO_SMS`    | `1` envia o SMS só se o e-mail falhar. `2` envia o SMS sempre, independente do resultado do e-mail. Ausente ou fora desses valores, assume `1` |
| `TEMPLATE_WHATSAPP` | Obrigatória em todas as linhas se a coluna existir no arquivo                                                                                  |
| `TEMPLATE_VOZ`      | Obrigatória quando `TELEFONE_DESTINATARIO_VOZ` estiver preenchido                                                                              |
| `TEMPLATE_CARTAS`   | Modelo da carta, quando `ENVIA_CARTAS` for `SIM`                                                                                               |
| `TIPO_ENVIO_CARTAS` | `1`, `2` ou `3`. Ausente ou fora desses valores, assume `1`                                                                                    |

<Warning>
  AR-Voz e AR-Cartas precisam estar habilitados na sua conta. Preencher esses campos sem a
  liberação faz a remessa inteira ser recusada. Para habilitar, fale com o Comercial.
</Warning>

## Anexos

`ANEXO_1` a `ANEXO_5`. Veja [Anexos](/remessas/anexos).

## Variáveis do modelo

Qualquer outra coluna do CSV pode ser usada como variável dentro do modelo. O nome da
coluna é o nome da variável.

Variáveis marcadas como obrigatórias no modelo **precisam** existir como coluna no CSV.
Se faltar alguma, a remessa é recusada — o texto do erro diz qual.

<Accordion title="Exemplo">
  Se o modelo usa `{nome_cliente}` e `{valor}`, o CSV precisa das colunas `nome_cliente` e
  `valor`:

  ```csv theme={null}
  ID;ASSUNTO;NOME_DESTINATARIO;EMAIL_DESTINATARIO;MODELO;nome_cliente;valor
  1;Aviso;Fulano de Tal;fulano@exemplo.test;modelo_padrao.html;Fulano;250,00
  ```
</Accordion>

## Número de colunas por linha

Toda linha deve ter a mesma quantidade de campos do cabeçalho.

* **Campos a mais** que o cabeçalho: a remessa é recusada. Costuma ser ponto e vírgula
  dentro de um texto — se o conteúdo tem `;`, coloque o campo entre aspas duplas.
* **Campos a menos**: aceito. As últimas colunas chegam vazias, o que pode não ser o que
  você quer. O portal avisa.