## Visão geral

A área de **Cobranças** é onde você acompanha e administra tudo o que foi cobrado. Ela tem uma
**lista pesquisável e paginada** (busca, período de criação, **status**, **gateway/conexão**, ordenação
e uma alternância para mostrar as **arquivadas**), **ações por linha** em cada cobrança (ver, editar, corrigir cliente e vínculos, enviar na conversa, reembolsar,
marcar como pago, cancelar, arquivar, restaurar, excluir) e uma **barra flutuante de ações em lote**
que aparece quando você seleciona várias cobranças de uma vez.

O objetivo é a **conciliação**: deixar o status de cada cobrança coerente com a realidade — refletindo
o que o gateway confirmou e também os pagamentos recebidos por fora da plataforma.

## Pré-requisitos

- Módulo **Pagamentos** habilitado e ao menos um **gateway conectado** (veja *Conectar gateway*).
- Cobranças já criadas (veja *Criar cobrança e enviar na conversa*).
- Para **excluir definitivamente** e para as **ações em lote** financeiras, é necessária permissão de
  **administrador**.

## Passo a passo

**1. Filtrar e abrir uma cobrança**

1. Abra a área de **Pagamentos → Cobranças**.
2. Pesquise por descrição, identificador do gateway/referência externa, nome/e-mail do cliente ou
   nome da conexão. Combine com **status**, **conexão** e o período de criação no fuso da conta.
3. Ordene por criação, vencimento, valor, status ou descrição; ative **arquivadas** para ver a
   lixeira. Cada controle ativo aparece como um marcador removível, e a URL preserva página,
   filtros e ordenação para voltar ou compartilhar a mesma visão.
4. Clique na cobrança para abrir os detalhes. A ação principal respeita o artefato disponível:
   página hospedada, boleto ou PIX copia e cola — uma cobrança manual continua auditável mesmo sem link.
5. Use **Exportar CSV** para baixar todo o recorte filtrado, sem limitar à página visível. Se houver
   cobranças selecionadas, o arquivo contém somente essa seleção. Em telas pequenas, os filtros ficam
   no painel **Filtros** e cada cobrança vira um cartão legível, sem tabela horizontal.

**2. Ver a linha do tempo de status (auditoria)**

1. Nos detalhes da cobrança, abra a aba de **linha do tempo**.
2. Cada evento (criada, paga, reembolsada, cancelada, atualizada) é registrado de forma **imutável**,
   com o agente responsável, o horário e a justificativa informada — é o histórico financeiro
   auditável da cobrança.

**3. Corrigir cliente e vínculos sem editar os fatos financeiros**

1. Na linha ou nos detalhes, use **Corrigir cliente e vínculos da venda** quando o contato estiver ausente
   ou errado, inclusive em uma cobrança paga que não pode mais ser editada.
2. Escolha um contato existente ou proponha um novo com nome e pelo menos e-mail, telefone ou documento.
   Revise também pedido, recuperação, organização, negócio e conversa alcançados pela mesma venda.
3. Gere a prévia e confira conflitos, histórico e eventual impacto em vendedor/afiliado. Alterações de
   crédito ou comissão exigem confirmação explícita. A aplicação é transacional e auditada.
4. Essa ação nunca muda valor, status, liquidação, vencimento nem identificador do gateway. Para esses fatos,
   use a operação financeira correspondente ou corrija a origem.

**4. Marcar como pago manualmente (e desfazer)**

1. Para um pagamento recebido **por fora** (dinheiro, PIX direto na conta), use **Marcar como pago**.
2. Informe a **justificativa** (obrigatória) — ela fica gravada no evento de auditoria.
3. A cobrança passa a **paga**. Disponível apenas para cobranças ainda **em aberto** (pendente,
   aguardando pagamento ou vencida) e em gateways que suportam baixa manual.
4. Para reverter, use **Desfazer baixa manual** — só funciona em uma cobrança que **você mesmo**
   liquidou manualmente; ela volta para pendente/vencida.

**5. Cancelar (em aberto) × reembolsar (paga)**

1. Use **Cancelar cobrança** quando a cobrança ainda estiver **em aberto** (não paga): o cliente não
   conseguirá mais pagá-la.
2. Use **Reembolsar** quando a cobrança já estiver **paga**: escolha **total** (devolve tudo) ou
   **parcial** (informe o valor). Você pode reembolsar parcialmente mais de uma vez, até o total.
3. Em ambos é possível registrar um **motivo**, que fica na auditoria.

**6. Reenviar na conversa**

1. Use **Enviar para a conversa** e informe a conversa de destino.
2. O cartão de pagamento volta a aparecer para o cliente na própria janela do atendimento.

**7. Arquivar → restaurar → excluir definitivamente**

