=== pFacturas for WooCommerce === Contributors: puntoexeconsultores Tags: facturacion electronica, uruguay, dgi, cfe, woocommerce Requires at least: 6.0 Tested up to: 7.1 Requires PHP: 7.4 Requires Plugins: woocommerce Stable tag: 1.5.0.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Facturación electrónica automática (e-Ticket, e-Factura, notas de crédito) para Uruguay cumpliendo normativa DGI. == Description == pFacturas es el plugin oficial para integrar la plataforma de facturación electrónica pFacturas con WooCommerce en Uruguay. Permite la emisión automática de Comprobantes Fiscales Electrónicos (CFE) cumpliendo con las normativas de la Dirección General Impositiva (DGI) de Uruguay. [youtube https://www.youtube.com/watch?v=6UlfmUef0I4] = Características principales = * **Emisión automática de CFE:** Genera automáticamente e-Ticket, e-Factura y Notas de Crédito al procesar pedidos * **Cumplimiento DGI:** 100% conforme a las especificaciones técnicas de DGI Uruguay * **Múltiples ambientes:** Soporte para Demo, Testing y Producción * **Facturación con/sin RUT:** Factura tanto a consumidores finales como a empresas * **Validación en tiempo real:** Validación de RUT uruguayo con dígito verificador * **Envío automático de PDF:** El cliente recibe el comprobante fiscal por email * **Compatible con WooCommerce Blocks:** Funciona con el nuevo checkout de WooCommerce * **Logs detallados:** Sistema de logging para depuración y auditoría * **Configuración flexible:** Múltiples opciones para adaptar el plugin a tus necesidades = Requisitos = * Cuenta activa en pFacturas (https://www.pfacturas.com) * WooCommerce instalado y activo * WordPress 6.0 o superior * PHP 7.4 o superior = Configuración rápida = 1. Instalar y activar el plugin 2. Ir a WooCommerce → pFacturas para revisar los settings y ajustar el comportamiento del plugin según tus necesidades 3. Realizar un pedido de prueba (el plugin viene en modo Demo por defecto, no requiere credenciales) 4. Verificar en WooCommerce → Pedidos que el CFE se emitió correctamente y consultarlo desde el botón "Ver CFE" en el detalle del pedido **Nota**: Para usar el ambiente de Testing o Producción, necesitarás credenciales de pFacturas obtenidas al contratar el servicio. = Servicios de terceros = Este plugin utiliza el servicio externo pFacturas para generar comprobantes fiscales electrónicos conforme a las regulaciones de DGI Uruguay. **Servicio:** API de Facturación Electrónica pFacturas **Proveedor:** PuntoExe Consultores **URL del servicio:** https://www.pfacturas.com **Qué datos se envían:** - Información del cliente (nombre, RUT, dirección) desde pedidos de WooCommerce - Detalles del pedido (artículos, precios, impuestos) - Información de la tienda (RUT, sucursal) - Estos datos se envían cuando se realiza un pedido y el plugin está configurado para emitir comprobantes electrónicos **Cuándo se envían los datos:** - Automáticamente después de completar el pedido (cuando está configurado) - Manualmente cuando el administrador activa la generación de factura - Solo para pedidos que requieren comprobantes fiscales electrónicos **Propósito**: Generar comprobantes fiscales electrónicos (CFE) legalmente conformes según lo requiere la ley tributaria uruguaya (DGI) **Política de privacidad:** https://efactura.puntoexe.com.uy/facturaci%C3%B3n-electr%C3%B3nica/woocommerce-integrado/pol%C3%ADtica-de-privacidad **Términos de servicio:** https://efactura.puntoexe.com.uy/facturaci%C3%B3n-electr%C3%B3nica/woocommerce-integrado/t%C3%A9rminos-y-condiciones-de-servicio Al usar este plugin, aceptas compartir datos de pedidos con el servicio pFacturas para fines de facturación electrónica. = Soporte técnico = Para consultas y soporte técnico, contactar a **efactura@puntoexe.com.uy** Plugin desarrollado y mantenido por Punto Exe Consultores. == Installation == 1. Ir a Plugins → Añadir nuevo → Subir plugin 2. Seleccionar el archivo ZIP y hacer clic en "Instalar ahora" 3. Activar el plugin 4. Ir a WooCommerce → pFacturas 5. Para pruebas rápidas: Seleccionar Modo "Demo" (no requiere configuración adicional) 6. Para uso en producción: Configurar RUT, Sucursal, Usuario y Contraseña con credenciales de pFacturas == Dependencies == Este plugin requiere que WooCommerce esté instalado y activo. == Screenshots == 1. Pestaña Conexión del plugin: selección de modalidad (Demo, Testing, Producción) y configuración de credenciales de pFacturas. En modo Demo no se requieren credenciales ya que el plugin solicita unas temporales automáticamente. 2. Pestaña Documento: configuración general del CFE (forma de pago por defecto, tipo de cambio comercial, adenda libre), sección "Datos del Receptor" con la opción para incluir los datos del cliente del Billing Address en el receptor del CFE de consumo final y el umbral de identificación en Unidades Indexadas, y sección "Forzar Indicador de Facturación" que permite anular el cálculo automático del IndFact y forzar uno de los 17 valores DGI (Exento IVA, Gravado tasa básica, No facturable, Exportación, Monotributo, etc.) en todas las líneas o solamente en líneas sin precio. 3. Pestaña Emisión: habilitación de emisión automática de CFE al cambiar el estado de la orden, emisión automática de Nota de Crédito al crear un Refund, y textos personalizables que se muestran al cliente en la página de order-received en caso de error de emisión. 4. Pestaña Checkout: selección del país de origen de los compradores (Uruguay o Cualquier País — habilita una sección alternativa para clientes internacionales con tipos de documento como NIE, NIFE, Pasaporte, DNI Mercosur, etc.), textos personalizables del checkout (pregunta para activar facturación con RUT, pregunta para declarar Documento en modo Cualquier País, etiqueta cuando es obligatorio identificar Documento), ubicación visual de los campos fiscales con detección automática del modo de checkout (clásico o Blocks), y sincronización opcional con campos billing estándar de WooCommerce (Tipo de Documento, Documento y Razón Social) para compatibilidad con flujos previos al plugin y reportes externos. 5. Pestaña Backoffice/POS: integración con sistemas de Punto de Venta como YITH POS. Soporta dos modos de identificación del receptor (explícito con dos campos separados o heurístico con un único campo de documento), y permite usar la Nota del Cliente como Adenda. 6. Pestaña Avanzado: registro de logs de depuración, emisión asíncrona de CFE vía Action Scheduler (recomendado cuando hay plugins de pago con webhooks de timeout corto como Mercado Pago), y visualización del caché de cotizaciones (Unidad Indexada y Dólar). 7. Campos fiscales en el checkout: cuando el cliente elige "Factura con RUT = Sí", se solicitan RUT y Razón Social con validación de dígito verificador del lado del cliente y del servidor. 8. Campos fiscales en el checkout: cuando el monto de la orden supera el umbral de identificación configurado en Unidades Indexadas, se solicitan Tipo y Número de Documento del cliente (Cédula de Identidad uruguaya, Pasaporte, DNI Mercosur u Otros). 9. Modo "Cualquier País" en el checkout: cuando el setting "País de origen de los compradores" está en "Cualquier País", se reemplaza la pregunta "¿Factura con RUT?" por "¿Quiere declarar Documento?" y se despliega una sección alternativa con un combo personalizado de Tipo de Documento que muestra cada opción (NIE, RUT, C.I., Pasaporte, DNI Mercosur, NIFE u Otros) con su título y descripción explicativa visible. Útil para tiendas que venden a clientes internacionales. 10. Modo "Cualquier País" cuando el monto supera el umbral de identificación: la pregunta "¿Quiere declarar Documento?" se oculta y en su lugar aparece la etiqueta informativa "Se requiere identificar un Documento del comprador" (parametrizable desde Settings). El cliente debe obligatoriamente seleccionar un Tipo de Documento, completar el Documento (con validación de dígito verificador para NIE/RUT/C.I. o validación alfanumérica mínima para Pasaporte/DNI Mercosur/NIFE/Otros) y la Denominación Social si el tipo es NIE, RUT o NIFE (entidades jurídicas). 11. Metabox de pFacturas en la pantalla de edición de orden: muestra el tipo de CFE emitido (eTicket, eFactura), el número fiscal asignado por DGI, el estado de emisión y el enlace al PDF del comprobante. 12. Emisión automática de Nota de Crédito al hacer un Refund de la orden: el metabox muestra tanto el CFE original como la NC asociada, ambos con sus números fiscales y enlaces al PDF, y las notas de la orden documentan el proceso. == Changelog == = 1.5.0.2 = * Corrección: En el checkout clásico en modo Uruguay, una compra por debajo del umbral de identificación y sin documento se rechazaba con errores sobre campos que el cliente no veía. * Corrección: El servidor ahora exige Tipo de Documento y Documento cuando el monto supera el umbral, en los dos checkouts y sin depender del JavaScript. * Corrección: El umbral se compara siempre contra el subtotal sin impuestos. El checkout clásico y la emisión podían usar el monto con IVA. = 1.5.0.1 = * Corrección: En el checkout clásico, los datos con comillas o apóstrofes (por ejemplo la razón social O'Brien) se guardaban en el pedido con una barra invertida agregada (O\'Brien) y podían llegar así al CFE. Afecta a tiendas con el almacenamiento de pedidos de alto rendimiento (HPOS). Los CFE ya emitidos no se modifican. * Compatibilidad: Probado con WordPress 7.1. = 1.5.0.0 = * Funcionalidad nueva: Consulta de datos de empresas por RUT para sistemas de Punto de Venta como YITH POS. A partir del RUT que ingresa el cajero, el plugin consulta a pFacturas y devuelve la razón social, el nombre comercial y los locales registrados de la empresa. Se habilita en WooCommerce → pFacturas → Backoffice/POS, donde también se eligen los roles que pueden usarla (por defecto, Administrador y Gestor de tienda; ahí hay que agregar el rol de los cajeros). Sólo pueden consultar usuarios con sesión iniciada en la tienda y con alguno de esos roles; cada usuario tiene un límite de 30 consultas por minuto. Los datos de cada RUT se guardan 30 días para responder al instante en consultas repetidas. Para desarrolladores: dirección REST `GET /wp-json/pfacturas/v1/rut/{RUT}` (requiere el encabezado `X-WP-Nonce`) y filtro PHP `pfwc_consultar_rut`. * Mejora de confiabilidad: El plugin ya no descarga de internet la descripción de los servicios de pFacturas (WSDL) cada vez que la necesita: ahora viaja incluida en el plugin. Las comunicaciones arrancan más rápido y la facturación en Producción ya no puede verse afectada por una caída del servidor de pruebas de pFacturas. = 1.4.0.4 = * Seguridad: En el ambiente de Producción, las comunicaciones con el Web Service de pFacturas (emisión de CFE y consulta de cotizaciones) ahora viajan siempre cifradas por HTTPS. Hasta esta versión, aunque la configuración del servicio se descargaba por HTTPS, el servicio publicaba su dirección con HTTP y las llamadas —que incluyen el usuario y la contraseña de pFacturas y los datos de cada comprobante— se enviaban sin cifrar. Se recomienda actualizar. El ambiente de Testing no cambia. * Seguridad: Con el registro de depuración activado, el log ya no guarda la contraseña de pFacturas. Antes quedaba escrita en texto plano en cada comunicación con el Web Service. Si tuviste el registro activado, te recomendamos borrar los logs anteriores y cambiar la contraseña del usuario de pFacturas. = 1.4.0.3 = * Corrección: Cuando una devolución se registraba indicando sólo un importe, sin completar las cantidades por producto, la Nota de Crédito era rechazada y el motivo no se mostraba en ninguna parte. En el pedido sólo aparecía un "CFE Rechazado" sin explicación, y repetido dos veces. Ahora el plugin detecta el caso antes de contactar a pFacturas y deja un mensaje claro, tanto en las notas del pedido como en el recuadro de pFacturas, explicando por qué no se pudo emitir y cómo resolverlo. La devolución del dinero al cliente nunca se bloquea. * Corrección: Los motivos de rechazo de una Nota de Crédito ahora se muestran en el pedido. Antes se guardaban asociados a la devolución, que en el panel de WooCommerce no muestra notas, así que el detalle quedaba invisible. * Mejora: Los avisos relacionados con Notas de Crédito ya no aparecen duplicados en el historial del pedido. El historial de versiones anteriores está en el [readme de la versión 1.5.0.0](https://plugins.trac.wordpress.org/browser/pfacturas-for-woocommerce/tags/1.5.0.0/readme.txt). == Support == ¿Preguntas o problemas? Escribe a **efactura@puntoexe.com.uy**.