Connect Notazz

With Notazz connected, Vipter sends every paid order to Notazz, which issues the invoice (nota fiscal, the Brazilian tax document) on behalf of your company. When the order is fully refunded or charged back, Vipter requests the cancellation. To understand the issuing rules, see Invoices: how they work.

Step 1: copy the API KEY in NotazzCopy Anchor Link

1. In Notazz, open Configurações›Empresas (Settings › Companies) and go into the company that will issue the invoices.
2. Copy that company's API KEY and keep it for step 2.

Step 2: paste the key into VipterCopy Anchor Link

1. In the Vipter dashboard, open General›Integrations›Invoices›Notazz.
2. Under Connection, paste the key into the numbered field.

3. Choose the Default invoice kind. It applies to products without delivery. Products with delivery always generate an NF-e.
4. Before the first test, turn off Issue when paid. That way no sale generates an invoice while you check the setup.
5. Leave Cancel on refund on to cancel the invoice when the order is fully refunded or charged back.

The environment, e-mail sending, unit and origin fields do not show for Notazz: Notazz does not receive this data from Vipter. Vipter does not control whether Notazz e-mails the invoice to the buyer: check that in the Notazz settings.

Step 3: fill in the fiscal defaultsCopy Anchor Link

In the NFS-e defaults and NF-e defaults cards, right below, fill in the codes that apply to every product. What each field asks for is in Integration fiscal defaults. The codes filled in on the product are used instead of these.

Then click Save, below the two cards.

Step 4: test the credentialsCopy Anchor Link

Click Test credentials. Vipter makes a query to Notazz with the saved key: it asks for the list of webhooks registered in the account. This query neither creates nor transmits an invoice.

The test only confirms the key. The tax codes and your company's data are only checked by the city hall or by SEFAZ when a real invoice is issued.

Step 5: issue the first invoiceCopy Anchor Link

Since there is no test environment, the first invoice is real. Pick a sale you would issue for anyway:

1. Open the paid order under Sales›Transactions.
2. On the Invoices card, click Issue invoice only once.
3. Wait for the invoice to go from Processing to Issued. Vipter checks every 10 minutes, or right away with the Refresh button.
4. Open the PDF and check the data with your accountant.

Once the invoice is right, go back to the integration, turn on Issue when paid and save.

How it works afterwardsCopy Anchor Link

• Order paid: Vipter sends the invoice for immediate issuing. The order ID goes as the external identifier, and Notazz rejects a second submission with the same ID. When you issue again with the button, the identifier gets an attempt number, such as -2.
• NFS-e: the amount, the description, the LC 116 item with the dot, the municipal code, the CNAE (Brazilian economic activity code), the ISS rate and whether the ISS is withheld.
• NF-e: the nature of operation, one item per product (main product and order bumps) with NCM and CFOP, the discount, the shipping with the freight mode and the payment method. Vipter does not send tax codes (ICMS, PIS, COFINS) to Notazz. Check with Notazz and with your accountant how they are filled in.
• Full refund or chargeback: Vipter requests the cancellation. An NF-e can only be cancelled in the first 24 hours after it is authorized. For the NFS-e, your city hall's deadline applies.

Common problemsCopy Anchor Link

• Test failed

  The key is wrong, was changed or belongs to another company. Copy it again from Configurações › Empresas, paste it and save before testing again.

• The invoice shows as Failed with "the customer has no complete address"

  The street, CEP (Brazilian postal code), city or state is missing. Open the customer under Sales›Customers, click Edit, complete the address and issue again from the order. If the order itself already has an incomplete address, Vipter uses the order's: issue this invoice directly in Notazz.

• The invoice shows as Failed with "the customer has no tax id"

  The NF-e requires the buyer's CPF or CNPJ (Brazilian individual or company taxpayer ID). Open the customer under Sales›Customers, click Edit, fill in the CPF or CNPJ and issue again from the order.

• The invoice shows as Rejected

  The city hall or SEFAZ rejected the invoice. The reason shows below the status. Most of the time it is a tax code: fix it in the defaults or on the product and issue again from the order.

• The cancellation did not go through

  The message shows on the order card. An NF-e older than 24 hours can no longer be cancelled. In that case, talk to your accountant about a return invoice.

What to do nextCopy Anchor Link

• See Invoices: how they work for what goes on each invoice and the fiscal defaults.
• Fill in the fiscal data of each product when the codes change from one product to another.