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.

📘

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.

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çã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.

Entenda onde cada configuração acontece

ConfiguraçãoOnde configurarFunção
AmbienteWooCommerceDefine o uso de Sandbox ou Produção.
API KeyBase ERP e WooCommerceAutentica a conexão entre os sistemas.
Cadastro e dados fiscais do produtoBase ERPFornece as informações utilizadas na emissão da NF-e.
Identificador Interno do ProdutoBase ERPIdentifica o produto que será vinculado ao WooCommerce.
Vínculo do produtoWooCommerceRelaciona o item vendido ao cadastro correspondente no Base ERP.
EstoqueWooCommercePermanece 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á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.

A geração da chave e a configuração do ambiente são detalhadas em Instalação/Configuração.

❗️

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

📘

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.

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


Did this page help you?