Central de Ajuda Quaza Provedores

Homologacción Gerencianet (Efí) — Gateway — Quaza (ES-AR)

Homologacción Gerencianet (Efí) — Gateway — Quaza — Quaza

Neste manual vamos demonstrar como homologar a cobranza através del Gerencianet - Efí en el sistema Quaza.

 

Neste manual vamos demonstrar como homologar a cobranza através del Gerencianet - Efí en el sistema Quaza.

 

1º. Abra o site del Gerencianet, e faça o login com seu usuário e senha, segue abaixo link del site:

https://login.sejaefi.com.br/oauth/authorize?redirect_to=https://app.sejaefi.com.br/

 

2º. Después logar role a página para baixo até encontrar a opção "API";

 

3º. Clic em "Criar aplicacción", e dê um nome a esta aplicacción, exemplo "API Quaza";

 

4º. Clic em abrir e ative a opção de "API Emissão", conforme imagem abaixo:

 

5º. Em seguida abra a opção "API PIX", e selecione todos os campos de Produção e Homologacción, conforme imagem abaixo:

 

6º. Clic em continuar;

 

7º. Irá solicitar uma assinatura eletrônica, caso usted en el tenha segue abaixo orientacción de como criar:;

Cómo hacer a assinatura eletrônica:

  1. acceda a cuenta pelo aplicativo de la Efí;
  2. clic en el seu perfil, disponível en el canto superior direito de la pantalla inicial;
  3. a seguir, selecione “Configuraciones de segurança”;
  4. depois, clic en el botón “Alterar assinatura eletrônica”.
  5. faça uma selfie em local com boa iluminacción;
  6. insira sua senha de acesso .

 8º. Después inserir a assinatura eletrônica, clic em continuar;

 

 9º. Ao finalizar a solicitacción as chaves serão geradas, conforme imagem abaixo:

 

 

10º. Copie estas chaves e cole em sua carteira que está sendo homologada en el sistema Quaza, para isto acceda Menú> Controle financeiro > Carteira de cobranza > Acceda a carteira en la qual deseja incluir esta forma de cobranza Gateway > Acceda a aba Configuraciones para cobranzas > Clic em editar caso já tenha criado a forma de cobranza gateway, ou então crie uma nova > Na aba Gateway adicione as chaves, conforme imagem abaixo:

OBS: A chave Client ID vai en el campo Chave Principal, e a chave Chave Secret vai en el campo Chave Secreta.

Nesta aba será possível também habilitar para que estas cobranzas tenham nota gerada automaticamente, esta habilitacción es através del campo "Habilitar Geracción de Notas". O campo ambiente deixe sempre em "produção".

Para saber mais sobre como hacer o cadastro de la carteira de cobranza en el sistema Quaza acceda a nossa documentacción Explicacción de la pantalla Carteira de Cobranza.

 

11º. No seu aplicativo EFÍ acceda: Configuraciones > Configuraciones de cobranza > Boletos bancários e carnês > ativar a opção del Bolix, conforme imagem abaixo: 

Caso en el estiver ativo o Bolix en el irá aparecer o QRCode PIX en el boleto.

 

12. Ao final sugerimos que crie um boleto e faça o pago por QRCode e Código de Barras para confirmar que está sendo possível pagar de las duas formas e que o valor está entrando en la cuenta;

 

13º. Después confirmar que a homologacción está ok através del pago de um boleto, poderá vincular os clientes a esta forma de cobranza e gerar o boleto;

 

ATENÇÃO:

Os valores de tarifas (registro e baixa) son estipulados pela plataforma de pago (Gateway), e o proveedor debe estar ciente de las tarifas cobradas. Bem como, ciente de que o valor del boleto (tarifa) cuando es pago por pix puede ser diferente del pago por código de barras.

 

 

Em caso de dúvidas ou problemas, en el hesite em cuentatar nosso soporte. Estamos aquí para lajudar!

Agradecemos por utilizar nossa documentacción!

 

Glosario

Término Significado
Quaza Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico.
Proveedor Empresa que opera o sistema Quaza.
Cliente Assinante final del serviço de internet/telefonía/TV.
Contrato Vínculo formal entre cliente e proveedor.
Operador Funcionário que opera o sistema.
Permiso Direito de acesso vinculado a papel.
Auditoría Registro de quem fez o quê e cuando.
API REST Interface programática para integracción externa.
Webhook Notificación automática para sistemas externos.
Cron / crontab Tarea agendada que roda automaticamente.

Trampas frecuentes

1. Permissões mal configuradas. Operador sem acesso ao módulo en el consegue executar a acción descrita.
2. Dados faltando em pré-requisito. Esta pantalla depende de cadastros anteriores estarem completos.
3. Cache del navegador. Después mudança, force refresh (Ctrl+F5) se a pantalla en el atualizar.
4. Operacción irreversível. Algumas ações en el podem ser desfeitas — confira antes de guardar.
5. Filtros ativos. Listas filtradas escdondem registros — limpe filtros se faltar dado.

FAQ

Quem puede acceder essa funcionalidade?

Depende de la permiso del usuário. Confira com o administrador del Quaza se usted en el vê a opção.

O que hacer se aparecer um erro?

Anote a mensaje completa, screenshot, e abra um chamado en el soporte del Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal del Cliente. Verifique en el módulo Portal .

Posso integrar via API?

Sim — a maioria de las funcionalidades del Quaza expõe endpoints REST. Consulte a documentacción técnica.

