Cómo instalar el Libro de Reclamaciones Virtual en WordPress y WooCommerce Perú 2026

Si tu tienda virtual corre sobre WordPress o WooCommerce, la buena noticia es que puedes tener el Libro de Reclamaciones Virtual operativo en menos de dos horas sin tocar el código del tema. La mala noticia: muchos instaladores improvisan con un formulario Contact Form 7, no emiten hoja ni correo al consumidor y terminan multados por INDECOPI como si no tuvieran libro. En esta guía vas a ver el procedimiento exacto para WordPress 6.x y WooCommerce, con el plugin oficial de reclamavirtual.com, el shortcode, las URLs canónicas que debes mostrar y cómo evitar los tres errores que paga todo el mundo la primera vez.

Antes de tocar WordPress: los tres datos legales que necesitas a la mano

La implementación técnica toma 30 minutos. Lo que puede demorarte el día entero es no tener listos los datos que pide el Anexo V del Código de Protección y Defensa del Consumidor. Ten a la mano:

• Razón social completa tal como figura en SUNAT y RUC de 11 dígitos. Si es persona natural con negocio, el «nombre o razón social» es el nombre de la persona; si es SAC, EIRL, SA o SRL, la denominación registral.
• Domicilio fiscal exacto con departamento, provincia y distrito. No uses la dirección de la oficina de coworking; usa la declarada en la ficha RUC.
• Correo electrónico del responsable del Libro. Debe ser una cuenta que alguien revise cada día hábil. No pongas info@ ni una cuenta compartida: pon la cuenta del gerente, administrador o encargado de Atención al Cliente.

Con estos datos vas a configurar el plugin una sola vez. Si luego cambia tu domicilio fiscal en SUNAT, acuérdate de actualizar el plugin ese mismo día; la hoja emitida con el domicilio anterior pierde validez ante INDECOPI.

Arquitectura: qué pieza pones dónde en WordPress

Un Libro de Reclamaciones Virtual en WordPress se apoya en tres piezas que coexisten sin chocar con tu tema ni con WooCommerce:

1. Página pública del formulario: una página de WordPress (/libro-de-reclamaciones/) con el shortcode del plugin incrustado. Ésta es la URL que publicitarás en header, footer, carrito, checkout y correo post-venta.
2. Panel administrativo del libro: accesible dentro de wp-admin bajo el menú «Libro Reclamaciones». Ahí listas, respondes y exportas hojas.
3. Módulo SaaS de reclamavirtual.com: el plugin hace puente vía API con la base central que tú pagas (Profesional S/125, Empresarial S/475, Corporativo S/1,450). Ahí se almacena la hoja firmada, el PDF con código de verificación y la bitácora.

Este diseño permite que tu WordPress siga liviano (no guarda PDFs ni archivos pesados en la base) y que si mañana decides cambiar de hosting, el histórico de reclamos no se pierde: vive en la nube de reclamavirtual.com.

Paso 1: Instalación del plugin en 3 minutos

Entra a tu wp-admin como administrador. Ve a Plugins → Añadir nuevo → Subir plugin y carga el ZIP que descargaste desde tu panel de reclamavirtual.com (sección «Integraciones → WordPress»). Activa el plugin. Aparecerá un menú nuevo «Libro Reclamaciones» en la barra lateral.

Si prefieres instalarlo desde el repositorio oficial de WordPress, busca «Libro de Reclamaciones Virtual» y filtra por el publicado por KOM Agencia Digital. La versión del repositorio es idéntica a la del panel; actualiza siempre a la última para tener los últimos cambios de UIT y jurisprudencia.

Entra al menú «Libro Reclamaciones → Ajustes» y pega tu API key. La encuentras en Mi cuenta → Desarrolladores → API Keys de reclamavirtual.com. Si te sale «Clave inválida», verifica que no tenga espacios al inicio o final (el error más común). Al guardar, el plugin hace un ping al servidor y verifica que tu suscripción esté activa.

Paso 2: Creación automática de la página pública

En «Libro Reclamaciones → Ajustes → Página» presiona el botón «Crear página automáticamente». El plugin va a:

• Crear una página llamada «Libro de Reclamaciones» con slug /libro-de-reclamaciones/.
• Insertar el shortcode [libro_reclamaciones].
• Agregar el encabezado legal (razón social, RUC, domicilio) extraído de la configuración.
• Dejar la página en estado «Publicada» y accesible sin login.

Visita la URL en modo incógnito para verificar que se muestre. Si el formulario no aparece y solo ves el shortcode en texto plano, tu tema está cacheando la página: borra caché del plugin de optimización (W3 Total Cache, WP Rocket, LiteSpeed) y recarga. Si persiste, tu tema puede estar escapando shortcodes en el loop; contacta a tu desarrollador o usa el widget «HTML crudo» de tu constructor (Elementor, Divi, Gutenberg, Beaver Builder).

