Como integrar o ERP com a Shopee
O que é a integração
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.
Recursos disponíveis
| Receber pedidos |
✓ |
| Enviar produtos |
✓ |
| Enviar estoque |
✓ |
| Enviar preços |
✓ |
| Sincronizar situação |
✓ |
| OMS |
✓ |
Como instalar a integração passo a passo
- Acesse menu > início > Integrações.
- Clique em adicionar integração, busque por Shopee e clique em instalar.
- 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.
Como configurar no ERP
Nesta seção, você encontra as informações para configurar a integração no ERP. Assista ao vídeo ou siga com o ajuste das configurações, conforme o artigo Como configurar uma integração.
Especificidades na configuração da integração
Aba Pedidos
Na aba pedidos, defina as regras do fluxo de recebimento e tratativas de pedidos da plataforma.
Campos 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
Campos 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
Fluxo de pedidos
- Importar valor do frete nos pedidos: habilite o parâmetro caso queira que o valor do frete também seja importado, ao importar os 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.
-
Completar endereço do cliente a partir do CEP na importação de pedidos: habilite esse parâmetro para que o endereço do cliente seja preenchido no ERP ao importar os pedidos.
- Não: o endereço do cliente permanecerá incompleto, caso esteja incompleto na plataforma.
- Apenas se bairro não está informado: Se o campo bairro no pedido de venda não estiver preenchido, o ERP irá completar o endereço do cliente.
- Sempre: o CEP sempre será validado junto ao Correios para preenchimento do endereço do cliente. Os dados de endereço obtidos na plataforma de e-commerce serão ignorados.
- 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.
-
Intermediador: necessário adicionar o intermediador Shopee.
- No campo Nome preencha: Shopee
- No campo CNPJ do intermediador preencha o CNPJ da Shopee: 35.635.824/0001-12

Importante: ao realizar integrações de marketplaces, adicione o Nome e CNPJ do intermediador da venda. A SEFAZ exige essa informação no XML da Nota Fiscal.
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.
- Bairro alternativo para emissão da nota fiscal: indique um bairro padrão que será utilizado na importação de pedidos, quando esta informação não for retornada ao importar os dados da plataforma.
- Natureza de operação para venda: selecione a natureza de operação que será atribuída de forma padrão na importação dos pedidos no ERP e ao gerar nota fiscal através do pedido importado. Mais informações, acesse naturezas de operação de saída.
- Definir natureza de operação diferente para destinatários contribuintes do ICMS: habilite esse 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.
Aba 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 da primeira etapa logística, retirando essa responsabilidade do cliente.
Pedidos com modalidade Fulfillment que exigem ação a ser executada, entrarão via ERP.
Para configurar no ERP, siga os passos abaixo.
Habilitando o Fulfillment
- Acesse: início > Integrações.
- Na integração da Shopee, clique em gerenciar e acesse a aba Fulfillment.
Atenção: as notas fiscais são importadas automaticamente a partir do fulfillment habilitado.
- Após as configurações, clique em salvar.
Configure o depósito Fulfillment
Para utilizar a modalidade Fulfillment, é necessário selecionar um depósito exclusivo para essa operação e configurá-lo corretamente.
Acesse: Menu > configurações > configurações ERP > aba suprimentos > depósitos de estoque.
Ao cadastrar ou editar o depósito, preencha os seguintes campos:
-
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.
Como usar o ERP com a Shopee
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
Como enviar dados fiscais dos produtos para o e-commerce
O envio das informações fiscais dos produtos, preenchidos durante seu cadastro, podem ser enviadas para a plataforma. Para isso, acesse menu lateral esquerdo > cadastros > Produtos > Selecione os produtos que deseja enviar > enviar dados fiscais para o e-commerce.
Os dados enviados serão referentes aos campos:
- CEST
- CFOP (mesmo estado)
- CFOP (para outros estados)
- CSOSN
- NCM
- Origem
- Unidade
- XML das notas
Estes dados serão enviados no envio de anúncios para a Shopee, quando identificada a utilização do faturador da Shopee.
Como pausar/ativar os anúncios
É possível pausar seus anúncios, durante um período de ausência, por exemplo. Veja como acessando como pausar/ativar os anúncios no nosso artigo anúncios.
Configurar a forma de envio Shopee Envios
As instruções para configurar a forma de envio Shopee Envios, encontram-se na ajuda Forma de Envio Shopee Envios.
Configurar a Logística do Vendedor Shopee no ERP
Para configurar a Logística do Vendedor na Shopee, consulte o artigo: Shopee - Logística do Vendedor.
Configurar atributos de produtos no ERP
- Para realizar as configurações dos atributos, acesse o menu lateral esquerdo > configurações > aba Cadastros > Configurações de Atributos de Produtos.
- Clique em incluir atributo.
- No campo Nome informe a descrição do atributo e em Campo equivalente no produto selecione a opção equivalente a esse atributo.
Ao final, clique em Salvar.
Observação: se a opção Nenhum for selecionada no Campo equivalente no produto o atributo pode ser vinculado manualmente durante o cadastro do produto.
Mapear atributos dos produtos no ERP com a Shopee
- Acesse o menu lateral esquerdo > cadastros > Produtos e clique sobre o Produto que deseja realizar o mapeamento de atributos.
O campo Valor deverá ser preenchido manualmente quando o atributo Campo equivalente no produto seja Nenhum.
- Na aba Ficha Técnica > Atributos e informe o nome de um dos atributos já cadastrados no ERP. O campo Valor será automaticamente preenchido quando configurado previamente.
- Após realizar o vínculo dos atributos, clique em Salvar.
O envio dos produtos ao e-commerce somente ocorrerá com o campo Atributo preenchido. Caso contrário, uma mensagem de erro será exibida. Para incluir atributos no produto, clique em Editar e inclua atributos ao produto.