Shopee - Como integrar no ERP
A integração com a Shopee foi desenvolvida pelo ERP da Olist, com importação de pedidos e produtos, além de sincronização de produtos e estoque.
Assista ao vídeo e confira o passo a passo na sequência:
Recursos disponíveis
Confira o que você pode gerenciar diretamente pelo ERP da Olist nesta integração:
| Receber pedidos |
✓ |
| Enviar produtos |
✓ |
| Enviar estoque |
✓ |
| Enviar preços |
✓ |
| Sincronizar situação |
✓ |
| OMS |
✓ |
Como instalar a integração
Para integrar a Shopee no menu do ERP siga o caminho abaixo:
- Acesse menu > início > Integrações.
- Clique em adicionar integração, busque por Shopee e clique em instalar.
Como configurar no ERP
Organizamos as explicações de cada parâmetro divididas pelas mesmas abas que você encontra na tela de integração do seu ERP.
Selecione a aba desejada para ver a explicação e orientação de cada parâmetro:
Conexão
Após localizar e instalar a integração, o próximo passo é estabelecer a autenticação entre a Shopee e o ERP permitindo que a troca de informações aconteça de forma segura e automática entre as plataformas.
-
Nome da integração no ERP: Defina um nome padrão ou específico para identificar essa conta da Shopee no ERP da Olist.
- Autenticação: A conexão da Shopee acontece por meio do usuário e senha (padrão). Insira suas credenciais habituais (o mesmo e-mail/usuário e senha) que você usa para acessar sua conta de vendedor da Shopee.
- Clique no botão conectar com Shopee. Conclua a autorização do aplicativo na plataforma.
- Após autorizar o aplicativo, a página será redirecionada para a página do ERP.
- Faça o login na conta desejada do ERP.
Produtos
Esta aba gerencia como o ERP troca dados de catálogo com a Shopee.
Abra os blocos abaixo para conferir as etapas de configuração desta tela:
Passo 1: Regras de Estoque
Parâmetros para definir as regras de estoque que serão consideradas na integração.
Atualizar estoque na loja virtual a partir do ERP
Defina qual saldo do ERP deve ser enviado para atualizar o estoque da integração.
- Não atualizar: O ERP não enviará nenhuma atualização de estoque para este canal.
Atenção: Recomendamos esta opção se você estiver em período de testes, configuração inicial do sistema ou se utiliza outra ferramenta externa para controlar seu estoque.
-
Enviar saldo físico: Envia para o canal de venda a quantidade bruta cadastrada no ERP, sem descontar as vendas que acabaram de acontecer e ainda estão sendo processadas.
- Enviar saldo disponível: Envia para o canal de venda apenas o estoque livre para novas vendas. O sistema pega a quantidade total (Saldo Físico) e subtrai as reservas de pedidos que ainda não foram aprovados. (Recomendado)
Depósito a ser considerado na integração
Neste campo, você define qual depósito do seu ERP fornecerá as quantidades de estoque para o canal de venda.
-
Geral: Escolha essa opção se você possui apenas um estoque.
- Todos os próprios: Escolha se você possui (ou pretende ter) mais de um depósito e quer somar o estoque desses depósitos (considerados como próprios).
Observação: se sua conta é nova, as duas opções acima geram o mesmo resultado
Atenção: Caso queira criar um depósito específico para atender a sua operação da Shopee, é necessário cadastrá-lo previamente no ERP para que essa opção apareça nesta listagem. Para mais informações, acesse: Como controlar estoques de vários depósitos.
Observação: O campo depósito de estoque a ser considerado na integração será exibido apenas nas contas que possuem a extensão “Depósitos de estoque” instalada.
Lançamento de estoque para saídas
Defina a regra para lançamento de estoque dos pedidos importados por meio desta integração. Escolha entre as opções:
- Usar configuração padrão da conta: Adota a regra inicial do sistema, que vem definida por padrão como Manual.
Atenção: Se você deseja usar esta opção acima, recomendamos que antes mude a regra geral em Configurações de estoque para um modo automático. Como o padrão do sistema é manual, se você não fizer esse ajuste prévio, seu estoque não atualizará automaticamente na Shopee gerando furos de estoque.
- Manual: A baixa de estoque não é automática. Você precisará acessar o pedido no ERP e realizar o lançamento manualmente. Essa opção não é recomendada pois aumenta o risco de furos e rupturas de estoque.
-
Automático ao autorizar a nota fiscal: O sistema baixa o estoque assim que a Nota Fiscal (NF-e) é autorizada pela SEFAZ. (Recomendado)
-
Automático ao salvar a nota fiscal: O estoque é baixado assim que a nota é gerada e salva no sistema, mesmo antes da autorização da SEFAZ.
-
Automático ao salvar o pedido: O estoque é baixado no exato momento em que o pedido é incluído ou importado para o ERP. Essa opção é indicada apenas para quem não deseja trabalhar com o recurso de Reserva de Estoque do sistema, pois sua ativação invalida a utilização da reserva.
- Automático ao marcar pedido como enviado: A baixa só acontece quando o status do pedido é alterado para "Enviado".
Utilizar estoque de segurança
Parâmetro opcional, utilizado para evitar a ruptura de estoque, especialmente em casos de vendas simultâneas em múltiplos canais.
Caso queira trabalhar com esse recurso, habilite o parâmetro e informe a quantidade de itens no estoque de segurança.
Quando o estoque real do item no ERP atingir a margem definida, o sistema automaticamente zera a disponibilidade no anúncio do canal de venda
Exemplo: ao definir um estoque de segurança igual a 5, todos os anúncios que atingirem a margem definida (5) irão refletir estoque igual a 0 no canal de venda.
Importante: essa margem de segurança se aplica a todos os anúncios da integração. Certifique-se que o valor é adequado para evitar anúncios zerados indevidamente.
Passo 2: Preços
Regras de utilização de preços para o e-commerce
Parâmetro para definir as regras de preço que serão consideradas na integração.
-
Preço fixo: O anúncio será atualizado conforme o preço do produto cadastrado no ERP.
-
Conforme lista de preços: Ter um preço diferenciado no momento da venda em relação ao preço cadastrado no produto.
- Conforme regras de preço: Irá definir uma regra específica para o canal que está sendo integrado, podendo considerar margens que cobrem custos operacionais e garantem uma precificação mais eficiente.
Passo 3: Receber Produtos
Ao importar produtos
Defina como as imagens do produto vão ser recebidas e armazenadas no ERP a partir da integração.
-
Importar imagens como anexos (Recomendado): O sistema importa e salva o arquivo da imagem diretamente no ERP. Suas fotos ficam protegidas, sempre visíveis em todas as telas do sistema e prontas para serem enviadas para novos canais de venda.
- Apenas importar a URL externa das imagens: O sistema salva apenas o link (URL) da imagem. O arquivo não fica guardado no ERP.
Atenção: se o link original quebrar ou mudar, você perde o acesso à imagem do produto, além de não conseguir visualizá-la dentro das telas do sistema.
Clique em “salvar e avançar” para seguir para a etapa de configuração de pedidos.
Importar anúncios com uma variação como anúncios simples
Utilize essa opção para importar anúncios com uma variação na Shopee como produtos simples no ERP.
Pedidos
Aqui você define como o seu ERP vai receber e processar as vendas vindas da Shopee, além de configurar as regras para a emissão das notas fiscais.
Passo 1: Fluxo de pedidos
Etapa para definir as regras no fluxo de recebimento dos pedidos da plataforma para o sistema ERP.
Importar valor do frete nos pedidos
Habilite o parâmetro para que o pedido importado tenha o valor do frete discriminado junto à sua composição.
Atenção: Em caso de dúvidas, deixe essa opção ativa ou peça orientação da sua contabilidade.
Completar endereço do cliente a partir do CEP na importação de pedidos
Parâmetro para que o endereço do cliente seja atualizado no ERP ao importar os pedidos.

