Como conectar o Quaza à API do Efí (Gerencianet) para cobrar por boleto e Pix e validar a integração — o que chamamos de homologar.
O que é o gateway Efí (Gerencianet)
O gateway Efí (Gerencianet) liga o Quaza diretamente à API do Efí (Gerencianet). Com ele, as cobranças são geradas pela internet e o pagamento volta confirmado automaticamente.
Homologar é validar suas credenciais com o Efí (Gerencianet): você as informa, clica em Testar gateway e o Quaza confirma a conexão.
Como funciona a homologação
Você configura as credenciais, o Quaza pede autorização ao Efí (Gerencianet) e, se estiverem corretas, a integração fica conectada:
Glossário
| Termo |
O que significa |
| Gateway |
Integração via API: a cobrança e a baixa do pagamento acontecem em tempo real, pela internet. |
| Homologar |
Validar suas credenciais com o Efí (Gerencianet). No Quaza, é o botão Testar gateway. |
| Ambiente |
Homologação = ambiente de testes; Produção = valendo de verdade. |
| Chave Principal |
o Client ID da sua conta no Efí |
| Chave Secreta |
o Client Secret da sua conta no Efí |
| Tarefa "Financeiro - Gateway" |
Rotina automática que sincroniza os pagamentos das cobranças do gateway. |
Antes de começar
Você vai precisar de:• Uma conta no Efí (Gerencianet) com a API de cobrança/integração habilitada.
• As credenciais de API: Chave Principal, Chave Secreta.
Passo a passo
Abra a configuração para cobrança e vá na aba Gateway:
Configuração para cobrança → aba Gateway
1 Em Integração gateway, selecione Gateway - Gerencianet.
2 Em Ambiente, escolha Homologação para testar ou Produção.
3 Em Chave Principal, cole o Client ID da sua conta no Efí.
4 Em Chave Secreta, cole o Client Secret da sua conta no Efí.
Grave e clique em Testar gateway.
Aba Gateway: (1) Integração gateway, (2) Ambiente, (3) Chave Principal, (4) Chave Secreta e o botão Testar gateway.
O botão "Testar gateway"
O botão Testar gateway pede uma autorização ao Efí (Gerencianet) usando as credenciais informadas. Se estiverem corretas, aparece Conectado com sucesso — a integração está homologada.
Deu erro ao testar? Confira as credenciais (sem espaços sobrando) e o Ambiente selecionado. Credenciais de Homologação não funcionam em Produção e vice-versa.
Tarefas automáticas
Depois de homologado, você não precisa baixar pagamento manualmente — o Quaza faz isso por tarefas que rodam sozinhas:
| Tarefa |
O que faz |
| Financeiro - Gateway |
Sincroniza o status de pagamento das cobranças do gateway, dentro da janela de dias configurada (campos "Verificação das cobranças"). É a tarefa principal da integração. |
| Financeiro - Gateway (aviso) |
Gera os avisos e notificações relacionados às cobranças do gateway. |
Manual ou automático. A baixa acontece sozinha pela tarefa; você também pode forçar a reconferência abrindo a cobrança na tela quando precisar de confirmação imediata.
Pegadinhas frequentes
1. Homologação não é Produção. Credenciais de teste só valem no ambiente de Homologação. Troque para as de Produção ao entrar no ar.
2. São 2 credenciais. O Efí (Gerencianet) exige todas preenchidas — faltando uma, o teste falha.
3. Credenciais exatas. Cole cada valor exatamente como o Efí (Gerencianet) forneceu, sem espaços no início ou no fim.
Perguntas frequentes
Quem pode configurar a homologação?O operador do financeiro com acesso à Configuração para cobrança. Como envolve credenciais, costuma ser feito por quem cuida da cobrança da empresa.
Onde consigo as credenciais?São fornecidas pelo Efí (Gerencianet) — você as obtém no painel/portal de integração do Efí (Gerencianet). O Quaza não gera essas credenciais.
O pagamento baixa sozinho?Sim. A tarefa Financeiro - Gateway sincroniza os pagamentos automaticamente, dentro da janela de dias configurada.
Posso testar antes de colocar para valer?Sim. Selecione o ambiente Homologação, valide a conexão e só depois troque para Produção.
"Testar gateway" deu erro. O que fazer?Confira as credenciais e o ambiente. Corrija, grave e teste de novo.
Preciso importar arquivo de retorno?Não. No gateway o pagamento volta confirmado automaticamente.
Troquei as credenciais. Preciso testar de novo?Sim. Sempre que alterar uma credencial ou o ambiente, grave e clique em Testar gateway.
Em quanto tempo o pagamento aparece como pago?Na próxima execução da tarefa de sincronização, desde que o vencimento esteja dentro da janela "Verificação das cobranças (Dias anterior/posterior)".
Para que servem os campos "Verificação das cobranças"?Definem a janela de dias (anterior e posterior ao vencimento) que a tarefa olha ao buscar pagamentos. O padrão costuma ser 60 e 60.
Gerencianet e Efí são o mesmo?Sim. A Gerencianet passou a se chamar Efí; as credenciais são as mesmas da sua aplicação no painel da Efí.
Documentos relacionados