Central de Ajuda Quaza Provedores

Como habilitar a NFSE para o provedor (PT)

Como habilitar a NFSE para o provedor — Quaza

Neste manual vamos demonstrar como fazer a integração do sistema netControl com a TechnoSpeed 1º.

 

Neste manual vamos demonstrar como fazer a integração do sistema netControl com a TechnoSpeed

 

1º. Antes de iniciar o processo certifique-se de ter em mãos: uma nota fiscal NFSE gerada anteriormente pelo provedor, Certificado A1, seu CNPJ, Inscrição Estadual e Inscrição Municipal. Login e senha do site da prefeitura do cliente onde ele faz a emissão das notas.

 

2º. Verifique se há integração da Technospeed com a prefeitura da cidade do provedor, acesse o link https://tecnospeed.com.br/plugdfe/nfse/#homologacao e busque pela cidade, conforme exemplo abaixo: 

No exemplo acima, há integração pois a cidade foi encontrada.

 

3º. Acesse o site da TechnoSpeed, seguem dados de acesso:

Link: https://managersaas.tecnospeed.com.br/#/group

Login: wesselpedro@gmail.com

Senha: tfhs4398

 

4º. Na tela da TecnoSpeed, aparecerão os grupos já cadastrados, Teutonet, SulInternet e RK por exemplo. Acima, haverá um botão azul + Adicionar, clique nele e será levado a outra página. Preencha os dados informados abaixo, pode usar o cadastro da Pixel ou Teutonet como referência, lembre de anotar a senha usada, ela será muito importante depois.

 

5º. Após o cadastro, você verá a empresa cadastrada junto as outras, clique no botão azul "Empresas" e adicione uma empresa. Dentro, informe as informações padrão da empresa como Nome, CNPJ, Razão Social, entre outras.

Nesta configuração você deve selecionar NFSe e como Ativo, Bilhetagem

Faça a inserção do certificado A1 do cliente na área do Certificado e na parte dos Demais Campos tenha certeza de informar os valores corretos do cliente.

Obs.: O email pode ser usado o do Pedro em caso de dúvidas.

 

6º. Após salvar as configurações, você terá criado um novo grupo de empresa da TecnoSpeed e ele irá constar junto as outras empresas, como na imagem abaixo.

 

7º. Agora, voltaremos ao sistema da Quaza e habilitaremos as permissões de NFSE em Admin > Grupo, especialmente a aba Fiscal > NFSe e Fiscal > Produto NFSe

 

8º. Adicione um produto de teste, pode ser usado um que a contabilidade do cliente enviou ou crie um produto com os seguintes dados:

Código do serviço: 1.07 – Suporte técnico em informática, inclusive instalação, configuração e manutenção de programas de computação

Código serviço tributação: 6209100

Descrição: Manutenção de equipamentos

Tipo de tecnologia: Internet

 

9º. Confirme as configurações da Empresa de Nota de Serviço estão corretas em Fiscal > Empresa NFe. 

Dentro de Empresa NFE, existe a aba Configuração (NFSE), ali terão informações como RPS, Ambiente, Cidade, Grupo e Token Basic Auth.

- Cidade deve ser preenchida com os valores todos em maiúsculo, sem espaços e sem acentos, a UF do estado da Cidade deve também ser informada, conforme exemplo abaixo:

- Token Basic Auth é o valor (admin:+Senha) que você anotou antes, encriptado. Você irá encriptar esta informação no site http://www.base64encode.org/  colar neste campo, segue imagem demonstrando como encriptar usando o site citado:

- Grupo deve ter o mesmo nome do grupo informado no Manager SaaS ao criar a empresa, segue imagem demonstrando onde verificar o nome do grupo.

- Demais campos devem ser preenchidos com 1 e o Ambiente pode ser informado como homologação durante o processo, conforme imagem abaixo:

 

10º. Agora, iremos acessar a empresa do cliente no Manager SaaS, você pode acessar usando o botão amarelo "Ir para", conforme imagem abaixo:

 

11º. Ao entrar, você irá fazer o login com usuário admin e a senha que anotamos previamente, e verá a tela abaixo. Se tiver alguma dúvida na forma como o nome de uma cidade é escrita no sistema, pode verificar abaixo, também pode verificar o CNPJ do cliente e o nome da empresa

Agora acessaremos Configurações como demarcado na imagem, passaremos por algumas telas que serão descritas abaixo:

Geral: Você não fará nenhuma alteração nesta tela

Autenticação da Prefeitura: Nesta tela serão informados os dados de login no site da prefeitura do provedor, o mesmo site utilizado para fazer emissão de notas de serviço

Numeração Automática: Esta tela é utilizada para definir o número da nota que será gerada, caso a empresa já tenha emitido alguma nota de Serviço anteriormente precisamos informar a Série, Número da última nota de serviço +1 (Número Inicial) e Tipo da nota ao Adicionar Numerações Configuradas.

E-Mail: Nesta tela serão configuradas as emissões de e-mail do sistema do Manager SaaS, eles não fazem o envio próprio então é correto configurar um do nosso sistema, por exemplo pode ser usado o do Pedro