-
Não: Ao assinalar essa opção, não haverá nenhum tipo de atualização do endereço do cliente a partir do CEP.
-
Apenas se o bairro não está informado: Se o campo bairro no pedido de venda não estiver preenchido, o ERP irá completar essa informação faltante a partir do CEP.
- Sempre: O CEP sempre será validado junto aos Correios para possível atualização da Rua ou Bairro.
Recomendação: Utilizar a opção “Apenas se bairro não está informado” ou “Sempre”.
Enviar rastreamento ao alterar a situação no ERP para enviado
Com esse parâmetro habilitado, o código de rastreio será automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para enviado.

Marcar pedido como entregue ao alterar a situação no ERP
Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, o mesmo também terá o seu status alterado na plataforma.

Intermediador
Campo de preenchimento obrigatório.
- Selecione o campo e aperte em: + Adicionar intermediador
- No campo “Nome” preencha: Shopee
- No campo “CNPJ do intermediador da transação” preencha o CNPJ da Shopee 35.635.824/0001-12 (plataforma responsável pela intermediação da venda)
- No campo “CNPJ da Instituição de Pagamento” preencha o CNPJ da empresa responsável por realizar o repasse financeiro ao vendedor.

Defina como processar valores diferentes entre nota fiscal e pagamento integrado
- Deixar assinalado a opção: Utilizar valor de pagamento integrado enviado pelo canal de venda (Recomendado)