Paso 3: Aviso visible en todo el sitio

El artículo 24 del Reglamento de Libro de Reclamaciones exige aviso visible en el local. En un e-commerce «el local» es tu sitio, así que el aviso va en el footer de toda la página y, adicionalmente, en:

• Página de carrito (/cart/ en WooCommerce).
• Página de checkout (/checkout/).
• Página de mi cuenta (/mi-cuenta/).
• Correo de confirmación de pedido (transactional email de WooCommerce).

El plugin incluye un widget de footer listo para arrastrar en «Apariencia → Widgets → Pie de página». Queda un bloque minimalista con el texto «Libro de Reclamaciones» y el enlace. El aviso mínimo exigido es el símbolo (libro) con el enlace activo; no necesita ser intrusivo.

Paso 4: Integración con correos de WooCommerce

Aquí muchos instaladores se olvidan y es donde INDECOPI pregunta cuando fiscaliza. Tu correo post-venta de WooCommerce («Tu pedido ha sido recibido», «Tu pedido está en camino») debe incluir el enlace al Libro. Hay dos formas:

Opción A — Con el plugin (recomendada). En «Libro Reclamaciones → Ajustes → Integración WooCommerce» activa «Agregar enlace al Libro en correos de pedido». El plugin inyecta un bloque HTML con el enlace antes del cierre del footer del correo, sin necesidad de editar templates.

Opción B — Editando los templates. Copia wp-content/plugins/woocommerce/templates/emails/email-footer.php a wp-content/themes/tu-tema-child/woocommerce/emails/email-footer.php y agrega antes del cierre del div.footer:

<p style="font-size:12px; color:#666;">
  Si tienes una queja o reclamo, puedes registrarlo en nuestro
  <a href="https://tudominio.com/libro-de-reclamaciones/">Libro de Reclamaciones Virtual</a>.
</p>

Usa child theme. Editar el tema padre directamente es condenar el aviso a desaparecer en la próxima actualización.

Paso 5: Prueba end-to-end (el paso que nadie hace)

Antes de anunciar que ya tienes Libro, presenta un reclamo de prueba como si fueras un consumidor:

1. Entra a /libro-de-reclamaciones/ en modo incógnito (sin sesión admin).
2. Llena el formulario con datos reales: tu nombre, tu DNI, tu correo alternativo, como tipo «Reclamo» y descripción «PRUEBA — no procesar».
3. Envía.
4. Verifica que llegaron dos correos: uno al consumidor (tú) con el PDF y otro al responsable del Libro configurado.
5. Descarga el PDF y verifica que tenga: código de hoja, fecha, razón social, RUC, domicilio, todos los campos que llenaste, firma del receptor (QR con código de verificación).
6. Entra a wp-admin → Libro Reclamaciones y verifica que la entrada aparezca con estado «Pendiente».
7. Borra el reclamo de prueba (botón «Eliminar prueba» disponible solo si el campo «Descripción» empieza con la palabra PRUEBA).

Este paso toma 5 minutos y te ahorra UIT en multas. Si alguno de los correos no llega, revisa tu configuración SMTP (WP Mail SMTP, FluentSMTP o Easy WP SMTP). WooCommerce sin SMTP autenticado pierde correos en entregabilidad; el Libro depende de que estos correos lleguen siempre.

Paso 6: Respuesta desde el panel (el flujo diario)

Cuando un consumidor real presenta un reclamo, el responsable recibe un correo con enlace al panel. Desde wp-admin → Libro Reclamaciones → Pendientes puedes:

• Leer el reclamo completo.
• Adjuntar documentos (factura, guía, capturas).
• Escribir respuesta y seleccionar «Reconoce», «Refuta» o «Prórroga».
• Enviar. El consumidor recibe automáticamente un correo con la respuesta y un PDF firmado.

El panel muestra un contador de días hábiles restantes (descontando feriados peruanos 2026) para que no se te pase el plazo de 15 días. Si te queda menos de 3 días y no respondiste, el correo automatizado te alerta. Tienes 15 días hábiles según Ley 31435 y DS 101-2022-PCM; superarlos expone a multa y suma como indicio en infracciones reiteradas.

Los tres errores que cuesta caro en WordPress

Error 1: Usar Contact Form 7, Forminator o un form custom en vez del plugin oficial. Un formulario normal no emite PDF con código de hoja, no tiene libro foliado, no registra en bitácora y no es «Libro de Reclamaciones» en el sentido legal. INDECOPI ya multó a varios e-commerce que tenían formularios genéricos rotulados «Libro»; la Resolución 0272-2024/SPC-INDECOPI dejó claro que no alcanza con un «formulario de contacto» llamado libro.

