## 1. Acessar a funcionalidade cobranças

Na barra lateral clique em menu de cobranças

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa21oIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a57b70efe511f69051677781dd9499098425188f/Captura%20de%20tela%202026-08-22%20004907.png)

Depois clique na seta ao lado de Nova Cobrança;

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3FoIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--6bd1dae164a8ed176f3f5b670be24300c43a8919/Captura%20de%20tela%202026-08-22%20004931.png)

Logo após em Cobrança em lote;

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3VoIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5305b79011a7dd06597d1a124fd61a14ebb6ff7/Captura%20de%20tela%202026-08-22%20004944.png)

## 2. Upload do arquivo

Na própria tela de upload  "Arraste e solte ou escolha um arquivo para fazer upload de seus dados".

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3loIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d512a481c35c91877acc15d69b8d26b60198130a/Captura%20de%20tela%202026-08-22%20005005.png)

## 3. Verificar a planilha

Valide as informações da planilha;

O sistema valida o cabeçalho antes de aceitar, se alguma coluna foi removida ou renomeada, aparece erro e é preciso corrigir o arquivo e subir de novo.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazJoIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2a25a0cb7797c02dab9f9cafde9ad1b743cf61c8/Captura%20de%20tela%202026-08-22%20012529.png)


## 5. Processamento automático e Revisão

Ao avançar, a plataforma processa as linhas em lotes, validando cada campo (CPF/CNPJ, telefone, data, valor, additional info) e tentando casar clientes já existentes na base pelo CPF/CNPJ ou email.

Uma barra mostra o progresso (X / total processado); ao terminar, avança automaticamente para a revisão.

### Revisão

Duas abas: todas as cobranças e cobranças com erro. Linhas com erro (ex.: valor inválido, data no passado, telefone mal formatado) ficam destacadas e não podem ser selecionadas para geração.

 Você escolhe quais linhas seguem adiante (checkbox por linha). Se deixar linhas erradas ou desmarcadas de fora, o sistema pede confirmação antes de continuar.

O botão de avançar mostra a contagem real: "Gerar N cobranças".

## 7. Geração das cobranças

As linhas selecionadas são enviadas uma a uma para criação real da cobrança.

Linhas que falharem no servidor voltam para a lista com erro e podem ser reprocessadas sem refazer o upload inteiro (botão "Reprocessar linhas").

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaytoIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b9a621878d17ed6d91148b683943b7cd6cdf027e/Captura%20de%20tela%202026-08-22%20014056.png)

 Ao final, é possível ir direto para "Ver Cobranças" na listagem geral.

## Observações importantes

Não fechar a janela durante o processamento nem durante a geração, ambos são acompanhados em tempo real e interromper perde o progresso da leva atual.