Integrações
Como emitir nota fiscal na Yampi automaticamente com o Notanexo

Neste artigo
A Yampi não emite nota fiscal sozinha: para cada venda, a NF-e precisa sair de um emissor. Fazer isso pedido por pedido consome tempo e abre espaço para erro. Este guia mostra como ligar a sua loja Yampi 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 direto à SEFAZ. A integração com a Yampi liga esse emissor à sua loja.
O caminho de um pedido é este:
- O cliente paga e a Yampi avisa o Notanexo pelo evento de pedido pago (
order.paid). Esse aviso é configurado automaticamente na sua loja quando você conecta. - O Notanexo confere o pedido na própria Yampi, monta a NF-e com os dados fiscais dos produtos, assina e envia à SEFAZ.
- Com a nota autorizada, o Notanexo devolve a nota para o pedido na Yampi: número, série e chave de acesso ficam registrados na venda.
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.
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.
- NCM, CFOP e origem dos produtos revisados com o seu contador. Esses dados ficam no 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. O checkout da Yampi já pede o documento; 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 Yampi
É o caminho recomendado, porque não exige copiar chave nenhuma.
- No painel da Yampi, abra a Loja de Aplicativos e procure por Notanexo (o app se chama Notanexo - Nota Fiscal). Clique em instalar.
- Escolha a loja e aceite as permissões. O app lê pedidos, produtos e clientes, registra a nota no pedido e cria o aviso de pedido pago. Nada além disso.
- Você é levado ao Notanexo. Entre na sua conta ou crie uma.
- Confira o alias da loja que aparece na tela. Só conecte se for a sua loja. Clique em Conectar loja.
- 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 Yampi e a autoemissão continua desligada. O acesso é renovado sozinho; se um dia a Yampi pedir, use Reautorizar na Yampi na mesma tela.
14 dias grátis do Essencial. Quem instala pela Yampi 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 com User Token
Se preferir, conecte com as credenciais de API da própria loja. No Notanexo, abra Integrações, depois Yampi, e use Avançado: conectar com User Token e User Secret Key. Informe o alias da loja, o User Token e o User Secret Key gerados no painel da Yampi. O painel valida as credenciais e cria o aviso de pedido pago automaticamente.
Depois de conectar: dados fiscais, certificado e teste
- Preencha os padrões fiscais do canal. Na tela da Yampi, informe NCM, CFOP dentro e fora do estado e origem da mercadoria usados como padrão nas notas da loja. Produtos cadastrados no catálogo do Notanexo com o mesmo SKU usam os dados do próprio cadastro.
- Envie o certificado A1 da empresa pelo painel. Ele fica guardado cifrado.
- 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. O diagnóstico da tela da Yampi mostra o que ainda falta.
- Ligue a autoemissão. Marque “Emitir automaticamente quando o evento chegar” e salve.
- Troque para produção. Mude o ambiente de emissão de Homologação para Produção. A partir daí as notas têm validade fiscal.

E se a nota for rejeitada?
O pedido não some: ele fica 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.
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 Yampi começa com 14 dias grátis. Veja todos os planos em preços. O certificado A1 e a assinatura da Yampi 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.
Funciona com loja Shopify usando o checkout da Yampi?
Sim. O que importa é o pedido passar pelo checkout da Yampi: é dele que vem o aviso de pedido pago. Veja mais em nota fiscal na Yampi.
Comece por aqui
Procure Notanexo na Loja de Aplicativos da Yampi, 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.