> ## 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 Integrar a Groner com o Base de Clientes para Gerar Cobrança? # Cobrança automática com a Base de Clientes Com essa integração, o Groner gera o boleto, o PIX ou o link de cartão direto da parcela do pagamento e **dá baixa sozinho** quando o cliente paga. Você não precisa emitir cobrança em outro sistema nem conferir extrato para marcar quem pagou. A configuração leva alguns minutos e é feita uma vez só. --- ## Antes de começar Você vai precisar de: * **Perfil de Administrador** no Groner. * **A chave de API da Base de Clientes**, gerada no painel deles, na área de integrações. * **Uma conta bancária cadastrada** no Groner, em **Financeiro → Cadastros → Contas Bancárias**. É nela que a baixa automática credita o dinheiro, e sem ela não dá para ativar a cobrança. * **Seus contatos com CPF ou CNPJ preenchido.** A Base de Clientes exige o documento de quem vai pagar; contato sem documento não gera fatura. > ⚠️ **A Base de Clientes não tem ambiente de testes.** Toda cobrança gerada é real e vai para o seu cliente. --- ## Passo 1 — Conectar o provedor Vá em **Configurações → Pagamentos → Cobrança**. No topo da tela está o quadro **Conexão com o provedor**. Preencha: | Campo | O que colocar | | ---- | | **Provedor** | Base de Clientes | | **Ambiente** | Fica fixo em Produção (a Base de Clientes não tem ambiente de testes) | | **Chave de API** | A chave gerada no painel da Base de Clientes | | **Token do webhook** | Uma senha que **você inventa agora**. Ela valida os avisos de pagamento que chegam da Base | | **Conta de liquidação** | A conta onde entra o dinheiro que o cliente pagar | | **Gateway ativo** | Ligue | Clique em **Salvar**. > 💡 Essa configuração é **uma só para a empresa** e vale também para o Contas a Receber. Se você usa os dois, não precisa configurar duas vezes. --- ## Passo 2 — Cadastrar o aviso de pagamento O aviso de pagamento (webhook) é o que faz a Base de Clientes avisar o Groner na hora em que alguém paga. Sem ele, a baixa não acontece sozinha. Logo abaixo da conexão você vê o campo **Aviso de pagamento (webhook)** com um endereço e o botão **Cadastrar no provedor**. **Clique em Cadastrar no provedor.** O Groner cria o aviso direto na sua conta da Base de Clientes. Se aparecer uma mensagem dizendo que não foi possível, não tem problema: significa que a sua conta na Base de Clientes não permite esse cadastro automático. Nesse caso, faça manualmente: 1. Copie o endereço que aparece no campo (use o ícone de copiar). 2. Envie para suporte@clientbase.com.br pedindo a configuração do webhook com: * esse endereço, * verbo **POST**, * os eventos **billing.paid** e **billing.cancelled**, * e o mesmo **token do webhook** que você definiu no passo 1. --- ## Passo 3 — Dizer como cada forma de pagamento cobra Ainda em **Configurações → Pagamentos → Cobrança**, abaixo da conexão está a lista das suas formas de pagamento. **Forma de pagamento que você não configurar aqui não gera fatura.** É assim que você escolhe quais cobranças passam pela Base de Clientes. Clique na engrenagem da forma que deseja e defina: | O que definir | Para que serve | | ---- | | **Gerar cobrança automaticamente** | Liga a emissão nessa forma de pagamento | | **Como o cliente pode pagar** | Boleto, PIX, cartão à vista e cartão parcelado. No parcelado, de 1 a 12 vezes | | **Atraso** | Sem juros, padrão de mercado (2% de multa e 1% ao mês) ou personalizado | | **Aceitar pagamento maior que a parcela** | **Ligue se você cobra juros** — veja o aviso abaixo | | **Desconto por antecipação** | Descontos por quantos dias antes o cliente pagar | | **Negativar o cliente se não pagar** | Quantos dias após o vencimento registrar a inadimplência | | **Bonificação e NFS-e** | Opcionais | | **Textos da fatura** | O que o cliente lê na fatura. Os marcadores como `{cliente}` e `{negocio}` são preenchidos sozinhos | > ⚠️ **Se você cobra juros ou multa, ligue "Aceitar pagamento maior que a parcela".** Quem paga atrasado paga a parcela mais os acréscimos, ou seja, um valor maior do que o previsto. Com essa opção desligada, o Groner recusa essa baixa e o pagamento não aparece no sistema. --- ## Passo 4 — Gerar a cobrança Abra o negócio, vá na aba **Pagamentos** e localize a parcela. No botão **Gerar cobrança**, o Groner cria a fatura na Base de Clientes. Não há pergunta de boleto ou PIX: quem responde isso é a configuração que você fez no passo 3. Depois de gerada, a parcela mostra: * **Ver fatura** — abre a página onde o cliente escolhe entre boleto, PIX ou cartão. É esse link que você envia para ele. * **Cancelar cobrança** — cancela a fatura na Base de Clientes e libera a parcela para gerar outra. Se você também usa o **Contas a Receber**, a mesma cobrança vale para os dois: a fatura é uma só, e quando o cliente pagar a baixa acontece nos dois lugares. --- ## Passo 5 — Acompanhar Em **Configurações → Pagamentos → Avisos do gateway** você vê tudo que a Base de Clientes comunicou ao Groner e tudo que o Groner pediu a ela. Cada linha mostra o que aconteceu, e as que falharam mostram o motivo. Quando a falha é passageira, o Groner tenta de novo sozinho e a linha avisa quando será a próxima tentativa. Quando precisa de você, existe o botão **Tentar de novo**. **Tentar de novo é seguro.** Antes de dar baixa o Groner confere o pagamento direto na Base de Clientes, então nada é lançado duas vezes. --- ## Problemas comuns **O cliente pagou e a parcela não baixou.** Abra **Avisos do gateway** e procure a fatura. Se o aviso chegou e falhou, o motivo está ali e o botão **Tentar de novo** resolve. Se nenhum aviso chegou, o webhook provavelmente não está cadastrado — volte ao passo 2. **O cliente pagou atrasado, com juros, e não baixou.** Ligue **Aceitar pagamento maior que a parcela** na configuração daquela forma de pagamento (passo 3) e use **Tentar de novo** no aviso correspondente. **O botão "Gerar cobrança" não aparece na parcela.** Ou a forma de pagamento daquela parcela não está configurada (passo 3), ou o seu perfil não tem permissão para cobrar. Fale com o administrador da sua empresa. **Erro dizendo que o cliente está sem CPF/CNPJ.** A Base de Clientes exige o documento de quem paga. Complete o cadastro do contato e gere a cobrança de novo. **Não consigo ativar o gateway.** Só é possível ativar com a **conta de liquidação** preenchida. Cadastre a conta em Financeiro → Cadastros → Contas Bancárias e volte à tela de Cobrança. **Preciso mudar os juros de uma cobrança que já emiti.** Não é possível alterar juros, multa ou negativação de uma fatura já criada. Cancele a cobrança e gere outra com a configuração nova. --- ## Precisa de ajuda? Fale com o nosso suporte pelo chat. Se o problema for na conta da Base de Clientes — a chave de API, o cadastro do webhook ou o pagamento em si — o contato é suporte@clientbase.com.br.