Changelog

🎉 Nuevas Características

Capacidad de subir CSF en checkout (Constancia de Situación Fiscal)

• Implementación completa del flujo de CSF para manejo de Constancias de Situación Fiscal
• Integración con PocketBase para almacenamiento de archivos CSF
• Configuración de flujos automatizados para incluir CSF en Flow
• Soporte para gestión de metaobjetos de Shopify con permisos actualizados (CSFs en metaobjetos próximamente)

🔧 Mejoras de Funcionalidad

Integración con Metaobjetos

• Actualización de permisos de alcance para metaobjetos de Shopify
• Mejor manejo de datos estructurados para información fiscal
• Configuración optimizada para campos personalizados

Almacenamiento Mejorado

• Integración completa con PocketBase para CSF
• Sistema de archivos optimizado para documentos fiscales complementarios
• Backup automático de complementos generados

🛠️ Actualizaciones Técnicas

Permisos y Seguridad

• Actualización de permisos de alcance para metaobjetos (commit: ed71d39)
• Mejoras en la seguridad del manejo de datos fiscales
• Validación mejorada de acceso a recursos

Base de Datos y Almacenamiento

• Implementación de guardado de CSF en PocketBase (commits: 4830b37, 9406c92)
• Optimización de consultas para mejor rendimiento
• Sistema de respaldo mejorado para documentos fiscales

📈 Funcionalidades Existentes Mantenidas

CFDI Express Core

• Todas las funcionalidades existentes de generación de CFDI mantienen su operación normal
• Compatibilidad total con configuraciones previas
• Sin cambios disruptivos en flujos existentes

Integración Shopify

• Mantenimiento de integración con API Shopify 2025-07
• Continuidad en extensiones de UI
• Soporte completo para todas las características existentes

📋 Notas de Actualización

Esta versión introduce el soporte para CSF (Complementos de Servicios Facturados), una funcionalidad importante para el cumplimiento fiscal mexicano. Los CSF permiten manejar complementos fiscales adicionales que complementan la facturación tradicional CFDI.

Cambios Específicos

• Nuevo módulo de gestión de CSF integrado
• Flujos automatizados para generación de complementos
• Sistema de almacenamiento dedicado en PocketBase
• Permisos actualizados para manejo de metaobjetos de Shopify

🔄 Compatibilidad

Esta versión mantiene total compatibilidad hacia atrás. Los comerciantes existentes pueden continuar usando todas las funcionalidades previas sin interrupción. Las nuevas características de CSF están disponibles como funcionalidades adicionales.

⚠️ Consideraciones Importantes

• Las funcionalidades de CSF requieren configuración adicional en el panel de administración
• Se recomienda verificar los permisos de metaobjetos después de la actualización
• Los archivos CSF se almacenan de forma segura en PocketBase

🚀 Próximos Pasos

Después de actualizar a la versión 1.9.0:

1. Acceso a nuevas funcionalidades de CSF en el panel de administración
2. Configuración de flujos de complementos fiscales según necesidades
3. Verificación de permisos actualizados para metaobjetos
4. Pruebas del nuevo sistema de almacenamiento CSF

📦 Información de Versión

• Versión anterior: 1.8.0
• Versión actual: 1.9.0
• Tipo de actualización: Minor (Nueva funcionalidad)
• Fecha de liberación: Septiembre 2025

🎉 Nuevas Características

Sistema de Reseñas de App

• Se agregó un flujo completo de reseñas para la aplicación
• Los usuarios pueden proporcionar feedback directo sobre su experiencia
• Sistema integrado de calificaciones y comentarios
• Mejora continua basada en retroalimentación de usuarios

Actualización Shopify API 2025-07

• Migración completa a la versión más reciente de Shopify API (2025-07)
• Compatibilidad con las últimas características y mejoras de Shopify
• Mejor rendimiento y estabilidad en la integración
• Soporte para nuevas funcionalidades de la plataforma Shopify

🔧 Mejoras de Funcionalidad

Extensiones de UI Actualizadas

