TL;DR. Shopify no trae Libro de Reclamaciones nativo: en Perú lo resuelves combinando un enlace footer-fijo, un bloque embebido en la página de Contacto y un párrafo en los correos transaccionales post-compra. La integración limpia con claimbook.pe se hace en cinco pasos: alta de cuenta y obtención de un enlace público, instalación de un snippet «embed» o iframe en el tema (Online Store 2.0), inclusión del enlace en los Notification templates de Shopify (orden confirmada, envío, reembolso), validación con la regla de «dos clics» de la Resolución 0272-2024/SPC-INDECOPI y monitoreo de acuses dentro del panel de claimbook.pe. Funciona igual en Shopify Basic, Advanced, Plus y en tiendas que cobran en USD.
Configuración del Libro de Reclamaciones en Shopify Perú: guía completa 2026
Shopify creció en Perú durante 2025 sobre dos públicos muy distintos: marcas DTC con tráfico pagado en Meta y emprendedores que migraron desde marketplaces buscando margen. Ambos grupos comparten el mismo dolor cuando reciben la primera notificación de Indecopi: el panel de Shopify no incluye Libro de Reclamaciones, no hay app peruana certificada por el regulador y los plantillas del tema cargan en inglés. Este tutorial resuelve la integración paso a paso, con la Ley 32495 y la Resolución 0272-2024/SPC-INDECOPI como marco de cumplimiento, y con claimbook.pe como capa que se conecta sin tocar el código del tema.
Shopify en Perú: el contexto de cumplimiento 2026
Shopify, como plataforma cerrada, no entrega un libro nativo y tampoco lo necesita: el deber legal recae sobre el comerciante, no sobre el proveedor de software. La Ley 32495 (publicada el 11 de noviembre de 2025) extendió expresamente la obligación a «toda plataforma digital de comercio electrónico» peruana, con lo cual cualquier tienda Shopify que vende a consumidor final en Perú —tenga o no RUC— y que reciba pago vía pasarela local debe ofrecer libro virtual con acuse y plazo de respuesta de 15 días hábiles improrrogables (Ley 31435).
El error más común que vemos en auditorías es asumir que con poner un enlace en «Términos y condiciones» el cumplimiento queda cubierto. No es así. La Resolución 0272-2024/SPC-INDECOPI consolidó la doctrina de que el enlace debe estar a un máximo de dos clics desde la home; cualquier ubicación más profunda configura infracción leve sancionable hasta 50 UIT (S/ 275,000 con UIT 2026). Una tienda Shopify típica tiene tres puntos donde Indecopi verifica visibilidad: footer del storefront, header del checkout y correos transaccionales.
Apps del Shopify App Store: lo que realmente existe
Cuando un emprendedor peruano busca «libro reclamaciones» en el App Store de Shopify, encuentra básicamente tres tipos de resultados: apps genéricas de «complaint forms» en inglés (no cumplen Anexo I del DS 011-2011-PCM porque no piden RUC ni numeran correlativamente), apps argentinas de «Defensa al Consumidor» (no aplican a Perú) y plugins peruanos de baja calidad sin actualización en 18+ meses. Ninguno garantiza acuses con sello de tiempo válido como prueba ante Indecopi.
La alternativa razonable es dejar la lógica regulatoria fuera de Shopify, en un SaaS peruano, y conectar mediante uno de estos tres mecanismos:
- Enlace público al libro virtual alojado en claimbook.pe (la integración más liviana: una URL única por comerciante).
- Bloque embebido vía iframe dentro de una página estática de Shopify (típicamente
/pages/libro-de-reclamaciones). - API directa para tiendas Plus que prefieren no salir del dominio (requiere desarrollador y acceso a Shopify Functions).
Paso a paso: integración con claimbook.pe en Shopify Basic y Advanced
Esta es la ruta recomendada para 90 % de las tiendas peruanas. No requiere desarrollador y se completa en menos de 30 minutos.
- Da de alta tu cuenta en claimbook.pe con tu RUC, razón social y domicilio fiscal. El sistema te entregará una URL pública del tipo
https://claimbook.pe/r/{tu-slug}y un código embed para iframe. - Crea la página estática en Shopify. Anda a Online Store → Pages → Add page. Título: «Libro de Reclamaciones». Handle:
libro-de-reclamaciones. En el editor, cambia a vista de código (<>) y pega el iframe de claimbook.pe conwidth="100%"yheight="900". Marca como visible. - Agrega el enlace al footer. En Online Store → Navigation → Footer menu, añade un ítem nuevo con texto «Libro de Reclamaciones» apuntando a
/pages/libro-de-reclamaciones. Esto cumple la regla de un clic desde cualquier página del storefront. - Modifica los correos transaccionales. Anda a Settings → Notifications → Order confirmation. Edita el HTML del template y agrega antes del
{% endif %}final un párrafo: «Si tienes algún reclamo o queja, registra tu Hoja de Reclamación aquí:https://claimbook.pe/r/tu-slug«. Repite la edición en Shipping confirmation y Refund notification. - Valida visibilidad y acuses. Hazte una compra de prueba con un correo distinto, registra un reclamo desde el footer, confirma que llega el acuse al consumidor en menos de 24 horas y aparece en tu panel de claimbook.pe. Recién ahí dale por cerrada la integración.
La guía general de integración del Libro de Reclamaciones en e-commerce peruano explica los principios que aplican a cualquier plataforma. Esta guía aterriza esos principios en la mecánica específica de Shopify.
Integración vía iframe seguro: cuándo y cómo
El método iframe sirve cuando quieres que el consumidor no salga del dominio (mejor experiencia de marca y mejor UX en mobile). claimbook.pe entrega un iframe con cabeceras de seguridad X-Frame-Options: ALLOWALL autorizadas para tu dominio Shopify específico, content security policy compatible y carga progresiva.
El snippet típico para pegar en la página estática es algo así:
<iframe src="https://claimbook.pe/embed/{slug}" width="100%" height="900" frameborder="0" loading="lazy" referrerpolicy="strict-origin-when-cross-origin" title="Libro de Reclamaciones"></iframe>
El atributo loading="lazy" es importante para no degradar el Core Web Vitals: Shopify mide LCP en la página y un iframe cargado en eager golpea PageSpeed. El referrerpolicy evita filtrar URLs internas a logs de claimbook.pe.
Ubicación: footer, menú y post-compra
La regla de dos clics derivada de la Resolución 0272-2024/SPC-INDECOPI exige tres ubicaciones simultáneas en una tienda Shopify bien configurada:
| Ubicación | Distancia (clics) | Cómo se implementa en Shopify |
|---|---|---|
| Footer global | 1 clic | Online Store → Navigation → Footer menu → ítem «Libro de Reclamaciones» |
| Header (opcional pero recomendado) | 1 clic | Sección de tema «Announcement bar» o «Top bar» con texto pequeño y enlace |
| Página de checkout | 1 clic | Settings → Checkout → Order status page (Additional scripts) — solo Shopify Plus |
| Correos transaccionales | 0 clics | Settings → Notifications → editar HTML |
En Shopify Basic y Advanced no se puede modificar el checkout; allí el enlace en footer y correos basta. En la guía de ubicación del enlace según la regla de dos clics entramos al detalle de qué constituye visibilidad insuficiente y qué casos llegaron a sanción.
Configuración en correos transaccionales
Los Notification templates de Shopify son archivos Liquid editables. Para cumplimiento es suficiente con tres ediciones:
- Order confirmation (correo de confirmación de pedido): añade el párrafo de Libro de Reclamaciones después del bloque de productos comprados.
- Shipping confirmation (correo de envío): incluye el mismo enlace en el pie del correo.
- Refund notification (correo de reembolso): aquí el enlace es crítico porque el consumidor que recibe un reembolso parcial o tardío suele querer registrar reclamo. Pónlo arriba, no en el footer.
El texto recomendado es directo: «¿Tienes un problema con tu pedido? Puedes registrar una Hoja de Reclamación en nuestro Libro de Reclamaciones Virtual. Te respondemos en máximo 15 días hábiles.» El enlace debe ser absoluto (incluyendo https://) porque algunos clientes de correo strippean enlaces relativos.
Shopify Plus: opciones avanzadas
Las tiendas en plan Plus tienen acceso a checkout extensions, scripts editor y Shopify Functions, lo cual habilita tres rutas adicionales:
- Checkout extension: muestra el enlace al libro durante el paso de pago (mayor visibilidad, más conversión informativa).
- Shopify Flow: dispara automáticamente un correo con el enlace cuando se cancela un pedido o se emite un reembolso.
- Customer accounts: integra el libro en el área de cuenta del cliente (post-login) usando metafields.
Para volúmenes superiores a 50,000 pedidos/año la recomendación es conectar mediante webhook: claimbook.pe escucha el evento orders/create de Shopify y precarga datos del consumidor en la hoja, reduciendo fricción y elevando tasa de uso del libro entre clientes con problemas reales.
Si vendes en USD: implicaciones legales
Algunas tiendas Shopify peruanas cobran en dólares (sobre todo dropshipping y exportadoras DTC). Esto no exime del Libro de Reclamaciones siempre que el consumidor sea residente en Perú o la transacción se perfeccione en territorio peruano. La Casación 20463-2022 dejó clara la aplicación territorial del Código de Protección y Defensa del Consumidor cuando el comerciante dirige oferta al mercado peruano, sin importar moneda ni servidor de hospedaje.
El detalle a cuidar: en la Hoja de Reclamación el campo «monto» debe registrar el valor en la moneda de la transacción y, opcionalmente, su equivalente en soles al tipo de cambio del día. claimbook.pe ya ofrece este conversor automático.
Si eres dropshipper
El dropshipping no cambia la obligación: la tienda peruana es la «proveedora» frente al consumidor, aunque el producto se despache desde China o Estados Unidos. Indecopi mira a quién paga el consumidor y a quién emite factura/boleta, no a quién despacha. Si el consumidor paga a tu RUC, tú respondes el reclamo en 15 días hábiles —sin importar si el problema es de tu fulfillment partner—.
Pruebas y validación final
Antes de dar por cerrada la integración, ejecuta este checklist en una sesión incógnito desde móvil:
- Abre la home de tu tienda Shopify y verifica que el enlace «Libro de Reclamaciones» aparece visible en el footer sin necesidad de scroll horizontal.
- Haz clic. Confirma que el iframe carga en menos de 3 segundos y muestra el formulario completo (nombre, DNI, descripción, archivo adjunto).
- Registra un reclamo de prueba con datos reales tuyos. Verifica que llega correo de acuse en menos de 5 minutos.
- Confirma que en tu panel de claimbook.pe aparece el reclamo con timestamp UTC-5 (hora Perú) y código correlativo.
- Pídele a alguien de tu equipo que haga una compra real de prueba, simule un problema y confirme que el correo de confirmación tiene el enlace visible.
Si los cinco puntos pasan, tu Shopify está alineado con la Ley 32495, la Ley 31435 y la doctrina vigente de Indecopi. Documenta capturas de pantalla con fecha (sirven como evidencia ante una eventual fiscalización).
Errores frecuentes en tiendas Shopify peruanas
De auditorías que hicimos en 2025 a más de 40 tiendas Shopify peruanas, los patrones de incumplimiento que más se repiten son:
- Enlace solo en «Términos y condiciones» (incumple regla de dos clics).
- Iframe roto por bloqueo CSP del tema custom (no validado en mobile).
- Correos transaccionales en inglés sin enlace al libro (default de muchos temas Plus).
- Página /libro-de-reclamaciones con error 404 después de migración de tema.
- Acuse no llegando porque el correo del comerciante está en filtro de spam.
Cualquiera de estos puntos puede gatillar una sanción si Indecopi audita. La lista de infracciones comunes en libro de reclamaciones recoge la casuística completa con montos.
Preguntas frecuentes
¿Shopify acepta plugins de Libro de Reclamaciones?
Acepta apps de terceros desde el App Store, pero ninguna app oficial peruana actualizada cumple los requisitos del Anexo I del DS 011-2011-PCM y del DS 101-2022-PCM (numeración correlativa, sello de tiempo válido como prueba, retención de 2 años). La práctica recomendada es no usar app del store y, en su lugar, integrar mediante enlace público o iframe a un SaaS peruano como claimbook.pe.
¿Hay app oficial peruana en el Shopify App Store?
A abril de 2026, no existe app peruana certificada por Indecopi en el App Store de Shopify. Hubo intentos en 2022-2023 que quedaron desactualizados. Si encuentras alguna que se publicite como «oficial», verifica fecha de última actualización: si supera 12 meses sin update, no la uses.
¿Cómo lo pongo en el footer?
En el panel de Shopify, anda a Online Store → Navigation → Footer menu → Add menu item. Texto: «Libro de Reclamaciones». Link: /pages/libro-de-reclamaciones (si usas iframe) o la URL pública de claimbook.pe (si prefieres redirección). Guarda y verifica en mobile.
¿Y en correos transaccionales?
Settings → Notifications. Edita los templates Order confirmation, Shipping confirmation y Refund notification. En el HTML, agrega antes del cierre del <body> un párrafo con el enlace absoluto a tu libro virtual. Prueba enviando un correo a ti mismo con la opción «Send test email».
¿Funciona en Shopify Plus?
Sí, e incluso se vuelve más limpio porque Plus permite checkout extensions, Shopify Flow y Functions. Las tiendas Plus pueden además precargar datos del cliente en la Hoja de Reclamación mediante webhooks orders/create, lo cual reduce fricción y mejora calidad del dato recibido.
¿Aplica si vendo en USD?
Sí. Lo que importa es si diriges oferta al mercado peruano y si el consumidor es residente en Perú. La moneda no exime de la obligación. Sí debes registrar el monto en la moneda de la transacción en la Hoja, con opción de equivalente en soles al tipo de cambio del día.
¿Y si soy dropshipper?
El dropshipping no exime: si el consumidor te paga a ti (a tu RUC), tú eres el proveedor responsable. Indecopi no acepta como descargo «el problema fue del fulfillment partner». Tienes 15 días hábiles para responder al reclamo en cualquier caso.
¿Cómo lo configuro en checkout?
En Shopify Basic y Advanced no se puede modificar el checkout (solo Plus puede). En Plus, anda a Settings → Checkout → Customize checkout → Order status page → agrega un bloque «Custom» con el enlace a tu libro. En Basic y Advanced, suple esa carencia con enlace en footer y en los correos transaccionales.
Conclusión
Shopify es plataforma cómoda para vender pero no resuelve el cumplimiento peruano por sí sola. Los tres puntos no negociables son: enlace en footer (regla de dos clics), bloque embebido en página estática y enlace en los tres correos transaccionales clave. Con un SaaS peruano de libro virtual conectas la capa regulatoria sin tocar tema ni código y dejas el panel de Shopify para lo que sabe hacer: vender.
¿Tu Shopify ya está vendiendo y aún no tienes Libro de Reclamaciones configurado? Conoce claimbook.pe — el SaaS peruano de Libro de Reclamaciones Virtual que se integra en 30 minutos sin desarrollador, con plantillas verificadas para Shopify Basic, Advanced y Plus. Empieza gratis hoy.
