Cadastro/Vínculo de Produtos
Nesta primeira versão do Plugin Emissor de NF-e para WooCommerce do Base ERP, não há sincronização automática de produtos e estoque entre WooCommerce e Base ERP.
Isso significa que a gestão de estoque continuará sendo feita exclusivamente pelo WooCommerce, sem interferência direta do Base ERP.
ImportanteO WooCommerce deve ser tratado como a fonte principal para controle de estoque nesta versão do plugin.
O cadastro do produto no Base ERP é necessário para viabilizar o fluxo de emissão de NF-e, mas não substitui o controle operacional de estoque realizado no WooCommerce.
Quando utilizar
Utilize esta página quando precisar preparar os produtos da sua loja WooCommerce para emissão de NF-e pelo Base ERP.
Alguns cenários comuns incluem:
- cadastrar no Base ERP os produtos vendidos no WooCommerce;
- vincular produtos do WooCommerce aos produtos correspondentes no Base ERP;
- localizar o Identificador Interno do Produto no Base ERP;
- informar o ID do produto do Base ERP dentro do cadastro do produto no WooCommerce;
- revisar informações fiscais necessárias para emissão de NF-e;
- evitar falhas de identificação de produtos no processo de emissão;
- validar o fluxo antes de utilizar o plugin em Produção.
Como funciona o vínculo de produtos
Para que o Base ERP identifique corretamente qual produto foi vendido no WooCommerce, é necessário criar um vínculo entre os dois sistemas.
Esse vínculo é feito por meio do Identificador Interno do Produto, gerado automaticamente no Base ERP após o cadastro do item.
Fluxo geral:
Cadastrar produto no Base ERP
↓
Localizar o Identificador Interno do Produto
↓
Acessar o produto correspondente no WooCommerce
↓
Informar o ID do Base ERP no campo indicado
↓
Salvar o produto no WooCommerce
↓
Validar se o vínculo foi realizado corretamenteFonte da verdade para estoque
Nesta versão do plugin, o estoque não é sincronizado automaticamente entre WooCommerce e Base ERP.
Por isso, considere a seguinte regra operacional:
| Informação | Sistema recomendado |
|---|---|
| Controle de estoque | WooCommerce |
| Disponibilidade de produto na loja | WooCommerce |
| Cadastro fiscal do produto | Base ERP |
| Dados usados para emissão de NF-e | Base ERP |
| Vínculo entre produto vendido e produto fiscal | WooCommerce e Base ERP |
Estoque no Base ERPAo cadastrar um produto no Base ERP, você pode deixar o estoque zerado.
Isso não causa indisponibilidade na emissão de notas fiscais, já que o controle de estoque não interfere nessa etapa nesta versão do plugin.
O que virá nas próximas versões?
Estamos trabalhando para que, em futuras atualizações, o plugin ofereça sincronização automática de estoque entre WooCommerce e Base ERP.
Assim, toda movimentação de produtos poderá ser atualizada em tempo real nas duas plataformas.
Enquanto a sincronização automática não estiver disponível, mantenha os controles operacionais de estoque e expedição no WooCommerce.
Atributos importantes do produto
Durante o cadastro e vínculo dos produtos, alguns campos merecem atenção especial.
| Campo ou atributo | Onde verificar | Por que é importante |
|---|---|---|
| Nome do produto | WooCommerce e Base ERP | Ajuda a identificar o produto correspondente nos dois sistemas. |
| SKU | WooCommerce e Base ERP, quando utilizado | Facilita conciliação interna, conferência de pedidos e identificação operacional. |
| Identificador Interno do Produto | Base ERP | É o código usado para vincular o produto do Base ERP ao produto do WooCommerce. |
| Dados fiscais | Base ERP | Impactam diretamente a emissão correta da NF-e. |
| CFOP | Base ERP | Deve estar correto conforme a operação fiscal. |
| Impostos | Base ERP | Informações incorretas podem causar falhas ou inconsistências na nota fiscal. |
| Tipo de item | Base ERP | Ajuda a classificar corretamente o produto ou serviço cadastrado. |
| Produto correspondente | WooCommerce | Produto da loja que receberá o ID interno do Base ERP. |
Boa práticaO Identificador Interno do Produto é o campo principal para o vínculo com o WooCommerce.
Campos como nome e SKU ajudam na conferência, mas não substituem o vínculo pelo ID interno do produto do Base ERP.
Cadastrando seus produtos no Base ERP
Para que a emissão de notas fiscais funcione corretamente, é necessário replicar seus produtos do WooCommerce dentro do Base ERP.
Siga o passo a passo abaixo:
-
Acesse o Base ERP.
Vá até o módulo Comercial > Produtos e Serviços.
-
Adicione um novo produto ou serviço.
Clique no botão Adicionar Produto/Serviço.
-
Preencha as informações obrigatórias.
Os campos obrigatórios são identificados pelo ícone de papel próximo ao nome do campo.
DicaVerifique também as abas Estoque, Fiscal, Composição e Anexos.
As informações fiscais do produto devem estar corretas para evitar inconsistências na emissão da NF-e.
-
Salve o cadastro.
Após preencher todos os campos necessários, clique em Salvar para concluir o cadastro.
Vinculando seus produtos entre o Base ERP e o WooCommerce
Com o produto já cadastrado no Base ERP, o próximo passo é fazer o vínculo entre o item do ERP e o produto correspondente no WooCommerce.
Esse vínculo é essencial para que o Base ERP identifique corretamente qual produto está sendo vendido no seu e-commerce.
Siga o passo a passo abaixo:
-
Localize o ID interno do produto no Base ERP.
Após salvar o cadastro, o sistema gera automaticamente um número de identificação interno.
Esse código é exibido no campo Identificador Interno do Produto.
Copie esse número.
-
Acesse o painel do WooCommerce.
No painel administrativo do WordPress, vá até:
Produtos > Todos os Produtos
Caso o item ainda não exista, acesse Adicionar Produto.
-
Edite o produto correspondente.
Localize o produto vendido na loja e abra a edição.
-
Cole o ID do Base ERP.
Dentro da aba Dados do Produto, selecione a seção Base ERP.
No campo indicado, cole o Identificador Interno do Produto que você copiou do Base ERP.
-
Salve as alterações.
Clique em Atualizar ou Publicar, caso seja um novo produto.
Pronto! Seu produto está vinculado entre o WooCommerce e o Base ERP.
Resumo do processo
| Etapa | Onde fazer | O que fazer |
|---|---|---|
| 1. Cadastro de produtos | Base ERP | Adicione o produto com as informações obrigatórias. |
| 2. Revisão fiscal | Base ERP | Confira dados fiscais, impostos e CFOPs. |
| 3. Localizar ID interno | Base ERP | Copie o Identificador Interno do Produto. |
| 4. Vincular produto | WooCommerce | Cole o ID no campo Base ERP do produto correspondente. |
| 5. Validar vínculo | WooCommerce e Base ERP | Confira se o produto correto foi relacionado entre os sistemas. |
Exemplo prático
Imagine que sua loja WooCommerce venda o produto Camiseta Azul Básica.
Para que esse produto possa ser usado no fluxo de emissão de NF-e pelo Base ERP:
Produto vendido no WooCommerce: Camiseta Azul Básica
↓
Produto cadastrado no Base ERP: Camiseta Azul Básica
↓
Base ERP gera o Identificador Interno do Produto
↓
ID interno é copiado do Base ERP
↓
ID é colado no produto correspondente no WooCommerce
↓
Produto passa a estar vinculado para o fluxo de emissão de NF-eEssa associação evita que o pedido seja processado sem identificação correta do produto fiscal correspondente.
Comportamentos importantes
Ao utilizar o cadastro e vínculo de produtos, considere que:
- o plugin não sincroniza automaticamente produtos entre WooCommerce e Base ERP;
- o plugin não sincroniza automaticamente estoque entre os sistemas;
- o WooCommerce continua controlando disponibilidade e estoque da loja;
- o Base ERP mantém o cadastro fiscal necessário para emissão da NF-e;
- cada produto vendido no WooCommerce precisa estar vinculado ao produto correspondente no Base ERP;
- produtos sem vínculo podem não ser identificados no processo de emissão;
- alterações feitas no produto em um sistema não atualizam automaticamente o outro;
- o nome e o SKU ajudam na conferência, mas o vínculo depende do ID interno do produto do Base ERP;
- dados fiscais incorretos podem impactar a emissão da nota fiscal;
- produtos com variações devem ser conferidos com atenção para evitar vínculo incorreto.
Impactos operacionais
A ausência de sincronização automática exige alguns cuidados operacionais.
Alguns impactos importantes:
- o estoque deve ser controlado no WooCommerce;
- alterações de estoque no Base ERP não devem ser consideradas como atualização automática da loja;
- a expedição do pedido deve seguir o fluxo operacional definido no WooCommerce;
- relatórios internos precisam considerar que os cadastros de produto existem em dois sistemas;
- divergências entre nome, SKU ou cadastro fiscal podem dificultar conciliações;
- produtos não vinculados podem atrasar ou impedir o fluxo de emissão de NF-e;
- alterações fiscais feitas no Base ERP devem ser revisadas antes da emissão;
- equipes de operação, fiscal e e-commerce devem estar alinhadas sobre qual sistema controla cada informação.
AtençãoEnquanto não houver sincronização automática, mantenha um controle interno dos produtos já cadastrados e vinculados.
Isso ajuda a evitar duplicidade de cadastro, vínculo incorreto e falhas na emissão de NF-e.
Boas práticas e observações
Para uma operação mais segura, recomenda-se:
- manter os nomes dos produtos iguais ou facilmente identificáveis no WooCommerce e no Base ERP;
- utilizar SKU para facilitar conferências internas, quando aplicável;
- manter uma planilha ou controle interno com produto WooCommerce, SKU e Identificador Interno do Produto no Base ERP;
- revisar as informações fiscais antes de iniciar a emissão em Produção;
- validar impostos e CFOPs no Base ERP;
- evitar cadastrar o mesmo produto mais de uma vez no Base ERP;
- conferir produtos com variações antes de realizar o vínculo;
- testar o fluxo em Sandbox antes de utilizar em Produção;
- manter o controle de estoque no WooCommerce;
- revisar periodicamente os produtos vinculados.
Erros e dúvidas comuns
| Situação | Possível causa | Como agir |
|---|---|---|
| Produto não aparece no Base ERP | Produto ainda não foi cadastrado no ERP | Cadastre o produto em Comercial > Produtos e Serviços |
| Produto não é identificado no fluxo de emissão | Produto do WooCommerce não está vinculado ao produto do Base ERP | Copie o Identificador Interno do Produto no Base ERP e informe no WooCommerce |
| Estoque divergente entre sistemas | Não há sincronização automática de estoque nesta versão | Controle o estoque pelo WooCommerce |
| NF-e com dados incorretos | Informações fiscais incorretas ou incompletas no Base ERP | Revise as abas fiscais do produto no Base ERP |
| Produto duplicado no Base ERP | Produto cadastrado mais de uma vez | Revise os cadastros antes de criar um novo produto |
| Produto com variação vinculado incorretamente | ID interno informado no item errado do WooCommerce | Confirme se o ID pertence ao produto ou variação correta |
| Pedido não segue para emissão corretamente | Produto vendido não possui vínculo com o Base ERP | Verifique o cadastro do produto no WooCommerce e o ID interno informado |
Checklist de validação
Antes de iniciar a emissão de NF-e em Produção, valide:
- se todos os produtos vendidos no WooCommerce foram cadastrados no Base ERP;
- se o Identificador Interno do Produto foi copiado corretamente;
- se o ID foi informado no produto correspondente no WooCommerce;
- se nomes e SKUs facilitam a identificação entre os sistemas;
- se os dados fiscais foram revisados no Base ERP;
- se CFOPs e impostos foram conferidos;
- se produtos com variação foram vinculados corretamente;
- se o estoque continua sendo controlado pelo WooCommerce;
- se a equipe responsável entende que não há sincronização automática nesta versão;
- se o fluxo foi testado em Sandbox antes de ser usado em Produção.
Próximo passo
Após cadastrar e vincular os produtos, valide se o fluxo de emissão de NF-e está funcionando conforme esperado.
Cadastrar produto no Base ERP
↓
Revisar dados fiscais
↓
Copiar Identificador Interno do Produto
↓
Informar ID no produto correspondente do WooCommerce
↓
Salvar alterações
↓
Testar fluxo de emissão de NF-e