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
Versão dos Webhooks: 2025-10
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
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.
Webhook no painel Shopify
O cadastro de webhook é importante para que a Shopify envie para a Martz algumas informações, como por exemplo códigos de rastreio.
Painel da loja Shopify
Acesse o painel da sua loja na Shopify → admin.shopify.com
Vá em Configurações → Notificações → Role até o final da página e clique em "Webhooks"
Clique em "Criar webhook" e preencha os campos:
Evento: Criação de processamento do pedido.
Formato: JSON
Versão da API do Webhook: Utilize a mais recente e estável
⚠️ Atenção: Para conseguir o valor do {storeId} vá até o painel de desenvolvedor da Shopify por meio do caminho: Desenvolvimento de apps → Desenvolver apps no dev dashboard → Clique no App Martz → Configurações (no menu lateral) → Copie o ID do cliente e cole no lugar de {storeId} na url mencionada acima.