Passo 2: Dados Fiscais
Esta etapa permite definir as Naturezas de Operação e as regras fiscais que serão aplicadas automaticamente aos pedidos importados por esta integração.
Importante: Para que a integração emita as Notas Fiscais Eletrônicas (NF-e) sem erros, é obrigatório que as suas Naturezas de Operação de Saída já estejam cadastradas e configuradas no ERP. Para mais informações, acesse: Natureza de operação de saída de mercadorias.
Bairro alternativo para emissão da nota fiscal
Preencha este campo para definir um bairro alternativo na emissão de Notas Fiscais Eletrônicas (NF-e). Essa opção é utilizada para ajustar a nota fiscal em casos de cadastros de endereço incompletos ou divergentes do cliente.
Natureza de operação para venda
Este é o campo onde você irá vincular a natureza de operação padrão que o sistema deve aplicar a cada nova venda vinda da integração com a Shopee.

Atenção: Não esqueça de, antes de iniciar a emissão das notas através da integração, validar todas as regras fiscais e tributações configuradas nas suas naturezas de saída diretamente com a sua contabilidade.
Definir natureza de operação diferente para destinatários contribuintes do ICMS
Habilite este parâmetro para definir uma natureza de operação específica para destinatários contribuintes do ICMS. Ela será aplicada automaticamente quando o ERP identificar que o pedido de venda é de um cliente contribuinte.
Mapeamentos
Passo 1: Situações de Pedidos
Nesta etapa, o sistema gerencia a equivalência entre os status dos pedidos na Shopee e no ERP da Olist.
Permitir retroceder situações dos pedidos na sincronização de situações
Define se o status do pedido pode voltar para uma etapa anterior no ERP durante a sincronização.
Importante: Mantenha este parâmetro desativado. Isso garante que o status do pedido siga o fluxo corretamente ao ser importado para o ERP.
Tabela de mapeamento de situações
Responsável pela sincronização automática dos status dos pedidos entre as plataformas.
A coluna da esquerda traz as nomenclaturas da Shopee e a coluna da direita as equivalências no ERP.
Para a integração com a Shopee, as configurações nesta tela já estão prontas, portanto, nenhuma ação é necessária da sua parte — basta clicar no botão "salvar e avançar" no rodapé da página para prosseguir.
Passo 2: Formas de Recebimento
Esta configuração é recomendada para quem busca maior controle financeiro sobre os pedidos importados da Shopee para o ERP.
- Para mais informações, acesse o artigo: Configuração das formas de recebimento nas Integrações
Passo 3: Formas de Frete
Essa configuração é exclusiva para operações que utilizam contratos próprios com soluções logísticas externas, onde a gestão de entrega fica sob responsabilidade do vendedor e não da Shopee.
Atenção: Caso utilize apenas a logística do canal essa configuração não deve ser realizada, neste caso avance para a próxima etapa sem realizar esse mapeamento.
Pré-requisito
Antes de realizar o mapeamento das formas de frete na integração da Shopee é obrigatório que a solução logística que será utilizada para entregar os pedidos deste canal esteja previamente cadastrada e configurada no ERP.
Identifique abaixo como funciona a sua entrega para saber qual artigo consultar:
Cenário |
Consultar o artigo |
|
Contrato próprio: Negociou a tabela direto com a transportadora (Jadlog, Loggi, Correios, etc) |
|
|
Intermediador de frete: Usa plataformas que centralizam a cotação de fretes (Envios da Olist, Frenet, Melhor Envio, ect) |
Mapear as formas de frete
Após configurar a Forma de Envio ou Gateway Logístico no ERP que será responsável por operar as entregas da Shopee, você deve fazer o mapeamento das formas de frete na integração.
- Acesse Mapeamentos > Formas de Frete.
- Clique em adicionar.
- No campo Forma de envio, selecione a forma de envio cadastrada no seu ERP.
- No campo Forma de frete, selecione a forma de frete correspondente.
- No campo Código na integração, clique no ícone de corrente.
- Na janela Relacionar forma de frete, localize a opção desejada e clique em selecionar.
- Clique em salvar.
Informações importantes:
- Os pedidos com tipo de envio por logística própria são identificados automaticamente.
- O código de rastreamento é enviado automaticamente para o canal.
Fulfillment
A Shopee oferece a opção de vendas por fulfillment para simplificar e acelerar as entregas. Nessa modalidade, a própria Shopee armazena o produto e cuida do fluxo logístico, retirando essa responsabilidade do cliente.
Atenção: esta etapa é exclusiva para vendedores que utilizam a modalidade de entrega Fulfillment da Shopee. Aba destinada para quem deseja importar e acompanhar os pedidos do Full no ERP.

