Parrotfy · Centro de ayuda

Centro de ayuda › Integraciones

0.4.1 Integración Shopify - emisión boletas

Actualizado 2026-09-29

Emite boletas automáticamente con cada venta de Shopify (webhook)

Cada vez que en tu tienda Shopify se paga un pedido, Parrotfy puede emitir sola la boleta (o factura, si el cliente la pide) y enviarla al correo que el cliente ingresó en el check-out. Se configura en dos partes: primero creas la tienda en Parrotfy y después pegas un webhook en Shopify.

1. Crea la tienda en Parrotfy

Hazlo con un usuario que pueda administrar las configuraciones de la cuenta (por ejemplo, el dueño de la cuenta).

  1. Entra a Mi empresa → Integraciones, pestaña Tiendas externas.
  2. Haz clic en Añadir nueva tienda.
  3. En Servicio externo elige Shopify y ponle un Nombre.
  4. Completa URL, Token, App ID y Secret con las credenciales de tu app de Shopify (Parrotfy las usa, por ejemplo, para sincronizar el inventario).
  5. Elige la Condición de pago con la que se crearán las boletas (ver más abajo cómo hacer que queden pagadas), el Centro de negocio y, si tienes más de una, la Bodega desde la que se descuenta el stock. Activa Sincronizar inventario si quieres que los cambios de stock se reflejen en Shopify.
  6. Guarda. La tienda queda en la lista, y en su ficha aparece el campo Shopify Webhook URL. Haz clic sobre esa URL para copiarla: ya trae el nombre de tu cuenta, el token y la tienda.

Si el botón Añadir nueva tienda aparece con candado, tu plan llegó a su máximo de tiendas activas.

Importante: si la tienda no está creada en Parrotfy, los avisos de Shopify llegan pero se ignoran y no se emite nada.

2. Crea el webhook en Shopify

  1. En tu panel de Shopify, entra a Settings (Configuración) → Notifications (Notificaciones) → Webhooks y haz clic en Create webhook (Crear webhook).
  2. Completa:
  • Event: Order payment (pago del pedido).
  • Format: JSON.
  • URL: pega la Shopify Webhook URL que copiaste de la ficha de la tienda en Parrotfy.
  • Webhook API version: la que está marcada como latest.
  1. Guarda el webhook.

Desde ese momento, cada pedido que Shopify marque como pagado genera su documento en Parrotfy, en segundo plano, y se envía al correo que el cliente ingresó en el check-out.

¿Cómo hacer que estas boletas se creen pagadas?

Asigna en la tienda una Condición de pago que tenga una Cuenta cobro asociada (la cuenta donde entra el dinero). Con eso, cada documento que llega desde Shopify se crea pagado, abonado a esa cuenta. Las condiciones de pago se editan en Administración → Cuentas → rueda "Administrar cuentas" → pestaña Condiciones de pagos.

Video: https://www.loom.com/embed/0296eced134c42c78ae3136fa1da5db4

¿Quieres ver las boletas desde Shopify y sincronizar el stock? (opcional)

Activa Sincronizar inventario en la tienda (paso 1) para que los cambios de stock de Parrotfy se reflejen en Shopify.

Video: https://www.loom.com/embed/c5ec5a4afc744303a755faad349cd0b3

Ojo: la URL de tu cuenta Parrotfy puede no coincidir con la URL de tu tienda. Por eso conviene copiar la Shopify Webhook URL desde la ficha de la tienda en vez de armarla a mano. Video: https://www.loom.com/share/3eaa8b99aa56456ca48db421800b90a5

¿Cómo ve el check-out el cliente?

Video: https://www.loom.com/embed/60e9e22fd33b460882b0b651d0011bda

PD: si tienes la versión avanzada de Shopify que permite un check-out personalizable, escríbenos a soporte.

Si un pedido pagado no generó su boleta

Revisa el ícono de advertencia de la barra superior (panel de problemas de emisión): ahí aparecen los documentos que no se pudieron emitir, con su error y un botón para reintentar. Ver "Conecta tu tienda online a Parrotfy".

¿Dudas? Escríbenos al chat de soporte y podemos configurar esto por ti.

--- Verificado contra el código de Parrotfy (commit 642ff78, 2026-08-26): app/views/integrations/index.html.erb, app/controllers/integrations_controller.rb, app/views/confs/_external_stores_index.html.erb (Añadir nueva tienda, límite limit_external_stores), app/views/external_stores/_form.html.erb y _shopify_show.html.erb (Shopify Webhook URL), app/helpers/external_store_helper.rb (webhook_url), app/controllers/api/v1/external_stores/shopify_controller.rb (sin tienda se ignora; solo financial_status paid), app/services/external_stores_order_adapters/shopify_order_adapter.rb (condición de pago de la tienda), app/models/sale_invoice.rb (create_payment_by_payment_condition), app/views/payment_conditions/_form.html.erb, app/views/banks/_link_tabs_banks.html.erb, config/locales/es.yml.

0.4.1 Integración Shopify - emisión boletas · Parrotfy · Falcon