Loja Integrada - Configurações

Pré-requisitos

• Disponível para os planos Iniciante, Começar, Básico, Crescer, Essencial, Evoluir, Grande e Potencializar.

O que é?

A Loja Integrada é uma plataforma de e-commerce, que está disponível para integração com o sistema de gestão da Olist. Com esta integração, você gerencia seus pedidos e catálogo de produtos. Além disso, os estoques serão atualizados automaticamente e os clientes relacionados aos pedidos vão ser importados para o Olist ERP.

Recursos disponíveis

Configurar na Loja Integrada

Gerar chave da sua conta da Loja Integrada para acesso via API

Acesse em sua conta na Loja Integrada, o menu Configurações → Chave para API e clique em Cadastrar nova chave.

No campo Identificação da chave insira a descrição de identificação (Ex: Olist ERP). Para gerar a chave de API, clique em Cadastrar e a chave estará disponível para você copiar.

Configurações no Olist ERP

Para realizar as configurações, acesse menu → início → integrações, clique em adicionar integração, busque por Loja Integrada e clique em instalar.

Deverá seguir as etapas de configuração, efetuando o preenchimento dos campos conforme:

Observação!

Por padrão, o sistema irá seguir um fluxo em etapas para conclusão das configurações da integração, e a mesma ficará disponível para utilização somente após o fluxo ser finalizado. Mas, se desejar, poderá interromper o preenchimento das informações, clicando em continuar depois, na parte inferior da tela e retomar a configuração de onde parou, em outro momento.

Etapa 1 - Conectar Integração

Neste primeiro momento, irá inserir os dados para estabelecer conexão entre o Olist ERP e Loja Integrada:

• Nome da integração no ERP: Este campo deve ser preenchido com o nome o qual deseja identificar esta integração no sistema. Será através deste nome que esta integração será listada nos menus da sua conta.
• Chave API: Este campo deve ser preenchido com a chave API que foi obtida no painel da Loja Integrada, conforme tópico acima.

Após preencher estes dados, clique em conectar com Loja Integrada, para seguir para a segunda etapa de configurações.

Etapa 2 - Produtos

Passo 1 - Regras de Estoque:

Neste tópico, irá definir quais são as suas preferências quanto ao comportamento do estoque em relação a esta integração:

• 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 Olist 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 Olist 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 Olist 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 Olist 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ê 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, poderá definir uma configuração padrão para lançamento de estoque automático, dos pedidos importados por esta 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:

Neste tópico, irá definir 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 Olist 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 Olist 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 nosso conteúdo: Configure os preços dos anúncios conforme as regras do e-commerce.

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

Passo 3 - Fluxo de Produtos:

Neste tópico, irá definir 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 Olist 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 Olist ERP com SKU diferente, o produto no ERP 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 para seguir para a etapa de pedidos de venda.

Etapa 3 - Pedidos

Passo 1 - Fluxo de Pedidos:

Neste tópico, irá definir 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 Olist ERP chegar na situação 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 Olist ERP chegar na situação 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 Olist 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 Olist 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 Olist ERP.
• A sincronização de situação sempre será com base na situação da plataforma. O Olist 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 Olist ERP 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 Olist 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 Olist 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 Olist ERP.

• + adicionar: Adiciona uma linha para mapear o identificador da forma de frete da plataforma com a correspondente no Olist 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 Olist ERP.
• Formatar nome dos contatos no recebimento dos pedidos: Se ativado, o nome do contato será formatado para um padrão (Ex: "José da Silva").
• 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 Olist 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 Olist ERP irá importar e mapear as grades automaticamente pela identificação do nome, que deve ser idêntico nas duas plataformas.

A integração da Loja Integrada com o Olist ERP facilita a gestão do e-commerce, permitindo a importação de pedidos, controle de estoque e preços, entre outras funcionalidades. Com essa integração, os lojistas podem otimizar suas operações, economizar tempo e melhorar a eficiência do seu negócio.

Para mais detalhes sobre a utilização da integração da Loja Integrada, acesse Loja Integrada - Utilização.