Emissor NF-e para WooCommerce - BaseERP
Use o Emissor de NF-e para WooCommerce para conectar os pedidos da sua loja ao Base ERP e utilizá-los no fluxo de emissão de NF-e de produto.
A integração depende da conexão com o Base ERP e do vínculo entre cada produto vendido no WooCommerce e seu cadastro correspondente no ERP.
ImportanteEsta 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.
Quando utilizar
Utilize esta integração quando:
- sua loja WooCommerce vende produtos que precisam de NF-e;
- sua operação utiliza ou pretende utilizar o Base ERP;
- os pedidos do WooCommerce precisam ser relacionados aos cadastros fiscais dos produtos no Base ERP.
O Base ERP é um sistema de gestão empresarial em nuvem disponível para contas Asaas de pessoa jurídica.
Para informações sobre ativação e funcionamento do ERP, consulte o FAQ do Base ERP.
Como funciona
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Instalar o plugin"] --> B["Gerar a API Key no Base ERP"]
B --> C["Conectar o WooCommerce"]
C --> D["Cadastrar os produtos no Base ERP"]
D --> E["Vincular os produtos pelo ID interno"]
E --> F["Validar os dados fiscais"]
F --> G["Testar o fluxo no Sandbox"]
G --> H["Utilizar em Produção"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
class A inicio
class B,C,D,E,F,G validacao
class H sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
A instalação e a conexão são tratadas em Instalação/Configuração. O cadastro e o vínculo dos produtos são detalhados em Cadastro/Vínculo de Produtos.
Antes de começar
Confirme que:
- 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;
- você possui acesso ao Base ERP.
AtençãoA 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.
Entenda onde cada configuração acontece
| Configuração | Onde configurar | Função |
|---|---|---|
| Ambiente | WooCommerce | Define o uso de Sandbox ou Produção. |
| API Key | Base ERP e WooCommerce | Autentica a conexão entre os sistemas. |
| Cadastro e dados fiscais do produto | Base ERP | Fornece as informações utilizadas na emissão da NF-e. |
| Identificador Interno do Produto | Base ERP | Identifica o produto que será vinculado ao WooCommerce. |
| Vínculo do produto | WooCommerce | Relaciona o item vendido ao cadastro correspondente no Base ERP. |
| Estoque | WooCommerce | Permanece como fonte de controle de estoque nesta versão do plugin. |
Sandbox e Produção
Cada ambiente utiliza sua própria chave de API.
Configure o Sandbox para testar a conexão, o cadastro dos produtos e o vínculo entre os sistemas antes de iniciar emissões reais.
Boa práticaUtilize 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.
A geração da chave e a configuração do ambiente são detalhadas em Instalação/Configuração.
Responsabilidade com a chave de APIA 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, vínculo e estoque
Cada produto vendido no WooCommerce precisa possuir um cadastro correspondente no Base ERP.
Após cadastrar o item no ERP, utilize o Identificador Interno do Produto para vinculá-lo ao produto correto no WooCommerce.
ImportanteNesta 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.
O WooCommerce permanece como fonte de controle de estoque. O Base ERP mantém o cadastro e as informações fiscais utilizadas no fluxo de emissão.
Consulte Cadastro/Vínculo de Produtos para cadastrar os itens, localizar o Identificador Interno do Produto e concluir o vínculo.
Antes de utilizar em Produção
Valide no Sandbox se:
- o plugin está conectado ao ambiente correto;
- a API Key corresponde ao ambiente configurado;
- os produtos vendidos estão cadastrados no Base ERP;
- cada produto está vinculado pelo Identificador Interno correto;
- as informações fiscais, impostos e CFOPs foram revisados no Base ERP;
- o fluxo de emissão utiliza o produto esperado.
Depois dessa validação, altere a integração para Produção com a chave correspondente ao ambiente.
Próximos passos
Updated 13 days ago
