Nota<\/strong>: Para usar el ambiente de Testing o Producci\u00f3n, necesitar\u00e1s credenciales de pFacturas obtenidas al contratar el servicio.<\/p>\n\nServicios de terceros<\/h4>\n\n
Este plugin utiliza el servicio externo pFacturas para generar comprobantes fiscales electr\u00f3nicos conforme a las regulaciones de DGI Uruguay.<\/p>\n\n
Servicio:<\/strong> API de Facturaci\u00f3n Electr\u00f3nica pFacturas\nProveedor:<\/strong> PuntoExe Consultores\nURL del servicio:<\/strong> https:\/\/www.pfacturas.com<\/p>\n\nQu\u00e9 datos se env\u00edan:<\/strong>\n- Informaci\u00f3n del cliente (nombre, RUT, direcci\u00f3n) desde pedidos de WooCommerce\n- Detalles del pedido (art\u00edculos, precios, impuestos)\n- Informaci\u00f3n de la tienda (RUT, sucursal)\n- Estos datos se env\u00edan cuando se realiza un pedido y el plugin est\u00e1 configurado para emitir comprobantes electr\u00f3nicos<\/p>\n\nCu\u00e1ndo se env\u00edan los datos:<\/strong>\n- Autom\u00e1ticamente despu\u00e9s de completar el pedido (cuando est\u00e1 configurado)\n- Manualmente cuando el administrador activa la generaci\u00f3n de factura\n- Solo para pedidos que requieren comprobantes fiscales electr\u00f3nicos<\/p>\n\nProp\u00f3sito<\/strong>: Generar comprobantes fiscales electr\u00f3nicos (CFE) legalmente conformes seg\u00fan lo requiere la ley tributaria uruguaya (DGI)<\/p>\n\nPol\u00edtica de privacidad:<\/strong> https:\/\/efactura.puntoexe.com.uy\/facturaci%C3%B3n-electr%C3%B3nica\/woocommerce-integrado\/pol%C3%ADtica-de-privacidad\nT\u00e9rminos de servicio:<\/strong> https:\/\/efactura.puntoexe.com.uy\/facturaci%C3%B3n-electr%C3%B3nica\/woocommerce-integrado\/t%C3%A9rminos-y-condiciones-de-servicio<\/p>\n\nAl usar este plugin, aceptas compartir datos de pedidos con el servicio pFacturas para fines de facturaci\u00f3n electr\u00f3nica.<\/p>\n\n
Soporte t\u00e9cnico<\/h4>\n\n
Para consultas y soporte t\u00e9cnico, contactar a efactura@puntoexe.com.uy<\/strong><\/p>\n\nPlugin desarrollado y mantenido por Punto Exe Consultores.<\/p>\n\n
Dependencies<\/h3>\n\n
Este plugin requiere que WooCommerce est\u00e9 instalado y activo.<\/p>\n\n
Support<\/h3>\n\n
\u00bfPreguntas o problemas? Escribe a efactura@puntoexe.com.uy<\/strong>.<\/p>\n\n\n\n- Ir a Plugins \u2192 A\u00f1adir nuevo \u2192 Subir plugin<\/li>\n
- Seleccionar el archivo ZIP y hacer clic en \"Instalar ahora\"<\/li>\n
- Activar el plugin<\/li>\n
- Ir a WooCommerce \u2192 pFacturas<\/li>\n
- Para pruebas r\u00e1pidas: Seleccionar Modo \"Demo\" (no requiere configuraci\u00f3n adicional)<\/li>\n
- Para uso en producci\u00f3n: Configurar RUT, Sucursal, Usuario y Contrase\u00f1a con credenciales de pFacturas<\/li>\n<\/ol>\n\n\n
1.2.1.1<\/h4>\n\n\n- Mejora: Changelog traducido al espa\u00f1ol (el p\u00fablico objetivo del plugin son empresas uruguayas)<\/li>\n
- Nota: Esta versi\u00f3n solo modifica la documentaci\u00f3n, no hay cambios de c\u00f3digo<\/li>\n<\/ul>\n\n
1.2.1.0<\/h4>\n\n\n- Mejora: Nuevo bot\u00f3n \"Restablecer defaults de POS\" al final de la pesta\u00f1a de configuraci\u00f3n Backoffice\/POS \u2014 rellena los campos vac\u00edos con sus valores por defecto sin sobrescribir configuraciones personalizadas<\/li>\n
- Mejora: Facilita la migraci\u00f3n desde versiones anteriores en las que
pos_doc_meta_key<\/code> quedaba guardado como string vac\u00edo (el nuevo default billing_vat<\/code> no se aplica autom\u00e1ticamente a configuraciones ya guardadas)<\/li>\n<\/ul>\n\n1.2.0.0<\/h4>\n\n\n- Funcionalidad: Detecci\u00f3n heur\u00edstica del tipo de documento en \u00f3rdenes que no provienen del checkout est\u00e1ndar (t\u00edpicamente sistemas POS integrados via REST API)<\/li>\n
- Funcionalidad: Detecci\u00f3n autom\u00e1tica de RUT (12 d\u00edgitos con d\u00edgito verificador v\u00e1lido), C\u00e9dula uruguaya (8 d\u00edgitos con d\u00edgito verificador v\u00e1lido) u \"Otros\" a partir de un \u00fanico campo de documento<\/li>\n
- Funcionalidad: Bloqueo de la creaci\u00f3n de la orden via REST cuando el documento es inv\u00e1lido pero la raz\u00f3n social termina en SA\/SAS\/SRL\/LTDA (se presume RUT mal tipeado y se exige correcci\u00f3n)<\/li>\n
- Funcionalidad: Nuevo default
billing_vat<\/code> para el meta key del documento \u2014 funciona out-of-the-box con la mayor\u00eda de plugins POS<\/li>\n- Mejora: Pesta\u00f1a Backoffice\/POS reorganizada con texto de ayuda expl\u00edcito para los dos modos (expl\u00edcito de 2 campos vs heur\u00edstico de campo \u00fanico)<\/li>\n
- Mejora: Nuevo helper
pfwc_nombre_parece_empresa()<\/code> para detectar sufijos SA\/S.A.\/SAS\/S.A.S.\/SRL\/S.R.L.\/LTDA\/Ltda (con o sin puntos)<\/li>\n- Mejora: Nuevo c\u00f3digo de error
pf_rut_invalido_empresa<\/code> para \u00f3rdenes POS bloqueadas por inconsistencia entre documento y sufijo empresarial<\/li>\n<\/ul>\n\n1.1.3.2<\/h4>\n\n\n- Correcci\u00f3n: La p\u00e1gina de settings ahora siempre abre en la primera pesta\u00f1a al navegar de vuelta<\/li>\n
- Correcci\u00f3n: La posici\u00f3n de la pesta\u00f1a activa solo se preserva durante la recarga por guardado de settings, no entre navegaciones<\/li>\n<\/ul>\n\n
1.1.3.1<\/h4>\n\n\n- Correcci\u00f3n: Aviso en settings de POS cuando los meta keys de identificaci\u00f3n fiscal no est\u00e1n configurados<\/li>\n
- Correcci\u00f3n: La validaci\u00f3n previa a la emisi\u00f3n detecta cuando
billing_company<\/code> est\u00e1 presente pero los meta keys fiscales no est\u00e1n configurados, evitando la emisi\u00f3n silenciosa como consumo final<\/li>\n- Correcci\u00f3n: El aviso din\u00e1mico en la pesta\u00f1a POS se actualiza en tiempo real mientras el usuario completa o borra los campos de meta keys<\/li>\n<\/ul>\n\n
1.1.3.0<\/h4>\n\n\n- Mejora: P\u00e1gina de settings reorganizada con navegaci\u00f3n por pesta\u00f1as (Conexi\u00f3n, Documento, Emisi\u00f3n, Checkout, Backoffice\/POS, Avanzado)<\/li>\n
- Mejora: Pesta\u00f1a activa persistida en localStorage entre recargas de p\u00e1gina<\/li>\n
- Mejora: Todo el JavaScript consolidado en un \u00fanico bloque inline<\/li>\n<\/ul>\n\n
1.1.2.0<\/h4>\n\n\n- Refactor: Settings de POS simplificados \u2014 se eliminaron
pos_rut_meta_key<\/code> y pos_razon_social_meta_key<\/code><\/li>\n- Funcionalidad: POS ahora usa el campo
tipo_doc<\/code> (2=RUT, 3=CI, etc.) alineado con los c\u00f3digos de tipo de documento de DGI<\/li>\n- Funcionalidad: Campos de billing POS configurables (
pos_billing_first_name<\/code>, pos_billing_last_name<\/code>, pos_billing_company<\/code>) con defaults est\u00e1ndar de WooCommerce<\/li>\n- Funcionalidad: Todos los campos de meta keys POS cambiados de combos a inputs de texto para compatibilidad universal con cualquier plugin<\/li>\n
- Funcionalidad: Sincronizaci\u00f3n checkout \u2014 nuevos settings para copiar RUT y Raz\u00f3n Social a los campos billing est\u00e1ndar de WooCommerce<\/li>\n
- Funcionalidad:
checkout_razon_social_meta_key<\/code> (default: billing_company<\/code>) sincroniza la Raz\u00f3n Social en el checkout<\/li>\n<\/ul>\n\n1.1.1.0<\/h4>\n\n\n- Correcci\u00f3n:
IndicadorDeFacturacion<\/code> ahora se infiere a partir de la tasa efectiva de impuestos en vez del nombre de la tax class<\/li>\n- Correcci\u00f3n: Los productos exentos de IVA (ej: libros al 0%) ahora usan correctamente el indicador 1 (Exento) en vez del 3 (IVA B\u00e1sica)<\/li>\n
- Correcci\u00f3n: El indicador de la l\u00ednea de env\u00edo tambi\u00e9n usa el c\u00e1lculo por tasa efectiva<\/li>\n
- Refactor: Mapeo centralizado de tasa de impuesto a indicador en el m\u00e9todo
indicador_por_tasa()<\/code><\/li>\n<\/ul>\n\n1.1.0.0<\/h4>\n\n\n- Funcionalidad: Compatibilidad con sistemas de Backoffice\/POS (YITH Point of Sale y plugins similares)<\/li>\n
- Funcionalidad: Resoluci\u00f3n autom\u00e1tica de datos fiscales desde los campos billing cuando los campos del checkout est\u00e1n vac\u00edos<\/li>\n
- Funcionalidad: Mapeo configurable de campos billing para RUT, Raz\u00f3n Social, Tipo Documento, Documento<\/li>\n
- Funcionalidad: Combos de settings populados din\u00e1micamente desde los billing fields registrados por WooCommerce<\/li>\n
- Funcionalidad: Validaci\u00f3n en dos niveles \u2014 hook de creaci\u00f3n de orden via REST API + validaci\u00f3n previa a la emisi\u00f3n<\/li>\n
- Funcionalidad: Funciones de validaci\u00f3n de d\u00edgito verificador para RUT y CI (C\u00e9dula de Identidad) del lado del servidor<\/li>\n
- Funcionalidad: Soporte para Adenda multi-l\u00ednea con un meta key extra configurable<\/li>\n
- Funcionalidad: Datos fiscales auto-persistidos en los meta de la orden para consistencia en notas de cr\u00e9dito<\/li>\n
- Correcci\u00f3n: El campo Id de MediosPago se trunca a 20 caracteres para cumplir con el l\u00edmite del WSDL<\/li>\n<\/ul>\n\n
1.0.27.64<\/h4>\n\n\n- Correcci\u00f3n: Modo Demo \u2014 el RUT y la Sucursal del Emisor se enviaban vac\u00edos cuando las credenciales demo estaban expiradas<\/li>\n
- Correcci\u00f3n: El constructor del Client ahora se ejecuta antes que el Mapper para que las credenciales demo se renueven antes de construir la secci\u00f3n Emisor del CFE<\/li>\n
- Correcci\u00f3n: Mismo fix aplicado al flujo de emisi\u00f3n de notas de cr\u00e9dito (NC)<\/li>\n
- Correcci\u00f3n: Bloqueo de la p\u00e1gina de checkout por loop infinito de MutationObserver\/toggle en blocks.js<\/li>\n
- Correcci\u00f3n: Debounce agregado al callback del MutationObserver y se omite el dispatch al Store API cuando el payload no cambi\u00f3<\/li>\n
- Limpieza: Removidos los
console.log<\/code> verbosos de debug en blocks.js<\/li>\n<\/ul>\n\n1.0.27.63<\/h4>\n\n\n- Seguridad: Corregido el orden de verificaci\u00f3n del nonce AJAX \u2014 ahora el nonce se verifica ANTES de extraer
order_id<\/code> de $_POST<\/code><\/li>\n- Seguridad: Migrado a verificaci\u00f3n est\u00e1tica de nonce con
check_ajax_referer()<\/code> en vez de nonces espec\u00edficos por orden<\/li>\n- Seguridad: El nonce ahora usa el nombre de acci\u00f3n est\u00e1tico
pfwc_emit_cfe<\/code> en lugar del din\u00e1mico pf_emit_<\/code> . $order_id<\/code><\/li>\n- Correcci\u00f3n:
ob_start()<\/code> y ob_get_clean()<\/code> separados en l\u00edneas individuales para manejo expl\u00edcito del buffer<\/li>\n- Mejora: El handler AJAX ahora usa
wp_localize_script()<\/code> para pasar nonce y ajaxUrl<\/code> al JavaScript<\/li>\n- Cumplimiento: Todas las correcciones de seguridad siguen los requerimientos del WordPress.org Plugin Directory<\/li>\n<\/ul>\n\n
1.0.27.62<\/h4>\n\n\n- Correcci\u00f3n: Renombradas todas las funciones helper del prefijo
pf_<\/code> al prefijo pfwc_<\/code> (WordPress.org requiere 4 caracteres o m\u00e1s)<\/li>\n- Correcci\u00f3n: Comentarios
phpcs:ignore<\/code> agregados para el uso de $_GET<\/code> en el enqueueing de scripts del admin (solo para mostrar mensaje, no procesa datos)<\/li>\n- Cumplimiento: Todos los nombres de funciones ahora cumplen con los est\u00e1ndares de naming de WordPress.org<\/li>\n<\/ul>\n\n
1.0.27.61<\/h4>\n\n\n- Correcci\u00f3n: Cambiados todos los prefijos de clases de
PF_<\/code> a PFWC_<\/code> (WordPress.org requiere 4 caracteres o m\u00e1s)<\/li>\n- Correcci\u00f3n: Constantes
PF_PLUGIN_DIR<\/code> y PF_PLUGIN_URL<\/code> cambiadas a PFWC_PLUGIN_DIR<\/code> y PFWC_PLUGIN_URL<\/code><\/li>\n- Correcci\u00f3n: Tags
<script><\/code> inline convertidos a wp_add_inline_script()<\/code> para enqueueing correcto<\/li>\n- Seguridad: Agregada verificaci\u00f3n de nonce y de capability en el m\u00e9todo
ajax_emit()<\/code><\/li>\n- Seguridad: Agregada verificaci\u00f3n de permisos en el m\u00e9todo
emit_if_needed()<\/code> y removido el procesamiento directo de $_POST<\/code><\/li>\n- Seguridad: Removidos los
var_export()<\/code> y print_r()<\/code> inseguros de datos de $_POST<\/code> en el logging<\/li>\n- Seguridad: Agregado el escapado correcto con
esc_html()<\/code> a todas las variables echoeadas<\/li>\n- Cumplimiento: Todos los scripts ahora est\u00e1n correctamente enqueueados siguiendo los WordPress Coding Standards<\/li>\n<\/ul>\n\n
1.0.27.60<\/h4>\n\n\n- Correcci\u00f3n: Toda la descripci\u00f3n del plugin traducida al ingl\u00e9s (readme.txt y headers del plugin)<\/li>\n
- Documentaci\u00f3n: Agregada secci\u00f3n completa de Servicios de Terceros documentando la integraci\u00f3n con la API de pFacturas<\/li>\n
- Cumplimiento: Documentaci\u00f3n completa de transmisi\u00f3n de datos, pol\u00edtica de privacidad y t\u00e9rminos de servicio<\/li>\n<\/ul>\n\n
1.0.27.59<\/h4>\n\n\n- Correcci\u00f3n: Corregido el m\u00e9todo de compresi\u00f3n del ZIP (cambiado a
Compress-Archive<\/code> para compatibilidad con WordPress.org)<\/li>\n<\/ul>\n\n1.0.27.58<\/h4>\n\n\n- Correcci\u00f3n: Corregido el nombre del plugin en readme.txt para que coincida con pFacturas.php (ambos usan ahora \"pFacturas for WooCommerce\")<\/li>\n<\/ul>\n\n
1.0.27.57<\/h4>\n\n\n- Correcci\u00f3n: Plugin URI corregido para cumplir con los requerimientos de WordPress.org (no puede ser una URL de WordPress.org, debe ser del sitio del desarrollador)<\/li>\n<\/ul>\n\n
1.0.27.56<\/h4>\n\n\n- Correcci\u00f3n: Corregido el nombre del autor de \"Punto Exe Consultores\" a \"PuntoExe Consultores\" (sin espacio)<\/li>\n<\/ul>\n\n
1.0.27.55<\/h4>\n\n\n- Correcci\u00f3n: Header completamente reescrito siguiendo el formato exacto de la documentaci\u00f3n oficial de WordPress.org (nombre en ingl\u00e9s, campos adicionales requeridos, License en el formato exacto)<\/li>\n<\/ul>\n\n
1.0.27.54<\/h4>\n\n\n- Correcci\u00f3n: Acentos removidos del header del plugin para evitar problemas de encoding (WordPress.org requiere ASCII puro en headers)<\/li>\n<\/ul>\n\n
1.0.27.53<\/h4>\n\n\n- Correcci\u00f3n: Agregados los campos Plugin URI y Author URI al header (requeridos por WordPress.org)<\/li>\n<\/ul>\n\n
1.0.27.52<\/h4>\n\n\n- Correcci\u00f3n: Formato del bloque de comentarios cambiado de
\/*<\/code> a \/**<\/code> (est\u00e1ndar PHPDoc DocBlock)<\/li>\n<\/ul>\n\n1.0.27.51<\/h4>\n\n\n- Correcci\u00f3n: Formato del header del plugin corregido (asterisco
*<\/code> agregado al inicio de cada l\u00ednea seg\u00fan el est\u00e1ndar de WordPress.org)<\/li>\n<\/ul>\n\n1.0.27.50<\/h4>\n\n\n- Correcci\u00f3n: Formato del header del plugin corregido (changelog interno removido, se mantiene solo en readme.txt)<\/li>\n<\/ul>\n\n
1.0.27.49<\/h4>\n\n\n- Correcci\u00f3n: Restaurados los acentos en Plugin Name y Description<\/li>\n<\/ul>\n\n
1.0.27.48<\/h4>\n\n\n- Correcci\u00f3n: Restaurados los acentos en los tags de readme.txt<\/li>\n<\/ul>\n\n
1.0.27.47<\/h4>\n\n\n- Correcci\u00f3n: Cambiado el enfoque de
phpcs:ignore<\/code> inline a un bloque phpcs:disable<\/code>\/phpcs:enable<\/code> en class-pf-emitter.php<\/code> l\u00edneas 588-590<\/li>\n<\/ul>\n\n1.0.27.46<\/h4>\n\n\n- Correcci\u00f3n: Actualizado el comentario
phpcs:ignore<\/code> inline en class-pf-emitter.php<\/code> l\u00ednea 589<\/li>\n<\/ul>\n\n1.0.27.45<\/h4>\n\n\n- Correcci\u00f3n: Agregado comentario
phpcs:ignore<\/code> inline en class-pf-emitter.php<\/code> l\u00ednea 589 para NonceVerification.Missing<\/code><\/li>\n<\/ul>\n\n1.0.27.44<\/h4>\n\n\n- Correcci\u00f3n: Cambiado el slug del plugin de \"woocommerce-pfacturas\" a \"pfacturas-for-woocommerce\"<\/li>\n
- Correcci\u00f3n: Ahora cumple con las reglas de trademark de WordPress.org (termina en \"for-woocommerce\")<\/li>\n
- Correcci\u00f3n: Agregado
sanitize_text_field()<\/code> en class-pf-emitter.php<\/code> l\u00ednea 606 para el nonce<\/li>\n- IMPORTANTE: Requiere desinstalar y reinstalar el plugin (cambio de slug)<\/li>\n<\/ul>\n\n
1.0.27.43<\/h4>\n\n\n- Correcci\u00f3n: Corregido el nombre del plugin para cumplir con las reglas de trademark de WordPress.org<\/li>\n
- Correcci\u00f3n: El nombre ahora termina en \"for WooCommerce\" en vez de \"para WooCommerce\"<\/li>\n
- Correcci\u00f3n: Removidos caracteres acentuados del nombre y la descripci\u00f3n para evitar problemas de encoding<\/li>\n
- Correcci\u00f3n: readme.txt reducido a un m\u00e1ximo de 5 tags y la descripci\u00f3n corta a menos de 150 caracteres<\/li>\n
- Correcci\u00f3n: Agregado
wp_unslash()<\/code> en class-pf-emitter.php<\/code> l\u00ednea 606 para $_POST['_wpnonce']<\/code><\/li>\n<\/ul>\n\n1.0.27.42<\/h4>\n\n\n- Correcci\u00f3n: Actualizado el Stable tag de readme.txt a 1.0.27.42<\/li>\n
- Correcci\u00f3n: Completados los comentarios
phpcs:ignore<\/code> faltantes en class-pf-checkout.php<\/code> (l\u00edneas 18-20, 37-39)<\/li>\n- Correcci\u00f3n: Agregado
phpcs:ignore<\/code> para var_export<\/code> en class-pf-emitter.php<\/code> l\u00ednea 155<\/li>\n- Correcci\u00f3n: Agregados
phpcs:ignore<\/code> para $_POST<\/code> en class-pf-emitter.php<\/code> l\u00edneas 588, 592, 605<\/li>\n- Correcci\u00f3n: Agregados
phpcs:ignore<\/code> para var_export<\/code> y print_r<\/code> en class-pf-mapper.php<\/code> l\u00edneas 17, 20, 25<\/li>\n<\/ul>\n\n1.0.27.41<\/h4>\n\n\n- Correcci\u00f3n: Agregado
sanitize_callback<\/code> a register_setting()<\/code> para cumplir con los est\u00e1ndares de WordPress<\/li>\n- Correcci\u00f3n: Actualizado \"Tested up to\" a WordPress 6.8<\/li>\n
- Correcci\u00f3n: Agregados comentarios
phpcs:ignore<\/code> para los warnings de verificaci\u00f3n de nonce en hooks de WooCommerce<\/li>\n- Correcci\u00f3n: Agregados comentarios
phpcs:ignore<\/code> para las funciones de debug (var_export<\/code>,