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 52 parâmetros distribuídos em 4 grupo(s): Credenciais de Acesso, Integração de Vendas, Integração de Produtos e Pedido.
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
Pedidos e pagamento
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
23 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Empresa Faturadora dentro estado PF | Lista | Empresa responsável pelo faturamento dos pedidos de pessoa física (PF) dentro do estado de origem. |
| Empresa Faturadora fora estado PF | Lista | Empresa responsável pelo faturamento dos pedidos de pessoa física (PF) fora do estado de origem. |
| 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. |
| Armazéns para importar pedido | Texto | Informe os códigos dos armazéns da Shopify cujos pedidos devem ser importados, separados por vírgula. Em branco, importa pedidos de todos os armazéns. Útil para empresas multi-loja na Shopify que querem que cada integração baixe apenas pedidos do seu próprio depósito. |
| 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. |
| Priorizar transportadora cadastro cliente | Sim/Não | Ao ativar, antes de criar o pedido o sistema verifica se o cliente tem transportadora no cadastro. Se tiver, usa essa transportadora no pedido em vez da que veio do canal — dispensando o De-Para de transportadora nesse caso. |
| Mapeamento note_attribute do TID | Texto | Nome do campo adicional do pedido na Shopify (note attribute) que carrega o TID do pagamento. Só é considerado com Usar ID da transação Shopify como TID desativado. |
| Mapeamento note_attribute do NSU | Texto | Nome do campo adicional do pedido na Shopify (note attribute) que carrega o NSU do pagamento. Só é considerado com Usar ID da transação Shopify como TID desativado. |
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 |
Pedido
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Usar ID da transação Shopify como TID | Sim/Não | Ao ativar, usa o código da transação da própria Shopify como TID (e NSU) do pagamento, em vez de buscar o código na adquirente/gateway (PagarMe, Mercado Pago). Útil quando a conciliação financeira é feita pelo identificador da Shopify. |
Importação de Anúncios
9 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 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. |
De onde o idworks tira o TID e o NSU do pagamento?
O TID e o NSU são os códigos que a conciliação financeira usa para casar o pedido com o repasse da adquirente. Na Shopify eles podem vir de três lugares, e o idworks segue esta ordem:
- Com "Usar ID da transação Shopify como TID" ativo — usa o código da própria transação da Shopify como TID e NSU. Nada mais é consultado.
- Com o parâmetro acima desativado e "Mapeamento note_attribute do TID" / "Mapeamento note_attribute do NSU" preenchidos — usa o valor do campo adicional do pedido cujo nome você informou. É o caminho para quando o checkout (ou um aplicativo da loja) grava o TID e o NSU nesses campos.
- Sem nenhum dos dois — o idworks busca os códigos direto na adquirente/gateway do pagamento (PagarMe, Mercado Pago, Appmax, PayPal) ou usa o que a própria transação da Shopify trouxer.
Cuidados ao usar o mapeamento de campo adicional:
- Escreva o nome do campo exatamente como ele aparece no pedido da Shopify (maiúsculas e minúsculas contam). Se o pedido não tiver esse campo, o idworks segue para o passo 3.
- O mapeamento é ignorado enquanto Usar ID da transação Shopify como TID estiver ativo — use um ou outro.
- Pagamentos que são desdobramento de outra transação (a captura de uma autorização, por exemplo) não geram um segundo lançamento no pedido: o idworks considera apenas a transação original, para não duplicar o valor pago.
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. |