Shopify: instalar la app
BillerPro se instala como una app en tu tienda. Shopify avisa cada vez que una orden se paga y BillerPro emite el comprobante.
Instalación (2 minutos)
- En tu panel de BillerPro, ve a Conectar canal → Shopify y escribe tu tienda (
mitienda.myshopify.com). También puedes abrir directamente:https://shopify.billerpro.store/shopify/instalar?shop=mitienda.myshopify.com - Shopify te pide autorizar la app (permiso de lectura de pedidos). Pulsa Instalar.
- Vuelves a la pantalla de configuración de BillerPro. Pega tu clave de acceso (
bp_…) y guarda.
Desde ese momento, cada orden con pago confirmado (orders/paid) se factura sola.
Boleta o factura: cómo capturar el RUC en Shopify
Shopify no pide RUC ni DNI de forma nativa. BillerPro lee estos datos de los atributos de la orden (note_attributes), que puedes recoger en el carrito o en el checkout con cualquiera de estas opciones:
- Campos de carrito de tu tema (Liquid): inputs con nombre
attributes[documento],attributes[razon_social]yattributes[tipo_comprobante]. - Una app de campos personalizados de checkout (Shopify Plus) que escriba esos mismos atributos.
Nombres reconocidos (en minúsculas):
| Atributo | Valores | Efecto |
|---|---|---|
documento |
8 dígitos (DNI) u 11 (RUC) | Con RUC se emite factura; con DNI, boleta |
razon_social |
texto | Nombre en el comprobante |
tipo_comprobante |
01 factura, 03 boleta |
Fuerza el tipo si lo necesitas |
tipo_documento |
catálogo 06 (1 DNI, 6 RUC, 4 CE, 7 pasaporte) |
Opcional, se deduce del número |
Si no llega ningún atributo, se emite boleta a "Cliente varios", que es válida para ventas menores a S/700 sin identificar al comprador.
Impuestos, envío y descuentos
- Cada línea se emite gravada con IGV por defecto. Si el producto está marcado como no gravable (
taxabledesactivado) en Shopify, se emite inafecto; si además lleva el tagbillerpro:exonerado, se emite exonerado. - El envío se emite como una línea gravada.
- Los descuentos se reparten proporcionalmente entre las líneas.
- Las líneas a S/0 se emiten como gratuitas (bonificación).
Ventas en dólares
Si la orden llega en USD, el comprobante se emite en dólares con el tipo de cambio oficial de SUNAT del día.
Ver el estado de cada comprobante
En tu panel de BillerPro verás cada orden con su número (B001-… o F001-…) y su estado en SUNAT. Los que requieren corrección aparecen en Requieren atención.
Problemas comunes
Instalé la app pero no se emite nada: comprueba que pegaste la clave de acceso en la pantalla de configuración de la app (Conectar canal → Shopify → clave). Sin clave, la app recibe la orden pero no sabe con qué RUC emitir.
Se emitió boleta y el cliente quería factura: el RUC no llegó en note_attributes. Revisa que tu tema o app escriba el atributo documento. Puedes emitir la factura a mano desde Emitir y anular la boleta.
Cambié de tienda o de RUC: repite la instalación con la nueva tienda; la clave puede ser la misma si el RUC no cambia.
Seguridad: cada aviso de Shopify llega firmado (X-Shopify-Hmac-Sha256) y se verifica antes de procesarlo. El token de tu tienda se guarda cifrado.
Sincronizar catálogo y stock con Shopify
Desde setiembre de 2026 la app pide permisos de productos e inventario (read_products, read_inventory, write_inventory). Si instalaste la app antes, entra a Conectar → Shopify → Instalar de nuevo para autorizar los permisos nuevos (no se duplica nada).
- Productos → Web: importar trae tus productos, variantes (color, talla…), precios, imágenes y stock de Shopify al catálogo de BillerPro, vinculados por SKU.
- Cada venta por panel, POS o WhatsApp descuenta el stock en Shopify (ubicación principal). Y Empujar a la web fija el stock de todas las variantes vinculadas.
- La visibilidad (activo/borrador) se sigue gestionando en Shopify; BillerPro solo mueve inventario.