Este guia irá ajudá-lo a configurar a integração entre a sua loja Shopify e a RO App. Irá aprender a preparar a sua conta Shopify e a ligar a sua loja para importar automaticamente ordens, clientes e produtos.
Depois de configurado, os dados serão sincronizados a cada minuto e o trabalho com ordens tornar-se-á rápido e conveniente.
⭐ Esta integração está disponível a partir do plano de subscrição All-in-One.
Importante: as novas lojas Shopify são conectadas através da API GraphQL Admin. As lojas que estavam conectadas anteriormente usando a API legada continuam a funcionar corretamente — nenhuma ação adicional é necessária.
Passo 1. Prepare a sua conta Shopify.
Você precisa criar e instalar a aplicação a partir da conta do proprietário da loja no Shopify.
1. Na sua loja Shopify, aceda a My store > Dev Dashboard.
2. Clique em Create app.
3. Introduza o nome da aplicação (por exemplo, RO App) e clique em Create.
4. Na página seguinte (Versions), no bloco Access, no campo Scopes, introduza o seguinte texto:
Read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,read_customer_data_erasure,read_customer_merge,read_delivery_customizations,read_price_rules,read_discounts,read_discounts_allocator_functions,read_discovery,read_files,read_fulfillment_constraint_rules,read_fulfillments,read_gift_card_transactions,read_gift_cards,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_delivery_option_generators,read_locations,read_marketing_integrated_campaigns,read_marketing_events,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,write_order_edits,read_order_edits,read_orders,write_orders,read_payment_customizations,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,read_returns,write_returns,read_shopify_payments_provider_accounts_sensitive,read_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,read_content,write_content,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations
5. Clique em Release na parte inferior da página, adicione o nome da versão (por exemplo, 1) na janela pop-up e clique em Release.
6. Vá para a secção Home e clique em Install app no bloco Installs.
7. Selecione a loja para a qual pretende instalar esta aplicação.
❗ Se tiver várias lojas, precisa criar um aplicativo separado para cada uma delas.
8. Clique em Install.
9. Volte para My store > Dev Dashboard e abra o aplicativo que criou.
10. Vá para a secção Settings e copie o Client ID e o Secret no bloco Credentials.
A configuração do aplicativo no Shopify está concluída! Em seguida, precisa conectar o Shopify ao RO App.
Etapa 2. Conectando a sua loja Shopify ao aplicativo RO
1. Vá para Configurações > E-commerce Connect.
2. Clique em + Loja e marque a caixa de seleção integração habilitada.
3. No campo Fonte, selecione Shopify.
4. Preencha todos os campos obrigatórios:
Nome — nome da loja;
URL do site — link para o seu site Shopify (por exemplo, gadgetlytest.myshopify.com)
Client ID — cole a Client ID copiada das configurações da aplicação no Shopify;
Client Secret — cole o Secret copiado das configurações da aplicação no Shopify;
Localizações — selecione as localizações onde as ordens do Shopify serão criadas;
Tipo de ordem — selecione o tipo de ordens importadas do Shopify;
💡 Dica
Crie um tipo de ordem especial apenas para ordens do Shopify e configure os campos necessários nele.
Também pode definir valores predefinidos para esses campos. Se a plataforma não fornecer um valor para um campo específico ao importar ordens de serviço, esse campo será preenchido automaticamente com o valor especificado no editor de formulários.
Identificar produtos por — selecione o parâmetro (nome, SKU ou ID do produto) pelo qual os produtos da plataforma serão identificados quando forem atualizados nas ordens do RO App. Isso é necessário para evitar a duplicação de produtos.
Gerentes — selecione os funcionários que serão designados como gerentes para as ordens importadas.
Observação: para que a integração funcione corretamente, os funcionários atribuídos pelos gerentes a essas ordens devem ter o direito Exibir funcionário na lista de gerentes ativado.
5. Configurar mapeamentos fiscais.
Através dos mapeamentos fiscais, pode associar as taxas de imposto transmitidas a partir de uma encomenda do Shopify aos impostos configurados na RO App. Depois disso, ao importar ou atualizar uma ordem de serviço, o sistema aplicará automaticamente os impostos correspondentes da RO App às linhas da ordem de serviço.
A coluna «Impostos do Shopify» apresenta os impostos configurados na sua conta do Shopify. Pode encontrar as definições fiscais em: Admin do Shopify → Configurações → Impostos e taxas. Pode configurar as taxas de imposto para cada Região fiscal.
IVA — Imposto sobre o Valor Acrescentado;
GST — Imposto sobre Bens e Serviços;
Imposto sobre vendas — Imposto sobre vendas;
Por outras palavras, o conjunto específico de impostos depende do país e da região onde o vendedor está registado e vende produtos.
O nome do imposto a utilizar no mapeamento pode ser encontrado nas ordens de serviço. Copie-o e cole-o no campo Impostos do Shopify na RO App.
Que impostos são transferidos do Shopify para a aplicação RO App
Apenas os impostos gerais configurados para toda a encomenda são transferidos. Os impostos adicionais definidos para produtos individuais não são transferidos.
A coluna Impostos da aplicação RO App apresenta todos os impostos configurados e ativados na página Configurações > Finanças. Se um imposto for desativado na aplicação RO App após a sincronização, deixará de ser aplicado às ordens de serviço.
6. Clique em Salvar e importar ordens.
Depois disso, será realizada uma importação única de ordens, produtos e clientes do Shopify para o RO App. O processo pode demorar algum tempo, dependendo do número de ordens a serem importadas. Graças a uma sincronização adicional, todas as novas ordens da plataforma Shopify serão automaticamente enviadas para o RO App, e os dados de todas as ordens importadas serão atualizados a cada minuto.
Atenção: todas as ordens criadas nos últimos 2 meses serão importadas, exceto as ordens concluídas, canceladas e reembolsadas.
Como editar e eliminar uma integração
Para editar as definições de integração, abra a integração desejada, faça as alterações e guarde as definições.
Para eliminar uma integração com uma loja, abra-a, clique no botão eliminar e confirme a ação.