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

# O arquivo CSV

> Formato, limites e nome do arquivo de remessa.

## Formato

| Item                  | Regra                              |
| --------------------- | ---------------------------------- |
| Extensão              | `.csv`                             |
| Separador de colunas  | ponto e vírgula (`;`)              |
| Codificação           | UTF-8                              |
| Tamanho máximo        | 10 MB                              |
| Registros por arquivo | até 5.000                          |
| Primeira linha        | cabeçalho com os nomes das colunas |

Linhas em branco e linhas contendo apenas separadores (`;;;;`) são ignoradas.

<Warning>
  Vírgula como separador é o erro mais comum. O Excel salva assim por padrão em algumas
  configurações — ao salvar, escolha **CSV separado por ponto e vírgula** ou **CSV UTF-8**.
</Warning>

## Exemplos

<Note>
  Nos exemplos, `modelo_padrao.html`, `aviso_cobranca`, `aviso_voz` e `carta_padrao` são
  nomes fictícios. Use os nomes dos modelos cadastrados na sua conta — o cadastro é feito
  pela AR Online no setup, e alterações são solicitadas pelo e-mail [suporte@ar-online.com.br](mailto:suporte@ar-online.com.br).
</Note>

Só e-mail e SMS:

```csv remessa-email-sms.csv theme={null}
ID;ASSUNTO;NOME_DESTINATARIO;EMAIL_DESTINATARIO;TELEFONE_DESTINATARIO;TIPO_ENVIO_SMS;MODELO
1;Comunicado de teste;Fulano de Tal;fulano@exemplo.test;11999990001;1;modelo_padrao.html
2;Comunicado de teste;Beltrano Silva;beltrano@exemplo.test;11999990002;2;modelo_padrao.html
```

Com todos os canais. Cada linha usa os canais que estiverem preenchidos nela — a linha 2
sai só por e-mail e carta, a linha 3 só por WhatsApp e voz:

```csv remessa-multicanal.csv theme={null}
ID;ASSUNTO;NOME_DESTINATARIO;EMAIL_DESTINATARIO;TELEFONE_DESTINATARIO;TIPO_ENVIO_SMS;TELEFONE_DESTINATARIO_WHATSAPP;TEMPLATE_WHATSAPP;NOME_WPP;TELEFONE_DESTINATARIO_VOZ;TEMPLATE_VOZ;ENVIA_CARTAS;TEMPLATE_CARTAS;TIPO_ENVIO_CARTAS;MODELO
1;Comunicado de teste;Fulano de Tal;fulano@exemplo.test;11999990001;1;11999990001;aviso_cobranca;Fulano;11999990001;aviso_voz;SIM;carta_padrao;1;modelo_padrao.html
2;Comunicado de teste;Beltrano Silva;beltrano@exemplo.test;;1;;aviso_cobranca;Beltrano;;;SIM;carta_padrao;1;modelo_padrao.html
3;Comunicado de teste;Sicrano Souza;;;1;11999990003;aviso_cobranca;Sicrano;11999990003;aviso_voz;;;;modelo_padrao.html
```

<Warning>
  No segundo exemplo, `TEMPLATE_WHATSAPP` e `NOME_WPP` estão preenchidos em **todas** as
  linhas, mesmo nas que não usam WhatsApp. Isso é obrigatório: se a coluna
  `TEMPLATE_WHATSAPP` existe no arquivo, ela não pode ficar vazia em nenhuma linha.
  O mesmo vale para `TEMPLATE_CARTAS` nas linhas com `ENVIA_CARTAS` igual a `SIM`.
  Veja [Regras do processamento](/remessas/regras).
</Warning>

Com anexos:

```csv remessa-com-anexos.csv theme={null}
ID;ASSUNTO;NOME_DESTINATARIO;EMAIL_DESTINATARIO;MODELO;ANEXO_1;ANEXO_2
1;Fatura;Fulano de Tal;fulano@exemplo.test;modelo_padrao.html;fatura_exemplo.pdf;
2;Fatura;Beltrano Silva;beltrano@exemplo.test;modelo_padrao.html;fatura_exemplo.pdf;extrato_exemplo.pdf
```

## Nome do arquivo

O nome precisa ser **único na sua Entidade**. Um nome já utilizado é recusado no momento
do envio, para evitar que a mesma remessa seja processada duas vezes e os destinatários
recebam a notificação em duplicidade.

Sugestão de convenção:

```
NOME_REMESSA_DDMMAAAA_N
```

Onde `DDMMAAAA` é a data e `N` o número sequencial, para quando houver mais de uma remessa
no mesmo dia:

```
COBRANCA_REMESSA_22102026_1
COBRANCA_REMESSA_22102026_2
```

<Accordion title="Por que o nome não pode repetir">
  A checagem de nome é o que impede o reenvio acidental do mesmo arquivo. Se você precisa
  reenviar de propósito — por exemplo, depois de corrigir linhas —, renomeie o arquivo
  antes de subir: acrescente a data, uma versão ou um sufixo como `_reenvio`.
</Accordion>

## Codificação

O arquivo precisa estar em UTF-8, senão acentos e cedilhas chegam corrompidos ao
destinatário. Se você vir caracteres estranhos no lugar de acentos na prévia, salve o
arquivo novamente escolhendo UTF-8.

<Accordion title="Como salvar em UTF-8">
  **Excel:** Arquivo → Salvar Como → tipo **CSV UTF-8**. Confira depois se o separador
  continuou ponto e vírgula.

  **Editores de texto** (VS Code, Notepad++): procure a opção de codificação e escolha
  converter para UTF-8, então salve.
</Accordion>