O arquivo CSV

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.

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.

Exemplos

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.

Só e-mail e SMS:

remessa-email-sms.csv

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:

remessa-multicanal.csv

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

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.

Com anexos:

remessa-com-anexos.csv

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

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.

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.

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.

Visão geral

O arquivo

Regras e falhas

Como entregar

Depois do envio

Formato

Exemplos

Nome do arquivo

Codificação

​Formato

​Exemplos

​Nome do arquivo

​Codificação

Formato

Exemplos

Nome do arquivo

Codificação