Integraciones
Plugin Facturalo.pe para WooCommerce
Plugin gratuito para WooCommerce que emite la boleta o factura electrónica SUNAT cuando el pedido llega al estado elegido, con elección de comprobante y DNI/RUC en el checkout.
Facturalo.pe for WooCommerce conecta tu tienda con Facturalo para emitir boletas y facturas electrónicas sin trabajo manual. Cuando un pedido llega al estado que elijas (por defecto, Completado), el plugin arma el comprobante con los datos del pedido y lo envía a POST /documentos/enviar. La respuesta de SUNAT y los enlaces a PDF y XML quedan guardados en el pedido.
Qué hace
- Emisión automática de boleta (con DNI o sin documento) o factura (con RUC) cuando el pedido llega al estado configurado. Una sola vez por pedido.
- Campos en el checkout (bloque de WooCommerce): el cliente elige el comprobante e ingresa DNI o RUC; para factura, también razón social y dirección fiscal. Validación en pantalla (DNI 8 dígitos, RUC 11).
- Demo y producción, cada uno con su clave de API (
sk_test_…/sk_live_…) y sus propias series. - Correlativo por serie y entorno, llevado dentro de WordPress.
- Pantalla Facturalo.pe en el admin: comprobantes emitidos, estado en SUNAT, acción «Consultar estado» y botón «Emitir ahora» para reintentar.
- Enlace «Descargar comprobante (PDF)» en Mi cuenta y en los correos del pedido.
- El costo de envío va como ítem del comprobante. Soles y dólares. IGV 18% o 10% (régimen especial). Compatible con HPOS.
Requisitos
| Requisito | Versión |
|---|---|
| WordPress | 5.8 o superior |
| WooCommerce | 6.0 o superior |
| PHP | 7.4 o superior |
| Checkout | Checkout en bloques de WooCommerce |
Descargar e instalar
Descarga el plugin (ZIP instalable de WordPress):
- facturalo-pe-for-woocommerce-1.0.0.zip — Versión 1.0.0 — boletas y facturas desde el checkout de WooCommerce.
- 1
Instala y activa
Sube el ZIP descargado en Plugins > Añadir nuevo > Subir plugin y activa Facturalo.pe for WooCommerce.
- 2
Abre los ajustes
Ve a WooCommerce > Facturalo.pe > Ajustes.
- 3
Configura la conexión
Elige el entorno e ingresa tu clave:
sk_test_…para demo osk_live_…para producción. La sacas de la consola al crear tu empresa. - 4
Series y disparador
Define las series de boleta y factura (exclusivas para la tienda, por ejemplo
B900/F900), el estado que dispara la emisión y activa la emisión automática.
Ajustes
| Ajuste | Para qué sirve |
|---|---|
| Entorno | «Prueba» mientras validas; en «Producción» los comprobantes van a SUNAT de verdad. Cada entorno usa su clave y su numeración. |
| Clave de API (prueba / producción) | Token sk_test_… o sk_live_… de la empresa. |
| Series | Serie de boleta y de factura por entorno. El plugin lleva el correlativo desde 1. |
| Emitir cuando el pedido esté | Normalmente «Completado». El comprobante se genera una sola vez por pedido. |
| Tipo de operación SUNAT | Casi siempre 0101 (Venta interna). |
| Tipo de IGV y porcentaje | 10 (Gravado - Operación onerosa) y 18%, o 10% para el régimen especial. |
| Enviar el PDF al cliente | Facturalo envía el comprobante al correo del pedido, además del enlace en Mi cuenta. |
Preguntas frecuentes
- ¿Qué serie uso? Una que solo emita WooCommerce. Si otro sistema usa la misma serie, SUNAT rechazará los correlativos repetidos.
- ¿Qué pasa si la emisión falla? El pedido queda con una nota del error, estado «error» y el botón «Emitir ahora» para reintentar. El detalle técnico de la solicitud y la respuesta se ve en el pedido.
- ¿El cliente necesita cuenta para descargar el comprobante? No. El enlace al PDF es público.
- ¿Funciona con el checkout clásico? Los campos fiscales están hechos para el checkout en bloques. Con el clásico (shortcode) no tendrás la experiencia completa.
Aún no incluye
- Nota de crédito automática al reembolsar un pedido.
- Guías de remisión desde el pedido.