Em Autorização e Cancelamento você irá poder configurar a mensagem padrão que será enviada no e-mail, o recomendado é pegar o exemplo de outro cliente para isso. Em Email destinatário é sempre bom informar o email do Pedro para que ele receba caso esteja ocorrendo algum erro nas notas do cliente.

Impressão: Colocar a Logo do cliente, porém o sistema só aceita o formato Jpg ou Jpeg.

 

11º. Assim que finalizar a configuração e Salvar, certifique-se de que a opção "NFSe gerar" está ativa em Admin > Configurações > Fiscal está como Sim.

 

12º. Agora, pode alterar a informação Ambiente Homologação para Produção, para isso acesse Menu > Fiscal > Empresa NFE > Configuração NFSE. Tente fazer um teste de emissão de Nota de Serviço pelo sistema da Quaza, geralmente as prefeituras não aceitam notas de serviço criadas no modo de homologação, altere também no Manager SaaS, conforme imagem abaixo:

 

13º. Caso tenha dúvidas de como conferir as rejeições das notas, você pode consultar a documentação Como encontrar as notas Rejeitadas.

 

Caso você esteja com alguma dificuldade ou encontre algum erro de protocolo ao gerar a nota, verifique com o Pedro ou diretamente com a suporte da TecnoSpeed.

Glossário

Termo Significado
Quaza Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico.
Provedor Empresa que opera o sistema Quaza.
Cliente Assinante final do serviço de internet/telefonia/TV.
Contrato Vínculo formal entre cliente e provedor.
Operador Funcionário que opera o sistema.
Permissão Direito de acesso vinculado a papel.
Auditoria Registro de quem fez o quê e quando.
API REST Interface programática para integração externa.
Webhook Notificação automática para sistemas externos.
Cron / crontab Tarefa agendada que roda automaticamente.

Pegadinhas frequentes

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

FAQ

Quem pode acessar essa funcionalidade?

Depende da permissão do usuário. Confira com o administrador do Quaza se você não vê a opção.

O que fazer se aparecer um erro?

Anote a mensagem completa, screenshot, e abra um chamado no suporte do Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal do Cliente. Verifique no módulo Portal .

Posso integrar via API?

Sim — a maioria das funcionalidades do Quaza expõe endpoints REST. Consulte a documentação técnica.

Quaza tem treinamento oficial?

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

Ciclo completo da operação

CICLO COMPLETO DE OPERAÇÃO QUAZA ───────────────────────────────── ┌──────────────────────────────────────────┐ │ 1. PREPARAÇÃO │ │ ───────────── │ │ - usuário com permissão correta │ │ - cadastros pré-requisitos prontos │ │ - integrações configuradas │ │ - equipe treinada nas operações │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 2. EXECUÇÃO │ │ ──────────── │ │ - input do operador, API ou cron │ │ - validação 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 do registro atualizado │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 4. ACOMPANHAMENTO │ │ ───────────────── │ │ - revisão periódica (semanal/mensal) │ │ - identificação de desvios e exceções │ │ - ajustes finos de configuração │ │ - treinamento contínuo da equipe │ └──────────────────────────────────────────┘

Boas práticas operacionais

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

Antes de operar

  • Confirme permissão de acesso: nem todo operador tem permissão para todas as funcionalidades. Verifique com o administrador do Quaza se algo não aparece como esperado. Permissões são 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 você precisa ter o cliente cadastrado, plano de vendas configurado, e regras de cobrança definidas.
  • Treine pelo menos 2 operadores: redundância previne paralisação por ausência. Funcionário pode sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
  • Documente procedimentos internos: crie checklist próprio para operações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operação

  • Documente decisões não óbvias: se você ajustou algo de forma diferente do default, anote o porquê. Próximo operador agradece e evita refazer análise.
  • Operações 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 pode não ser possível em todas as ações. Em dúvida, faça export ou imprima tela antes.
  • Comunique alterações: mudanças que impactam outras equipes (atendimento, 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 da operação. Acompanhe tendências, não só valores absolutos. Variação maior que 20% merece investigação.
  • Auditoria mensal: revise sample de operações do mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
  • Compare com período anterior: "Vendi R$ 100k" — é bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

  • Anote a mensagem de erro completa: copie o texto exato. Captura de tela 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 suporte. Isso acelera resolução.
  • Procure no 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 suporte do Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada provedor define seus próprios indicadores, mas alguns são quase universais para qualquer operação no Quaza:

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

Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.

Recursos relacionados no Quaza

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

  • Cadastro de cliente — base de tudo no Quaza. Cliente bem cadastrado evita problemas downstream.
  • Plano de Contas — onde o impacto financeiro é classificado contabilmente.
  • Logs de auditoria — histórico de quem fez o quê e quando, essencial para diagnóstico.
  • Permissões e papéis — definem quem pode operar o quê.
  • Tarefas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para operação eficiente:

  • Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão pode esconder registros antigos.
  • Exportação: a maioria das listas exporta para CSV/Excel. Útil para análise externa ou backup pré-mudança.
  • Histórico: cada registro tem timeline de modificações. Acesse via botão "Histórico" ou aba lateral.
  • Atalhos de teclado: Ctrl+F (busca), Ctrl+S (salvar), Esc (cancelar) na maioria das telas.
  • Permissão restrita: se botão estiver cinza, é falta de permissão — não bug.