Error 2: Olvidar el aviso en el footer y en los correos. Si el fiscalizador entra a tu sitio y no ve dónde hacer clic para llegar al Libro sin bajar 14 pantallas, consigna «no cuenta con aviso visible», que es la misma falta que quien no tiene libro físico en el local. UIT 2026 de S/5,500 es el piso de cálculo.

Error 3: Dejar el cron de WordPress desactivado. El plugin usa wp-cron para enviar recordatorios de vencimiento y sincronizar con la nube de reclamavirtual.com. Si tienes DISABLE_WP_CRON=true en tu wp-config.php (muchos hosts lo configuran así por rendimiento), reemplázalo con un cron de servidor real cada 5 minutos. Sin cron, los recordatorios no se disparan y puedes pasarte el plazo sin darte cuenta.

Integración con temas populares: Astra, Divi, Elementor, GeneratePress

El shortcode [libro_reclamaciones] funciona en cualquier tema compatible con WordPress 5.9+. Con constructores visuales:

• Elementor: arrastra el widget «Shortcode» y pega el código. Usa la versión Pro si quieres estilizar el contenedor; con la gratis, el formulario hereda los estilos del tema.
• Divi: módulo «Código» con el shortcode adentro.
• Gutenberg / Editor de bloques: bloque «Shortcode» nativo.
• Beaver Builder: módulo «Shortcode».
• Astra / GeneratePress: al ser temas ultra-ligeros, el shortcode queda perfecto sin ajustes. Si necesitas ocultar la sidebar en esa página, usa las opciones «Layout» del tema.

Multisite, idioma, multidivisa

Si tu WordPress es un multisite, instala el plugin a nivel network y activa por sitio. Cada sitio tendrá su propio libro separado con su razón social (útil si operas varias marcas bajo RUCs distintos).

Si usas WPML o Polylang para tener el sitio en español e inglés, la página del Libro debe estar en español (el Reglamento exige castellano). Puedes tener una versión en inglés como referencia informativa, pero la hoja que se emita debe estar en español, y los datos legales (razón social, RUC) no se traducen.

Si usas multidivisa (dólares, euros) en WooCommerce, no impacta al libro. El libro registra el reclamo sin importar la moneda del carrito; la moneda aparece como texto libre en la descripción del bien o servicio.

Checklist final antes de salir en producción

• ☐ Plugin instalado y activo, API key validada.
• ☐ Razón social, RUC y domicilio fiscal correctos en Ajustes.
• ☐ Página /libro-de-reclamaciones/ publicada y accesible sin login.
• ☐ Aviso en footer visible en todas las páginas.
• ☐ Enlace en carrito, checkout, mi cuenta y correos de WooCommerce.
• ☐ Prueba end-to-end exitosa (ambos correos llegan).
• ☐ Responsable del Libro con acceso al panel y notificaciones activadas.
• ☐ WP-Cron operativo (o cron de servidor real).
• ☐ Plan contratado acorde al volumen (Profesional S/125 anual + IGV hasta 120 reclamos/año).
• ☐ URL del libro publicada en redes sociales y Google My Business.

Cuando los 10 puntos estén ✓, tu tienda WordPress está en regla con el Código de Protección y Defensa del Consumidor. Para cuando llegue un fiscalizador de INDECOPI, no te va a sorprender: la hoja se emite automáticamente, el histórico está exportable en CSV/XLSX y el SaaS guarda los cinco años que exige la norma.

Preguntas frecuentes de WordPress + Libro Virtual

¿Necesito HTTPS obligatorio? Sí. Desde 2018 todo sitio que capture datos personales debe usar HTTPS. Usa Let’s Encrypt gratis en cPanel, SiteGround, Kinsta, WP Engine y la mayoría de hostings peruanos.

¿Y si tengo Wordfence o iThemes Security bloqueando AJAX? El plugin usa llamadas REST API, no AJAX legacy. Si tu plugin de seguridad bloquea /wp-json/, agrega una regla de excepción para /wp-json/libro-reclamaciones/v1/*.

¿Cuánto pesa el plugin? 320KB. Los PDFs se generan del lado del servidor de reclamavirtual.com, no dentro de tu WordPress, así que no añade carga a tu base de datos.

¿Funciona en WordPress.com hosting gestionado? Solo en planes Business y eCommerce (los que permiten plugins externos). En planes Personal, Premium y gratis, no puedes subir plugins personalizados.

Si todavía tienes dudas, revisa nuestras guías complementarias: implementación en 24 horas para cualquier plataforma, comparativa de precios 2026 y cómo responder en 15 días hábiles. Si prefieres que lo instalemos por ti, escríbenos y te dejamos operativo en menos de un día.