• Todas las extensiones de UI han sido actualizadas para compatibilidad con Shopify 2025-07
• Formulario de facturación mejorado con mejor experiencia de usuario
• Integración optimizada en el flujo de checkout y thank you page
• Mejor rendimiento en dispositivos móviles

Integración de Datos de Tienda Mejorada

• Los correos de facturación ahora incluyen información completa de la tienda
• Configuración automática del remitente con datos del comerciante
• Reply-to personalizado con el email de contacto de la tienda
• Branding consistente en todas las comunicaciones

🛠️ Actualizaciones Técnicas

Dependencias Actualizadas

• Actualización de Shopify CLI y librerías relacionadas
• Migración de Prisma a la versión más reciente
• Optimización de todas las dependencias del proyecto
• Mejoras de seguridad en bibliotecas de terceros

Archivo MCP Agregado

• Incorporación de configuración MCP para mejor integración
• Soporte mejorado para herramientas de desarrollo
• Configuración optimizada para el entorno de desarrollo

📈 Funcionalidades Heredadas Mejoradas

Prueba Gratuita de 7 Días

• Continuidad del período de prueba gratuito para nuevos usuarios
• Acceso completo a todas las características durante la prueba
• Onboarding optimizado para nuevos comerciantes

Descargas y Visualización

• Mantenimiento del sistema mejorado de descarga de acuses de cancelación
• Conservación de badges de colores para estados de facturas
• Interfaz consistente y mejorada

📋 Notas de Actualización

Esta versión representa una importante actualización técnica que prepara CFDI Express para las mejores prácticas y funcionalidades más recientes de Shopify. La migración a la API 2025-07 garantiza compatibilidad a largo plazo y acceso a las características más avanzadas de la plataforma.

Cambios Específicos

• Migración completa de API de Shopify de versiones anteriores a 2025-07
• Implementación de sistema de reseñas integrado en el flujo de la app
• Actualización de todas las extensiones de UI para nueva compatibilidad
• Optimización de dependencias y bibliotecas del proyecto
• Mejora en la integración de datos de tienda en comunicaciones

🔄 Compatibilidad

Esta versión mantiene total compatibilidad con configuraciones existentes. Los comerciantes no necesitan realizar cambios adicionales en su configuración. La actualización es transparente y automática.

⚠️ Consideraciones Importantes

• La migración a Shopify API 2025-07 puede requerir re-instalación de la app en algunas tiendas
• Se recomienda probar el flujo completo de facturación después de la actualización
• Las nuevas características de reseñas están habilitadas por defecto

🚀 Próximos Pasos

Después de actualizar a la versión 1.8.0:

1. Los usuarios verán el nuevo sistema de reseñas integrado
2. Mejor rendimiento general de la aplicación
3. Compatibilidad mejorada con las últimas características de Shopify
4. Acceso a funcionalidades más robustas de la API 2025-07

🎉 Nuevas Características

Prueba Gratuita de 7 Días

• Se agregó un período de prueba gratuito de 7 días para nuevos usuarios
• Los comerciantes pueden probar todas las funcionalidades de CFDI Express sin costo inicial
• Acceso completo a todas las características durante el período de prueba

🔧 Mejoras de Funcionalidad

Descarga Mejorada de Acuses de Cancelación

• Optimización del sistema de descarga de acuses de cancelación
• Implementación de fetch API para una descarga más fluida
• Los archivos se descargan automáticamente con nombres descriptivos
• Mejor manejo de errores durante el proceso de descarga

Mejoras Visuales en Estado de Facturas

• Nueva visualización de estados de facturas con badges de colores distintivos
• Mayor claridad en la identificación del estado de cada factura
• Interfaz más intuitiva y profesional en el panel de administración
• Mejora en la experiencia de usuario al revisar facturas

Mejora en Comunicación por Email

• Integración de información de la tienda en los correos de facturación
• Los correos ahora incluyen el nombre de la tienda en el remitente
• Configuración automática del Reply-To con el email de contacto de la tienda
• Los clientes pueden responder directamente al email de contacto del comerciante

📋 Notas de Actualización

Esta versión introduce una importante característica comercial con el período de prueba gratuito, permitiendo a nuevos usuarios experimentar el sistema completo antes de comprometerse. Además, se han realizado mejoras significativas en la experiencia de usuario con mejor visualización de estados y descarga de documentos.

