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.

📘

Importante

O 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 corretamente

Fonte 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çãoSistema recomendado
Controle de estoqueWooCommerce
Disponibilidade de produto na lojaWooCommerce
Cadastro fiscal do produtoBase ERP
Dados usados para emissão de NF-eBase ERP
Vínculo entre produto vendido e produto fiscalWooCommerce e Base ERP
🚧

Estoque no Base ERP

Ao 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 atributoOnde verificarPor que é importante
Nome do produtoWooCommerce e Base ERPAjuda a identificar o produto correspondente nos dois sistemas.
SKUWooCommerce e Base ERP, quando utilizadoFacilita conciliação interna, conferência de pedidos e identificação operacional.
Identificador Interno do ProdutoBase ERPÉ o código usado para vincular o produto do Base ERP ao produto do WooCommerce.
Dados fiscaisBase ERPImpactam diretamente a emissão correta da NF-e.
CFOPBase ERPDeve estar correto conforme a operação fiscal.
ImpostosBase ERPInformações incorretas podem causar falhas ou inconsistências na nota fiscal.
Tipo de itemBase ERPAjuda a classificar corretamente o produto ou serviço cadastrado.
Produto correspondenteWooCommerceProduto da loja que receberá o ID interno do Base ERP.
📘

Boa prática

O 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:

  1. Acesse o Base ERP.

    Vá até o módulo Comercial > Produtos e Serviços.

  2. Adicione um novo produto ou serviço.

    Clique no botão Adicionar Produto/Serviço.

  3. Preencha as informações obrigatórias.

    Os campos obrigatórios são identificados pelo ícone de papel próximo ao nome do campo.

📘

Dica

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

  1. 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:

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


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

  2. Edite o produto correspondente.

    Localize o produto vendido na loja e abra a edição.

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

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

EtapaOnde fazerO que fazer
1. Cadastro de produtosBase ERPAdicione o produto com as informações obrigatórias.
2. Revisão fiscalBase ERPConfira dados fiscais, impostos e CFOPs.
3. Localizar ID internoBase ERPCopie o Identificador Interno do Produto.
4. Vincular produtoWooCommerceCole o ID no campo Base ERP do produto correspondente.
5. Validar vínculoWooCommerce e Base ERPConfira 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-e

Essa 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ção

Enquanto 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çãoPossível causaComo agir
Produto não aparece no Base ERPProduto ainda não foi cadastrado no ERPCadastre o produto em Comercial > Produtos e Serviços
Produto não é identificado no fluxo de emissãoProduto do WooCommerce não está vinculado ao produto do Base ERPCopie o Identificador Interno do Produto no Base ERP e informe no WooCommerce
Estoque divergente entre sistemasNão há sincronização automática de estoque nesta versãoControle o estoque pelo WooCommerce
NF-e com dados incorretosInformações fiscais incorretas ou incompletas no Base ERPRevise as abas fiscais do produto no Base ERP
Produto duplicado no Base ERPProduto cadastrado mais de uma vezRevise os cadastros antes de criar um novo produto
Produto com variação vinculado incorretamenteID interno informado no item errado do WooCommerceConfirme se o ID pertence ao produto ou variação correta
Pedido não segue para emissão corretamenteProduto vendido não possui vínculo com o Base ERPVerifique 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