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

# Falhas no processamento

> O que cada tipo de falha significa e como corrigir.

Quando uma remessa é recusada, ela aparece na aba **Remessas com falha** do portal, com o
tipo e o motivo. Nenhuma notificação foi enviada.

<Note>
  Falha de processamento é diferente de falha de entrega. Aqui a remessa nem chegou a sair.
  Notificação que saiu e não chegou ao destinatário é outro assunto — veja
  [Depois do envio](/remessas/apos-envio).
</Note>

## Tipos de falha

<AccordionGroup>
  <Accordion title="Arquivo já processado">
    Já existe uma remessa com esse nome. O sistema recusa para não enviar as mesmas
    notificações duas vezes.

    **Correção:** renomeie o arquivo acrescentando data, versão ou sufixo, e envie de novo.
    Antes, confirme se os destinatários já não receberam.
  </Accordion>

  <Accordion title="Separador incorreto">
    O arquivo usa vírgula onde deveria usar ponto e vírgula.

    **Correção:** salve como **CSV separado por ponto e vírgula**. Cuidado para não trocar
    vírgulas que fazem parte de textos.
  </Accordion>

  <Accordion title="Codificação inválida">
    O arquivo não está em UTF-8. Acentos e cedilhas chegariam corrompidos.

    **Correção:** salve novamente escolhendo UTF-8.
  </Accordion>

  <Accordion title="Cabeçalho incorreto">
    Falta uma coluna obrigatória, ou existe coluna repetida no cabeçalho.

    **Correção:** garanta `ASSUNTO`, `NOME_DESTINATARIO` e `MODELO`, escritos exatamente
    assim, e que nenhum nome de coluna apareça duas vezes.
  </Accordion>

  <Accordion title="Campo obrigatório vazio">
    Alguma linha está com campo obrigatório em branco. O motivo indica a linha e o campo.

    **Correção:** preencha o campo, ou remova a linha.
  </Accordion>

  <Accordion title="Modelo não encontrado">
    O nome em `MODELO` não corresponde a nenhum modelo cadastrado na pasta de modelos da
    sua conta.

    **Correção:** confira o nome exato, incluindo maiúsculas, minúsculas e a extensão
    `.html`. O motivo da falha sugere modelos de nome parecido quando encontra algum.

    Se o modelo ainda não existe, solicite o cadastro pelo e-mail
    [suporte@ar-online.com.br](mailto:suporte@ar-online.com.br). O
    cadastro de modelos de remessa é feito pela AR Online, não pelo portal. Modelos criados
    em **Cadastros → Modelos** servem ao envio avulso e não valem para remessa.
  </Accordion>

  <Accordion title="Variáveis obrigatórias do modelo ausentes">
    O modelo usa variáveis marcadas como obrigatórias e o CSV não tem as colunas
    correspondentes.

    **Correção:** acrescente as colunas com esses nomes e preencha em todas as linhas.
  </Accordion>

  <Accordion title="Funcionalidade não habilitada">
    A remessa usa AR-Cartas ou AR-Voz e a conta não está liberada para esse canal.

    **Correção:** peça a liberação ao Comercial, ou remova o uso do canal nas linhas
    envolvidas.
  </Accordion>

  <Accordion title="Anexo não encontrado">
    Um arquivo citado em `ANEXO_1` a `ANEXO_5` não estava disponível no processamento.

    **Correção:** envie o anexo junto com a remessa. O nome precisa bater exatamente com
    o que está no CSV.
  </Accordion>

  <Accordion title="Anexo excede o limite de tamanho">
    Um dos anexos passa do tamanho permitido.

    **Correção:** comprima o arquivo ou reduza a resolução das imagens. Alternativa:
    disponibilize por link dentro do modelo.
  </Accordion>

  <Accordion title="Arquivo vazio ou apenas com cabeçalho">
    Não há linhas de dados para processar.

    **Correção:** inclua ao menos um destinatário.
  </Accordion>
</AccordionGroup>

## Depois de corrigir

Corrija o arquivo, **renomeie** e envie de novo. Reenviar com o mesmo nome e o mesmo
conteúdo é recusado — a checagem existe justamente para impedir duplicidade.

<Warning>
  Antes de reenviar, confirme que os destinatários não receberam a notificação. Se a falha
  foi de validação, nada saiu e pode reenviar com segurança.
</Warning>

## Precisa de ajuda?

Nossa equipe de suporte está à disposição. Em caso de dúvidas, entre em contato pelo e-mail [suporte@ar-online.com.br](mailto:suporte@ar-online.com.br).

Informe o **identificador da remessa** e o tipo de falha exibido no portal. Não é necessário
anexar a lista de destinatários nem o conteúdo das notificações.