Cambios Específicos

• Implementación de lógica de prueba gratuita de 7 días
• Actualización del sistema de descarga de acuses con fetch API
• Nuevos componentes de badges con colores para estados de facturas
• Integración con GraphQL de Shopify para obtener datos de la tienda
• Configuración automática de Reply-To en correos de facturación
• Optimización general del rendimiento de la interfaz

🔄 Compatibilidad

Esta versión es totalmente compatible con la versión 1.6.1. No se requieren cambios en la configuración existente. Los comerciantes existentes no se verán afectados por la implementación del período de prueba.

🚀 Próximos Pasos

Después de actualizar a la versión 1.7.0:

1. Los nuevos usuarios verán automáticamente la opción de prueba gratuita
2. Los usuarios existentes continuarán con su plan actual sin cambios
3. La interfaz mostrará automáticamente los nuevos badges de estado de facturas

🔧 Mejoras de Funcionalidad

Descarga Mejorada de Acuses

• Se mejoró el sistema de descarga de acuses de cancelación de facturas
• Ahora la descarga se realiza mediante fetch API en lugar de navegación directa
• Los archivos PDF se descargan automáticamente con el nombre acuse-{facturamaId}.pdf
• Mejor experiencia de usuario sin redireccionamientos innecesarios

🐛 Correcciones Técnicas

Optimización de Interfaz

• Eliminada la navegación directa a URLs de descarga
• Implementado manejo programático de archivos blob
• Limpieza automática de URLs temporales para optimizar memoria
• Manejo de errores mejorado durante el proceso de descarga

📋 Notas de Actualización

Esta versión mejora la experiencia de descarga de acuses de cancelación de facturas. Los usuarios ahora pueden descargar estos documentos de forma más fluida y confiable.

Cambios Específicos

• La función downloadAcuse maneja la descarga completa del PDF
• Se removió el atributo url del botón de descarga
• Se agregó el atributo onClick para manejar la descarga programáticamente
• Mejor nomenclatura de archivos descargados

🔄 Compatibilidad

Esta versión es totalmente compatible con la versión 1.6.0. No se requieren cambios en la configuración existente ni actualizaciones de dependencias.

🚀 Nuevas Funcionalidades

Visualización Mejorada del Estado de Facturas

• Se agregó integración con PocketBase para obtener el estado real de las facturas en la página principal
• Nuevo sistema de badges con códigos de color para identificar rápidamente el estado de facturación:
  • Rojo: Órdenes pendientes de facturar o con todas las facturas canceladas
  • Amarillo: Órdenes facturadas que tienen al menos una factura cancelada
  • Verde: Órdenes facturadas sin cancelaciones
• Nuevo estado "Cancelada" para órdenes donde todas las facturas han sido canceladas

🔧 Mejoras Técnicas

Optimización de Consultas

• La página principal ahora consulta directamente la base de datos de PocketBase para obtener información actualizada
• Mejor rendimiento al agrupar facturas por orden para reducir consultas individuales

Experiencia de Usuario

• Los usuarios pueden identificar de un vistazo qué órdenes requieren atención
• Mayor transparencia en el estado real de las facturas de cada orden
• Interfaz más intuitiva con indicadores visuales claros

📋 Notas de Actualización

Esta versión mejora significativamente la visibilidad del estado de facturación en la página principal de órdenes. Los badges con códigos de color permiten a los usuarios identificar rápidamente:

• Órdenes que necesitan ser facturadas
• Órdenes con facturas canceladas que podrían requerir re-facturación
• Órdenes correctamente facturadas

Cambios en la API

• La ruta /app ahora incluye autenticación con PocketBase
• Se agregó lógica para recuperar y procesar el estado de facturas desde la base de datos

🔄 Compatibilidad

Esta versión es totalmente compatible con las versiones anteriores. No se requieren cambios en la configuración existente ni migraciones de base de datos.

🐛 Correcciones

Descarga de Acuses de Cancelación

