Como integrar o ERP com o WooCommerce
O que é a integração com o WooCommerce
Integração desenvolvida pelo ERP. Por meio dela, os pedidos e produtos do WooCommerce (plataforma de código aberto criada com WordPress) podem ser importados em sua conta no ERP.
A integração é compatível com as versões do WooCommerce de 2.2+ até 3.0+. Atualmente, a versão 7.0 não é compatível para integrar ao ERP. Acesse o site do WooCommerce.
Recursos disponíveis
| Receber pedidos | ✓ |
| Receber produtos | ✓ |
| Enviar produtos | ✓ |
| Enviar estoque | ✓ |
| Enviar preços | ✓ |
| Sincronizar situação | ✓ |
| OMS | ✓ |
Como instalar a integração passo a passo
- Para instalar, acesse menu > início > Integrações.
- Clique em adicionar integração, busque por WooCommerce e clique em instalar.
- No campo Nome da integração no ERP, informe o nome desejado.
- Preencha a URL da loja, o Consumer Key e o Consumer Secret.
- Na seção Autenticação, clique em conectar com WooCommerce.
Dica:
Para gerar as chaves necessárias para a integração, acesse em sua loja WooCommerce: Users > Your Profile, marque Generate API Key e clique em Update Profile. Copie os valores Consumer Key e Consumer Secret para os respectivos campos no ERP.
Para a API Rest do WooCommerce funcionar, é necessário que os links sejam Restful. Na sua loja WooCommerce, em Settings > Permalinks, altere para Day and name.
Para mais informações, acesse: Tutorial para geração de chaves WooCommerce.
Como configurar no ERP
Ao finalizar a instalação e autenticação da conta do ERP, siga com o ajuste das configurações, conforme o artigo Como configurar uma integração e as especificações listadas abaixo.
Especificidades na configuração da integração
Sincronização de produtos
- Enviar imagens dos produtos ao sincronizar: escolha entre Sim ou Apenas para novos produtos para enviar as imagens quando houver o envio para WooCommerce.
- Ao importar produtos: defina se as imagens serão consideradas como Anexos (Importar imagens como anexos) ou se será importada apenas a URL das imagens (Apenas importar a URL externa das imagens).
- Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): habilite este campo para atualizar o Código (SKU) sempre que os produtos forem importados do e-commerce.
- Enviar categoria no envio de produtos: selecione Sim para que, ao enviar os produtos do ERP ao e-commerce, a categoria também seja enviada. O ERP envia apenas uma categoria por produto.
Sincronização de pedidos
- Importar forma de recebimento nos pedidos: habilite para receber a forma de recebimento na importação. A configuração deve ser feita na aba Formas de recebimento.
- Importar valor do frete nos pedidos: ative se desejar importar o valor do frete.
- Enviar rastreamento ao alterar a situação no ERP para enviado: se ativo, quando o pedido mudar para Enviado no ERP, o código de rastreio é enviado automaticamente para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
- Marcar pedido como entregue ao alterar a situação no ERP: ao habilitar, a alteração para Entregue no ERP muda o status na plataforma.
- Completar endereço do cliente a partir do CEP na importação de pedidos: escolha Sempre para que o CEP seja validado nos Correios, ignorando os dados de endereço da plataforma de e-coomerce.
- Formatar nome dos contatos no recebimento dos pedidos: ajusta o nome do cliente com iniciais maiúsculas no Nome e Sobrenome.
- Adicionar o endereço do cliente nas observações da venda: adiciona o endereço do cliente nas observações ao importar o pedido.
- Campo relacionado ao número do pedido na plataforma: escolha como o número será importado no ERP: Número ou Identificador.
- Marcar pedido como enviado ao enviar o código de rastreio: o pedido é marcado como enviado assim que o código de rastreio for transmitido.
- Importar valor de taxa nos pedidos: habilite para que as informações do campo fee_lines sejam consideradas despesas no pedido.
Notificações por e-mail
- Enviar rastreamento ao alterar a situação no ERP para enviado: o envio do código ocorre automaticamente quando o status muda para Enviado.
- Enviar e-mail de entrega ao alterar a situação no ERP para entregue: Quando o status no ERP for Entregue, um e-mail é enviado ao destinatário.
Campos personalizados e categorias
Na aba Campos personalizados, mapeie os dados que serão importados para o ERP preenchendo as descrições conforme o e-commerce:
- CNPJ: informe cnpj.
- CPF: informe cpf.
- Bairro: informe neighborhood.
- Número: informe number.
- IE: informe ie.
Caso ainda não possua categorias cadastradas em sua conta no ERP, as instruções para incluir categorias estão disponíveis em Como cadastrar categorias de produtos.
As instruções pra vincular as categorias no cadastro de produtos, estão disponíveis em Como cadastrar um produto.
Como usar o ERP com o WooCommerce
Acesse o artigo Como usar uma integração no dia a dia para saber mais sobre o uso e descobrir como aproveitar ao máximo a integração.
Especificidades no uso da integração
Enviar código de rastreio
Para realizar o envio, certifique-se de que o transportador (Correios ou Transportadora) esteja informado no pedido de venda ou na nota fiscal. Além disso, é necessário ter gerado o agrupamento (PLP ou Coleta) no módulo de expedição.
- Acesse o menu vendas > Expedição.
- Filtre pela forma de envio desejada (ex: Correios).
- Clique na aba concluídas.
- No menu de contexto (três pontos) ao lado da expedição gerada, clique em enviar código de rastreio para o e-commerce.
Observação: além do envio do código de rastreio, também é atualizada a situação do pedido para Enviado no WooCommerce. Para isso, acontecer é necessário que na configuração da integração tenha realizado o mapeamento das situações dos pedidos do e-commerce com o ERP, inclusive a situação Enviado.
Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado ao WooCommerce.
Marcar pedidos como entregues
Ao marcar os pedidos como entregues no ERP, o status será sincronizado automaticamente como Entregue no WooCommerce.
- Acesse menu > vendas > Expedição.
- Filtre pela forma de envio utilizada.
- Clique na aba concluídas.
- No menu de contexto ao lado da expedição gerada, clique em marcar pedidos como entregue.
Após concluir esses passos, um Marcador será adicionado à expedição para identificar que a venda foi sincronizada com sucesso na plataforma.
Importação automática (OMS)
- No ERP, acesse a configuração da integração e clique em Gerar link para usar a importação automática de pedidos. Copie a URL.

- No painel do WooCommerce, acesse WooCommerce > Configurações > Aba Avançado > Webhooks > Adicionar webhook.

- Preencha:
- Nome: descrição do webhook.
- Status: opção Sim.
- Tópico: a situação dos pedidos a serem importados, entre as opções: Pedido Criado ou Pedido Atualizado.
- URL de entrega: cole o link gerado no ERP.
- Versão da API: Integração com WP REST API v2.
- Clique em Salvar webhook.
Observação: o campo Segredo será preenchido automaticamente quando Salvar o webhook. Não é necessário preencher neste momento.

Pronto! Com o webhook criado na WooCommere você já pode utilizar o serviço de OMS em sua conta no ERP.
Mapeamento de frete Frenet
- Acesse o painel administrativo da Frenet com seu Usuário e Senha.
- No menu lateral, acesse a opção Transportadoras. Serão listadas todas as transportadoras disponíveis. Aquelas já integradas ao seu e-commerce possuem um marcador em destaque, conforme imagem abaixo:

- Acesse a transportadora desejada para localizar o código do serviço.

- Na lista de serviços de entrega ativos, identifique e anote o Código do serviço, conforme imagem abaixo:

- Agora, no seu ERP, acesse menu > configurações > aba e-commerce > Integrações e clique sobre a sua integração.
- Na aba Formas de frete, clique em adicionar mapeamento de frete.
- No campo Código no e-commerce, insira o código localizado no painel da Frenet.
- Ao lado, em Forma de envio, selecione a forma de frete correspondente (caso não exista, será necessário cadastrar uma nova forma de envio).
- A Forma de frete será preenchida automaticamente conforme o cadastro da forma de envio selecionada.

- Clique em salvar.
Dicas e informações adicionais
- Exclusão de mapeamentos: caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse configurações > aba e-commerce > Integrações, na integração desejada, clique em mais ações > excluir todos os anúncios no ERP. Esta ação, depois de concluída, não poderá ser desfeita.
- Envio de produtos: atualmente, é possível enviar produtos do ERP para o WooCommerce a partir da versão 3.0.
- Frete: a forma de frete presente no pedido no WooCommerce é enviada ao ERP no momento da importação dos pedidos.
- Cadastro de produto via pedido: após importar um pedido, é possível realizar o cadastro do produto no ERP através do lançamento de estoque, disponível no menu de contexto, localizado ao lado do pedido ou da nota. Botão lançar estoque.
- Importação por planilha: se desejar, você pode realizar a importação através de planilha de acordo com o nosso layout disponibilizado em Importador de produtos.
- Cadastro de clientes: sempre que um pedido é importado, o cliente automaticamente é cadastrado em cadastros > Clientes e Fornecedores.