Como emitir nota fiscal na Nuvemshop automaticamente com o Notanexo

Se a sua loja é na Nuvemshop, emitir a NF-e pedido por pedido consome tempo e abre espaço para erro. Este guia mostra como ligar a loja ao Notanexo para que o pedido pago vire nota, o que preparar antes e como testar com segurança.

O que a integração faz

O Notanexo é um emissor de NF-e que assina a nota com o certificado A1 da sua empresa e a envia à SEFAZ. A integração com a Nuvemshop liga esse emissor à sua loja, para que você não precise digitar pedido por pedido.

O caminho de um pedido é este:

1. O cliente paga e a Nuvemshop avisa o Notanexo (evento order/paid). Além do aviso, o Notanexo consulta os pedidos pagos da loja a cada 15 minutos, para recuperar algum aviso que tenha se perdido.
2. O Notanexo confere o pedido na própria Nuvemshop, monta a NF-e com os dados fiscais do seu catálogo, assina e envia à SEFAZ.
3. Com a nota autorizada em produção, a chave de acesso é gravada no pedido da Nuvemshop, em um campo adicional (metafield nfe/key). É o campo que outros apps, como os de transportadora, costumam ler.

Também é possível importar o catálogo da loja para o Notanexo e completar ali os dados fiscais dos produtos. Duas regras de segurança valem desde o início: a autoemissão começa desligada e a conexão começa em homologação, o ambiente de testes da SEFAZ, em que a nota não tem valor fiscal. Por isso a chave não é gravada no pedido enquanto você estiver em homologação.

O que você precisa antes

• Empresa com inscrição estadual habilitada para NF-e. A nota sai em nome do CNPJ emissor.
• Certificado digital A1 da empresa. Ele é contratado à parte, com uma certificadora. Se ainda não tem, veja o guia do certificado A1.
• Produtos com NCM, CFOP e origem revisados com o seu contador. O Notanexo não importa os dados fiscais da Nuvemshop: NCM, CFOP e origem ficam no cadastro do Notanexo, que é o que vai para a nota. Veja também cadastro de produtos e informação contábil.
• CPF ou CNPJ do comprador no pedido. Sem ele, a NF-e não pode ser emitida e o pedido fica como pendência no painel.
• Plano Essencial ou superior. A integração de loja está incluída a partir do Essencial.

Sobre os estados: a emissão de NF-e está disponível para empresas da maioria dos estados. No momento, AM, MS, PE, PR, SC e TO ainda não emitem. Se a sua empresa é de outra UF, confirme antes de assinar pelo contato@notanexo.com.br.

Opção 1: instalar pela Loja de Aplicativos da Nuvemshop

É o caminho recomendado, porque não exige criar token nenhum.

1. No painel da Nuvemshop, abra a Loja de Aplicativos e procure por Notanexo (o app se chama Notanexo - Emissor de Nota Fiscal). Clique em instalar.
2. Aceite as permissões. O app lê pedidos e produtos da loja e grava a chave da nota no pedido. Nada além disso.
3. Você é levado ao Notanexo. Entre na sua conta ou crie uma.
4. Confira o nome, o endereço e o ID da loja que aparecem na tela. Só conecte se for a sua loja. Clique em Conectar loja.
5. Se você tiver mais de uma empresa cadastrada, escolha qual delas emite as notas dessa loja.

Pronto: a loja aparece como conectada em Integrações, o aviso de pedido pago é registrado automaticamente na Nuvemshop e a autoemissão continua desligada.

14 dias grátis do Essencial. Quem instala pela Nuvemshop ganha 14 dias do plano Essencial, sem cartão. A oferta vale uma vez por conta e uma vez por loja; reinstalar a mesma loja não renova o período.

Opção 2: conectar por token

Se preferir, conecte com um token criado na própria loja. Na Nuvemshop, abra Aplicativos, depois Aplicativos sob medida, e crie um token com leitura de loja, pedidos e produtos e escrita de metadados dos pedidos. Esse recurso está disponível nos planos Escala e Next da Nuvemshop.

No Notanexo, abra Integrações, depois Nuvemshop, e preencha o ID da loja e o token de acesso no Passo 1, “Conectar a loja”. Nessa opção, os pedidos pagos chegam pela consulta automática a cada 15 minutos. A Nuvemshop mantém um passo a passo para criar o token.

Depois de conectar: catálogo, certificado e teste

1. Importe o catálogo. Na tela da Nuvemshop, use “Conferir o que viria” para ver o resumo e depois importe. Os produtos entram no catálogo do Notanexo.
2. Complete os dados fiscais. A importação traz nome, SKU e preço; NCM, CFOP e origem você completa no Notanexo. Revise cada produto na fila de revisão do catálogo, com o seu contador.
3. Envie o certificado A1 da empresa pelo painel. Ele fica guardado cifrado.
4. Teste um pedido em homologação. Faça um pedido de teste, pague e confira se a nota aparece no painel, com ou sem pendência. A nota de homologação não tem valor fiscal.
5. Ligue a autoemissão. Em “Configuração das notas”, marque “Emitir automaticamente os pedidos pagos” e salve.
6. Troque para produção. No mesmo bloco, mude o ambiente de Homologação para Produção. A partir daí as notas têm validade fiscal e a chave passa a ser gravada no pedido.

E se a nota for rejeitada?

O pedido não some: ele fica pendente na lista de pedidos da integração, com o motivo. A mensagem costuma apontar o dado a corrigir, como o NCM de um produto ou o documento do comprador. Corrija o cadastro e use o botão “Tentar de novo” no pedido; não é preciso criar outra nota. Para entender as causas mais comuns, leia nota fiscal rejeitada e a rotina para resolver a causa.

E se eu desinstalar o app?

Quando o app é desinstalado na Nuvemshop, a conexão é desligada e o Notanexo deixa de receber os pedidos da loja. As notas já emitidas continuam guardadas no Notanexo: os XMLs precisam ser mantidos por 5 anos.

Perguntas frequentes

A nota sai sozinha assim que o pedido é pago?

Sim, depois que você liga a autoemissão. Até lá, o Notanexo recebe o pedido mas não emite.

Quanto custa?

O Essencial custa R$ 39 por mês, ou R$ 390 por ano, com notas ilimitadas, 1 CNPJ e a integração incluída. Quem instala pela Nuvemshop começa com 14 dias grátis. Veja todos os planos em preços. O certificado A1 e a assinatura da Nuvemshop não estão incluídos.

Meu contador consegue acessar?

Sim. Você o convida como usuário e ele baixa os XMLs e o fechamento do mês no painel. Veja o que ele precisa receber em XML da nota fiscal.

A Nuvemshop já emite nota?

A Nuvemshop tem recurso próprio de emissão, com regras e cobrança dela. O Notanexo é um serviço independente: emite com o seu certificado e com cobrança própria. Compare as duas opções com o seu contador.

Comece por aqui

Procure Notanexo na Loja de Aplicativos da Nuvemshop, ou crie sua conta no Notanexo e conecte pelo painel. Para tirar dúvidas antes, escreva para contato@notanexo.com.br ou veja os planos.