O que é a integração com a Loja Integrada

A Loja Integrada é uma plataforma de e-commerce que está disponível para a integração com o ERP da Olist.

Através da integração você consegue ter melhor controle de estoque, gerenciar pedidos de venda e automatizar a emissão de nota fiscal, tudo pelo ERP. Está disponível para todos os planos. 

Recursos disponíveis

Como instalar a integração passo a passo 

Para realizar a integração da Loja Integrada com o ERP, é necessário gerar uma chave de acesso através da plataforma de e-commerce para autorizar a integração com o ERP. O artigo Como configurar uma integração mostra como gerar uma chave de acesso.

Importante: o passo 3 no artigo é o que corresponde ao Gerar uma chave de acesso.

Como configurar no ERP

Após gerar a chave de acesso na plataforma da Loja Integrada, busque pelo e-commerce no ERP.

Através do artigo Como  configurar uma integração você encontra o passo a passo de como conectar o e-commerce ao ERP. Após buscar pela integração ao sistema é necessário preencher os campos obrigatórios para finalizar a conexão.

Nome da integração ao ERP.

Neste campo, insira o nome de identificação da sua loja no ERP.

Chave API.

Neste campo é necessário inserir a chave API obtida na plataforma da Loja Integrada.

Etapa 2 - Produtos

Passo 1 - Regras de Estoque:

Após finalizar a conexão do e-commerce ao ERP é necessário definir as regras de mapeamento da sua integração ao sistema.

Importante: caso você queira concluir as configurações em outro momento, basta clicar em Continuar depois, na parte inferior da tela.

Atualizar estoque na loja virtual a partir do ERP: Neste campo, você define a consideração de estoque, para sincronização com a plataforma.

• Não atualizar: Selecionando esta opção, o ERP não efetuará a sincronização de estoque automática para a plataforma. O controle de estoque do ERP e da plataforma serão separados e sem ligação, a não ser que você efetue manualmente o envio de estoque dos seus produtos para a plataforma.
• Enviar saldo físico: Escolhendo esta opção, sempre que o estoque dos produtos do ERP sofrer alteração, seja por entrada, saída ou balanço, será feita uma sincronização para a plataforma, enviando o saldo físico atual do produto.
• Enviar saldo disponível: Escolhendo esta opção, sempre que o estoque dos produtos do  ERP sofrer alteração, será feita uma sincronização para a plataforma, enviando o saldo disponível atual do produto. O saldo disponível é obtido a partir do saldo físico menos as reservas de estoque.

Observações!

• A opção Enviar saldo disponível é apresentada somente quando existe o módulo de Reservas de estoque instalado na conta.
• Para que a sincronização de estoque seja realizada corretamente, é necessário que os produtos do ERP estejam devidamente mapeados com os seus anúncios correspondentes na plataforma.
• Lançamentos de balanço de estoque gerados a partir de importações de produtos de plataformas, não geram sincronização de estoque automática.
• Depósito a ser considerado na integração: Neste campo você vai selecionar o depósito de estoque a ser considerado para esta integração nas sincronizações de estoque e nas importações de pedidos.
• Lançamento de estoque para saídas: Neste campo, você pode definir uma configuração padrão para lançamento de estoque automático dos pedidos importados nesta integração. Poderá escolher entre as opções:
  • Usar configuração padrão da conta: Esta opção define que a integração seguirá conforme a configuração de lançamento de estoque automático padrão da conta.
  • Manual: Esta opção define que os pedidos importados por esta integração não terão o estoque lançado automaticamente.
  • Automático ao autorizar a nota fiscal: Lançamento de estoque automático efetuado no momento em que a sua nota fiscal for autorizada junto a SEFAZ.
  • Automático ao salvar a nota fiscal: Lançamento de estoque automático efetuado no momento em que forem geradas e salvas as notas fiscais.
  • Automático ao salvar o pedido: Lançamento de estoque automático efetuado no momento em que os pedidos forem importados.
  • Automático ao marcar pedido como enviado: Lançamento de estoque automático efetuado no momento em que a situação do pedido for alterada para Enviado.
