Instalação/Configuração

Instale o Plugin Emissor de NF-e para WooCommerce do Base ERP e conecte sua loja ao ambiente correto utilizando uma chave de API.

Ao concluir esta etapa, siga para o cadastro e vínculo dos produtos antes de iniciar o fluxo de emissão de NF-e.

Antes de começar

Confirme que:

• sua conta Asaas é de pessoa jurídica;
• o Base ERP está ativado para a conta;
• você possui acesso ao Base ERP;
• sua loja utiliza WooCommerce;
• você possui acesso administrativo ao WordPress.

Utilize, no mínimo:

Defina também qual ambiente será utilizado:

Fluxo de configuração

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Instalar o plugin"] --> B["Definir o ambiente"]
    B --> C["Gerar a API Key no Base ERP"]
    C --> D["Configurar a chave no WooCommerce"]
    D --> E["Validar a configuração"]
    E --> F["Cadastrar produtos no Base ERP"]
    F --> G["Vincular produtos no WooCommerce"]

    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 validacao
    class G sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

1. Instale o plugin

A forma recomendada é utilizar a página oficial do WordPress:

Plugin Base ERP – Faturas para WooCommerce

No painel do WordPress:

1. Acesse Plugins > Adicionar novo.
2. Pesquise por Base ERP for WooCommerce.
3. Clique em Instalar agora.
4. Após a instalação, clique em Ativar.

Instalação manual

Se precisar instalar manualmente:

1. Baixe o arquivo .zip pela página oficial do plugin no WordPress.
2. Acesse Plugins > Adicionar Plugin.
3. Clique em Enviar Plugin.
4. Selecione o arquivo .zip.
5. Clique em Instalar Agora.
6. Após a instalação, clique em Ativar Plugin.

Ao concluir, a aba Base ERP deve ficar disponível em WooCommerce > Configurações.

2. Gere a API Key no Base ERP

A chave deve ser criada no mesmo ambiente que será utilizado pelo plugin.

Se ainda não possui acesso ao Base ERP, consulte Conta Asaas no Base ERP.

No Base ERP:

1. Acesse Menu do usuário > Configurações > Chaves de API.
2. Crie uma nova chave.
3. Defina um nome que identifique a integração, como Emissor NF WooCommerce.
4. Copie a chave gerada antes de sair da tela.

Consulte também a documentação de Autenticação do Base ERP.

3. Conecte o WooCommerce ao Base ERP

No WordPress:

1. Acesse WooCommerce > Configurações.
2. Abra a aba Base ERP.
3. Selecione Sandbox ou Produção.
4. Informe a chave correspondente no campo API Key.
5. Salve as configurações.

Resultado esperado

A configuração deve ser salva sem erro de autenticação e permanecer associada ao ambiente selecionado.

Se a conexão falhar, confirme:

• se a API Key foi copiada integralmente;
• se a chave continua ativa;
• se a chave pertence ao ambiente selecionado;
• se o plugin está instalado e ativo.

4. Prepare os produtos

A conexão com o Base ERP não conclui a integração.

Antes de emitir NF-e:

• cadastre os produtos no Base ERP;
• preencha as informações fiscais necessárias;
• localize o Identificador Interno de cada produto;
• vincule esse identificador ao produto correspondente no WooCommerce.

Essa etapa é detalhada em Cadastro/Vínculo de Produtos.

Ao trocar de ambiente

Sempre troque ambiente e API Key em conjunto.

Uma chave de Sandbox utilizada em Produção, ou uma chave de Produção utilizada em Sandbox, impede a autenticação correta.

Após alterar o ambiente, valide novamente a conexão antes de realizar qualquer emissão.

Próximos passos

• Cadastre e vincule os produtos
• Consulte a visão geral do Emissor de NF-e
• Consulte a autenticação do Base ERP