Passar para o conteúdo principal

Como realizar a integração com a Shopee pelo TMS

M
Escrito por Maurício Medeiros Lima
Atualizado há mais de uma semana

A Shopee atualizou recentemente sua política de integração logística. Com essa mudança, os sellers que utilizam transportadoras próprias — ou seja, que não operam com a logística da Shopee — devem se adequar ao novo modelo Logística do Vendedor Shopee, no qual a Shopee aceita apenas três tipos de atualizações de status de pedido: Despachado, Entregue e Falha na Entrega.

Pensando nisso, a Intelipost disponibilizou um novo modelo de integração direto pelo TMS, de forma simples e rápida. Ao conectar sua conta Shopee ao sistema, você garante o envio automático desses status diretamente para a plataforma da Shopee, evitando erros manuais, reduzindo retrabalhos e garantindo conformidade com as novas diretrizes da marca.

O que muda com essa nova integração?

Com a atualização das diretrizes da Shopee, a experiência de tracking será mais limitada. A plataforma passou a aceitar apenas os três status mencionados anteriormente. Isso significa que os eventos intermediários (como “pedido coletado”, “em trânsito”, etc.) não serão mais transmitidos.

Toda a ativação agora deve ser feita exclusivamente via TMS.

🧩 Requisitos técnicos para a integração funcionar corretamente

Para garantir que os status sejam atualizados corretamente na Shopee, é fundamental que os pedidos enviados à Intelipost incluam, obrigatoriamente, os campos exigidos pela Shopee no payload de criação do pedido:

{
"external_order_numbers": {
"marketplace": "{order_sn_shopee}"
},
"additional_information": {
"shop_id": "{shop_id}"
},
"sales_channel": "shopee"
}

⚠️ O campo "sales_channel” deve ser enviado obrigatoriamente em letras minúsculas, pois se trata de um campo case-sensitive.

Esses campos garantem a associação correta do pedido com a conta da Shopee e o funcionamento adequado da atualização de status.

Caso esses campos ainda não estejam sendo enviados corretamente, o cliente deverá abrir um chamado junto à integradora de pedidos, solicitando a adequação e o envio dessas informações.

Após a implementação dessa correção, será possível solicitar a liberação do APP da Intelipost no TMS, permitindo a autenticação e integração com a Shopee.

Integrações obrigatórias da Shopee

Com a ativação via TMS, será necessário que o cliente integre a dois fluxos obrigatórios da Shopee:

  1. Cotação

  2. Tracking

Essas integrações são exigência da Shopee para permitir o envio dos dados.

Passo a passo: como integrar sua conta Shopee ao TMS

  1. Acesse o menu de configurações de entrega
    No menu lateral do TMS, vá até:
    Entregas > Configurar Entregas > Shopee

  2. Clique em “Ativar Integração”
    Na tela da Shopee, você verá um botão de ativação. Clique em “Ativar nova integração com a Shopee”.

  3. Faça login com sua conta de Seller da Shopee
    Você será redirecionado para a página de autenticação da Shopee. Insira suas credenciais da conta de Seller e autorize o acesso da Intelipost.


Assim que você finalizar a integração com a Shopee, você será direcionado automaticamente para a integração com a Intelipost.

  1. Para finalizar, integre com a Intelipost

    Como última etapa, clique em "Confirmar Autenticação" e conclua a integração

  2. Integração concluída, verifique o sucesso na coluna de "status da integração".

    A partir de agora, você já consegue gerenciar seus pedidos da Shopee pelo TMS

    A partir de agora, você já pode gerenciar seus pedidos da Shopee diretamente pelo TMS. Essa integração foi desenvolvida para ajudar nossos clientes a se adaptarem de forma rápida e eficiente ao novo modelo logístico da Shopee, evitando penalidades e mantendo a operação fluindo sem interrupções.

    Ao conectar sua conta via TMS, você automatiza a atualização de status dos pedidos, mantém a Shopee sempre informada com os eventos corretos e garante conformidade com as novas exigências da plataforma.

    Em caso de dúvidas ou dificuldades, entre em contato com nosso time de suporte.

📢 Dúvidas frequentes

1. O que é a Logística do Vendedor (API de Frete)?

A Logística do Vendedor (API de Frete) permite que o seller use sua própria logística ou transportadora para cotar e enviar pedidos.

Esse modelo é indicado para produtos muito grandes ou pesados (ex.: geladeira, TV, guarda-roupa), que não cabem na Shopee Express.

O frete e o prazo são definidos pelo vendedor, por meio do seu sistema (ERP/TMS).

2. Como habilitar a Logística do Vendedor na Shopee?

Para habilitar a Logística do Vendedor Shopee, é necessário entrar em contato com o gerente de contas responsável pela sua conta na Shopee e solicitar a ativação dessa modalidade de logística.

Após a liberação realizada pela Shopee, será possível operar com transportadoras próprias ou terceirizadas e realizar a integração logística conforme as regras da plataforma.

3. Quais campos são obrigatórios no envio do pedido?

No momento da criação do pedido, é obrigatório enviar:

  • ID da loja

  • Número externo do pedido no marketplace

  • Canal de vendas shopee (em letras minúsculas)

4. O que fazer se os campos obrigatórios não estiverem sendo enviados?

O seller deverá abrir um chamado junto à integradora de pedidos ERP, plataformas, solicitando o envio correto dessas informações.

Caso a sua Integradora/ERP/ plataforma conectas á Shopee necessite de suporte, é necessário abrir um chamado na Shopee no Open Platform, que é um sistema à parte, não tendo relação direta com o atendimento ao Vendedor.

5. Quais status de pedido a Shopee aceita?

A Shopee aceita apenas os status Despachado, Entregue e Falha na Entrega para operações com logística do vendedor.

6. Não possuo gerente de contas. Como habilitar a Logística do Vendedor?

Caso você não possua um gerente de contas dedicado, será necessário abrir um chamado diretamente na Shopee, solicitando a ativação do canal Logística do Vendedor Shopee para a sua conta.

Após a liberação por parte da Shopee, a funcionalidade ficará disponível para configuração e utilização, conforme as regras e diretrizes estabelecidas pela plataforma.

7. Os pedidos em andamento na logística antiga serão afetados com a migração?

Sim, a Shopee orienta que ao migrar de canal de envio, é obrigatório concluir o envio de todos os pedidos ativos pela logística anterior até a data de ativação da Logística do Vendedor. Pois, cada anúncio permite apenas um tipo de logística.

8. É possível operar com mais de uma logística em um produto (Shopee Express & Logística Própria)?

Não, cada produto deve ser configurado com apenas um tipo de logística.

  • Produtos habilitados como Shopee Express devem ter essa opção habilitada no anúncio.

  • Produtos que ultrapassam as dimensões permitidas para Shopee Express serão vendidos pela Logística do Vendedor.

Ou seja, o seller que utiliza as duas logísticas deve definir, dentro do anúncio, qual logística será usada para cada item.

Respondeu à sua pergunta?