RevGlanceDocumentación

Shopify

Conecta una tienda de Shopify a través de una app del Dev Dashboard para leer pedidos, reembolsos, comisiones y contratos de suscripción.

RevGlance lee tu tienda a través de la GraphQL Admin API de Shopify. Inicia sesión con el client ID y el secreto de tu app (el flujo client credentials), que solo funciona con tiendas de la propia organización de la app.

Conectar

  1. En el Dev Dashboard de Shopify, crea una app en la misma organización que tu tienda.
  2. Dale los scopes read_orders, read_all_orders, read_own_subscription_contracts y read_customers, publica una versión e instala la app en tu tienda.
  3. En los Settings de la app, copia el Client ID y el Client secret (empieza por shpss_).
  4. Rellena la dirección .myshopify.com de tu tienda y ambos valores, y elige Conectar Shopify.

Qué pide el formulario

CampoAspecto
Tiendaacme.myshopify.com
Client ID1a2b3c4d5e6f…
Client secretSe guarda cifradoshpss_…

Añadir el webhook

Shopify firma sus webhooks con el client secret de la app, que la fuente ya tiene, así que no hay ningún secreto que pegar.

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente de Shopify y elige Webhook. Copia la URL.
  2. En la configuración de tu app, suscríbete a los temas de pedidos, reembolsos y contratos de suscripción con esa URL como endpoint, y publica el cambio.

Qué sincroniza RevGlance

  • Pedidos pagados, antes de impuestos, en la moneda de la tienda, con las comisiones de Shopify Payments. Los pedidos de prueba quedan fuera. El scope read_all_orders permite que la primera sincronización vaya más allá de los 60 días que Shopify da por defecto.
  • Reembolsos, descontando los impuestos en la misma proporción que en el pedido.
  • Contratos de suscripción de Shopify Subscriptions y de las apps basadas en él, para el MRR. Los pedidos creados por un plan de venta cuentan como recurrentes.

Shopify no da fecha ni motivo de cancelación, así que un contrato cancelado termina en su último cambio.

Cómo se cuenta Shopify

  • Los pedidos pagados cuentan antes de impuestos, en la moneda de la tienda, con las comisiones de Shopify Payments como comisión. Los pedidos de prueba se dejan fuera.
  • Los reembolsos incluyen impuestos, así que RevGlance resta el impuesto en la misma proporción que en el pedido.
  • El MRR sale de los contratos de suscripción (Shopify Subscriptions y las apps creadas sobre él), después de sus descuentos. Los pedidos creados por un plan de venta cuentan como recurrentes.
  • Shopify no da fecha ni motivo de cancelación: un contrato cancelado, vencido, fallido o en pausa termina en su último cambio.
  • Un pedido pagado en parte cuenta lo que ha entrado hasta ahora.
  • Donde los precios incluyen impuestos, el MRR cuenta antes de impuestos, en la proporción de impuesto del primer pedido.
  • Los contratos de suscripción no llevan fechas de prueba, así que las pruebas no se muestran.
  • Los contracargos no se leen, así que uno perdido sigue contando como cobro salvo que el proveedor también lo informe como reembolso.
  • Los cobros fallidos no se informan, así que esa cifra se queda en cero.