• Se corrigió el botón de descarga para facturas canceladas
• Ahora permite descargar correctamente el acuse de cancelación en formato PDF
• Nueva ruta API /api/acuse para obtener acuses de cancelación

Flujo de Cancelación de Facturas

• Se agregó el ID de orden (orderId) al proceso de cancelación para mejorar el seguimiento
• Mejor integración con el flujo de trabajo de Shopify

🔧 Mejoras Técnicas

Entorno de Desarrollo

• Se agregó lógica específica para el entorno de desarrollo en la API de cancelación
• Las cancelaciones en desarrollo ahora retornan una respuesta simulada exitosa
• Esto facilita las pruebas sin afectar el ambiente de producción de Facturama

Depuración

• Se comentaron logs de consola innecesarios para mantener limpia la salida
• Mejor manejo de errores en el flujo de cancelación

📋 Notas de Actualización

Esta versión se enfoca en mejorar la experiencia de cancelación de facturas y facilitar el desarrollo local. No se requieren cambios en la configuración existente.

Archivos Modificados

• app/routes/api.cfdi.ts - Lógica de desarrollo para cancelación y orderId en flujo
• app/routes/app.factura.$factura.tsx - Cambio de descarga de CFDI a acuse para facturas canceladas
• app/routes/api.acuse.ts - Nueva ruta API para obtener acuses de cancelación (archivo nuevo)

🔄 Compatibilidad

Esta versión es totalmente compatible con la versión 1.5.0. No se requieren migraciones de base de datos ni cambios de configuración.

🚀 Nuevas Funcionalidades

Integración con Sentry

• Se agregó monitoreo de errores con Sentry para mejorar la detección y resolución de problemas
• Captura automática de errores en producción para una respuesta más rápida a incidencias

Asistente Virtual Robo CFDI 🤖

• Nuevo asistente de chat integrado para ayudar a los usuarios con dudas sobre facturación
• Disponible en toda la aplicación para soporte inmediato
• Integración con API especializada en CFDI Express

API GraphQL Mejorada

• Se agregó el campo "fully paid" (totalmente pagado) a las consultas de facturas
• Mejor seguimiento del estado de pago de las facturas

🐛 Correcciones

Cálculo de Descuentos

• Se corrigió el cálculo de descuentos en la generación de facturas
• Ahora los descuentos se aplican correctamente según las reglas del SAT

Cancelación de Facturas

• Se implementó un trigger automático para el proceso de cancelación de facturas
• Mayor confiabilidad en el flujo de cancelación

Modo de Flujo CFDI

• Se corrigió la funcionalidad del modo de flujo para la generación de facturas
• Mejor manejo de estados y transiciones en el proceso de facturación

🔧 Mejoras Técnicas

Estabilidad General

• Mejoras en el manejo de errores y excepciones
• Optimización de procesos críticos de facturación
• Actualización de dependencias y componentes

Experiencia de Usuario

• Interfaz más intuitiva con el nuevo asistente virtual
• Mejor retroalimentación visual en procesos de facturación

📋 Notas de Actualización

Esta versión incluye mejoras significativas en la estabilidad y funcionalidad de CFDI Express. Se recomienda actualizar para aprovechar las nuevas características y correcciones.

Commits Incluidos

• 625b8a0 Added release notes
• 4868455 Fix expedition place configuration for CFDI invoices
• fdf0ab4 Added release notes and readme
• 5a77a78 Added new pr messages folder
• d1b9982 Added fully paid to the GraphQL API call
• 34dea9e Added flow action in CFDI
• 64c575f Fix de descuentos y Trigger de cancelación de Factura
• 9a8aa54 Added discount fix
• a207735 Added sentry to app

🔄 Compatibilidad

Esta versión es totalmente compatible con las versiones anteriores. No se requieren cambios en la configuración existente.

🐛 Correcciones

Configuración del Lugar de Expedición en CFDI

• Se corrigió la configuración del lugar de expedición (código postal) en la generación de facturas CFDI
• Ahora se utiliza correctamente el código postal del comerciante para todas las modalidades de facturación
• Se eliminaron valores hardcodeados que causaban inconsistencias en el cumplimiento fiscal

🔧 Mejoras Técnicas

