RevGlanceDocumentação

Shopify

Conecte uma loja Shopify por meio de um app do Dev Dashboard para ler pedidos, reembolsos, taxas e contratos de assinatura.

O RevGlance lê sua loja pela GraphQL Admin API do Shopify. Ele entra com o client ID e o secret do seu app (o client credentials grant), o que só funciona para lojas da própria organização do app.

Conectar

  1. No Dev Dashboard do Shopify, crie um app na mesma organização da sua loja.
  2. Dê a ele os escopos read_orders, read_all_orders, read_own_subscription_contracts e read_customers, publique uma versão e instale o app na sua loja.
  3. Nas Settings do app, copie o Client ID e o Client secret (ele começa com shpss_).
  4. Preencha o endereço .myshopify.com da sua loja e os dois valores, e escolha Conectar Shopify.

O que o formulário pede

CampoFormato
Lojaacme.myshopify.com
Client ID1a2b3c4d5e6f…
Client secretArmazenado criptografadoshpss_…

Adicione o webhook

O Shopify assina seus webhooks com o client secret do app, que a fonte já tem, então não há segredo para colar.

  1. No RevGlance, abra Configurações › Fontes, abra o menu da fonte Shopify e escolha Webhook. Copie o URL.
  2. Na configuração do seu app, assine os tópicos de pedido, reembolso e contrato de assinatura com esse URL como endpoint e publique a mudança.

O que o RevGlance sincroniza

  • Pedidos pagos, antes dos impostos, na moeda da loja, com as taxas do Shopify Payments. Pedidos de teste ficam de fora. O escopo read_all_orders permite que a primeira sincronização volte além dos 60 dias padrão do Shopify.
  • Reembolsos, descontando os impostos na mesma proporção do pedido.
  • Contratos de assinatura do Shopify Subscriptions e dos apps construídos sobre ele, para MRR. Pedidos criados por um selling plan contam como recorrentes.

O Shopify não informa data nem motivo de cancelamento, então um contrato cancelado termina na data da sua última alteração.

Como o Shopify é contado

  • Pedidos pagos contam antes de impostos, na moeda da loja, com as taxas do Shopify Payments como taxa. Pedidos de teste ficam de fora.
  • Os reembolsos incluem impostos, então o RevGlance retira os impostos na mesma proporção do pedido.
  • O MRR vem dos contratos de assinatura (Shopify Subscriptions e apps criados sobre ele), após os descontos. Pedidos criados por um plano de venda contam como recorrentes.
  • O Shopify não informa data nem motivo de cancelamento: um contrato cancelado, expirado, com falha ou pausado termina na última alteração.
  • Um pedido pago parcialmente conta o que entrou até agora.
  • Onde os preços incluem impostos, o MRR conta antes de impostos, na proporção de impostos do primeiro pedido.
  • Os contratos de assinatura não trazem datas de teste, então os testes não são mostrados.
  • Estornos não são lidos, então um perdido continua contado como cobrança, a menos que o provedor também o informe como reembolso.
  • Cobranças com falha não são informadas, então esse número fica em zero.