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:
Acessar o Dev Dashboard da Shopify
Criar um novo aplicativo, para integrar com a Martz
Instalar o aplicativo
Obter os dados de autenticação
Obter o nome da loja
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:
Nome: pode ser "Martz" ou outro a sua escolha
Escopos (copie e cole a lista abaixo):
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:
No seu aplicativo, selecione Início no painel esquerdo do Painel de Controle do Desenvolvedor.
Deslize para baixo e selecione Instalar aplicativo .
Selecione ou crie a loja para seu aplicativo.
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:
No painel de controle do Dev Dashboard da Shopify, selecione o aplicativo recém criado e selecione Configurações .
Copie seu ID de cliente e segredo do cliente .
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
Faça login no painel da sua loja Shopify.
No menu lateral esquerdo, clique em Configurações (Settings) no canto inferior esquerdo.
Selecione Domínios (Domains).
Na seção "Domínios", o seu endereço original
nomedaloja.myshopify.comestará 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.comou 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:
Acesse a área de Integrações, dentro do menu de Configurações, em seu painel da Martz
Na tela de integrações, dentro da seção de "E-commerces", encontre a Shopify e clique em "Integrar"
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.