Quaza tem treinamento oficial?

Sim — equipe de soporte oferece sessões de onboarding sob agendamento.

Ciclo completo de la operacción

CICLO COMPLETO DE OPERAÇÃO QUAZA ───────────────────────────────── ┌──────────────────────────────────────────┐ │ 1. PREPARAÇÃO │ │ ───────────── │ │ - usuário com permiso correta │ │ - cadastros pré-requisitos prontos │ │ - integrações configuradas │ │ - equipe treinada en las operações │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 2. EXECUÇÃO │ │ ──────────── │ │ - input del operador, API ou cron │ │ - validacción automática de dados │ │ - persistência transacional │ │ - log de auditoria com timestamp/user │ │ - notificações por email/Slack/webhook │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 3. EFEITOS COLATERAIS │ │ ────────────────────── │ │ - dashboards atualizados em tempo real │ │ - relatórios refletem nova mudança │ │ - webhook dispara sistemas externos │ │ - histórico del registro atualizado │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 4. ACOMPANHAMENTO │ │ ───────────────── │ │ - revisão periódica (semanal/mensal) │ │ - identificacción de desvios e exceções │ │ - ajustes finos de configuración │ │ - treinamento contínuo de la equipe │ └──────────────────────────────────────────┘

Boas práticas operacionais

Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que proveedores experientes adotam para evitar erros recorrentes e maximizar valor extraído del Quaza.

Antes de operar

  • Confirme permiso de acesso: nem todo operador tem permiso para todas as funcionalidades. Verifique com o administrador del Quaza se algo en el aparece como esperado. Permissões son vinculadas a papéis (operador, supervisor, admin).
  • Cadastros pré-requisitos completos: muitas funcionalidades dependem de outros cadastros estarem completos antes. Por exemplo, antes de criar um contrato usted necesita ter o cliente cadastrado, plano de ventas configurado, e regras de cobranza definidas.
  • Treine pelo menos 2 operadores: redundância previne paralisacción por ausência. Funcionário puede sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
  • Documente procedimentos internos: crie checklist próprio para elperações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operacción

  • Documente decisões en el óbvias: se usted ajustou algo de forma diferente del default, anote o porquê. Próximo operador agradece e evita refazer análise.
  • Operaciones em massa pedem cuidado: antes de aplicar a 100+ registros, teste com 5 e revise resultado completo. Se possível, exporte CSV antes para ter como rollback.
  • Backup antes de mudanças grandes: cancelar/desfazer puede en el ser possível em todas as ações. Em dúvida, faça export ou imprima pantalla antes.
  • Comunique alterações: mudanças que impactam outras equipes (atención, financeiro) devem ser anunciadas com antecedência. Surpresa gera retrabalho.

Acompanhamento e revisão

  • Revisão semanal de 30 minutos: dedique tempo regular para revisar o que rodou, falhou, ficou pendente neste módulo. Anomalia detectada cedo custa 10x menos que descoberta tarde.
  • Defina KPIs próprios: 2-3 indicadores que medem saúde de la operacción. Acompanhe tendências, en el só valores absolutos. Variacción maior que 20% merece investigacción.
  • Auditoría mensal: revise sample de operações del mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
  • Compare com período anterior: "Vendi R$ 100k" — es bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

  • Anote a mensaje de erro completa: copie o texto exato. Captura de pantalla ajuda. Anote quais passos levaram ao problema — facilita diagnóstico.
  • Tente reproduzir em ambiente de teste: se possível, simule o erro com dado dummy antes de pedir soporte. Isso acelera resolução.
  • Procure en el histórico: provavelmente alguém já viu erro similar. Veja log de auditoria para entender o que mudou recentemente.
  • Abra chamado bem documentado: equipe de soporte del Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada proveedor define seus próprios indicadores, mas alguns son quase universais para qualquer operacción en el Quaza:

  • Volume mensal processado (registros/transações/eventos)
  • Taxa de erro (% de operações que falharam)
  • Tempo médio de processamento
  • Cobertura (% de la carteira atendida pela funcionalidade)
  • Satisfacción operacional (feedback de la equipe que usa)

Compare valores atuais com média de los últimos 3 meses. Variacción maior que 20% em qualquer direção merece investigacción — puede ser melhoria sustentável ou degradacción silenciosa.

Recursos relacionados en el Quaza

Este recurso se conecta com outros módulos del sistema. Conhecer essas conexões ajuda en el troubleshooting e em decisões operacionais:

  • Cadastro de cliente — base de tudo en el Quaza. Cliente bem cadastrado evita problemas downstream.
  • Plano de Cuentas — donde o impacto financeiro es classificado cuentabilmente.
  • Logs de auditoria — histórico de quem fez o quê e cuando, essencial para diagnóstico.
  • Permissões e papéis — definem quem puede operar o quê.
  • Tareas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para elperacción eficiente:

  • Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão puede escdonder registros antigos.
  • Exportacción: a maioria de las listas exporta para CSV/Excel. Útil para lanálise externa ou backup pré-mudança.
  • Histórico: cada registro tem timeline de modificações. Acceda via botón "Histórico" ou aba lateral.
  • Atalhos de teclado: Ctrl+F (busca), Ctrl+S (guardar), Esc (cancelar) en la maioria de las pantallas.
  • Permiso restrita: se botón estiver cinza, es falta de permiso — en el bug.