> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como gerar boleto e PIX pelo Groner ERP

Com o **gateway de cobrança**, você gera o boleto ou o PIX direto da parcela no Contas a Receber. Quando o cliente paga, o ERP dá a baixa sozinho e lança o valor na conta bancária que você escolher. O Groner ERP trabalha com dois provedores: **Asaas** e **Base de Clientes**.

---

## Antes de começar

- Configurar o gateway, gerar, cancelar e sincronizar cobranças são ações do perfil **Administrador**.
- Tenha uma conta ativa no Asaas ou na Base de Clientes e a **API Key** em mãos. No Asaas, ela fica em **Integrações > Chave de API**; na Base de Clientes, na área de integrações.
- Tenha pelo menos uma conta em **Financeiro > Configurar > Contas Bancárias**. É nela que os pagamentos vão entrar.
- A conta a receber precisa ter um **cliente vinculado**, e o cadastro desse cliente no CRM precisa ter **CPF ou CNPJ**.

## Passo a passo: configurar o gateway

1. Abra **Financeiro > Configurar > Cobrança (gateway)**.
2. Escolha o **Provedor** e o **Ambiente**. No Asaas, use **Sandbox (testes)** para experimentar e **Produção** para valer. A Base de Clientes funciona sempre em Produção.
3. Deixe **Ativo** ligado.
4. Preencha a **API Key** e o **Token do webhook** (uma senha que valida os avisos de pagamento).
5. Em **Baixa automática**, escolha a **Conta bancária padrão**.
6. Clique em **Criar configuração** (ou **Salvar alterações**, se estiver editando).

> **Atenção:** em Produção, as cobranças geradas são reais e vão para o cliente.

## Passo a passo: ligar o aviso de pagamento (webhook)

O webhook é o canal pelo qual o provedor avisa o ERP que a cobrança foi paga. É ele que faz a baixa automática.

- **Asaas:** no card **Webhook de pagamento**, copie a **URL do webhook** e cole no painel do Asaas. Marque os eventos de pagamento recebido e confirmado e use o mesmo token do campo **Token do webhook**. Sem o token preenchido no ERP, os avisos do Asaas são recusados e a baixa não acontece sozinha.
- **Base de Clientes:** preencha e salve o **Token do webhook** e clique em **Cadastrar no provedor**. Se a sua conta não permitir o cadastro automático, a tela explica o motivo; nesse caso, copie a URL e peça a configuração ao suporte da Base de Clientes.

## Passo a passo: gerar a cobrança

1. Abra **Financeiro > Contas a Receber** e clique em **Detalhes** na conta desejada.
2. Na tabela de **Parcelas**, clique no ícone **Gerar cobrança (boleto/PIX)** da parcela em aberto.
3. Confira os meios de cobrança. Se a forma de pagamento da parcela já tem essa configuração no CRM, os meios vêm dela; se não tem, escolha **Boleto**, **PIX** ou **Boleto + PIX** (o cliente escolhe). Clique em **Gerar cobrança**.
4. Envie ao cliente o link **Abrir fatura**, a **linha digitável** do boleto ou o **PIX copia-e-cola**.

O valor cobrado é o saldo da parcela. Se a parcela já venceu, a cobrança sai com vencimento no dia de hoje, porque os provedores não aceitam vencimento no passado; no ERP, a parcela mantém o vencimento original.

Cada parcela aceita uma cobrança ativa por vez. Para corrigir o valor ou trocar a forma de pagamento, use **Cancelar cobrança no gateway** e gere outra.

## Quando o cliente paga

O recebimento entra na conta bancária padrão, com a data de pagamento informada pelo provedor. Se o cliente pagou a mais (multa ou juros de atraso cobrados pelo provedor), a parcela é quitada e a diferença fica registrada como juros.

O botão **Sincronizar cobranças**, no topo do Contas a Receber, consulta o provedor e dá baixa nas cobranças pagas. Use-o como reforço, principalmente com a Base de Clientes, ou quando achar que algum aviso de pagamento não chegou.

## Problemas comuns

- **O cliente pagou e a parcela não baixou:** confira se o **Token do webhook** no ERP é igual ao do provedor. Depois, clique em **Sincronizar cobranças**.
- **"Parcela já possui cobrança gerada":** cancele a cobrança atual na própria parcela e gere a nova.
- **"Título sem cliente vinculado":** vincule o cliente à conta e complete o CPF ou CNPJ dele no CRM.
- **"Configuração de cobrança inexistente ou inativa":** configure o gateway ou ligue a opção **Ativo**.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [Como Integrar a Groner com o Base de Clientes para Gerar Cobrança?](https://ajuda.groner.app/pt-br/article/como-integrar-a-groner-com-o-base-de-clientes-para-gerar-cobranca-1acd4zz/)
- [Como lançar e receber contas no Contas a Receber do Groner ERP](https://ajuda.groner.app/pt-br/article/como-lancar-e-receber-contas-no-contas-a-receber-do-groner-erp-8m4tu8/)
- [Como configurar a aba de financiamento e cadastrar formas de pagamento](https://ajuda.groner.app/pt-br/article/como-configurar-a-aba-de-financiamento-e-cadastrar-formas-de-pagamento-3z6pns/)
- [Como controlar os pagamentos e as parcelas das vendas no CRM](https://ajuda.groner.app/pt-br/article/como-controlar-os-pagamentos-e-as-parcelas-das-vendas-no-crm-8wg3go/)

<!-- groner-suporte:veja-tambem:fim -->