Conectar a Notazz
Emita NF-e e NFS-e pela Notazz a cada pedido pago e cancele no estorno, sabendo que a Notazz não tem ambiente de teste.
Com a Notazz conectada, o Vipter envia cada pedido pago para a Notazz, que emite a nota pela sua empresa. Quando o pedido é estornado por inteiro ou sofre chargeback, o Vipter pede o cancelamento. Para entender as regras de emissão, veja Notas fiscais: como funcionam.
A Notazz não tem ambiente de teste
Na Notazz, toda nota enviada pelo Vipter é um documento fiscal real, transmitido para a prefeitura ou para a SEFAZ. Isso vale para compras de teste, para vendas com a conta de pagamento em modo de teste e para o botão Emitir nota no pedido. A homologação da sua empresa é feita com o suporte da Notazz. Só o botão Testar credenciais é seguro: ele não emite nota.
Antes de começar
- Uma conta na Notazz com a sua empresa cadastrada, com certificado digital e dados fiscais completos.
- Papel Admin ou Dono no projeto do Vipter.
- Os códigos fiscais definidos com seu contador: item da LC 116, código municipal e alíquota de ISS para serviços, NCM e CFOP para produtos.
Passo 1: copiar a API KEY na Notazz
- Na Notazz, abra ConfiguraçõesEmpresas e entre na empresa que vai emitir as notas.
- Copie a API KEY dessa empresa e guarde para o passo 2.

Guarde a chave com cuidado
Com essa chave dá para emitir e cancelar notas em nome da sua empresa. Cole a chave só no Vipter. Depois de salva, ela não aparece de novo: o campo mostra só o final dela.
Passo 2: colar a chave no Vipter
- No painel do Vipter, abra GeralIntegraçõesNotas fiscaisNotazz.
- Em Conexão, cole a chave no campo numerado.

| # | Campo | O que colar |
|---|---|---|
| 1 | API key | A API KEY da empresa, copiada no passo 1. |
- Escolha o Tipo de nota padrão. Ele vale para os produtos sem entrega. Produtos com entrega sempre geram NF-e.
- Antes do primeiro teste, desligue Emitir ao pagar. Assim nenhuma venda gera nota enquanto você confere a configuração.
- Deixe ligado Cancelar no estorno para cancelar a nota quando o pedido for estornado por inteiro ou sofrer chargeback.
Na Notazz não aparecem os campos de ambiente, de envio por e-mail, de unidade e de origem: a Notazz não recebe esses dados do Vipter. O Vipter não controla se a Notazz manda a nota por e-mail ao comprador: confira isso nas configurações da Notazz.
Passo 3: preencher os padrões fiscais
Nos cards Padrões NFS-e e Padrões NF-e, logo abaixo, preencha os códigos que valem para todos os produtos. O que cada campo pede está em Padrões fiscais da integração. Os códigos preenchidos no produto valem no lugar desses.
Depois, clique em Salvar, abaixo dos dois cards.
Passo 4: testar as credenciais
Clique em Testar credenciais. O Vipter faz uma consulta à Notazz com a chave salva: pede a lista de webhooks cadastrados na conta. Essa consulta não cria nem transmite nota.
Deu certo se
Aparece a mensagem Credenciais válidas.
O teste confirma só a chave. Os códigos fiscais e os dados da sua empresa só são conferidos pela prefeitura ou pela SEFAZ quando uma nota de verdade é emitida.
Passo 5: emitir a primeira nota
Como não há ambiente de teste, a primeira nota é real. Escolha uma venda que você emitiria de qualquer jeito:
- Abra o pedido pago em VendasTransações.
- No card Notas fiscais, clique em Emitir nota uma única vez.
- Espere a nota passar de Processando para Emitida. O Vipter consulta a cada 10 minutos, ou na hora pelo botão Atualizar.
- Abra o PDF e confira os dados com seu contador.
Com a nota certa, volte à integração, ligue Emitir ao pagar e salve.
Como funciona depois
- Pedido pago: o Vipter manda a nota para emissão imediata. O ID do pedido vai como identificador externo, e a Notazz recusa um segundo envio com o mesmo ID. Quando você emite de novo pelo botão, o identificador ganha um número de tentativa, como
-2. - NFS-e: vão o valor, a descrição, o item da LC 116 com o ponto, o código municipal, o CNAE, a alíquota de ISS e se o ISS é retido.
- NF-e: vão a natureza da operação, um item por produto (principal e order bumps) com NCM e CFOP, o desconto, o frete com a modalidade e a forma de pagamento. O Vipter não envia códigos de impostos (ICMS, PIS, COFINS) para a Notazz. Confira com a Notazz e com seu contador como eles são preenchidos.
- Estorno total ou chargeback: o Vipter pede o cancelamento. A NF-e só pode ser cancelada nas primeiras 24 horas depois de autorizada. Para a NFS-e, vale o prazo da sua prefeitura.
Problemas comuns
-
Falha no teste
A chave está errada, foi trocada ou é de outra empresa. Copie de novo em Configurações › Empresas, cole e salve antes de testar outra vez.
-
A nota ficou como Falhou com "o cliente não tem endereço completo"
Falta rua, CEP, cidade ou estado. Abra o cliente em VendasClientes, clique em Editar, complete o endereço e emita de novo pelo pedido. Se o próprio pedido já tem um endereço incompleto, o Vipter usa o do pedido: emita essa nota direto na Notazz.
-
A nota ficou como Falhou com "o cliente não tem CPF/CNPJ"
A NF-e exige o documento do comprador. Abra o cliente em VendasClientes, clique em Editar, preencha o CPF ou o CNPJ e emita de novo pelo pedido.
-
A nota ficou como Rejeitada
A prefeitura ou a SEFAZ recusou a nota. O motivo aparece embaixo do status. Na maioria das vezes é um código fiscal: corrija nos padrões ou no produto e emita de novo pelo pedido.
-
O cancelamento não passou
A mensagem aparece no card do pedido. Uma NF-e com mais de 24 horas não pode mais ser cancelada. Nesse caso, fale com seu contador sobre a nota de devolução.
O que fazer a seguir
- Veja Notas fiscais: como funcionam para o que vai em cada nota e os padrões fiscais.
- Preencha os dados fiscais de cada produto quando os códigos mudam de um produto para outro.
Notas fiscais: como funcionam
Entenda quando o Vipter emite e cancela NF-e e NFS-e pela Notazz, pelo eNotas ou pelo PlugNotas, quais padrões fiscais configurar e como acompanhar as notas de cada pedido.
Conectar o eNotas (Nota Gateway)
Emita NFS-e e NF-e pelo eNotas a cada pedido pago, teste em homologação quando a sua prefeitura permitir e cancele no estorno.