Releases: yolovany/facturacionmozart-woocommerce-plugin
Release list
v1.15.0
Errores de facturación con salida clara: el comprador sólo interviene cuando el rechazo es suyo, y el administrador ve qué hacer.
Cambios
- Los errores del backend, PAC o configuración ya no se presentan al comprador como si sus datos fiscales fueran incorrectos.
- El cliente ve un formulario directo para actualizar sus datos y reintentar únicamente cuando el rechazo sí requiere su intervención.
- El administrador ve en el pedido el tipo de incidencia, los pasos recomendados y botones directos para reintentar o solicitar datos al cliente.
- Se conserva la clasificación de errores (
reintentable) recibida tanto por sondeo como por webhook. - Los administradores reciben una notificación persistente y un correo cuando falta configuración o los folios cruzan los umbrales de 100, 50, 20, 10, 5, 1 y 0. Cada condición se avisa una sola vez y vuelve a notificarse únicamente si cambia el umbral, cambia la configuración o el problema reaparece después de resolverse.
- Guía de implementación para clientes con tiendas ya en operación (
docs/implementacion-cliente-woocommerce.md). - El contrato público documenta el campo
alertasde/health.
Requisitos del backend
Los avisos de folios y configuración necesitan FacturaciónMozart 2026.07.27.12 o superior, que publica alertas en /health. Con un backend anterior el plugin funciona igual, sólo sin esos avisos.
Instalación
Descarga el ZIP e instálalo desde Plugins → Añadir nuevo → Subir plugin. Las instalaciones con 1.14.0 o superior se actualizan solas desde Escritorio → Actualizaciones.
v1.14.1
Actualización recomendada. A partir de esta versión, el plugin se actualiza solo.
Cambios
- Actualizaciones desde el panel y por línea de comandos. La actualización aparece en Escritorio → Actualizaciones y en la lista de plugins, y funciona con
wp plugin update facturacionmozart-woocommerce-plugin. Ya no hace falta descargar el ZIP y subirlo a mano. - Aviso cuando hay versión nueva. Si tu proveedor de facturación lo informa, aparece un aviso en el panel.
- El plugin declara su versión al puente en cada petición. Permite al proveedor saber qué versión usa cada tienda y, si lo configura, exigir una mínima.
- Si el puente responde que la versión es demasiado antigua, el pedido se reintenta en vez de quedar en error: al actualizar, los pedidos en vuelo se recuperan solos.
Al actualizar
Nada que configurar. Esta versión no cambia ajustes ni comportamiento de la tienda.
Si vienes de una versión anterior a la 1.14.0, revisa también sus notas: hay tres puntos que requieren atención.
Instalación
Desde Plugins → Añadir nuevo → Subir plugin con el .zip de abajo. A partir de aquí, las siguientes actualizaciones llegan solas.
v1.14.0
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Actualización recomendada.
Al actualizar
- Captura el "Secreto del webhook" en WooCommerce → Ajustes → Facturación CFDI. Pídeselo a tu proveedor de facturación. Sin él, los pedidos se actualizan por sondeo en vez de por aviso.
- Si administras la tienda, entra con tu contraseña. El enlace de acceso queda reservado a cuentas de cliente.
- Los campos de token y secreto aparecen vacíos. No se perdió nada: al guardar, vacío conserva el valor. Para vaciar uno, escribe
borrar.
Cambios
- Mejoras de seguridad en el manejo de credenciales y del acceso sin contraseña.
- Un token o dominio mal configurados ya no interrumpen el checkout; el problema queda en el registro.
- Aviso en el panel si la URL del puente no usa HTTPS.
- El perfil fiscal de Mi Cuenta valida los datos al guardarlos.
Compatible con WordPress 7.0, WooCommerce 10.9 y PHP 8.2, con HPOS.
v1.13.1
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Actualizar es desplegar y listo: las tiendas existentes siguen funcionando sin cambios.
Cambios
- "Probar conexión" también revisa la configuración, no sólo la conectividad: informa qué pasos quedan pendientes entre el puente y la tienda.
v1.13.0
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Cambios
- Nuevo ajuste "Secreto del webhook" (WooCommerce → Ajustes → Facturación CFDI): el valor con el que el puente firma sus avisos de timbrado, independiente del token de API. Te lo entrega tu proveedor de facturación.
v1.12.3
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Actualización de robustez. Recomendada antes de rotar el token de API.
Cambios
- Los fallos de acceso al puente ya no dejan pedidos en error definitivo. Los problemas de credenciales, tiempo de espera o límite de peticiones entran al mismo reintento con espera progresiva que un error de servidor, así que los pedidos en vuelo se recuperan solos al corregir la configuración.
v1.12.2
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Actualización de mantenimiento. Recomendada para todas las instalaciones.
Cambios
- Refuerzo del saneo de los datos que devuelve el puente antes de guardarlos en el pedido.
Sin cambios de comportamiento ni de configuración.
v1.12.1
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Reúne los cambios desde la v1.11.5.
Cuenta sin fricción
- Cuenta silenciosa: al comprar como invitado se crea la cuenta del cliente automáticamente, vinculando el pedido y los datos del checkout. Filtro
fcfdi_crear_cuenta_silenciosapara desactivarla. - Acceso sin contraseña: desde Mi Cuenta el cliente pide un enlace de acceso a su correo, de un solo uso y con caducidad.
Otros cambios
- El aviso de timbrado libera de inmediato el pedido retenido y detiene el sondeo pendiente.
- Si el pedido se cancela o reembolsa por completo antes de timbrar, no se emite CFDI; si ya estaba en proceso, se cancela ante el SAT automáticamente.
- Limpieza de los archivos temporales del CFDI adjuntado por correo.
v1.11.5
Descarga retirada. Instala siempre la última versión: las anteriores no reciben correcciones de seguridad.
Primer release público del plugin FacturaciónMozart para WooCommerce.
Qué incluye
- Checkout con captura de datos fiscales (clásico y por bloques), con validación
antes de cobrar (pre-flight) para no perder ventas por datos SAT inválidos. - Timbrado asíncrono vía Action Scheduler; retención del pedido hasta tener CFDI si se
solicitó factura, con backoff largo y aviso al admin si el backend está caído. - Portal del cliente: pestaña "Mis Facturas", perfil fiscal reutilizable con
autorrelleno del checkout, solicitud de factura post-compra. - Descarga de XML/PDF vía proxy autenticado + adjunto automático por correo.
- Cancelación de CFDI ante el SAT, webhook de notificación y reintento manual desde el
admin de pedidos (HPOS y legacy).
Requisitos
- WordPress 6.0+, WooCommerce 6.0+, PHP 7.4+.
- Un backend/puente REST de facturación propio que implemente el contrato descrito en
readme.txt.
Instalación
- Descarga
facturacion-cfdi-1.11.5.zipde este release. - WordPress → Plugins → Añadir nuevo → Subir plugin → activa.
- WooCommerce → Ajustes → Facturación CFDI: captura la URL de tu backend y el token de
API, y prueba la conexión.
Changelog completo
Ver la sección == Changelog == de readme.txt (historial desde v1.0.0).
Demo y desarrollo local
demo/ (tienda ficticia) y docker/ (entorno reproducible) — ver el README principal.