1. **Arquivar** tira a cobrança da lista padrão sem apagá-la (vai para a lixeira de arquivadas).
2. **Restaurar** traz a cobrança arquivada de volta para a lista ativa.
3. **Excluir definitivamente** apaga de vez — só é permitido em cobranças **arquivadas** e **não
   liquidadas**; cobranças pagas/reembolsadas são mantidas para auditoria e nunca podem ser apagadas.

**8. Ações em lote**

1. Selecione várias cobranças; a **barra flutuante** aparece com a contagem.
2. Na lista ativa (admin): **marcar como pago**, **cancelar** e **reembolsar** (apenas total), além de
   **arquivar**.
3. Na lista de arquivadas: **restaurar** e **excluir definitivamente** (admin).
4. Todas as ações em lote são **best-effort**: o resultado informa quantas foram processadas e lista
   os IDs que falharam. Somente as falhas continuam selecionadas para revisão ou nova tentativa;
   nenhum item pedido desaparece silenciosamente do resultado.

## Configurações & opções

- **Ação por linha × em lote**: a mesma operação existe individualmente em cada cobrança e em lote
  sobre a seleção.
- **Permissões**: **excluir definitivamente** e as **ações financeiras em lote** (marcar como pago,
  reembolsar, cancelar) e a **exclusão em lote** são restritas a **administradores**.
- **Reembolso em lote = só total**: o reembolso **parcial** existe apenas como ação por linha.
- **Excluir exige arquivar antes**: a exclusão permanente é sempre uma ação deliberada em duas etapas
  (arquivar e só então excluir).
- **Exportação**: respeita busca, período, filtros e a seleção corrente; dados textuais são
  protegidos para não serem interpretados como fórmulas pela planilha.
- **Editar × corrigir vínculos**: editar continua sujeito ao status e às regras do gateway. Corrigir
  vínculos é uma operação separada, inclusive para liquidadas, e atua somente nas associações da venda.

## Casos de uso

- **Conciliar um PIX pago por fora**: marque a cobrança como paga com a justificativa, mantendo o
  histórico coerente.
- **Limpar cobranças de teste**: arquive em lote e, em seguida, exclua definitivamente as arquivadas.
- **Estornar em massa**: selecione as cobranças pagas e reembolse em lote (total).

## Dicas, limites e boas práticas

- **Cancelar** só vale para cobranças em aberto; para uma cobrança paga, o caminho é o **reembolso**.
- O **reembolso depende do gateway** — o tipo (total/parcial) e o prazo de devolução seguem as regras
  do provedor e do meio de pagamento.
- O **webhook continua sendo a fonte da verdade**: a baixa manual serve para o que foi pago por fora;
  os pagamentos do próprio gateway chegam e atualizam o status sozinhos.
- **Desfazer baixa manual** só funciona no que **você** liquidou manualmente — não é o caminho para
  reverter um pagamento real do gateway (use o reembolso).
- Se o valor está correto, mas o cliente, pedido ou evento de recuperação está errado, use **Corrigir
  cliente e vínculos**; não cancele nem reembolse apenas para consertar uma associação.

## Solução de problemas

- **"Não consigo excluir"**: a cobrança precisa estar **arquivada** primeiro; e cobranças **pagas/
  reembolsadas** nunca são excluídas (ficam para auditoria). Arquive-a em vez de tentar apagar.
- **"Desfazer indisponível"**: a baixa manual só pode ser desfeita pela mesma origem — apenas uma
  cobrança que **você marcou como paga** manualmente (em gateway compatível) pode ser revertida.
- **"Marcar como pago indisponível"**: a cobrança não está em aberto ou o gateway não suporta baixa
  manual.
- **"Editar está indisponível em uma cobrança paga"**: os fatos liquidados são imutáveis. Para corrigir
  apenas cliente, organização, negócio ou conversa, use **Corrigir cliente e vínculos da venda**.
- **Ação em lote ignorou cobranças**: é o comportamento esperado — inelegíveis (status incompatível ou
  gateway sem o recurso), IDs ausentes e itens fora da visão permitida aparecem como não processados
  e permanecem selecionados para revisão.
- **A lista não carregou**: use **Tentar novamente**; se ainda falhar, revise a conexão com o servidor.

## Veja também

- [Visão geral de Pagamentos](/hc/ajuda/articles/payments-overview-pt-br)
- [Criar cobrança e enviar na conversa](/hc/ajuda/articles/payments-criar-cobranca-enviar-na-conversa-pt-br)
- [Reembolsos, webhooks e relatórios](/hc/ajuda/articles/payments-reembolsos-webhooks-relatorios-pt-br)
- [Conectar gateway: Asaas e Mercado Pago](/hc/ajuda/articles/payments-conectar-gateway-pt-br)