VipterCentral de Ajuda
Integrações

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.

Admin ou DonoTodos os planosVerificado em 28 de set. de 2026

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

  1. Na Notazz, abra ConfiguraçõesEmpresas e entre na empresa que vai emitir as notas.
  2. Copie a API KEY dessa empresa e guarde para o passo 2.
Cadastro da empresa na Notazz com a API KEY destacada
Ilustração provisória: a tela real pode ter pequenas diferenças. O print definitivo entra em breve.

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

  1. No painel do Vipter, abra GeralIntegraçõesNotas fiscaisNotazz.
  2. Em Conexão, cole a chave no campo numerado.
Card de conexão da Notazz no Vipter com o campo da API key numerado e o aviso de que não há ambiente de teste
#CampoO que colar
1API keyObrigatório · fica oculto depois de salvoA API KEY da empresa, copiada no passo 1.
  1. Escolha o Tipo de nota padrão. Ele vale para os produtos sem entrega. Produtos com entrega sempre geram NF-e.
  2. Antes do primeiro teste, desligue Emitir ao pagar. Assim nenhuma venda gera nota enquanto você confere a configuração.
  3. 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:

  1. Abra o pedido pago em VendasTransações.
  2. No card Notas fiscais, clique em Emitir nota uma única vez.
  3. Espere a nota passar de Processando para Emitida. O Vipter consulta a cada 10 minutos, ou na hora pelo botão Atualizar.
  4. 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

Nesta página