Emissor NF-e para WooCommerce - BaseERP

Se você já utiliza o Plugin Asaas para WooCommerce para gerenciar suas vendas de produtos, também pode automatizar a emissão de Notas Fiscais Eletrônicas de Produto utilizando o Emissor de NF-e para WooCommerce do Base ERP.

Essa integração conecta sua loja WooCommerce ao Base ERP, permitindo que pedidos de produtos vendidos no e-commerce sejam utilizados no fluxo de emissão de NF-e, desde que o plugin esteja instalado, configurado e os produtos estejam corretamente vinculados entre os sistemas.

Quando utilizar

Utilize esta seção quando sua loja WooCommerce vender produtos e precisar automatizar ou facilitar o processo de emissão de NF-e por meio do Base ERP.

Alguns cenários comuns incluem:

lojas WooCommerce que vendem produtos físicos;
operações que já utilizam o Plugin Asaas para WooCommerce;
empresas que precisam emitir NF-e de produto após vendas no e-commerce;
clientes pessoa jurídica que utilizam ou desejam utilizar o Base ERP;
lojas que precisam centralizar dados comerciais, fiscais e financeiros;
operações que desejam reduzir processos manuais de emissão de notas fiscais.

📘
Importante
Esta seção é voltada para emissão de NF-e de produto no WooCommerce.
Para que a emissão funcione corretamente, é necessário configurar o plugin, gerar a chave de API no ambiente correto e vincular os produtos do WooCommerce aos produtos cadastrados no Base ERP.

O que é o Base ERP?

O Base ERP é um sistema ERP do Asaas, em nuvem e sem mensalidade, disponível exclusivamente para clientes pessoa jurídica.

Ele reúne recursos financeiros e de gestão empresarial em um único sistema, permitindo controlar rotinas operacionais e administrativas da empresa.

Com o Base ERP, é possível:

controlar contas a receber;
controlar contas a pagar;
acompanhar fluxo de caixa;
gerenciar estoque;
registrar notas de entrada;
elaborar propostas comerciais;
criar pedidos de venda;
criar pedidos de compra;
emitir notas fiscais de produto;
emitir notas fiscais de serviço;
utilizar sistema de frente de caixa, PDV;
gerar relatórios financeiros.

Caso queira conhecer mais ou tirar dúvidas sobre ativação e configuração do Base ERP pelo Asaas, consulte o FAQ do Base ERP ou acione o time de atendimento.

Como funciona o Emissor de NF-e para WooCommerce

O Emissor de NF-e para WooCommerce conecta sua loja ao Base ERP por meio de uma chave de API.

Depois que o plugin é instalado e configurado, os produtos vendidos no WooCommerce precisam estar vinculados aos produtos correspondentes no Base ERP. Esse vínculo permite que o Base ERP identifique corretamente os itens vendidos e utilize as informações necessárias no processo de emissão da nota fiscal.

Fluxo geral:

Instalar o Plugin Emissor de NF-e para WooCommerce
↓
Gerar a chave de API no Base ERP
↓
Configurar o ambiente e a API Key no WooCommerce
↓
Cadastrar os produtos no Base ERP
↓
Vincular os produtos do WooCommerce aos produtos do Base ERP
↓
Validar as informações fiscais dos produtos
↓
Iniciar o fluxo de emissão de NF-e

Pré-requisitos

Antes de utilizar o Emissor de NF-e para WooCommerce, verifique se:

sua conta Asaas é de pessoa jurídica;
o Base ERP está ativado para a conta;
sua loja utiliza WooCommerce;
você possui acesso administrativo ao WordPress;
o Plugin Emissor de NF-e para WooCommerce está instalado e ativo;
você possui acesso ao Base ERP;
a chave de API do Base ERP foi gerada no ambiente correto;
os produtos vendidos na loja estão cadastrados no Base ERP;
os produtos do WooCommerce foram vinculados aos produtos correspondentes no Base ERP;
as informações fiscais dos produtos foram revisadas no Base ERP.

🚧
Atenção
A instalação do plugin, por si só, não garante a emissão automática das notas fiscais.
É necessário concluir a configuração da API Key, selecionar o ambiente correto e vincular os produtos entre WooCommerce e Base ERP.

Configurações importantes

Algumas configurações têm impacto direto no funcionamento da integração.

Configuração	Onde configurar	Impacto
Ambiente	WooCommerce	Define se o plugin utilizará Produção ou Sandbox.
API Key	Base ERP e WooCommerce	Conecta a loja WooCommerce ao Base ERP.
Produto no Base ERP	Base ERP	Permite que o item vendido tenha cadastro fiscal e comercial.
ID interno do produto	Base ERP	Identificador usado para vincular o produto ao WooCommerce.
Vínculo do produto	WooCommerce	Relaciona o produto da loja ao produto cadastrado no Base ERP.
Informações fiscais	Base ERP	Impactam a emissão correta da NF-e.

Ambientes de conexão

Durante a configuração, será necessário escolher o ambiente de conexão:

Ambiente	Quando utilizar
Sandbox	Para testes, simulações e validação do fluxo antes da emissão real.
Produção	Para emissão real de notas fiscais.

📘
Boa prática
Utilize o ambiente Sandbox para validar a instalação, a conexão com o Base ERP e o vínculo de produtos antes de utilizar o ambiente de Produção.