Consistencia en la Generación de Facturas

• El campo ExpedicionPlace en el XML del CFDI ahora refleja correctamente el domicilio fiscal del emisor
• Aplicación uniforme del código postal del comerciante en:
  • API de generación de facturas
  • Panel de administración
  • Portal de autoservicio para clientes

📋 Notas de Actualización

Esta actualización es crítica para el cumplimiento fiscal correcto. El lugar de expedición debe corresponder al domicilio fiscal registrado del emisor según las regulaciones del SAT.

Cambios Incluidos

• Actualización del endpoint API /api/cfdi para incluir el código postal del comerciante
• Corrección en la página de administración de facturas
• Actualización de todas las extensiones compiladas con los últimos cambios

🚀 Nuevas Funcionalidades

Integración con Shopify Flow para Cancelaciones

• Ahora puedes automatizar acciones cuando se cancela una factura CFDI
• Crea flujos personalizados: envía notificaciones, actualiza etiquetas de pedidos, registra eventos
• Mayor control sobre el ciclo de vida de tus facturas

🔧 Mejoras

Cálculo de Descuentos Mejorado

• Corrección en el manejo de descuentos para facturas más precisas
• Cálculos fiscales más exactos en línea con los requerimientos del SAT

Estabilidad y Rendimiento

• Mejor manejo de errores en el proceso de facturación
• Optimizaciones en la visualización de detalles de facturas

📋 Notas Técnicas

Esta versión incluye una nueva extensión de Flow (cfdi-deleted) que se activa automáticamente al cancelar una factura, permitiendo a los comerciantes crear flujos de trabajo personalizados basados en eventos de cancelación.

Nuevas funcionalidades

• ✨ Agregadas capacidades de búsqueda y filtrado en la página de órdenes
• 🔧 Agregadas opciones al endpoint de CFDI para mayor flexibilidad

Correcciones

• 🐛 Corregida normalización del carácter Ñ en campos de texto
• 💰 Corregido redondeo de descuentos en facturas

Mejoras técnicas

• 📝 Agregado archivo de descripción para pull requests
• 🎨 Mejorados estilos del changelog
• 🗄️ Agregado Prisma al endpoint de órdenes
• 🌐 Mejorada configuración de CORS con logs de método y origen

Notas técnicas

Esta versión mejora la experiencia del usuario con mejor búsqueda de órdenes y corrige problemas de codificación de caracteres especiales en español.

Esta versión tiene algunas nuevas características y correcciones de errores.

Features

• Se añadieron funciones de búsqueda y filtrado a la página de pedidos para una mejor navegación.
• Se añadió la posibilidad de facturar ordenes no pagadas (se deben filtrar desde los nuevos filtros).
• Se solucionaron problemas de redondeo de descuentos y se mejoraron los estilos del registro de cambios.

Bugs

• Se añadió compatibilidad con CORS y puntos de acceso de opciones para una mejor compatibilidad con la API.

Esta versión tiene algunas correcciones de errores.

Errores

• Redondeo de porcentaje de descuentos con decimales de 0 a 2 decimales.
• Mejora de Meta Título y Meta Descripción en https://cfdi.express
• Corrección de estilos en Changelog

Esta versión tiene algunas nuevas características y correcciones de errores.

Características

• Lanzamiento de nuestra nueva Theme Extension para agregar un formulario de facturación en cualquier página de Shopify. Encuentrala en el editor de plantillas en las secciones de Apps.
• Mejores diseños de correos transaccionales.

Errores

• Fix de errores de CORS cuando se usa un explorador que envía OPTIONS en las llamadas http.

Este es un lanzamiento menor, se creó la página https://cfdi.express/changelog

Esta versión tiene algunas nuevas características y correcciones de errores.

Características

• Barra de búsqueda en productos a través de Shopify Search (SKU, Nombre, Nombre de Variante, etc...)

Errores

• Corrección acentos y mayúsculas en la Página de Incorporación para Razón Social.
• Corrección acentos y mayúsculas en la Página de Configuración para Razón Social.
• Corrección acentos y mayúsculas en la Página de Factura para Razón Social.