Shein
A integração com o Shein 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 46 parâmetros distribuídos em 5 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
Pedidos
- Pedidos atendidos pelo estoque da Shein (fulfillment)
- Como os descontos e cupons entram no valor do pedido?
- Pedido devolvido entrou com valor zerado
Erros mais comuns
Referência rápida
O que é a integração Shein?
É a conexão entre o canal Shein 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 → Shein.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Shein 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
3 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| openKeyId | Texto | openKeyId |
| secretKey | Senha | secretKey |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
11 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| 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) |
| Excluir desconto de campanha | Sim/Não | Ative se quiser que a idworks subtraia do pedido o valor de desconto de campanha |
| Excluir desconto total de cupom | Sim/Não | Ative se quiser que a idworks subtraia do pedido o valor do desconto total de cupom |
| Excluir valor comissão na NF para PF | Sim/Não | Ative se quiser excluir o valor da comissão do marketpalce na Nota Fiscal quando a venda for para pessoa física (PF) |
| 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. |
| Cancelar pedido automaticamente | Sim/Não | Ative se quiser cancelar pedido automaticamente caso ele seja cancelado no canal de vendas |
| Consultar etiqueta automaticamente | Sim/Não | Ao ativar, a etiqueta é consultada e baixada automaticamente no canal de vendas assim que a nota fiscal do pedido é emitida. |
| Margem mínima desejável | % | Percentual mínimo de margem de contribuição para os pedidos desta integração. Quando a margem do pedido fica abaixo do valor configurado, o pedido é enviado para aprovação de margem em vez de seguir o fluxo automático. |
| Checar taxa/imposto efetivo do pedido | Sim/Não | Ao ativar, o sistema valida a margem de contribuição no fechamento do pedido. Exige que a Margem mínima desejável (ou a taxa efetiva) esteja preenchida. |
Integração de Produtos
15 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser enviar a atualização de saldo de estoque 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 |
| 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 |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| 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 |
| 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. |
| 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 |
| 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 |
| Frete grátis? | Sim/Não | Ative se quiser oferecer Frete Grátis acima de algum valor no marketplace |
| Valor frete grátis | Decimal | Qual o valor mínimo para conceder Frete Grátis no marketplace? |
| 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 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. |
Conciliação
11 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Ativar conciliação | Sim/Não | Ativar a conciliação para importar as transações |
| 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 |
| Atualizar comissão marketplace ao realizar conciliação | Sim/Não | Ao ativar, as taxas de marketplace serão atualizadas no pedido conforme a conciliação é feita. Essa parametrização pode afetar os relatórios de resultado e também a aba de resultado no pedido, uma vez que a comissão do marketplace pode mudar para maior ou menor |
Importação de Anúncios
6 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 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 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. |
Pedidos atendidos pelo estoque da Shein (fulfillment)
Nem todo pedido da Shein sai do seu estoque. Quando a venda é atendida a partir do estoque que está com a Shein, o pedido chega ao idworks identificado com o armazém do canal fulfillment — e o tratamento é diferente do pedido comum:
- O pedido entra direto no status Fulfillment, sem passar pela separação, faturamento e expedição do idworks. Quem separa e envia é o canal.
- Não há reserva nem baixa de estoque no seu armazém para esses itens.
- Sem o De-Para de armazém para o código
fulfillment, o pedido não é criado e a integração avisa que falta o De-Para de armazém informando o código que veio do canal.
Como preparar:
- Abra o De-Para de Armazéns da integração Shein.
- Cadastre o vínculo do armazém do canal
fulfillmentcom o armazém do idworks que você usa para representar o estoque que está com o marketplace. - Mantenha o vínculo do armazém comum (pedidos que saem do seu estoque) — os dois convivem na mesma integração.
Se você usa Selecionar armazém com saldo ao criar pedido, ela não se aplica aos pedidos de fulfillment: nesses casos o armazém sempre vem do De-Para do código
fulfillment.
Como os descontos e cupons entram no valor do pedido?
A Shein informa dois tipos de desconto em cada pedido, e cada um tem a sua parametrização no grupo Integração de Vendas (Configurações → Integrações → Minhas Integrações → Shein → Configurar parâmetros):
| Desconto informado pela Shein | Parametrização | Com a parametrização ativa | Com a parametrização desativada |
|---|---|---|---|
| Desconto total de cupom (cupom da loja) | Excluir desconto total de cupom | É subtraído do valor do pedido e entra como desconto do pedido | É registrado como cupom do marketplace |
| Desconto de campanha (promoção do canal) | Excluir desconto de campanha | É subtraído do valor do pedido e entra como desconto do pedido | É registrado como cupom do marketplace |
Ou seja: o desconto concedido na Shein sempre aparece no pedido — a parametrização decide se ele reduz o faturamento (excluído) ou se é tratado como custo de cupom do canal (não excluído).
O valor registrado como cupom do marketplace:
- aparece na linha Cupom do resultado do pedido e nos relatórios de vendas;
- entra como custo de marketplace no cálculo da margem de contribuição, junto com a comissão e a taxa de serviço do canal;
- por isso influencia a aprovação de margem quando a Margem mínima desejável está preenchida — um pedido com cupom alto pode cair em aprovação mesmo com o preço cheio.
Para o lançamento contábil desse valor na conciliação, use Plano de contas cupom, no grupo Conciliação.
Pedido devolvido entrou com valor zerado
Quando um pedido é devolvido, a Shein passa a devolver os totais do pedido zerados, mantendo os valores apenas item a item. Se a importação do pedido acontecesse depois da devolução, ele entrava no idworks com valor de produto, comissão e taxas em 0,00 — o que distorcia o resultado do pedido e a conciliação.
O idworks agora identifica essa situação: quando o total de produtos vem zerado mas os itens têm valor, ele reconstrói o pedido somando os itens —
- valor dos produtos;
- comissão do marketplace;
- taxa de serviço do canal;
- desconto de cupom e desconto de campanha.
Em pedido normal nada muda: os valores por item e os totais do pedido são iguais, e o idworks continua usando os totais informados pela Shein.
A correção vale para as importações feitas a partir dessa atualização. Pedidos que já haviam entrado zerados antes disso mantêm os valores como estão — confira esses casos pelo resultado do pedido antes de conciliar.
"Failed to print the sheet — current order cannot print the shipping label, please wait"
Mensagem "Order number: GSH... Failed to print the sheet, reason for failure: [The current order cannot print the shipping label, please wait for it to be processed and try again!]" (ou a versão em chinês "当前订单不可打印面单，请等待处理后重试！", com o mesmo significado). Não é erro do idworks — é o próprio Shein dizendo que o pedido ainda não está pronto para gerar a etiqueta de envio.
O Shein passa cada pedido por uma fila interna antes de liberar a etiqueta: validação do pagamento, conferência fiscal, atribuição de transportadora. Enquanto qualquer dessas etapas não conclui, a impressão da etiqueta fica bloqueada e o canal devolve esse aviso. É a situação mais comum em pedidos muito recentes (minutos após a aprovação) e em pedidos do final do expediente (Shein processa em lotes).
Como resolver:
- Aguarde alguns minutos e tente imprimir de novo. Em pedidos novos, a liberação costuma sair em até 15 minutos depois da aprovação do pagamento.
- Se o pedido tem mais de algumas horas com a mesma mensagem, abra o painel do Shein (Seller Center) e veja o status do pedido: pode estar parado em validação fiscal ou em atribuição manual da transportadora.
- Se o Shein mostrar uma pendência (CNPJ não autorizado, valor divergente, restrição), resolva pelo painel — o idworks só consegue imprimir depois que o canal libera.
- Se a mensagem persistir por dias, é sinal de cancelamento silencioso do canal — confira em Hub → Pedidos Integrados se o pedido voltou como cancelado.
Para evitar o erro em rotina diária, espere o pedido chegar ao status Pronto para envio no Shein antes de mandar imprimir em massa. Imprimir muito cedo desperdiça tentativas e polui o log de integrações.
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. |