Importar pedidos do Fulfillment
Ao habilitar essa opção, pedidos do Fulfillment serão importados e identificados com um marcador.
Importante: as notas fiscais são importadas automaticamente a partir do fulfillment habilitado.
Depósito do Fulfillment
Campo dinâmico que irá aparecer caso o parâmetro Importar pedidos do Fulfillment seja ativado.
Importante: Antes de selecionar, é necessário criar um depósito específico para esta finalidade no ERP. Clique em Criar depósito ao lado do campo para cadastrá-lo no sistema.
- Para criar o depósito no sistema, acesse: Depósitos de estoque.
-
Descrição: informe o nome do depósito.
-
Tipo: selecione Exclusivo canal de venda.
-
CNPJ do destinatário: informe o CNPJ utilizado como destinatário nas notas fiscais de transferência para o Fulfillment.
-
CNPJ do remetente: informe o CNPJ da empresa que envia o estoque para o Fulfillment. Esta informação é opcional para quando usado mais de um depósito Fulfillment da mesma integração configurado na conta.
-
Criar transferências de estoque para notas fiscais cujo destinatário possuir um dos CNPJ acima: habilite esta opção para que o sistema realize automaticamente a transferência do estoque para o depósito Fulfillment quando identificar uma nota fiscal com o CNPJ do destinatário configurado.
-
Desconsiderar saldo deste depósito: habilite esta opção para que o saldo armazenado no depósito Fulfillment não seja considerado no saldo disponível para outras operações.
- Após criar o depósito que será utilizado exclusivamente para controlar o estoque do Full, selecione no campo: Depósito Fulfillment.
Lançamento de estoque para saídas de pedidos Fulfillment
Para que os pedidos do fulfillment não realizem a reserva de estoque a recomendação é selecionar a opção:
- Automático ao marcar o pedido como enviado
Atenção: Evite utilizar outras opções para não interferir na lógica operacional dos demais pedidos da sua empresa no ERP.
Configurações avançadas
Após finalizar a instalação inicial com a Shopee, parâmetros avançados ficarão disponíveis no seu painel.
Conheça essas opções e saiba quando ajustar para garantir o fluxo correto de faturamento e recebimento de vendas.
Produtos
Enviar Produtos
Na aba “Produtos” > “Enviar Produtos” existe um parâmetro que é liberado.

- Enviar imagens dos produtos ao sincronizar: Parâmetro que define se deseja realizar o envio de imagens dos seus produtos já anunciados ou apenas dos novos anúncios.
Pedidos
Na aba “Pedidos” existem oito parâmetros avançados que poderão ser configurados.
Fluxo de Pedidos
Na aba “Pedidos” > “Fluxo de Pedidos” :
Formatar nome dos contatos no recebimento dos pedidos
Habilite esse parâmetro para que, ao importar os pedidos, as primeiras letras do nome e sobrenome do cliente sejam transformadas em maiúsculas.
Utiliza Interpretador de endereços não estruturados para tratar os endereços
Com esse parâmetro habilitado, quando o endereço do cliente não é retornado de forma clara pela plataforma, as informações faltantes no endereço do cliente serão preenchidas a partir do pedido.
Sincronização automática de pedidos
Com esse parâmetro habilitado, os pedidos criados no marketplace vão ser importados de forma automática para o ERP, utilizando o recurso de OMS. Saiba mais sobre o recurso em OMS.
Importar moedas como desconto no pedido de venda
Uma vez habilitado, as moedas aplicadas pelo comprador serão consideradas como um desconto no valor total da venda importada. O valor será considerado no cálculo do custos do e-commerce.
Importar taxa de cartão de crédito como outras despesas
Uma vez habilitado, a taxa de transação do cartão de crédito será inserida em 'Outras Despesas' e somada ao valor total do pedido de venda.
Organizar envio ao enviar dados de NFe
Habilite para 'Organizar o envio' automaticamente ao enviar dados de NFe para o e-commerce
Método de impressão de etiquetas
Defina o formato de etiqueta de envio utilizado na sua operação.
Dados Fiscais
Na aba “Pedidos” > “Dados Fiscais”:

Envio de dados da NFe
Defina a forma de envio dos dados fiscais da nota para a plataforma:
-
Automático ao autorizar a nota: quando a nota fiscal for autorizada na Sefaz, automaticamente o ERP irá enviar os dados da nota.
- Manual: os dados fiscais da nota devem ser enviados manualmente. Mais informações, consulte enviar dados da NFe ao e-commerce (Manual).

Observação: pedidos com as formas de envio abaixo não têm os dados das notas fiscais enviados para a Shopee, pois a plataforma não aceita esses dados para estas modalidades:
- Coleta Correios
- Pegaki-Correios
- Correios-Transacional
A forma de envio Correios segue com o envio dos dados de nota fiscal normalmente.
Mapeamentos
Categorias
Na aba “Mapeamentos” > “Categorias” existe um parâmetro que é liberado.
O mapeamento de categorias associa as categorias do ERP (lado esquerdo) às categorias da Shopee (lado direito).
Observação: O mapeamento de categorias pode ser feito diretamente durante a publicação do produto. Não é necessário mapear todas as categorias nesta etapa. Ao enviar um produto para a Shopee, o ERP identifica se falta algum mapeamento e solicita a categoria correspondente na tela, atualizando a lista automaticamente.
Caso precise realizar uma edição ou correção, você pode fazer isso nesta tela.
Campos importados e enviados nos anúncios
Importados
- Código (SKU)
- GTIN
- Descrição
- Descrição complementar
- Peso bruto
- Peso líquido
- Preço de venda
- Marca
- Estoque atual
- Altura embalagem
- Largura embalagem
- Comprimento embalagem
- Imagens
- Variações
Enviados
- Descrição
- Código (SKU)
- GTIN
- Preço de venda ou promocional, caso preenchido
- Peso bruto
- Peso líquido
- Descrição complementar
- Estoque atual
- Código da categoria no e-commerce
- Imagens
- Variações
- Atributos
- Altura embalagem
- Largura embalagem
- Comprimento embalagem

