• Utilizar estoque de segurança: Este parâmetro possibilita que seja definida uma quantidade de estoque para ser considerada como saldo mínimo de segurança. Quando o produto atinge essa quantidade, as sincronizações de estoque para a plataforma serão com saldo 0.
  • Ativado: O sistema irá considerar a quantidade informada no campo Estoque de segurança.
  • Desativado: Não haverá consideração de estoque mínimo de segurança.

Observação!

Produtos sob encomenda não são abrangidos pelo parâmetro Utilizar estoque de segurança.

Por fim, após ajustar os campos conforme sua necessidade, clique em > salvar e avançar

Passo 2 - Preços: nessa etapa você define quais são as suas preferências quanto ao comportamento dos preços em relação a esta integração:

• Regra de utilização de preços para o e-commerce: Neste campo definimos a regra de preço considerada no envio e recepção de anúncios a partir desta integração.
  • Preço fixo: Ao enviar um anúncio para a plataforma, o preço será conforme o preço do produto cadastrado no ERP.
  • Conforme lista de preços: Ao enviar um anúncio, o preço será com base na lista de preço definida no campo Lista de preços utilizada nos produtos.
  • Conforme regras de preço: Você poderá definir uma regra de preço personalizada para esta integração.

Percentual de acréscimo ou desconto: Neste campo deve ser informado o percentual que será aplicado no valor de cadastro do produto no ERP para formar o preço final.

Adicional de frete: Neste campo, poderá adicionar regras para definir um valor adicional a ser aplicado ao preço do anúncio, correspondente ao frete.

Forma para aplicar os valores adicionais: Aqui, irá escolher a forma de consideração da base de cálculo para a aplicação dos valores adicionais:

• Base simples: Inclui o percentual e o adicional de frete na base de cálculo, porém não preserva o preço de cadastro do produto.
• Base por dentro: Inclui o percentual e o adicional de frete na base de cálculo e preserva o preço de cadastro do produto.

Para mais detalhes, acesse o artigo: Configuração de preços conforme regras do e-commerce.

Após configurar, clique em > salvar e avançar.

Passo 3 - Fluxo de Produtos:

Neste tópico, você define o comportamento dos anúncios em situações de envio e recepção:

• Ao importar produtos: Escolha o formato que irá receber as imagens ao importar os anúncios da plataforma para o ERP.
  • Importar imagens como anexos: Traz as imagens em formato de arquivo, anexadas ao cadastro do produto.
  • Apenas importar a URL externa das imagens: Traz as imagens em formato de URL, armazenada externamente.
• Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): Se ativado, quando um anúncio é importado e já existe no ERP com SKU diferente, o produto no sistema será atualizado com o SKU da plataforma. Se desativado, o SKU permanecerá sem alteração.

Observação:

Ao escolher Importar imagens como anexos, as imagens consumirão espaço de armazenamento do sistema.

Após definir suas preferências, clique em >salvar e avançar.

Etapa 3 - Pedidos

Passo 1 - Fluxo de Pedidos:

Neste tópico, você define o comportamento das sincronizações de informações dos pedidos:

• Importar valor do frete nos pedidos: Se habilitado, o valor de frete será importado nos pedidos de venda.
• Enviar rastreamento ao alterar a situação no ERP para enviado: Se habilitado, quando o pedido no ERP estiver como Enviado, o sistema enviará o código de rastreamento para a plataforma automaticamente.
• Marcar pedido como entregue ao alterar a situação no ERP: Se habilitado, quando o pedido no ERP estiver como Entregue, o sistema enviará esta situação para o pedido na plataforma.

Após ajustar os campos, clique em > salvar e avançar.

Passo 2 - Dados Fiscais:

Defina o comportamento dos dados fiscais dos pedidos:

• Natureza de operação para venda: Selecione a natureza de operação padrão para os pedidos importados.
• Definir natureza de operação diferente para destinatários contribuintes do ICMS: Se habilitado, pedidos onde o cliente é contribuinte serão salvos no ERP com a natureza de operação indicada no campo específico que aparecerá.

Após selecionar as opções, clique em >salvar e avançar.

Etapa 4 - Mapeamentos

Passo 1 - Situações de Pedido:

Neste tópico, você irá mapear as situações para sincronização dos pedidos de venda.

• Adicionar situações padrão: Ao clicar, serão listadas as situações padrões da plataforma para que você possa mapear com as situações correspondentes no ERP.

