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
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) |
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. |