Como integrar o ERP com o Magento
O que é a integração
O Magento é uma plataforma de e-commerce que está disponível para integração com o ERP da Olist.
Através da integração você consegue obter melhor controle de estoque, gerenciar seus pedidos de vendas, automatizar a emissão de notas fiscais, dentre outras funcionalidades.
Recursos disponíveis
| Receber pedidos | ✔ |
| Receber produtos | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
| OMS | ✔ |
Configurando a integração
Atenção: para versões Magento diferentes de 1.9, 2.0 e 2.3, sugerimos que efetue testes de fluxo, a fim de validar que a integração ocorra corretamente.
Acesse o Painel de administração da sua loja Magento.
No menu System , opção WebServices , deve ser criado um papel (Role ou SOAP/XML-RPC - Roles).
Na tela a seguir, acesse Add new role para criar o papel que deve ser vinculado ao usuário.
No campo Role Name , informe a descrição. Abaixo, deve-se informar a senha do administrador e após salve no botão Save role.
Agora em Role resources , atribua todas as funções no campo Resource Access. Após isso salve em Save role.
Ainda no painel de administração da sua loja Magento. Para criar o usuário, acesse menu System , opção WebServices , deve ser criado um usuário ( Users ou SOAP/XML-RPC - Users ).
A seguir, acesse no botão Add New User , para incluir o usuário.
Preencha os Dados referentes ao usuário e após salve no botão Save User.
Observações:
- Current Admin Password: deve informar a senha do administrador do painel de administração da sua loja Magento.
- API Key: informe a senha de acesso ao usuário que esta cadastrando.
- API Key Confirmation: repita a senha do usuário informada no campo "API Key".
Após ter salvo o usuário, deve vincular o mesmo ao papel de administrar, realizado no Passo 2. Para isso, acesse User role e marque a opção Admin e salve em Save User.
Após realizar a permissão da conexão do ERP na plataforma, acesse o artigo Como configurar uma integração para verificar as informações de conexão dentro do ERP. Após concluir a conexão, retorne para esse artigo para prosseguir com as configurações da integração.
Configurações da integração
Sincronização de produtos
| Enviar imagens dos produtos ao sincronizar | Selecione umas das opções disponíveis para que as imagens do produto, no ERP, sejam enviadas para o e-commerce. |
|---|---|
| Enviar imagens do produto pai nas variações | Habilite essa opção para que ao enviar um produto para o e-commerce, as imagens do produto pai sejam enviadas para as variações que não possuem imagens. |
| Ao importar produtos | Selecione umas das opções disponíveis para que o ERP receba, em cadastro de produto, as imagens dos produtos importados do e-commerce. |
| Enviar categoria na atualização do produto | Habilite essa opção para que a categoria do produto seja enviada ao atualizar os produtos já existentes no e-commerce. |
| Na importação de produtos, ao atualizar um produto, atualizar o código (SKU) | Habilite essa opção para que o código SKU do produto do produto seja importado para o ERP, ao atualizar os produtos. |
| Envio e importação de produtos com variações (beta) |
Habilite essa opção para que os produtos com variações sejam enviados e importados. * Configuração válida apenas para loja virtual com versão igual a 2.3 |
| Atualizar o produto em todos os escopos |
Habilite essa opção para que os produtos sejam atualizados em todos os store modes. * Configuração válida apenas para loja virtual com versão igual a 2.3 |
Sincronização de pedidos
| Sincronização automática de pedidos | Habilite essa opção para utilizar o recurso de OMS na integração com seu e-commerce. Saiba mais sobre o recurso em OMS. |
|---|---|
| Importar valor do frete nos pedidos | Habilite essa opção para importar o valor do frete na importação dos pedidos. |
| Importar forma de recebimento nos pedidos | Habilite a opção para receber a forma de recebimento na importação dos pedidos. A configuração das formas de recebimento devem ser realizadas na aba formas de recebimento. |
| Importar campo "shipping_description" como: | Selecione entre as opções transportadora ou transportadora + prazo de entrega para definir o local da informação. |
| Importar transportadora ou forma de frete | Habilite essa opção para que a forma de frete de transportadora seja importada para o ERP. |
| Shipping Carrier para envio de código de rastreio |
Preencha esse campo para que o código de rastreio do ERP seja enviado para a loja virtual. * Esta informação é obtida no campo Shipping Carrier da sua loja virtual. |
| Enviar rastreamento ao alterar a situação no ERP para enviado | Habilite este parâmetro para que o código de rastreio seja automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para Enviado. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos. |
| Formatar nome dos contatos no recebimento dos pedidos | Habilite este campo para que o nome do cliente, ao importar os pedidos, será formatado com as iniciais maiúsculas em seu Nome e Sobrenome. |
| Importar campo COMPANY quando cliente for pessoa jurídica |
Habilite essa opção para que o campo "company" seja importado para o ERP sempre que o cliente for pessoa jurídica. Quando desabilitado, as informações importadas serão os campos firstname e lastname. |
| Completar endereço do cliente a partir do CEP na importação de pedidos |
Habilite essa opção para que o endereço do cliente seja preenchido no ERP, ao importar os pedidos, de acordo com a opção escolhida * Escolhendo a opção Sempre, o CEP sempre será validado junto ao Correios para preenchimento do endereço do cliente. Assim, os dados de endereço obtidos na plataforma de e-commerce serão ignorados. |
| Adicionar o endereço do cliente nas observações da venda | Habilite esta opção para adicionar o endereço do cliente nas observações da venda, ao importar o pedido do e-commerce. |
| Inclui observação no pedido do Magento com o número da nota fiscal ou venda | Habilite essa opção para que os números da nota fiscal ou da venda sejam incluídos na observação do pedido. |
| Enviar e-mail, através da plataforma, ao enviar rastreamento ao Magento | Habilite essa opção para que, ao enviar o rastreamento para a plataforma, um e-mail seja enviado. |
Notificações por e-mail
| Enviar e-mail de entrega ao alterar a situação no ERP para entregue | Habilite esse parâmetro para que, sempre que um pedido for alterado para a situação entregue no ERP, um e-mail será enviado de forma automática, conforme layout estabelecido nas configurações da expedição. |
|---|
Configurações adicionais
| Envio de dados da NFe | Selecione esta opção para enviar os dados na NFe ao e-commerce. Para envio manual consulte maiores informações em Enviar dados da NFe ao e-commerce (Manual). |
|---|---|
| Layout da mensagem do envio de dados da NFe | Preencha a caixa de texto para configurar a mensagem do envio de dados da NFe. |
Observação:
As informações enviadas pelo campo envio de dados da NFe são: XML da NFe, chave de acesso da NFe, data de envio, número, série e CFOP do primeiro item da NFe.
- Na aba estoque, defina as regras de estoque para a integração.
| Atualizar estoque na loja virtual a partir do ERP | Selecione umas opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque). |
|---|---|
| Depósito a ser considerado na integração | Selecione o depósito padrão para: importar pedido, importar produtos e enviar estoque. * O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada. |
| Estoque mínimo | Selecione umas das opções disponíveis para envio da informação de produtos com estoque mínimo ao e-commerce: enviar para quantidade mínima para exibir produto como disponível (min_qty), enviar para quantidade mínima para notificar estoque baixo (notify_stock_qty) ou não enviar. |
| Produto sempre em estoque no Magento | Habilite esse parâmetro para os produtos manterem estoque na plataforma. |
Na aba dados fiscais, selecione a informação natureza de operação para venda nesta integração. A natureza selecionada será atribuída de forma padrão na importação dos pedidos no ERP e no momento em que gerar a nota fiscal através do pedido importado.
Observações:
Você pode habilitar ou desabilitar o campo definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.
Lembre de verificar as informações da natureza de operação com a sua contabilidade.
- Na aba campos personalizados, caso sua loja virtual possua essas informações, preencha os campos que serão importados com os pedidos ou produtos, conforme as descrições do e-commerce.
- Atenção!
Estas informações somente devem ser preenchidas se a sua loja virtual foi alterada para incluir as mesmas.
Se você não efetuou alterações na sua loja para incluir as informações apresentadas, deixe-as em branco.
- Na aba gestão de preços, defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce:
- Preço fixo: conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
- Conforme regras de preço: trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
- Conforme lista de preços: utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar em listas de preços.
- Na aba categorias, relacione as categorias de produtos no ERP com as categorias do e-commerce, assim os produtos já serão enviados nas categorias mapeadas previamente.
Categorias já cadastradas serão apresentadas em categoria no ERP. Adicione o código da categoria no e-commerce clicando no botão configurar categoria no e-commerce
Observações:
- Caso ainda não possua categorias cadastradas em sua conta no ERP, verifique as instruções para inclusão de categorias em como cadastrar categorias de produtos.
- As instruções para vincular as categorias no cadastro de produtos, estão disponíveis em como cadastrar um produto simples.
- Na aba situações, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no ERP, assim como o fluxo da sequência das situações no ERP.
Adicione as situações presentes no e-commerce, clicando em adicionar situações padrão.
Para adicionar novas situações, clique em adicionar mapeamento de situação.
Para alterar a situação de um pedido para uma situação anterior à atual, habilite o campo permite retroceder situação dos pedidos na sincronização de situações, assim, por exemplo, um pedido enviado poderá voltar para a situação preparando Envio.
Em situações personalizadas, é possível adicionar filtros personalizados que serão exibidos na listagem dos pedidos do e-commerce, além dos status padrões, que já são preenchidos automaticamente.
Para adicionar novos filtros preencha os campos código da situação, descrição da situação e confirme a inclusão do filtro personalizado.
Observação:
Ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado terá a situação em aberto atribuída.
- Na aba formas de recebimento, pode-se relacionar as formas de recebimento dos seus pedidos da loja virtual com a forma de recebimento no ERP. Esta configuração fará com que suas contas a receber sejam geradas no ERP com as mesmas informações da plataforma.
Ao habilitar o parâmetro importar forma de recebimento nos pedidos, será possível relacionar as formas de pagamento presentes em sua plataforma com os respectivos destinos no ERP. Para isso, clique em adicionar forma de recebimento.
A seguir, no campo de forma de recebimento, selecione a forma de recebimento do ERPa ser relacionada com a da integração. No campo código na integração, clique sobre o botão relacionar forma de recebimento e selecione a forma de recebimento de sua plataforma que corresponderá à do ERP.
Se a forma de recebimento correspondente não for exibida, é possível buscar por pedido que possua a mesma forma de recebimento selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código.
Observação:
Ao adicionar as formas de recebimento selecionadas, o ERP busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de envio, acesse Formas de Recebimento.
Para confirmar o relacionamento, clique em relacionar.
No campo forma de recebimento padrão, defina a forma de recebimento que será utilizada sempre que o pedido importado não possua nenhuma forma relacionada.
- Na aba formas de frete, pode ser realizado o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no ERP.
Para isso, no campo forma de envio e forma de frete, selecione as formas que deseja mapear.
Em código na integração, clique no botão relacionar forma de frete. E, na listagem exibida, selecione a forma de envio correspondente em sua plataforma.
Se a forma de frete correspondente não for exibida, é possível obter por pedido que possua a mesma forma de frete selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código. Para confirmar o relacionamento, clique em relacionar.
Para adicionar novas formas de frete, clique em adicionar.
Observações:
- Ao adicionar as formas de frete selecionadas, o ERP busca as formas de envio já configuradas em sua conta. Para cadastro de novas formas de envio, consulte formas de envio.
- Para mapear as formas de frete da Frenet, acesse a ajuda mapear formas de frete Frenet.
- Na aba custos, são definidos os custos de comissão cobrados pelos pedidos do marketplace. Defina se a base de cálculo da comissão irá considerar o valor total da venda ou o total da venda sem o frete.
Observação:
A aba custos somente aparecerá com a extensão custos do e-commerce instalada.
Não esqueça de Salvar as configurações.
Como usar a integração no ERP
Após concluir as configurações ao ERP, acesse o artigo Como Usar uma integração no dia a dia para entender como trabalhar com a sua integração dentro da sua operação.
