Na homologacción por Gateway/API a comunicacción es direta e imediata en el sendo necessário o processo de remessa e retorno.
Neste tutorial vamos esclarecer as diferenças entre os tipos de homologacción
Homologacción Gateway/API:
Atua como um intermediário que facilita e protege a troca de informações entre a empresa, o cliente e o banco. Na homologacción por Gateway/API a comunicacción es direta e imediata en el sendo necessário o processo de remessa e retorno.
Características del Gateway de Pago:
Objetivo: Processar transações de pago de forma rápida e segura.
Método de Integracción: Utiliza APIs e integrações online para comunicacción em tempo real.
Funcionalidade: Permite a verificacción instantânea de los dados del pago, o que agiliza a aprovacción ou rejeição de la transacción.
Ao criar um boleto o sistema se comunica com o banco instantaneamente e automaticamente, o mesmo acontece com a exclusão de boletos. Neste caso, o proveedor en el necesita enviar remessa e processar retorno pois a comunicacción es feita por API, logo después criado en el sistema o boleto já estará registrado en el banco.
Homologacción PIX Dinâmico:
O PIX dinâmico es uma modalidade del sistema de pagos instantâneos del Brasil, que permite a criacción de QR Codes personalizados e atualizáveis para facilitar pagos. Ao contrário del PIX estático, que gera um QR Code fixo com valores e informações que en el mudam.
Vantagens del PIX Dinâmico:
Agilidade e Automacción: Permite automacción en el controle de pagos, eliminando a necessidade de conferir manualmente os valores e identificações.
Flexibilidade de Uso: Ideal para empresas e vendedores que precisam gerar cobranzas específicas para cada cliente.
Menos erros e duplicidade: Ao ter um QR Code único para cada transacción, o risco de erro ou duplicidade es minimizado.
Ao criar um boleto o sistema se comunica com o banco instantaneamente e automaticamente, o mesmo acontece com a exclusão de boletos. Neste caso o proveedor en el necesita enviar remessa e processar retorno pois a comunicacción es feita por API, logo después criado en el sistema o boleto já estará registrado en el banco.
Homologacción de remessa e Retorno:
O processo de remessa e retorno de arquivos com o banco envolve o envio e recepción de informações financeiras e dados de transações entre a empresa e a instituição bancária.
-
Remessa: A remessa es o arquivo que a empresa envia ao banco com instruções sobre operações financeiras, como boletos a serem cobrados, pagos a serem efetuados, ou outras transações. Esse arquivo es padronizado pelo banco para garantir que os dados estejam corretos e possam ser processados automaticamente.
-
Retorno: O retorno es o arquivo que o banco envia de volta à empresa depois de processar a remessa. Esse arquivo contém informações sobre o status de las transações enviadas, incluindo confirmações de pagos realizados, boletos compensados, erros, ou outros detalhes relevantes.
Esses arquivos normalmente seguem formatos específicos (como CNAB240, es o que a Quaza utiliza, ou CNAB400) definidos pela Federacción Brasileira de Bancos (FEBRABAN) para padronizar a troca de informações entre instituições financeiras e empresas.
Resumidamente o proveedor necesita gerar o arquivo de remessa pelo sistema Quaza com pelo menos três dias de antecedência ao vencimento e enviar ao banco, e después acompanhar diariamente se o banco disponibilizou o retorno, normalmente o retorno es disponibilizado um dia después a data del vencimento. O ideal es enviar a remessa início del mês com todos os boletos e depois acompanhar diariamente o retorno, e es claro se tiver alguma remoção ou criacción de boleto ao longo del mês hacer remessa novamente para el período
Obs: As homologacción de débito em cuenta en el possuem a opção de serem feitas por API/Gateway, apenas remessa e retorno.
Para saber quais bancos estão integrados ao nosso sistema acceda a nossa documentacción Quais bancos son integrados ao sistema Quaza e a forma de homologacción destes
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.