Chave de API do Base ERP

A chave de API do Base ERP é responsável por conectar sua loja WooCommerce ao emissor de NF-e.

Ela deve ser gerada dentro do Base ERP, no ambiente correspondente ao ambiente configurado no plugin.

❗️
Responsabilidade com a chave de API
A chave de API do Base ERP é exibida apenas uma vez no momento da criação.
Copie e armazene a chave em local seguro antes de sair da tela de geração. Caso a chave seja perdida, será necessário gerar uma nova chave e atualizar a configuração no plugin.

Cadastro e vínculo de produtos

Para que a emissão de NF-e funcione corretamente, os produtos vendidos no WooCommerce precisam estar cadastrados no Base ERP.

Depois do cadastro no Base ERP, é necessário copiar o Identificador Interno do Produto e informar esse ID no produto correspondente dentro do WooCommerce.

Esse vínculo é essencial para que o Base ERP identifique corretamente qual item foi vendido na loja.

📘
Importante
Nesta versão do plugin, não há sincronização automática de produtos e estoque entre WooCommerce e Base ERP.
A gestão de estoque permanece no WooCommerce, e o cadastro dos produtos no Base ERP deve ser realizado para viabilizar o fluxo de emissão de NF-e.

Comportamentos relevantes

Ao utilizar o Emissor de NF-e para WooCommerce, considere que:

a integração depende da API Key do Base ERP;
cada ambiente possui sua própria chave de API;
a configuração de Produção e Sandbox deve ser feita com atenção;
produtos precisam existir no Base ERP;
produtos precisam estar vinculados corretamente no WooCommerce;
a gestão de estoque continua sendo feita pelo WooCommerce nesta versão;
alterações de estoque em um sistema não são refletidas automaticamente no outro;
informações fiscais incorretas podem impedir ou comprometer a emissão da NF-e;
produtos sem vínculo correto podem não ser identificados no processo de emissão;
a emissão real de NF-e deve ser feita apenas após validação das configurações.

Impactos operacionais

A configuração incorreta do Emissor de NF-e pode impactar diretamente o fluxo fiscal e operacional da loja.

Alguns impactos importantes:

pedidos podem ficar sem nota fiscal emitida;
produtos vendidos podem não ser identificados no Base ERP;
dados fiscais incorretos podem gerar inconsistências na NF-e;
uso de API Key de ambiente incorreto pode impedir a comunicação entre sistemas;
ausência de vínculo entre produtos pode interromper o fluxo de emissão;
divergências entre WooCommerce e Base ERP podem dificultar conferências fiscais e operacionais;
emissão em Produção sem testes prévios pode gerar notas fiscais com dados incorretos.

Por isso, valide todo o fluxo em Sandbox antes de iniciar a emissão real.

Boas práticas

Para uma configuração mais segura, recomenda-se:

utilizar sempre o nome Base ERP de forma padronizada;
testar a integração em Sandbox antes de usar Produção;
gerar a API Key no ambiente correto;
armazenar a chave de API em local seguro;
não salvar chaves de API em código-fonte ou arquivos públicos;
cadastrar os produtos no Base ERP antes de iniciar a emissão;
manter nomes de produtos iguais ou facilmente identificáveis no WooCommerce e no Base ERP;
revisar informações fiscais, impostos e CFOPs no Base ERP;
validar o vínculo dos produtos antes de processar pedidos reais;
manter registro interno dos produtos já vinculados;
revisar periodicamente a configuração do plugin.

Erros e dúvidas comuns

Situação	Possível causa	Como agir
Plugin não conecta ao Base ERP	API Key inválida, ausente ou de ambiente incorreto	Gere uma nova chave no ambiente correto e atualize a configuração do plugin
Produto não é identificado	Produto do WooCommerce não está vinculado ao produto do Base ERP	Copie o Identificador Interno do Produto no Base ERP e informe no produto correspondente no WooCommerce
Nota não é emitida corretamente	Informações fiscais ausentes ou incorretas no Base ERP	Revise o cadastro fiscal do produto
Ambiente incorreto	Plugin configurado em Produção com chave de Sandbox, ou o contrário	Confirme o ambiente selecionado e a origem da API Key
Estoque divergente	Não há sincronização automática de estoque nesta versão	Mantenha o controle de estoque no WooCommerce
Chave de API perdida	A chave é exibida apenas uma vez	Gere uma nova chave e substitua a anterior na configuração do plugin

Estrutura desta seção

Esta seção está organizada em páginas específicas para orientar a configuração completa do Emissor de NF-e para WooCommerce.

Consulte também:

Instalação e configuração;
Instalação do Plugin;
Configuração do Plugin;
Cadastro e vínculo de produtos;
Boas práticas para emissão de NF-e;
FAQ do Base ERP.

Próximos passos

Para iniciar a configuração, siga a ordem recomendada:

Ler a visão geral desta página
↓
Instalar o Plugin Emissor de NF-e para WooCommerce
↓
Gerar a API Key no Base ERP
↓
Configurar o ambiente e a chave no WooCommerce
↓
Cadastrar produtos no Base ERP
↓
Vincular produtos entre WooCommerce e Base ERP
↓
Validar o fluxo em Sandbox
↓
Utilizar em Produção