Shopify
A integração com o Shopify 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 43 parâmetros distribuídos em 3 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: E-commerce.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Referência rápida
O que é a integração Shopify?
É a conexão entre o canal Shopify e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é E-commerce), 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 → Shopify.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Shopify 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
5 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Chave Api | Senha | Insira a chave de API do app privado. Dentro do portal da shopify, configurações -> aplicativos e canais de venda -> desenvolver |
| Senha | Senha | Insira a senha do app privado. [começa com shppa] |
| Shop | Texto | Insira o nome da conta na plataforma. [nome antes do myshopify.com] |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
| Url loja | Texto | Inserir o dominio da loja para permitir a visualização de anúncios de forma rápida e efetiva no site. Incluir, por exemplo "https://www.teste.com.br" |
Integração de Vendas
15 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. |
| Importar pedidos pendente pagamento | Sim/Não | Importar pedidos no status de pagamento pendente para reservar o estoque |
| 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. |
| Dividir pedido entre multiplos armazéns | Sim/Não | Quando ativo, se o pedido estiver em mais de um armazém, será feito o split e criado um pedido para cada armazém |
| Utilizar nome transportadora de/para | Sim/Não | Ao ativar, será considerado o nome da transportadora ao invés do código para realizar o de/para |
| Concatenar armazém e transportadora para de/para | Sim/Não | Ao ativar, será concatenado o armazém junto a transportadora para realizar o de/para |
| Marcar como enviado item a item | Sim/Não | Ao ativar, será enviado item a item faturado para a Shopify. Desta forma, será possível fazer envios parciais. Por exemplo, se o pedido tem 2 itens e foi enviado apenas 1, será marcado apenas 1 como enviado na Shopify |
| Mapeamento metafield da data emissão da NF | Texto | Código do metafield na shopify para envio da data e hora da emissão da Nota Fiscal. |
| Mapeamento metafield link da Danfe | Texto | Código do metafield na shopify para envio do link da Danfe |
| Mapeamento metafield link do XML da NF | Texto | Código do metafield na shopify para envio do link do XML da Nota |
| Mapeamento metafield chave de acesso da NF | Texto | Código do metafield na shopify para envio da chave de acesso da Nota Fiscal |
| Usar código de referência | Sim/Não | Usar código de referência do canal como pedido de origem |
| Bloquear pedidos com alto risco de fraude | Sim/Não | Quando habilitado, pedidos identificados com alto risco de fraude não seguirão o fluxo automático de processamento e serão enviados para o status ‘Validar risco’. O cancelamento deverá ser realizado manualmente após análise do usuário. |
Integração de Produtos
23 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Criar oferta | Sim/Não | Ative se quiser criar a oferta automaticamente, se cadastro do SKU existir no marketplace |
| 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. |
| Baixar cadastro produto | Sim/Não | Ative se quiser baixar produtos criados no marketplace |
| 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 |
| Atualizar SKU | Sim/Não | Ative se quiser enviar a atualização de SKU 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 |
| Utilizar categoria como coleção | Sim/Não | Ative se quiser utilizar a árvore de categoria como coleção. Será necessário cadastrar o de/para das categorias com o código na plataforma |
| Criar produto status rascunho | Sim/Não | Ao ativar, quando for criado um novo produto, ele vai ser no status de rascunho. Será necessário ativar o produto diretamente do painel da plataforma |
| Inativar produto como rascunho | Sim/Não | Ao ativar, quando um anúncio for marcado dentro da idworks como inativo e sincronizado na paltaforma, o status irá mudar para rascunho |
| Enviar categoria nas tags | Sim/Não | Ao ativar, a árvore de categoria da idworks será enviada como tag, sendo cada nível enviado separadamente |
| Mapeamento metafield altura variação | Texto | Código do metafield na shopify para enviado da altura. O campo precisa estar em centimetros |
| Mapeamento metafield comprimento variação | Texto | Código do metafield na shopify para enviado da comprimento. O campo precisa estar em centimetros |
| Mapeamento metafield largura variação | Texto | Código do metafield na shopify para enviado da largura. O campo precisa estar em centimetros |
| Criar imagem capa da variação | Sim/Não | Ao ativar, a primeira imagem da variação será usada como capa no anúncio |
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. |