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.
Pré-requisitos
- Disponível para os todos os planos Olist.
- Integração instalada na conta do ERP.
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
Confira no vídeo como fazer a configuração. Se preferir, o passo a passo está logo abaixo.
Ao finalizar a instalação e autenticação da conta do ERP com a Shopee, siga com o ajuste das configurações, conforme o artigo Como configurar uma integração e as especificações listadas abaixo.
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.
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 terão os dados das NFes enviados para Shopee, devido não aceitarem estes dados para estas formas de envio: Correios, Coleta Correios, Pegaki-Correios e Correios-Transacional.
- 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.
Criando um novo depósito de estoque
- Acesse: menu > configurações.
- Na aba suprimentos, clique em depósitos de estoque > incluir depósito.
- Preencha os campos conforme as orientações:
- Descrição: Crie uma descrição para identificar o depósito, como "Fulfillment Shopee", para diferenciá-lo dos demais.
- Tipo: Selecione a opção Exclusivo para um canal de venda.
- CNPJ deste depósito: Informe o CNPJ do seu depósito de fulfillment. Se necessário, você pode adicionar mais de um.
- Habilite a opção criar transferências de estoque para notas fiscais cujo destinatário possui o CNPJ acima. Assim, ao lançar notas de transferência para o CNPJ informado, uma movimentação de entrada será criada automaticamente no depósito do Fulfillment.
- Habilite a opção desconsiderar saldo deste depósito para que o saldo de estoque dos produtos deste depósito não seja atualizado nas suas outras integrações.
- Ao finalizar, clique em salvar.
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.