• Na coluna Código da situação no E-commerce são identificadas as situações da plataforma. Na coluna Situação no ERP devem ser indicadas as situações correspondentes.

Observações!

• O mapeamento é importante para a sincronização de situações dos pedidos da plataforma para o ERP.
• A sincronização de situação sempre será com base na situação da plataforma. O ERP não envia sincronização de situação do sistema para a plataforma.
• Permite retroceder situação dos pedidos na sincronização de situações: Se ativado, o sistema irá permitir que o pedido retorne para uma situação anterior.

Após realizar os mapeamentos, clique em > salvar e avançar.

Passo 2 - Formas de Recebimento:

Defina se os pedidos serão importados com a forma de recebimento e mapeie as formas da plataforma com as do ERP.

• Importar forma de recebimento nos pedidos: Ao habilitar, os pedidos serão importados com as informações das parcelas.
  • Forma de recebimento padrão: Selecione uma forma de recebimento padrão para pedidos que não possuírem a forma mapeada.
  • + adicionar forma de recebimento: Adiciona uma linha para mapear o identificador da forma de recebimento da plataforma com a correspondente no ERP.

• No campo Código na integração, clique no ícone 🔗 para buscar o identificador correspondente na plataforma.
• Se já souber o identificador, clique em informar código manualmente.

• Se não souber, pode usar um pedido já realizado para identificá-lo.

Observação!

Não é possível mapear mais de uma forma de recebimento do Olist ERP com um mesmo identificador.

Após configurar, clique em > salvar e avançar.

Passo 3 - Formas de Frete:

Mapeie as formas de frete da plataforma com as suas correspondentes no ERP.

• + adicionar: Adiciona uma linha para mapear o identificador da forma de frete da plataforma com a correspondente no ERP.

• Em Código na integração, clique no ícone 🔗 para buscar o identificador correspondente.
• Se já possuir o identificador, clique em informar código manualmente.

• Se não souber, pode usar um pedido já realizado para identificá-lo.

Por fim, após realizar todos os ajustes, clique em finalizar instalação.

O sistema abrirá uma tela com as opções importar produtos e concluir. Se deseja já importar seus anúncios, selecione a primeira opção. Caso contrário, clique em concluir.

Para verificar os campos adicionais, abra a integração para edição novamente.

Campos Adicionais

Produtos - Fluxo de Produtos:

• Exportar e importar o preço de custo: Ativando este parâmetro, o preço de custo será considerado na recepção ou envio de dados do produto.

Pedidos - Fluxo de Pedidos:

• Sincronização automática de pedidos: Se ativado, os pedidos serão importados automaticamente da plataforma para o ERP.
• Formatar nome dos contatos no recebimento dos pedidos: Se ativado, o nome do contato será formatado de forma padrão. 
• Adicionar o endereço do cliente nas observações da venda: Se ativado, o endereço do cliente aparecerá nas observações do pedido de venda.

Mapeamentos - Categorias:

O processo de mapeamento garante que as categorias do ERP fiquem vinculadas com as suas correspondentes na Loja Integrada.

Acesse as configurações da integração, em Mapeamentos → Categorias:

Existem duas formas de efetuar o processo:

• Manual: Clicando no ícone 🔗, serão apresentadas as categorias da sua Loja Integrada para você selecionar a correspondente.

• Importando as categorias da Loja Integrada: Clicando em importar categorias do e-commerce, as categorias serão importadas e vinculadas automaticamente pelo nome, que deve ser idêntico em ambas as plataformas.

Mapeamentos - Variações:

Para que os produtos com variações possam ser importados/exportados, é necessário que as grades de variação do Olist ERP estejam mapeadas com as suas correspondentes da Loja Integrada.

Acesse as configurações da integração, em Mapeamentos → Variações:

O processo pode ser feito de duas maneiras:

• Manual: Selecione manualmente, em cada grade e valor, a opção correspondente através dos campos Chave no e-commerce e Valor no e-commerce.

• Relacionando automaticamente pelo nome: Clicando em relacionar valores pelo nome, o  ERP irá importar e mapear as grades automaticamente pela identificação do nome, que deve ser idêntico nas duas plataformas.

Após finalizar as configurações da sua integração com o ERP é importante entender como utilizar a integração no dia a dia. Para isso, confira o artigo Como utilizar uma integração no dia a dia .