C Controle | Ajuda — Resolver problemas da Shopee

Objetivo: descobrir a causa real de uma falha da Shopee antes de reconectar, sincronizar novamente ou tentar converter um pedido. Resultado esperado: a equipe diferencia conta desconectada, pedido ainda não disponível, dados mascarados, vínculo de produto e pendência fiscal, sem criar venda ou XML duplicados.

Antes de investigar

Perfil ou permissão: Administrador ou usuário com acesso ao cartão Shopee, Pedidos Externos e consulta de vendas.

Caminho: Configurações > Vínculo e Integração > Shopee; depois Entradas > Pedidos Externos.

Nome da Conta Shopee que deveria estar vinculada à empresa.
Número do pedido, quando a dúvida for sobre uma compra específica.
Horário aproximado da última sincronização ou do erro apresentado.
Print sem dados pessoais, caso seja necessário acionar o suporte.

Comece pelo sintoma, não pelo botão de reconectar

A origem do problema define o próximo passo. Reconectar a conta não libera dados mascarados; sincronizar de novo não corrige um produto sem vínculo; e reenviar XML não resolve uma nota que a Shopee não pode receber pela logística. Primeiro localize o cenário abaixo.

O que você vê	Causa mais provável	Próxima ação segura
Cartão informa que a Conta Shopee não está vinculada ou pede autorização.	Autorização ausente, vencida ou concluída na conta errada.	Reconecte somente a loja correta e confirme o retorno do cartão antes de sincronizar pedidos.
Cartão está conectado, mas o pedido não aparece.	Filtro de origem, período ou situação; pedido ainda não disponibilizado pelo canal; ou atualização em andamento.	Espere a execução terminar e filtre origem Shopee antes de concluir que a integração falhou.
Pedido aparece, mas há dados mascarados.	A Shopee ainda não disponibilizou a informação para aquele estado do pedido.	Não digite dados fictícios. Siga o procedimento de dados mascarados e aguarde a atualização oficial.
Pedido aparece, mas item não encontra produto interno.	Falta vínculo de produto ou variação.	Confirme SKU, referência, código de barras e variação antes de criar vínculo; não trate isso como queda da integração.
XML retorna Wrong parameters, Invoice Issuer ou error_param.	O emissor padrão da loja Shopee está configurado para a própria Shopee.	Corrija o emissor para Outro/Outros no Seller Centre e só então reenvie a NF-e modelo 55.

1. Confira a conta e a autorização

Abra o cartão da Shopee em Vínculo e Integração.
Confira se o cartão mostra a mesma Conta Shopee que deveria enviar os pedidos para a empresa atual.
Se estiver desconectado, use a autorização exibida pelo sistema e conclua o acesso somente na loja correta.
Ao voltar ao CControle, valide o estado do cartão antes de abrir Pedidos Externos.

Captura real do cartão Shopee no CControle exibindo o estado desconectado e a mensagem Conta Shopee não vinculada. — Captura real do CControle: quando o cartão indica que a Conta Shopee não está vinculada, regularize a autorização antes de procurar o pedido na central.

Não desconecte por tentativa: desconectar interrompe as próximas atualizações. Não use essa ação apenas porque um pedido está sem produto vinculado, porque a lista está filtrada ou porque há dados mascarados.

2. Quando o pedido não aparece

Abra Entradas > Pedidos Externos.
Selecione a origem Shopee, confira período, situação e busca antes de sincronizar novamente.
Se houver atualização em andamento, aguarde o fim e atualize a lista. Não clique repetidamente em Sincronizar.
Compare o número e a situação do pedido com a loja Shopee. Um pedido sem disponibilidade no canal não será criado no CControle por tentativa manual.

Captura demonstrativa do CControle para conferir origem, período, situação e pedidos pendentes na Central de Pedidos Externos. — Use origem, período e situação na Central de Pedidos Externos antes de repetir uma sincronização. A captura é demonstrativa e não contém pedidos reais.

3. Quando o problema é dado, não conexão

Situação	O que não fazer	O caminho correto
Nome, CPF/CNPJ, telefone ou endereço vêm com asteriscos.	Não copiar os asteriscos nem usar dados de outro cliente para converter.	Leia Dados do comprador mascarados pela Shopee.
Produto ou variação não foi encontrado.	Não vincular pelo nome parecido sem confirmar a variação comprada.	Revise o anúncio e o produto interno antes de converter; comece por conferir a amostra Shopee.
Pedido já foi convertido em venda.	Não converter uma segunda vez para testar se “vai aparecer”.	Abra a venda vinculada e confira origem, itens e histórico antes de qualquer correção.

4. Quando a falha é fiscal ou de etiqueta

Antes de enviar um XML, confirme que a NF-e é modelo 55, está autorizada e pertence à venda correta. Pedidos com logística Correios não aceitam upload de NF-e pela Shopee. Quando o retorno citar Wrong parameters, emissor de fatura ou error_param, não reconecte a integração: siga Shopee recusou o XML: emissor de NF-e da loja.

Depois de uma tentativa de envio, confira a coluna XML marketplace. Ela informa se a comunicação ficou pendente, enviada, falhou ou não se aplica; não trate “Falhou” com tentativas repetidas sem corrigir a causa.

O que enviar ao suporte

Canal Shopee, Conta Shopee exibida e número do pedido.
Estado do cartão de integração, filtros utilizados e horário da última atualização.
Mensagem completa do erro e estado da coluna XML marketplace, quando houver nota.
Print do problema sem CPF/CNPJ, endereço, telefone, senha, token ou código de autorização.

Próximos passos

Depois de corrigir a causa, volte ao guia Shopee: o que sincroniza e como conferir e valide uma única amostra. Para emissão, XML e etiqueta, use Shopee: enviar NF-e e imprimir a etiqueta oficial.

Revisado em: 25/08/2026.

Esse artigo foi útil?

Obrigado pelo retorno!

Sem problemas — fale direto com o nosso suporte que a gente resolve com você:

Chamar no WhatsApp ou ligue (32) 3721-6702