Shopee
A integração com o Shopee conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 60 parâmetros distribuídos em 7 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: Marketplace.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
- Credenciais de Acesso
- Integração de Vendas
- Integração de Produtos
- Conciliação
- Importação de Anúncios
- Logística (WMS) -> Picking
- Pedido
Erros comuns
- O anúncio não publica porque a dimensão do produto está zerada
- Faltam atributos obrigatórios da categoria
- O anúncio tem mais de dois tipos de variação
- Variação duplicada ou com anormalidades
- O gênero não bate com o título
- O status do anúncio está irregular e não atualiza
- Por que o estoque não atualiza sozinho em alguns anúncios da Shopee?
- O saldo fica zerado ao sincronizar mesmo com estoque no SKU
- A Shopee exige código de barras (EAN/GTIN) e não publica o anúncio
- Não consigo subir nova variação ou imagem ("tier-variation not change")
- O anúncio não cota frete na Shopee (reautenticar Shopee Logistics)
- Mudei o status para "Enviado" e a informação não foi para a Shopee
- Como deixar de imprimir a DANFE junto da etiqueta da Shopee?
- Pedido da Shopee integrou zerado por cupom/desconto (NF R$ 0,00)
- Checklist depois de integrar a Shopee
- Importei anúncios direto na Shopee — devo continuar criando por lá?
- Ativei "Atualizar saldo de estoque" e o estoque foi para zero
Referência rápida
O que é a integração Shopee?
É a conexão entre o canal Shopee e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Marketplace), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Shopee.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Shopee e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Código loja | Cópia | Código loja |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
20 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Incluir valor do frete | Sim/Não | Ligar/desligar inclusão de valor frete no pedido |
| Não incluir valor pago em moedas Shopee | Sim/Não | Ative para que a idworks não inclua ao pedido o valor pago em moedas Shopee |
| Não incluir o valor do voucher Seller | Sim/Não | Ative para que a idworks não inclua ao pedido o valor do voucher Seller |
| Não incluir o valor do voucher Shopee | Sim/Não | Ative para que a idworks não inclua ao pedido o valor do voucher Shopee |
| Detalhar forma de pagamento | Sim/Não | Importar o detalhe da forma de pagamento utilizado pelo cliente, como cartão de crédito, boleto e etc. Exige realizar o DE/PARA de todas as formas |
| Não incluir o valor do desconto Shopee | Sim/Não | Ative para que a idworks não inclua ao pedido o valor do desconto Shopee |
| Importar pedidos pendente pagamento | Sim/Não | Importar pedidos no status de pagamento pendente para reservar o estoque |
| Cancelar pedido automaticamente | Sim/Não | Ative se quiser cancelar pedido automaticamente caso ele seja cancelado no canal de vendas |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Não incluir o valor do desconto Seller | Sim/Não | Ative para que a idworks não inclua ao pedido o valor do desconto Seller |
| Incluir pedidos transferencia fulfillment | Sim/Não | Ative se quiser que a idworks integre pedidos de transferência para o fulfillment. Se não estiver ativo, a nota fiscal será importada, mas sem movimentação de saldo de estoque |
| Não importar NF de retorno simbólico fulfillment | Sim/Não | Ative para não importar as notas fiscais de retorno simbólico emitidas pelo canal na modalidade full. Esta funcionalidade só tem validade se a opção de "incluir pedidos fulfillment" estiver ativa |
| Emails para enviar Nfe fulfillment | Texto | Adicionar lista de email separado por vírgula para enviar nota fiscal emitida pelo FULL |
| Incluir pedidos fulfillment | Sim/Não | Ative se quiser que a idworks integre pedidos fullfilment do canal de vendas |
| Não incluir valor de taxa de pagamento como despesas acessórias | Sim/Não | Ative para que a idworks não inclua o valor de taxas de pagamento como despesas acessórias |
| Utilizar data estimada expedição como data entrega | Sim/Não | Ao ativar, o campo data estimada de entrega será preenchido com o valor do campo data estimada expedição |
| Alterar status em espera etiqueta | Sim/Não | Ao ativar, quando a data estimada de expedição for maior que o dia atual e a logistica for diferente de envio próprio, o pedido será alterado automaticamente para o status "em espera etiqueta". Quando chegar no dia da liberação da etiqueta, o pedido seguirá o fluxo normal |
Integração de Produtos
17 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Estoque de segurança | Inteiro | Se a quantidade de um produto estiver abaixo do valor escolhido, seu anúncio será pausado para evitar que sejam feitas vendas sem estoque. O valor de estoque mínimo é aplicado a todos os produtos. |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda, se existir cobrança de frete |
| Valor de ajuste no preço frete grátis | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda, se houver frete grátis e se o preço base for maior que a regra de frete grátis |
| Percentual de ajuste no preço | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda, se existir cobrança de frete |
| Percentual de ajuste no preço frete grátis | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda, se houver frete grátis e se o preço base for maior que a regra de frete grátis |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Atualizar descrição | Sim/Não | Ative se quiser enviar a atualização da descrição do produto na integração |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
| Selecionar armazém com saldo ao criar pedido | Sim/Não | Caso habilitado, e, preenchido Armazéns para somar quantidade, ao criar um pedido, será selecionado ao primeiro armazém da lista que tiver estoque disponível. Por exemplo: pedido tem a quantidade um do item e o saldo no primeiro armazém é zero. Será selecionado o segundo ou outro armazém que tiver disponibilidade. Caso nehum tenha disponibilidade, será considerado o armazém configurado no de/para de armazens |
| Atualizar título e descrição | Sim/Não | Ative para atualizar título e descrição de anúncios que já possuem venda |
| Utilizar imagem do produto Pai como capa de variação | Sim/Não | Ative se quiser que a primeira imagem de todas as variações seja a imagem do produto Pai |
Conciliação
9 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Plano de contas taxa | Lista | Plano de contas para lançamento da taxa marketplace |
| Tipo documento taxa | Lista | Tipo documento para lançamento da taxa marketplace |
| Centro de custo taxa | Lista | Centro de custo para lançamento da taxa marketplace |
| Conta bancária para realizar conciliação | Lista | Conta bancária para realizar conciliação. Deve ser uma conta própria para a integração |
| Plano de contas antecipação | Lista | Plano de contas para lançamento de antecipação marketplace |
| Diferença dias data venda para conciliação automática | Inteiro | Quantidade de dias a mais e a menos permitido na conciliação automática |
| Diferença valor para conciliação automática | Decimal | Diferença de valor a maior e a menor permitido na conciliação automática |
| Plano de contas comissão frete | Lista | Plano de contas para lançamento de comissão de frete |
| Plano de contas cupom | Lista | Plano de contas para lançamento de comissão de cupom |
Importação de Anúncios
10 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Preços na ficha do Anúncio | Sim/Não | Traz o preço do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado preço definido pela política comercial do cadastro do produto no momento da sincronização do anúncio. |
| Incluir URL do Video no Cadastro do Produto | Sim/Não | Traz a URL do vídeo do anúncio publicado para dentro da ficha de cadastro do produto, somente nos casos em que for possível realizar o vínculo (match) entre o anúncio, suas variações e os produtos/SKUs cadastrados no sistema. |
| Incluir Título na ficha do Anúncio | Sim/Não | Traz o título do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Nome do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Traz o descrição do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Descrição do cadastro do produto no momento da sincronização do anúncio. |
| **Importar somente anúncios inexistente dentro da ** | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
| Incluir Imagem dentro do Produto | Sim/Não | Traz as imagens do anúncio publicado para dentro do cadastro do produto no sistema. Caso a opção de trazer imagens para dentro do anúncio esteja habilitada, esta funcionalidade será desconsiderada. |
| Incluir Imagem dentro do Anúncio | Sim/Não | Traz as imagens do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, serão utilizadas as imagens vinculadas ao cadastro do produto no momento da sincronização do anúncio e das imagens. |
| Não Realizar o vínculo do Anúncio ao Produto/SKU | Sim/Não | Ignora o vínculo automático do anúncio com o produto/SKU, permitindo que o vínculo seja realizado posteriormente. |
| Criar Produto/SKU, com base no Anúncio Importado. | Sim/Não | Cria o Produto/SKU com base no anúncio importado... |
| Criar Produto ou SKU Único (Todos Anúncios terá um produto único associado) | Sim/Não | Diferente da opção Criar Produto/SKU com base no Anúncio Importado, esta configuração faz com que o sistema crie um produto único para cada anúncio importado. Nesse caso, o código será utilizado como código do produto, enquanto o código da variação será utilizado para o cadastro do SKU correspondente. O sistema criará os cadastros sempre como Tipo Produto e Tipo SKU. Caso algum dos anúncios importados represente um Kit, será necessário editar manualmente o item após a importação, alterando seu tipo para Kit e definindo sua composição corretamente. |
Logística (WMS) -> Picking
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Emitir NF após iniciar picking | Sim/Não | Emitir NF de forma automática ao iniciar o picking |
Pedido
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Emitir nota fiscal após pedido conferido | Sim/Não | Ao ativar, a emissão da nota será coloca em uma fila após o pedido ter sido marcado como conferido (botão na aba info. adicionais) |
O anúncio não publica porque a dimensão do produto está zerada
A Shopee exige que comprimento, largura e altura do produto venham preenchidos com valor maior que zero — pelo menos 1 cm em cada uma. Quando o produto vai com dimensão 0 ou com um número que arredonda para zero no envio (ex.: 0,35 cm), a Shopee devolve uma mensagem em inglês informando que uma das dimensões precisa ser maior que zero. O termo em inglês da mensagem indica qual das três falhou: comprimento, largura ou altura.
Como resolver:
- Abra o produto/SKU em Produtos → Listar Produtos → editar SKU.
- Na aba de medidas, preencha Comprimento, Largura, Altura e Peso com valores reais da embalagem (use centímetros e gramas).
- Confirme que os três valores de dimensão são maiores ou iguais a 1 cm. Para itens muito pequenos, arredonde para cima — a Shopee não aceita fração que vire zero.
- Salve o cadastro e refaça a publicação/sincronização do anúncio.
A mesma regra vale ao editar um anúncio já publicado — se as dimensões forem zeradas na edição, a Shopee rejeita o envio.
Faltam atributos obrigatórios da categoria
Ao publicar ou sincronizar, a Shopee pode recusar o anúncio com mensagens como "Your attribute info is invalid. Please fill in the category related attributes with correct attribute value" ou "O atributo Fabricante (Manufacturer) é obrigatório". Isso quer dizer que a categoria escolhida na Shopee exige atributos (marca, fabricante, material e outros) que estão em branco.
Como resolver:
- Abra o anúncio em Integrações → Anúncios e confira a categoria vinculada na Shopee.
- Preencha os atributos obrigatórios daquela categoria — a Shopee marca os obrigatórios no painel dela. Os mais cobrados são marca/fabricante, material e atributos específicos do tipo de produto.
- Se o atributo vier do cadastro, complete-o em Produtos → Listar Produtos → editar produto/SKU e refaça a sincronização.
Os campos exigidos mudam conforme a categoria — ao trocar a categoria do anúncio, novos atributos podem passar a ser obrigatórios.
O anúncio tem mais de dois tipos de variação
A Shopee aceita no máximo dois tipos de variação por anúncio (por exemplo, Cor e Tamanho). Quando o produto tem três ou mais tipos (ex.: Cor + Tamanho + Sabor), ela recusa com a mensagem "invalid InitTierVariationRequest.TierVariation: value must contain no more than 2 item(s)".
Como resolver:
- Abra o produto em Produtos → Listar Produtos → editar e veja quantos tipos de variação ele usa.
- Reduza para no máximo dois tipos. Se precisar de uma terceira característica, desmembre em produtos separados ou inclua a informação no título/descrição.
- Salve e refaça a publicação.
Variação duplicada ou com anormalidades
A mensagem Variação duplicada ou com anormalidades - Shopee é um aviso geral: o idworks enviou a grade de variações e a Shopee recusou. Por baixo, costuma ser um destes motivos:
- Combinação repetida — duas variações com a mesma combinação (ex.: dois itens "Azul / M"). Cada combinação da grade precisa ser única.
- Quantidade inválida — mensagem "O atributo QUANTITY não é um número válido. Cause_ID:153". Em geral é uma variação sem SKU vinculado ou sem saldo definido, e não o estoque em si — confira se todas as variações têm SKU e grade preenchidos.
- Código de barras inválido — mensagem "The GTIN is invalid for model". O EAN/GTIN de uma das variações não é válido. Corrija ou remova o código na variação.
- O anúncio já existe na Shopee — se o produto já tem um anúncio publicado no canal (criado direto na Shopee ou importado antes), publicar de novo gera uma "duplicata". Nesse caso, vincule o anúncio existente ao produto em vez de criar outro (ver mais abaixo).
Como resolver:
- Abra o produto em Produtos → Listar Produtos → editar → aba de variações/grade.
- Remova combinações repetidas, confirme que toda variação tem SKU e grade e que os códigos de barras são válidos.
- Salve e sincronize novamente.
O produto subiu, mas no canal aparece sem variações e sem estoque
Às vezes a mensagem aparece e o anúncio chega a ser criado na Shopee, só que sem as variações e, por consequência, sem estoque — a Shopee criou a casca do anúncio e recusou a grade. Quando isso acontece:
- Corrija a grade no idworks (combinações únicas, SKU e código de barras válidos em todas as variações), como acima.
- Sincronize o anúncio novamente para a Shopee receber a grade completa.
- Se o anúncio continuar sem aceitar as variações, a casca já criada na Shopee pode estar travada sem grade. Aí o caminho é encerrar/remover o anúncio no Seller Center da Shopee, desvincular o anúncio antigo no idworks e publicar de novo já com a grade corrigida.
Não encontro onde está o anúncio "duplicado" vinculado
Quando você não acha o anúncio que está duplicando, o número que aparece no erro costuma ser o código do anúncio na Shopee — e não o código interno do idworks. Para localizar:
- No Seller Center da Shopee, pesquise pelo número do anúncio ou pelo nome do produto: é comum já existir lá um anúncio publicado que passou despercebido.
- No idworks, abra Integrações → Anúncios e filtre pelo produto/SKU para ver se já há um anúncio vinculado a ele nessa conta.
- Se já existe anúncio na Shopee para esse produto, vincule o anúncio existente ao produto/SKU em vez de criar outro. Se houver mesmo dois anúncios para o mesmo item, mantenha um e encerre o outro no Seller Center.
O gênero não bate com o título
A Shopee compara o atributo Gênero do anúncio com o gênero sugerido pelo título. Quando os dois divergem (ex.: título "infantil unissex" e atributo "Sem gênero"), ela recusa com a mensagem "Please make sure you enter a gender that matches the title of your listing. Cause_ID:4210".
Como resolver:
- Ajuste o atributo Gênero para o mesmo gênero que aparece no título — ou ajuste o título para refletir o gênero do atributo.
- Para itens unissex ou infantis, escolha o valor de gênero que a Shopee oferece para a categoria (ela não aceita combinações que contradigam o título).
- Sincronize novamente.
O status do anúncio está irregular e não atualiza
A mensagem "All the fields cannot be updated because the product status is abnormal" indica que, no painel da Shopee, aquele anúncio está em uma situação que bloqueia atualização — normalmente banido, bloqueado, apagado ou em revisão. Por isso ele às vezes nem aparece quando você procura pelo número do anúncio no canal, mesmo existindo no idworks.
Como resolver:
- Acesse o Seller Center da Shopee e localize o anúncio pelo número. Verifique o motivo (bloqueio, infração ou item removido).
- Resolva a pendência no próprio canal (corrija o que a Shopee apontou ou recrie o anúncio).
- Se o anúncio foi removido na Shopee, desvincule o anúncio antigo no idworks e publique um novo.
Por que o estoque não atualiza sozinho em alguns anúncios da Shopee?
É a dúvida mais comum do canal: você ativou Atualizar saldo estoque (grupo Integração de Produtos), mas um anúncio do produto sincroniza o saldo automaticamente e outro do mesmo produto não — ou nenhum sincroniza. Quase sempre a causa não é falta de estoque, e sim a ficha do anúncio incompleta no idworks. A Shopee só aceita a atualização automática de saldo quando o anúncio está completo.
Os motivos mais frequentes, em ordem de quem mais aparece:
- Anúncio sem categoria definida — sem a categoria preenchida, a Shopee recusa a atualização de saldo. Esse é o motivo nº 1 de "um anúncio atualiza e o outro não".
- Especificações (ficha técnica) em branco — atributos obrigatórios da categoria vazios travam a sincronização automática.
- Anúncio vinculado ao código errado — se a variação ficou amarrada a um código de outro canal (por exemplo, um código do Mercado Livre), o idworks não consegue atualizar o saldo desse item na Shopee.
- Anúncio que existe só no canal — se o anúncio foi criado direto na Shopee e nunca foi trazido para o idworks, não há o que controlar por aqui. É preciso criar/vincular o anúncio no idworks primeiro.
Como resolver (o procedimento que destrava na maioria dos casos):
- Abra o anúncio em Integrações → Anúncios.
- Confira a categoria — se estiver vazia, defina a categoria correta da Shopee.
- Preencha as especificações/atributos obrigatórios daquela categoria.
- Confirme que cada variação está vinculada ao SKU certo (e não a um código de outro canal).
- Use a ação Baixar Completo (você pode escolher sem imagem) para o idworks trazer a ficha completa do anúncio do canal e alinhar tudo.
- Use Sincronizar → saldo de estoque para reenviar o saldo.
Depois que a ficha fica completa, as próximas atualizações de saldo passam a sair automaticamente sempre que o estoque muda no idworks. Se um anúncio específico continuar parado, refaça os passos só nele — é comum que um produto tenha vários anúncios e só um esteja com a ficha incompleta.
Estoque reservado em campanha: quando você reserva estoque para uma campanha dentro da Shopee, esse saldo fica retido no painel do canal e não reflete no idworks enquanto a campanha está ativa. Ao sair da campanha, confira o saldo dos dois lados e sincronize para evitar comprometer o estoque real.
O saldo fica zerado ao sincronizar mesmo com estoque no SKU
Você sincroniza o saldo e o anúncio vai para 0 (ou não sobe), mas o SKU tem estoque de sobra. Antes de abrir chamado, confira estes pontos no grupo Integração de Produtos (ver tabela acima) — quase sempre é configuração de origem do saldo:
- Armazéns para somar quantidade preenchido com o armazém errado. Se o produto está em um único armazém e você marcou nesse campo um armazém diferente (ou um armazém sem saldo), o idworks envia 0. Nesse caso, o ideal é deixar o campo em branco — assim vale o armazém do de/para. Esse é o motivo nº 1 de "saldo zerado com estoque no SKU".
- Dimensões do SKU não preenchidas (ou inválidas). A Shopee é criteriosa com medidas: se comprimento, largura, altura e peso do SKU estiverem zerados ou errados, a atualização de saldo pode ser recusada. Preencha as medidas reais (ver a pergunta sobre dimensão zerada acima).
- Variação sem saldo trava as demais. Se uma variação da grade está sem saldo (ou com saldo negativo), a Shopee pode recusar a atualização de todas as variações daquele anúncio. Garanta saldo válido em cada variação.
- Percentual disponibilidade de estoque baixo ou Estoque de segurança acima do saldo — os dois reduzem (ou pausam) o que é enviado.
Como resolver: ajuste o campo Armazéns para somar quantidade (deixe em branco se o produto fica num só armazém), complete as dimensões do SKU, garanta saldo em todas as variações e refaça Sincronizar → saldo de estoque.
Para não vender sem estoque enquanto a sincronização não conclui, use o Estoque de segurança (grupo Integração de Produtos): quando o saldo cai abaixo do valor escolhido, o anúncio é pausado e evita venda sem saldo.
A Shopee exige código de barras (EAN/GTIN) e não publica o anúncio
A Shopee passou a validar o código de barras de cada variação. Anúncios sem EAN válido — ou com um código fora do padrão — passaram a ser recusados na publicação e na sincronização, mesmo a opção Item sem GTIN (que existia na tela da Shopee) deixou de funcionar para muitos casos. Quando isso acontece, o anúncio recusa com mensagens como "The GTIN is invalid for model" ou um aviso de código de barras inválido.
O código aceito pelos marketplaces é o EAN-13 — uma sequência de 13 números com um dígito verificador no final. O SKU não serve como código de barras: o SKU é um código interno da sua empresa (pode ter letras e símbolos), enquanto o EAN-13 só aceita números e tem cálculo de verificação próprio. Por isso, copiar o SKU para o campo de código de barras não resolve.
Como resolver:
- Abra o produto em Produtos → Listar Produtos → editar → aba de variações/grade.
- Em cada variação, preencha o campo de código de barras com um EAN-13 válido e único.
- Se a sua variação tem mais de um código, confira também o campo de códigos de barras adicionais — em alguns produtos é nesse campo que o código precisa entrar para a Shopee aceitar.
- Salve e sincronize o anúncio novamente.
E se o produto não tem EAN oficial? Produtos sem código de barras de fábrica precisam de um EAN-13 só para fins de cadastro:
- Gere um EAN-13 válido em um gerador de código de barras (escolha o tipo EAN-13) e use um número diferente para cada variação.
- Em alguns casos a Shopee aceita preencher o código com 00 para entender que o produto não tem EAN — vale tentar antes de gerar um código.
- Evite reaproveitar um EAN que já pertença a outro produto: um mesmo código usado em itens diferentes gera conflito no canal.
Não consigo subir nova variação ou imagem ("tier-variation not change")
Ao adicionar uma nova variação a um anúncio já publicado, ou ao tentar atualizar a imagem logo em seguida, a Shopee pode recusar com a mensagem "tier-variation not change". Isso acontece porque a estrutura de variações do anúncio precisa ser atualizada no canal antes de qualquer outra alteração — principalmente antes das imagens.
Como resolver:
- Em Integrações → Anúncios, selecione o anúncio.
- Use Sincronizar → produto primeiro, para a Shopee receber a nova grade de variações.
- Só depois use Sincronizar → imagens (e demais itens). Sincronizar a imagem antes do produto é o que costuma gerar a mensagem.
Quando a Shopee não deixa mudar a estrutura: a Shopee tem limites para alterar a quantidade/estrutura de variações de um anúncio que já está no ar. Se mesmo sincronizando o produto a grade não muda, o caminho é criar um anúncio novo já com a estrutura de variações correta e encerrar o antigo no canal.
O anúncio não cota frete na Shopee (reautenticar Shopee Logistics)
Quando um anúncio (ou todos os anúncios de uma conta) deixa de cotar frete na Shopee — o comprador vê "endereço não suportado" e não consegue finalizar a compra — quase sempre é a integração de logística da Shopee (Shopee Logistics) que precisa ser reautenticada, e não o anúncio em si.
Como resolver:
- No Seller Center da Shopee, vá em Configurações da Loja → Gerenciamento de Parceiros e confira se a integração está ativa. Se houver outra integradora vinculada (ou a própria idworks aparecendo duplicada), é sinal de que o vínculo precisa ser refeito.
- No idworks, desvincule e autentique novamente a integração de logística da Shopee daquela conta (use a ação Autenticar Integração na linha da integração).
- Confirme que o frete está habilitado no anúncio dentro do canal (a Shopee tem essa opção por anúncio).
- Repita para cada conta — quando você tem várias lojas, a reautenticação precisa ser feita em todas as contas afetadas.
Depois de reautenticar, a cotação de frete volta a ser calculada normalmente. Se só um produto específico não cota e os demais cotam, verifique também as dimensões e o peso do SKU — medidas zeradas ou erradas impedem o cálculo de frete.
Mudei o status para "Enviado" e a informação não foi para a Shopee
Você altera o pedido para Enviado no idworks, o status muda por aqui, mas não chega à Shopee. Isso depende de quem é a transportadora do pedido:
- Logística da própria Shopee — a atualização do status "enviado" no canal é feita pelo idworks. Se não subir, verifique a integração da transportadora Shopee do pedido.
- Transportadora própria do vendedor (ex.: Intelipost e similares) — quem atualiza o status "enviado" diretamente no canal é a própria transportadora, não o idworks. Nesse caso é normal o status mudar no idworks e o envio ao canal ficar a cargo da transportadora. Se você tentar forçar a atualização pelo idworks, o canal recusa com uma mensagem informando que a transportadora é diferente da logística do vendedor e o status não pode ser atualizado.
O que fazer: confirme qual logística está no pedido. Se for transportadora própria, acompanhe a atualização do status pela própria transportadora — não é necessário (nem possível) forçar pelo idworks. A emissão e o envio da nota fiscal ao canal continuam acontecendo normalmente, independentemente disso.
Como deixar de imprimir a DANFE junto da etiqueta da Shopee?
A etiqueta de envio da Shopee já costuma trazer a DANFE simplificada espelhada nela. Para não imprimir a DANFE separada (e sair só a etiqueta de transporte), o ajuste fica na transportadora do pedido:
- Acesse a configuração da transportadora usada nos pedidos da Shopee.
- Localize a opção de desativar a DANFE na finalização do packing.
- Desligue-a.
Com essa opção ligada, ao finalizar o packing o sistema imprime a DANFE simplificada (ou declaração de conteúdo) junto. Desligada, imprime apenas a etiqueta de transporte.
Importante: isso muda só a impressão — a emissão da nota fiscal continua normal. Você não deixa de emitir NF; apenas para de imprimir a DANFE em separado, já que a etiqueta da Shopee já a espelha.
A etiqueta de envio em si é o modelo padrão da transportadora do canal — ela não é personalizável pelo idworks (não dá, por exemplo, para acrescentar o código do SKU na etiqueta). Se a etiqueta da entrega direta estava saindo fora do padrão, normalmente é porque a integração da transportadora estava em branco no pedido: vincular a integração da Shopee à transportadora faz a etiqueta voltar ao padrão do canal.
Pedido da Shopee integrou zerado por cupom/desconto (NF R$ 0,00)
Pedidos da Shopee com cupom, voucher ou desconto grande podem entrar no idworks com valor zerado (ou bem menor que o real), gerando NF de valor incorreto e, às vezes, impedindo a etiqueta de sair por falta de valor. Isso acontece quando a integração está configurada para não incluir esses valores no pedido.
No grupo Integração de Vendas (ver tabela acima), a Shopee tem parâmetros que controlam o que entra ou não no valor do pedido:
- Não incluir o valor do desconto Shopee
- Não incluir o valor do desconto Seller
- Não incluir o valor do voucher Shopee
- Não incluir o valor do voucher Seller
- Não incluir valor pago em moedas Shopee
Como resolver: revise esses parâmetros na configuração da integração Shopee e desligue os que estiverem fazendo o valor sumir do pedido, conforme a regra fiscal que você quer aplicar. Depois de ajustar, os próximos pedidos integram com o valor correto.
Se um pedido já integrado ficou com o valor errado e você precisa corrigir os valores manualmente, abra o pedido (em Vendas → Pedidos), vá na aba Fiscal e ligue a opção Cálculo manual impostos — só com ela ligada os campos fiscais de cada item ficam editáveis. Com ela desligada, o sistema usa as regras do departamento fiscal e os campos ficam apenas para leitura. A ação Editar Detalhes Fiscais de cada item exige o privilégio Editar Detalhes Fiscais Pedido.
Checklist depois de integrar a Shopee
Depois de ativar e autenticar a integração, vale conferir esta lista antes de começar a anunciar — ela cobre os pontos que mais geram erro na primeira sincronização:
- Status da integração Ativo — em Configurações → Integrações → Minhas Integrações, confirme que a Shopee está Ativo (não Não Autenticado nem Erro). Se estiver pendente, conclua a autenticação (ver Como autenticar e validar as credenciais?).
- De/para preenchidos — confira o de/para de armazéns e o de/para de formas de pagamento (este último só é exigido se você ativou Detalhar forma de pagamento). O de/para reflete a rotina da sua operação — não há um "certo único".
- Atualizações ligadas — no grupo Integração de Produtos, ative o que você quer que o idworks envie: Atualizar saldo estoque, Atualizar preço, Atualizar produto, etc.
- Armazéns para somar quantidade — só preencha se você soma o saldo de vários armazéns. Produto em um único armazém: deixe em branco (preencher errado zera o saldo).
- Logística configurada no canal — os parâmetros de logística/frete precisam estar configurados dentro da Shopee (no Seller Center). Falta de logística no canal gera erro ao cadastrar o anúncio.
- Cadastro do produto completo — antes de sincronizar, garanta no SKU: dimensões e peso maiores que zero, código de barras EAN-13 válido em cada variação, categoria e especificações/atributos da Shopee preenchidos, e imagens em JPEG ou PNG. São esses campos que mais aparecem nos erros de sincronização ("tamanho do pacote deve ser maior que 0", "código de barras inválido", atributos da categoria).
Se ainda restar dúvida sobre os erros de sincronização, cada mensagem tem sua própria seção em Erros comuns acima.
Importei anúncios direto na Shopee — devo continuar criando por lá?
Você pode trazer para o idworks anúncios que já criou direto na Shopee (criar o anúncio no idworks, preencher o código do anúncio do canal e usar Baixar Completo — o passo a passo completo está em Anúncios). Mas, como boa prática, recomendamos criar os anúncios pela idworks sempre que possível.
Motivo: anúncios criados pela idworks já nascem com categoria, especificações, dimensões e vínculo de SKU corretos — que são exatamente os campos cuja ausência trava a sincronização de saldo e a publicação na Shopee. Anúncios criados direto no canal e só vinculados depois costumam chegar com a ficha incompleta, e é aí que aparecem os problemas de "estoque não atualiza" e "erro de atributos".
Se você tem uma conta nova inteira (dezenas ou centenas de anúncios) para trazer de uma vez, abra um chamado no suporte informando as contas/integrações — esse volume é importado em lote, em vez de um a um.
Ativei "Atualizar saldo de estoque" e o estoque foi para zero
Quando você liga Atualizar saldo estoque e o anúncio passa a mostrar 0 (ou o estoque simplesmente não sobe), quase sempre é a origem do saldo que está mal configurada, e não falta de estoque:
- Anúncio sem vínculo com o SKU certo — se o anúncio não está vinculado ao SKU, o idworks envia 0. Confira o vínculo em Integrações → Anúncios.
- Armazém de envio — se você usa Armazéns para somar quantidade, só o saldo desses armazéns é enviado; se ficar em branco, vale o armazém do de/para. Confirme que o armazém com saldo está selecionado.
- Percentual disponibilidade de estoque — se estiver baixo, envia apenas uma fração do saldo (ex.: 100 unidades com percentual baixo envia pouco ou nada).
- Estoque de segurança — se o saldo estiver abaixo do estoque de segurança, o anúncio é pausado para não vender sem estoque.
Como resolver: confira esses quatro pontos no grupo Integração de Produtos (ver tabela acima), garanta o vínculo do anúncio ao SKU correto e refaça a sincronização de estoque.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |