Central de Ajuda Quaza Provedores

Neste manual vamos demonstrar como homologar a cobranza através del Sicoob en el sistema Quaza.

Neste manual vamos demonstrar como homologar a cobranza através del Sicoob en el sistema Quaza.

1º - O proveedor dever ter os seguintes dados bancários para pré-configurar a carteira:

Razão Social:

CNPJ:

Nº del contrato (código del cliente/cedente):

Carteira:

Nº de la cuenta e dígito:

Nº de la agência e dígito:

Nº del convênio e dígito:

Certificado A1 e senha:

Caso tenha dúvidas sobre como criar ou configurar a carteira, acceda a nossa documentacción  Explicacción de la pantalla Carteira de Cobranza.

2º - Colar en la área de trabalho o arquivo del certificado A1>abrir>usuário atual> avançar>senha>marcar a primeira opção "selecionar automaticamente o repositório de certificados conforme o tipo de certificado">avançar>concluir. Después o documento aparecer en la pasta, renomear o arquivo com o título "cert" >colocar dentro de la pasta certificado que se encontra en el disco local, caso esta pasta en el exista, debe ser criada;

3º - Converter o arquivo del certificado A1 para .pem e alterar o nome de la pasta privada para "certID.pem" donde ID es o número de la carteira modelo (Por exemplo, se a configuración de cobranza tiver o ID 6, vai ser  cert6.pem). Segue imagem indicando como conferir o id:

4º. Segue passo a passo de como coverter para .pem:

Fazer tudo pelo Prompt de Comando com os seguintes comando abaixo: 

Sicoob necesita o certificado sem a chave privada (arquivo público.pem):

openssl pkcs12 -in C:\Certificado\cert.pfx -nokeys -out C:\Certificado\CertificadoPublico.pem

Colocar en el sistema Quaza com a chave privada (arquivo certID.pem):

openssl pkcs12 -in C:\Certificado\cert.pfx -out C:\Certificado\certificado.pem -nodes

5º. Enviar o arquivo certID.pem para el soporte de la Quaza incluí-lo en el servidor.

O soporte irá hacer o seguinte: Acessar WinSCP > novo site > preencher com os dados del proveedor que podem ser acessados en el Backuper-cliente-ssh > protocolo de arquivo=scp > host=ip > porta > usuário > senha (inspecionar para visualizar)

Colocar o certificado certID.pem en la pasta var/www/html/quaza/media/certs ou então conferir o que consta lá en el Backuper SSH Projeto (a parta certs tem que ser criada. Ex: clicar com o botón direito del mouse > novo > diretório > nomear a pasta como "certs" > ok >  colar)

6º. Acceda o site https://developers.sicoob.com.br/portal/   > clic em cadastro > preencher (no campo conte-nos um pouco... colocar "somos um proveedor") em seguida terá que hacer o login com e-mail cadastrado anteriormente (a senha debe ser definida pelo e-mail que será recebido). 

7º. Después hacer login, abrirá a pantalla abaixo:

Acceda o menu Meus Aplicativos e preencha as informações:

Depois, clic em Prosseguir e abrirá a seguinte pantalla:

No parâmetro "A integracción será por uma empresa parceira?", marque como Sim.

Em "Empresa Parceira" selecione a opção Quaza Tecnologia.

Na próxima etapa, selecione a modalidade "Cobranza Bancária V3" e depois clic em Prosseguir:

6    Confirme se os seus dados estão corretos e clic em "Criar aplicativo":

7    Criada a aplicacción com sucesso, agora clic em "Ver aplicativos":

8    Em seguida, clic en la sua aplicacción para exibir os detalhes dela.

9    Copie o código Client ID que foi gerado:

8º. Ativacción de la aplicacción:

Después a conclusão del processo de criacción de la Credencial de API, o aplicativo estará disponível en el menu Meus Aplicativos com o status de Pendente.

Para ativar os aplicativos CNPJ, será necessário que os responsáveis pela cuenta autorizem en el Sicoobnet Empresarial.
Basta acceder o ícone de pesquisa, procure por Transações Pendentes / Detalhamento e, em seguida, por Autorizacción para Uso de APIs Insira sua senha e autorize.

O aplicativo será atualizado para el status Ativo, e as credenciais estarão prontas para uso.

9º. Na carteira pré-configurada colar a chave principal que foi obtida através del SICOOB, e añadir a chave secreta que es a senha del certificado A1:

10º. É necessário que o proveedor solicite ao seu gerente del SICOOB uma chave PIX aleatória e a autorize, ou o próprio proveedor puede hacer a geracción, e autorizar en el APP. Esta chave en el necesita ser adicionada ao sistema.

11º. Etapa final - Testes:

- Testar Gateway en la carteira, para confirmar que está comunicando (Retorno Conectado com Éxito);

- Testar criacción de boleto e baixa, criar boleto teste, o proveedor debe pagar e depois conferir se baixou o boleto en el sistema e se o valor consta en la cuenta.

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

Trampas frecuentes

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

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.