Conectar o PlugNotas

Com o PlugNotas conectado, o Vipter envia cada pedido pago para o PlugNotas, que emite a nota pela sua empresa. Quando o pedido é estornado por inteiro ou sofre chargeback, o Vipter pede o cancelamento. O PlugNotas tem um sandbox com retornos simulados, então dá para testar tudo antes de emitir nota real. Para entender as regras de emissão, veja Notas fiscais: como funcionam.

Passo 1: pegar o token no PlugNotasCopiar link da seção

O PlugNotas chama a chave de token, e ela vai no campo x-api-key. O token depende do ambiente:

• Sandbox: o PlugNotas publica um token de testes na documentação dele, válido só em api.sandbox.plugnotas.com.br:

  Copiar

  2da392a6-79d2-4304-a8b7-959572c7e44d

• Produção: entre no painel do PlugNotas, em app2.plugnotas.com.br, e gere o seu token de acesso.

Anote também o CNPJ da empresa que vai emitir as notas, exatamente como está cadastrado no PlugNotas.

Passo 2: colar os dados no VipterCopiar link da seção

1. No painel do Vipter, abra Geral›Integrações›Notas fiscais›PlugNotas.
2. Em Conexão, preencha os campos numerados.

3. Em Ambiente, escolha Sandbox / homologação para os testes. Sandbox usa api.sandbox.plugnotas.com.br com retornos simulados.
4. Escolha o Tipo de nota padrão. Ele vale para os produtos sem entrega. Produtos com entrega sempre geram NF-e.
5. Confira as chaves:
   • Emitir ao pagar: emite assim que o pedido é pago.
   • Cancelar no estorno: pede o cancelamento no estorno total e no chargeback.
   • Enviar por e-mail ao cliente: o PlugNotas manda a nota para o e-mail do comprador.

O ambiente e o token andam juntos. O token de testes não funciona em produção, e o seu token de produção não funciona no sandbox.

Passo 3: preencher os padrões fiscaisCopiar link da seção

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 no sandboxCopiar link da seção

1. Clique em Testar credenciais. O Vipter consulta a empresa do CNPJ no ambiente salvo. Essa consulta não emite nota. Se você trocou o ambiente, salve antes de testar.
2. Faça uma compra de teste e acompanhe a nota no card Notas fiscais do pedido. Veja Testar a sua loja.

No sandbox, o CNPJ precisa existir como empresa no ambiente de testes do PlugNotas. Se o teste falhar só no sandbox, veja na documentação do PlugNotas como cadastrar a empresa de testes.

Passo 5: passar para produçãoCopiar link da seção

1. Troque o token pelo seu token de produção.
2. Mude o Ambiente para Produção.
3. Clique em Salvar e depois em Testar credenciais.

A partir daí, cada pedido pago gera uma nota real.

Como funciona depoisCopiar link da seção

• Pedido pago: o ID do pedido vai como identificador da integração. Se o mesmo pedido chegar de novo, o PlugNotas devolve a nota que já existe em vez de criar outra.
• Cidade do comprador: o PlugNotas exige o código IBGE da cidade. O Vipter descobre esse código pelo CEP do comprador.
• NFS-e: vão o tomador com endereço, o item da LC 116, o código municipal, o CNAE, a alíquota de ISS, se o ISS é retido, a descrição, o valor e o desconto. Sem alíquota em lugar nenhum, o Vipter envia 0.
• NF-e: vão a natureza da operação, um item por produto (principal e order bumps) com NCM, CFOP, unidade, origem, frete e desconto, a forma de pagamento e a modalidade do frete. O comprador vai como consumidor final, não contribuinte, em venda pela internet.
• Impostos da NF-e: o Vipter envia o ICMS com situação tributária 102 e o PIS e a COFINS com situação 08. O código 102 de ICMS é o usado por empresas do Simples Nacional. Se a sua empresa é de outro regime, fale com seu contador antes de emitir NF-e.
• Estorno total ou chargeback: o Vipter pede o cancelamento. O prazo para cancelar é o da prefeitura (NFS-e) ou da SEFAZ (NF-e).

Problemas comunsCopiar link da seção

• Falha no teste

  O token não combina com o ambiente, ou o CNPJ não está cadastrado no PlugNotas desse ambiente. Confira os dois, salve e teste 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 Vendas›Clientes, 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 no PlugNotas.

• 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 Vendas›Clientes, clique em Editar, preencha o CPF ou o CNPJ e emita de novo pelo pedido.

• A nota foi recusada por causa da cidade

  O código IBGE vem da consulta do CEP. Se o CEP do comprador está errado ou a consulta não respondeu, a cidade vai sem código. Corrija o CEP no cadastro do cliente e emita de novo pelo pedido.

• A nota ficou como Falhou ou Rejeitada com outra mensagem

  O motivo e os campos que o PlugNotas recusou aparecem embaixo do status. Corrija nos padrões, no produto ou no cadastro do PlugNotas e emita de novo pelo pedido.

O que fazer a seguirCopiar link da seção

• 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.