WooCommerce: instalar el plugin

Un solo campo de configuración: tu clave de acceso. Tu certificado y credenciales tributarias nunca viven dentro de tu WordPress.

Requisitos

• WordPress 6.0 o superior y WooCommerce 7.0 o superior.
• PHP 7.4 o superior.
• Tu tienda debe poder hacer peticiones HTTPS salientes (lo normal en cualquier hosting).

Instalación (3 minutos)

1. Descarga el plugin desde tu panel: billerpro-plugin.zip.
2. En tu WordPress: Plugins → Añadir nuevo → Subir plugin, elige el ZIP e Instalar ahora.
3. Pulsa Activar.
4. Ve a WooCommerce → Ajustes → pestaña BillerPro.
5. Pega tu Clave de acceso (empieza con bp_) y Guardar cambios. Verás el mensaje Conexión con BillerPro verificada.

Listo. Desde el próximo pedido pagado, tu tienda emite sola.

Qué hace en cada pedido

1. El cliente paga.
2. El plugin envía a BillerPro los datos del pedido (líneas, precios, descuentos, cupones, envío, datos del comprador).
3. BillerPro decide boleta o factura según el documento del comprador: RUC → factura; DNI, carné de extranjería, pasaporte o sin documento → boleta.
4. El comprobante viaja a SUNAT. Al aceptarse, el cliente recibe por correo el PDF y el XML.
5. En el pedido de WooCommerce aparece la caja Comprobante electrónico con el número, el estado (Aceptado por SUNAT, Reintentando…, Rechazado), el plazo restante y los botones Emitir ahora / Volver a emitir / Reintentar ahora. La lista de pedidos gana la columna Comprobante.

Ajustes disponibles

Cuándo emitir

• Cuando el pedido se paga (recomendado): emite al pasar a Procesando. Deja el margen más amplio dentro de los 3 días que da SUNAT para facturas.
• Cuando el pedido se completa: útil si solo quieres facturar lo que ya despachaste.
• Solo cuando yo lo pida: emites a mano desde el pedido con el botón Emitir ahora.

Impuesto por defecto: Gravado con IGV (18%), Exonerado o Inafecto. Para cambiarlo en un producto concreto, en su ficha añade el campo personalizado _billerpro_afectacion con 10 (gravado), 20 (exonerado) o 30 (inafecto). Del mismo modo, _billerpro_unidad cambia la unidad (por defecto NIU; usa ZZ para servicios) y _billerpro_icbper fija el impuesto a la bolsa por unidad.

Enviar el comprobante al cliente: activa o desactiva el correo con PDF y XML.

Exigir RUC para factura: si el comprador elige factura en el checkout, no puede pagar sin escribir un RUC válido. Evita rechazos.

Avanzado → Dirección del servicio: ya apunta a BillerPro. Cámbiala solo si te indicamos otra (por ejemplo, un entorno de pruebas).

El checkout

El plugin agrega al checkout un selector Boleta / Factura y los campos Tipo de documento, Número y Razón social (para factura). Todo se valida antes de pagar: dígitos correctos, longitud del DNI (8) y del RUC (11).

Promociones, cupones y envío

• Los cupones y descuentos se reparten proporcionalmente entre las líneas, como exige SUNAT.
• Los productos a S/0 (regalos, "lleva 3 paga 2") se emiten como gratuitos con el código de bonificación correcto.
• El envío aparece como una línea más, gravada.
• La bolsa plástica se emite con el ICBPER si el producto tiene el campo _billerpro_icbper (por ejemplo 0.50).

Ventas en dólares

Si tu tienda vende en USD, el comprobante se emite en dólares con el tipo de cambio oficial de SUNAT del día, sin que configures nada.

Actualizaciones

El plugin se actualiza solo, como cualquiera del repositorio de WordPress: cuando publicamos una versión nueva, aparece "Hay una nueva versión disponible" en Plugins y la instalas con un clic (o se instala sola si tienes activadas las actualizaciones automáticas). Tu clave y tus ajustes se conservan. Por seguridad, el plugin solo acepta actualizaciones firmadas desde el dominio de BillerPro por HTTPS.

Guardar la clave en wp-config.php (opcional, más seguro)

Si prefieres que la clave no viva en la base de datos de WordPress, añade esto a tu wp-config.php y deja el campo vacío en los ajustes:

define( 'BILLERPRO_API_KEY', 'bp_tu_clave' );

Problemas comunes

"No se pudo conectar con BillerPro": revisa que copiaste la clave completa (sin espacios) y que tu hosting permite conexiones salientes HTTPS. Si tienes un firewall (Cloudflare, Wordfence), permite las salidas a *.selvagencia.com.

Un pedido no generó comprobante: abre el pedido y mira la caja Comprobante electrónico. Si dice Rechazado por SUNAT, el dato indicado (casi siempre el documento del comprador) es inválido: corrígelo en el pedido y pulsa Volver a emitir. Reintentar sin corregir volverá a fallar.

Quiero emitir pedidos antiguos: abre el pedido y pulsa Emitir ahora. Recuerda el plazo legal de 3 días para facturas.

Cambié de RUC: crea una nueva empresa en tu panel y pega la nueva clave en el plugin.