Passar para o conteúdo principal

Shopify

Este artigo explica, em um tutorial guiado, como ativar a integração entre sua conta Martz e sua loja na Shopify.

Atualizado essa semana

Aplicativo na Shopify

Para integrar sua loja com a Martz, precisaremos de um token de autenticação.

Para obter o token de autenticação, será necessário:

  1. Acessar o Dev Dashboard da Shopify

  2. Criar um novo aplicativo, para integrar com a Martz

  3. Instalar o aplicativo

  4. Obter os dados de autenticação

  5. Obter o nome da loja

  6. Integrar com a Martz pelo nosso painel

Importante: que este processo seja feito pelo titular da conta na Shopify, pois mesmo com permissões totais, a Shopify pode não permitir a instalação do aplicativo por um usuário que não é o titular.

Acessar o Dev Dashboard

Dentro do seu painel da Shopify, clique no botão para acessar o Dev Dashboard ou acesse https://dev.shopify.com/dashboard.

Criar um novo aplicativo

Dentro do Dev Dashboards, vá em Apps > Criar um app > "Começar pelo Dev Dashboard".

Siga os passos nesta documentação da Shopify para criar o aplicativo.

Durante a criação do aplicativo, você precisará informar:

read_all_orders,read_analytics,read_app_proxy,read_apps,read_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_cart_transforms,read_all_cart_transforms,read_validations,read_cash_tracking,read_channels,read_checkout_branding_settings,read_checkouts,read_companies,read_custom_fulfillment_services,read_custom_pixels,write_custom_pixels,read_customers,read_customer_data_erasure,read_customer_payment_methods,read_customer_merge,read_delivery_customizations,read_price_rules,write_price_rules,read_discounts,write_discounts,read_discounts_allocator_functions,write_discounts_allocator_functions,read_discovery,read_draft_orders,read_files,read_fulfillment_constraint_rules,read_fulfillments,read_gift_card_transactions,read_gift_cards,write_gift_cards,read_inventory,read_inventory_shipments,read_inventory_shipments_received_items,read_inventory_transfers,read_legal_policies,read_delivery_option_generators,read_locales,read_locations,read_marketing_integrated_campaigns,read_marketing_events,read_markets,read_markets_home,read_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,read_online_store_navigation,read_online_store_pages,read_order_edits,read_orders,read_packing_slip_templates,read_payment_mandate,read_payment_terms,read_payment_customizations,read_pixels,write_pixels,read_privacy_settings,read_product_feeds,read_product_listings,read_products,read_publications,read_purchase_options,read_reports,read_resource_feedbacks,read_returns,read_script_tags,write_script_tags,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,read_store_credit_account_transactions,read_store_credit_accounts,read_own_subscription_contracts,read_themes,read_third_party_fulfillment_orders,read_translations

  • Versão dos Webhooks: 2025-10

Instalar o aplicativo aplicativo

Siga os passos abaixo para instalar seu aplicativo em uma loja:

  1. No seu aplicativo, selecione Início no painel esquerdo do Painel de Controle do Desenvolvedor.

  2. Deslize para baixo e selecione Instalar aplicativo .

  3. Selecione ou crie a loja para seu aplicativo.

  4. Selecione Instalar .

Seu aplicativo já está instalado. Para começar a fazer chamadas à API, você precisará autenticar seu aplicativo conforme descrito na próxima etapa.

Obter os dados de autenticação

Estamos quase lá. Para obter as credenciais necessárias para conexão na Martz:

  1. No painel de controle do Dev Dashboard da Shopify, selecione o aplicativo recém criado e selecione Configurações .

  2. Copie seu ID de cliente e segredo do cliente .

  3. Use essas credenciais na próxima etapa, dentro do painel da Martz

Com o token em mãos, siga para a sua conta na plataforma da Martz.

Obter o nome/domínio da loja

O nome da loja é uma informação necessária na integração com a Martz, assim como as credenciais listadas acima. Para encontrá-lo, você pode seguir um das opções abaixo.

Pelo Painel de Controle (Admin) da Shopify

  1. Faça login no painel da sua loja Shopify.

  2. No menu lateral esquerdo, clique em Configurações (Settings) no canto inferior esquerdo.

  3. Selecione Domínios (Domains).

  4. Na seção "Domínios", o seu endereço original nomedaloja.myshopify.com estará listado como um dos domínios da loja.

Neste caso, o valor a ser preenchido no campo "Nome da conta (loja)" é nomedaloja.

Pela URL do Navegador

Quando você estiver logado no painel administrativo da Shopify, olhe para a barra de endereços do navegador (Chrome, Safari, etc.).

  • A URL aparecerá no formato: ://admin.shopify.com ou diretamente como ://nome-da-loja.myshopify.com.

  • Neste caso, o valor a ser preenchido no campo "Nome da conta (loja)" é nome-da-loja, que é o início do seu domínio .myshopify.com.

Pelo E-mail de Cadastro

Procure no seu e-mail por mensagens enviadas pela Shopify quando você criou a conta. O e-mail de "Boas-vindas" ou de confirmação de cadastro geralmente contém o link direto da sua loja no formato *.myshopify.com.

Neste caso, o valor a ser preenchido no campo "Nome da conta (loja)" é o que vem no lugar do "*" em *.myshopify.com.

Usando o "Esqueci minha loja" (Recuperação)

Se não conseguir acessar o painel, acesse a página de login da Shopify e clique em "Esqueci minha loja". Digite o e-mail que você usa para a loja e a Shopify enviará uma lista de todas as lojas associadas àquele e-mail, incluindo o endereço .myshopify.com.

Integrar no painel da Martz

Com as credenciais em mãos e os devidos acessos concedidos, siga para o painel da Martz, e finalize sua integração. Para isso:

  1. Acesse a área de Integrações, dentro do menu de Configurações, em seu painel da Martz

  2. Na tela de integrações, dentro da seção de "E-commerces", encontre a Shopify e clique em "Integrar"

  3. Preencha os campos solicitados no modal e clique em "Criar integração"

    • Campo de seleção: Aplicação via Partner Dashboard

    • Nome da conta (loja): valor obtido nas seções anteriores

    • Client ID: valor obtido nas seções anteriores

    • Secret: valor obtido nas seções anteriores

Pronto! Agora é só aguardar que nós começaremos a sincronizar as informações da sua loja com o seu painel da Martz.

Essa sincronização pode demorar até 1 hora para ser iniciada. O tempo de término vai depender do tamanho da base da sua loja, pode levar algumas horas para finalização do recebimento dos dados.

Respondeu à sua pergunta?