Changelog

Novedades en v1.16.0

Esta versión te permite saber desde dónde se genera cada factura en tu tienda, ayudándote a entender mejor cómo tus clientes utilizan el sistema de facturación.

✨ Nuevas Características

Identificación de Canal de Facturación

Ahora puedes ver exactamente desde dónde se solicitó cada factura:

• 📱 Panel de Administración: Cuando tú o tu equipo generan facturas manualmente desde el admin de Shopify
• 🛒 Punto de Venta: Facturas creadas durante el proceso de compra en línea
• 🏪 Tienda en Línea: Cuando tus clientes solicitan sus propias facturas usando el formulario

Mejoras en Configuración

• Se agregó soporte especial de precios para tiendas asociadas
• Nuevas herramientas internas que hacen el sistema más rápido y confiable

💡 Beneficios para tu Negocio

Conoce las Preferencias de tus Clientes

• Descubre si tus clientes prefieren facturar por sí mismos o necesitan asistencia
• Identifica oportunidades para mejorar la experiencia de facturación
• Optimiza los canales más utilizados

Mejor Atención al Cliente

• Al revisar una factura, sabrás inmediatamente cómo fue generada
• Resuelve dudas más rápido con información completa
• Brinda un servicio más personalizado

Análisis y Mejoras

• Datos reales sobre cómo se usa el sistema de facturación
• Identifica si necesitas hacer más visible el formulario de auto-facturación
• Toma decisiones informadas para mejorar tu proceso

🔧 Detalles Técnicos

Canales de Facturación

Canal	Descripción	Cuándo Ocurre
Admin	Panel de administración	Cuando generas facturas manualmente
POS	Punto de venta	Durante el proceso de compra (post-purchase)
Theme	Formulario en tienda	Cuando el cliente solicita su factura

Compatibilidad Total

• ✅ Funciona con todas tus facturas existentes
• ✅ No necesitas hacer ningún cambio
• ✅ No afecta la experiencia de tus clientes
• ✅ La información se empieza a registrar automáticamente

📊 Próximos Pasos

En futuras versiones, usaremos esta información para:

• Crear reportes visuales de uso por canal
• Generar estadísticas de preferencias de clientes
• Sugerir mejoras automáticas basadas en patrones de uso

🔄 Actualización

Esta actualización es automática y no requiere ninguna acción de tu parte. Todo seguirá funcionando exactamente igual, pero ahora con más información útil para ti.

---

Versión anterior: 1.15.0
Versión actual: 1.16.0
Tipo de actualización: Nuevas funcionalidades (Minor)

---

Para información técnica completa, consulta: releases/release-1.16.0.md

Overview

This minor release enhances the Shopify Flow integration by adding comprehensive fiscal data fields to the CFDI created trigger, enabling more sophisticated automation workflows. Additionally, the invoice generation system now supports dynamic tax rates from Shopify orders instead of hardcoded values.

New Features

Enhanced Shopify Flow Trigger Data

• Expanded CFDI Created Trigger: The cfdi-created Flow trigger now includes complete fiscal and invoice information
  • Razón Social: Customer's business name for automated communications
  • Régimen Fiscal: Tax regime code for compliance workflows
  • Código Postal: Postal code for geographic-based automations
  • Método de Pago: Payment method (cash, transfer, card, etc.)
  • Tipo de Pago: Payment type (PUE - paid in one installment, PPD - deferred payment)
  • Uso de CFDI: CFDI usage code for tax categorization
  • Email: Customer email for automated notifications
  • UUID: SAT unique identifier for invoice verification and tracking

Dynamic Tax Rate Support

• Intelligent Tax Calculation: System now retrieves actual tax rates from Shopify orders
  • Queries Shopify's taxLines field to get applied tax rates
  • Automatically adapts to different tax percentages configured in the store
  • Falls back to 16% IVA (Mexico's standard rate) if no tax information is available
  • Applies dynamic rates to product subtotals, shipping, and discount calculations

UUID Integration

• SAT UUID Extraction: Captures and stores the fiscal folio (UUID) from Facturama
  • Extracted from facturamaData.Complement.TaxStamp.Uuid
  • Stored in PocketBase for record keeping
  • Included in Shopify Flow trigger payload
  • Available for invoice verification and tracking workflows

Improvements

API Enhancements

• Invoice Data API (/api/invoice-data):
  • Updated GraphQL query to fetch tax lines from orders
  • Dynamic tax rate extraction with fallback mechanism
  • Improved calculation logic using variable tax rates
  • Better logging for tax rate diagnostics

Code Quality

• TypeScript Fixes: Added @ts-ignore comments for JSZip Blob compatibility
  • Resolves type conflicts with JSZip library
  • Maintains type safety while working with binary data
  • Improves build stability

Invoice Generation

• CFDI API (/api/cfdi):
  • Enhanced Shopify Flow payload with comprehensive fiscal data
  • UUID capture and storage for compliance tracking
  • Improved data completeness for automation workflows
  • Better integration with third-party systems

Technical Details

Modified Files

• app/routes/api.cfdi.ts

  • Added UUID extraction from Facturama response
  • Enhanced Flow trigger payload with 8 new fiscal data fields
  • Added TypeScript ignore comments for JSZip operations
  • Improved PocketBase record creation with UUID

• app/routes/api.invoice-data.ts

  • Added taxLines to order GraphQL query
  • Implemented dynamic tax rate extraction
  • Updated product calculation logic for variable rates
  • Enhanced shipping cost calculations with dynamic taxes
  • Modified discount calculations to use dynamic multipliers
  • Applied dynamic rates to invoice item generation

• extensions/cfdi-created/shopify.extension.toml

  • Added 8 new settings fields for comprehensive fiscal data
  • Marked UUID and CSF as optional fields
  • Enhanced automation capabilities with detailed invoice information

New Flow Trigger Fields

The CFDI created Flow trigger now provides these additional fields:

Field	Type	Description	Optional
razonsocial	Text	Customer's registered business name	No
regimenfiscal	Text	Tax regime code (e.g., 601, 612)	No
codigopostal	Text	Customer's fiscal postal code	No
metodopago	Text	Payment method code (e.g., 01-Cash, 04-Card)	No
tipopago	Text	Payment type (PUE or PPD)	No
usocfdi	Text	CFDI usage code (e.g., G03-General expenses)	No
email	Text	Customer email address	No
UUID	Text	SAT fiscal folio (unique identifier)	Yes

Use Cases

Shopify Flow Automation Examples

With the enhanced trigger data, merchants can now create sophisticated automations:

1. Email Notifications by Tax Regime:

   • Send customized email templates based on customer's fiscal regime
   • Include specific tax information relevant to their regime type

2. Geographic-Based Processing:

   • Route invoices to regional processors based on postal code
   • Apply location-specific handling or approval workflows

3. Payment Method Routing:

   • Different notification channels for cash vs. card payments
   • Automated reconciliation based on payment method

4. UUID Tracking:

   • Automatically verify invoices with SAT database
   • Send UUID confirmation emails to customers
   • Integrate with accounting systems using SAT folio

5. CFDI Usage Categorization:

   • Tag orders in external systems based on CFDI usage
   • Generate usage reports for business analytics
   • Automated tax category assignment

Multi-Tax Rate Scenarios

The dynamic tax rate feature enables:

1. Multi-Region Support:

   • Automatically handle different tax rates for border regions
   • Support for tax-free zones (0% rate)
   • Proper calculations for special economic zones

2. Product-Specific Rates:

   • Apply different tax rates for exempt products
   • Support for reduced tax rate products
   • Handle mixed carts with varying tax rates

3. Future-Proof:

   • Adapts automatically to tax rate changes
   • No code updates needed when rates change in Shopify
   • Consistent calculations across all invoice touchpoints

What's Changed

Added

• 8 new fields to CFDI created Shopify Flow trigger
• Dynamic tax rate extraction from Shopify orders
• UUID capture and storage from Facturama
• Comprehensive fiscal data in Flow payload
• Tax lines query in order GraphQL

Modified

• Invoice data API to support dynamic tax rates
• CFDI API to include extended fiscal data
• Flow trigger configuration with detailed fields
• Tax calculation logic across all invoice components

Fixed

• TypeScript type conflicts with JSZip library
• Hardcoded 16% tax rate limitation
• Missing fiscal data in Flow triggers

Compatibility

This release maintains full backward compatibility:

• Existing Flow automations continue to function
• Tax calculations work with or without tax lines data
• All customer-facing interfaces remain unchanged
• Database schema unchanged (no migrations required)
• API contracts preserved and extended

Version Information

• Previous Version: 1.13.0
• Current Version: 1.14.0
• Type: Minor (New Features & Enhancements)
• Release Date: October 2025

Benefits

For Merchants

• Better Automation: Create more sophisticated Flow workflows
• Accurate Tax Rates: Invoices reflect actual Shopify tax configuration
• Complete Data: All fiscal information available for integrations
• UUID Tracking: Enhanced compliance and verification capabilities

For Developers

• Flexible Tax Handling: No more hardcoded tax rates
• Rich Flow Data: Build powerful custom automations
• Better Integration: More data points for third-party systems
• Type Safety: Improved TypeScript compatibility

For Compliance

• SAT UUID: Proper fiscal folio tracking
• Complete Records: All required fiscal data captured
• Dynamic Rates: Always reflects correct tax percentages
• Audit Trail: Comprehensive data for tax compliance

Overview

This minor release introduces a centralized invoice data generation API, significantly simplifying invoice creation across multiple touchpoints in the application. The update also includes enhanced environment configuration with vaulted secrets for improved security.

New Features

Centralized Invoice Data API

• New Endpoint: /api/invoice-data - Unified invoice data generation service
  • Consolidates invoice calculation logic from multiple extensions
  • Accepts fiscal data parameters (RFC, razón social, régimen fiscal, código postal, método de pago, uso CFDI)
  • Returns standardized invoice data structure compatible with Facturama API
  • Includes comprehensive validation for required fiscal data
  • Supports CORS for cross-origin requests from extensions

Invoice Generation Capabilities

• Order Data Integration: Automatic order data fetching via Shopify GraphQL API

  • Retrieves product information, quantities, and pricing
  • Fetches metafield data (SAT product codes and unit codes)
  • Calculates discounts and applies them proportionally to line items
  • Includes shipping costs with proper tax calculation

• Smart Invoice Calculations:

  • Proportional discount distribution across all items
  • Automatic tax calculations (16% IVA)
  • Subtotal and total calculations per item
  • Support for cart-level discounts
  • Shipping line integration with tax compliance

• CFDI 4.0 Compliance:

  • GlobalInformation section for general public invoices (RFC: XAXX010101000)
  • Dynamic periodicity (monthly) with automatic month/year calculation
  • Conditional GlobalInformation based on RFC type
  • Proper fiscal regime and tax zone code handling

Environment Configuration Enhancements

• Vaulted Environment Files: Secure credential management
  • .env-cfdi-express-development-valut - Development environment secrets
  • .env-sentry-build-plugin-valut - Sentry build plugin configuration
  • .env-valut - Main vaulted environment configuration
  • Enhanced security for sensitive API credentials and tokens

Code Improvements

Extension Refactoring

• Simplified Post-Purchase Modal (cfdi-orden-de-compra):

  • Removed 149 lines of invoice calculation logic
  • Now delegates to centralized /api/invoice-data endpoint
  • Cleaner, more maintainable codebase
  • Consistent invoice generation across touchpoints

• Streamlined Thank You Page (thank-you-order-status-cfdi):

  • Removed 147 lines of duplicate invoice logic
  • Uses centralized API for invoice data generation
  • Improved error handling and user feedback
  • Better separation of concerns

• Enhanced Invoice Request Form (formulario-de-facturación):

  • Reduced complexity by 110 lines
  • Delegates invoice calculations to API
  • Improved form validation
  • Better user experience with consistent data handling

Admin Interface Updates

• Invoice Form Simplification (app.factura.$factura.tsx):
  • Removed 179 lines of redundant logic
  • Cleaner component structure
  • Better error handling
  • Improved maintainability

Database Changes

New Migration

• Flow Configuration (20251003170922_flow):
  • Database schema updates for invoice flow management
  • Enhanced data model for invoice generation workflows
  • Migration lock file updated to PostgreSQL

Technical Highlights

Architecture Benefits

• Code Deduplication: Eliminated ~685 lines of duplicate invoice calculation logic
• Single Source of Truth: All invoice generation now uses one centralized endpoint
• Improved Maintainability: Changes to invoice logic only need to be made in one place
• Better Testing: Centralized logic is easier to test and validate
• Enhanced Security: Vaulted environment files protect sensitive credentials

API Features

• Comprehensive Validation: All required fiscal data validated before processing
• Error Handling: Clear error messages for missing or invalid data
• CORS Support: Proper cross-origin headers for extension integration
• Session Management: Secure Shopify session handling
• GraphQL Integration: Modern Shopify API usage for order data

What's Changed

Added

• New /api/invoice-data endpoint for centralized invoice generation
• Vaulted environment configuration files for enhanced security
• Database migration for invoice flow management
• Comprehensive fiscal data validation
• CORS support for cross-origin API requests

Modified

• Refactored post-purchase modal to use centralized API
• Updated thank you page to delegate invoice calculations
• Simplified invoice request form logic
• Streamlined admin invoice form component
• Updated extension build artifacts with new centralized approach

Removed

• Duplicate invoice calculation logic from extensions (685+ lines)
• Redundant GraphQL queries across multiple components
• Inconsistent discount calculation implementations
• Scattered tax calculation logic

Migration Notes

For Developers

• Extensions now require access to the /api/invoice-data endpoint
• Ensure proper CORS configuration if deploying to different domains
• Vaulted environment files should be properly configured for deployments
• Database migration will run automatically on deployment

For Merchants

• No user-facing changes - invoice generation works exactly the same
• Enhanced reliability and consistency in invoice calculations
• Better error messaging for invalid fiscal data
• Improved performance due to optimized calculations

Compatibility

This release maintains full backward compatibility:

• All existing invoice generation workflows continue to work
• Customer-facing interfaces remain unchanged
• Database schema changes are additive
• API contracts are preserved
• Existing merchant configurations are unaffected

Version Information

• Previous Version: 1.12.0
• Current Version: 1.13.0
• Type: Minor (New Features & Architectural Improvements)
• Release Date: October 2025

Technical Details

New Files

• app/routes/api.invoice-data.ts (297 lines) - Centralized invoice data generation API

Modified Files

• app/routes/app.factura.$factura.tsx - Simplified by 179 lines
• extensions/cfdi-orden-de-compra/src/PostPurchaseActionModal.tsx - Reduced by 149 lines
• extensions/formulario-de-facturación/assets/facturas.js - Streamlined by 110 lines
• extensions/thank-you-order-status-cfdi/src/Checkout.tsx - Simplified by 147 lines
• Extension build artifacts updated to use centralized API

Environment Files

• .env-cfdi-express-development-valut - Development environment secrets
• .env-sentry-build-plugin-valut - Sentry configuration
• .env-valut - Main vaulted configuration

Database Migration

• prisma/migrations/20251003170922_flow/migration.sql - Flow configuration schema

What's Next

With version 1.13.0, CFDI Express now provides:

1. Centralized, maintainable invoice generation architecture
2. Enhanced security with vaulted environment configuration
3. Consistent invoice calculations across all touchpoints
4. Improved error handling and validation
5. Better code maintainability and testability

This release sets the foundation for future enhancements while maintaining the reliable Mexican electronic invoicing functionality that merchants depend on.

🚀 New Features

Public General Billing Support

• Quick Public Invoice: Added "Facturar al Publico en General" (Invoice to General Public) functionality
  • One-click button to auto-populate fields for general public invoicing
  • Uses RFC: XAXX010101000 (General Public) with appropriate tax regime
  • Pre-fills with merchant's postal code and shop contact email
  • Sets proper payment method (PUE) and CFDI usage (S01)

Enhanced Form Validation

• Required Field Validation: Comprehensive client-side validation for all mandatory invoice fields
  • RFC, Razón Social, Código Postal, Régimen Fiscal, Email, Método de Pago, Tipo de Pago, Uso CFDI
  • Clear error messaging when required fields are missing
  • Prevents form submission with incomplete data

Invoice Compliance Improvements

• Global Information Support: Added GlobalInformation section for CFDI 4.0 compliance
  • Automatic periodicity setting (04 - Monthly)
  • Dynamic month and year calculation based on current date
  • Proper formatting for single-digit months (01, 02, etc.)
  • Conditionally excluded for general public invoices (XAXX010101000)

Shop Integration Enhancements

• Contact Email Integration: Automatic fetching of shop contact email via Shopify GraphQL API
  • Used as default email for public general billing
  • Improves user experience by reducing manual input
  • Error handling for GraphQL fetch operations

🔧 Technical Improvements

Form State Management

• Enhanced form state with proper error message handling
• Improved user feedback during form submission
• Better loading state management

Code Quality

• Added proper TypeScript type handling for new features
• Enhanced error handling for Shopify GraphQL operations
• Improved conditional logic for invoice data structure

User Interface

• Added secondary action button for public billing
• Improved error message display with proper styling
• Better form validation feedback

🎯 What's Improved

This minor release focuses on streamlining the invoice generation process and improving compliance:

User Experience Benefits

• Faster invoice creation for general public sales
• Reduced form errors through comprehensive validation
• Clearer error messaging and user guidance
• One-click setup for common invoice scenarios

Compliance Benefits

• Enhanced CFDI 4.0 compliance with GlobalInformation section
• Proper handling of different invoice types (individual vs. general public)
• Accurate periodicity and date formatting
• Improved tax regulation adherence

Business Benefits

• Simplified workflow for high-volume public sales
• Reduced manual data entry errors
• Better customer experience with faster invoice processing
• Enhanced compliance with Mexican tax regulations

🔄 Compatibility

This release maintains full backward compatibility:

• All existing invoice generation workflows remain unchanged
• Customer-facing interfaces preserve existing functionality
• Database schema remains compatible
• API endpoints maintain the same behavior
• Existing merchant configurations are unaffected

📦 Version Information

• Previous Version: 1.11.1
• Current Version: 1.12.0
• Type: Minor (New Features & Enhancements)
• Release Date: September 2025

🚀 What's Next

With version 1.12.0, CFDI Express now provides:

1. Streamlined public general billing process
2. Enhanced form validation and error handling
3. Improved CFDI 4.0 compliance features
4. Better integration with Shopify shop data
5. More robust invoice generation workflow

📝 Technical Details

Modified Files

• app/routes/app.factura.$factura.tsx - Enhanced invoice form with validation, public billing, and shop integration

New Features Implementation

• Shop contact email GraphQL query and integration
• Public general billing auto-fill functionality
• Comprehensive form validation with error messaging
• GlobalInformation section for CFDI compliance
• Conditional invoice data structure based on RFC type

Enhanced Functionality

• Improved error handling for missing required fields
• Better user feedback during form interactions
• Dynamic date and month formatting for tax compliance
• Smart form pre-population for common use cases

This minor release strengthens CFDI Express's invoice generation capabilities while maintaining the reliable Mexican electronic invoicing functionality that merchants depend on for their business operations.

🔍 SEO Improvements

Search Engine Optimization

• Added XML sitemap: Implemented /sitemap.xml with all public documentation and marketing pages
• Added robots.txt: Created proper robots.txt file to guide search engine crawlers
  • Allows access to all public routes
  • Blocks private /app/ and /api/ routes
  • References sitemap for better indexing

📚 Documentation Updates

Technical Documentation

• Enhanced CLAUDE.md: Updated project documentation with:
  • Added CSS Modules to tech stack description
  • Clarified routing structure between private (/app/*, /api/*) and public routes
  • Improved technical accuracy and developer guidance

Visual Updates

• Updated favicon: Refreshed favicon.ico for better brand consistency

🎯 What's Improved

This patch release focuses on improving search engine visibility and technical documentation:

SEO Benefits

• Better search engine discovery through structured sitemap
• Proper crawler guidance via robots.txt
• Improved indexing of documentation pages
• Enhanced organic search potential for public content

Developer Experience

• Clearer project structure documentation
• Updated tech stack information
• Better understanding of routing architecture

🔄 Compatibility

This release maintains full backward compatibility:

• All existing CFDI generation features remain unchanged
• Customer-facing interfaces maintain existing functionality
• API endpoints preserve the same behavior
• Database schema remains compatible
• Existing merchant configurations are unaffected

📦 Version Information

• Previous Version: 1.11.0
• Current Version: 1.11.1
• Type: Patch (SEO & Documentation)
• Release Date: September 2025

🚀 What's Next

With version 1.11.1, CFDI Express now provides:

1. Better search engine visibility for public documentation
2. Improved technical documentation for developers
3. Enhanced SEO foundation for future marketing efforts
4. Clearer project structure guidance

📝 Technical Details

New Files Added

• app/routes/sitemap[.]xml.tsx - Dynamic XML sitemap generation
• public/robots.txt - Search engine crawler guidance

Modified Files

• CLAUDE.md - Enhanced project documentation
• public/favicon.ico - Updated brand favicon

SEO Configuration

• Sitemap includes all public documentation pages with appropriate priorities
• Robots.txt properly restricts access to admin and API routes
• Dynamic domain detection for proper URL generation

This patch release strengthens CFDI Express's online presence and developer documentation while maintaining the robust Mexican electronic invoicing functionality that merchants rely on.

🚀 New Features

Documentation System

• Added comprehensive documentation system: Implemented a new docs section with dynamic routing and markdown support
• AI-powered documentation: Integrated LLM-powered documentation endpoint for enhanced user support
• Dynamic document routing: Created flexible routing system for documentation pages (/docs/*)
• Markdown processing: Added markdown support with proper TypeScript types for documentation content

UI/UX Improvements

• New Header component: Created reusable Header component for consistent navigation across the app
• Refactored landing page: Improved main page structure with better component organization and modularity
• Enhanced styling: Added dedicated documentation styles and improved overall visual consistency
• Better layout structure: Reorganized page layouts for improved user experience

🔧 Technical Changes

Architecture Improvements

• Component modularity: Extracted landing page content into separate components for better maintainability
• Route organization: Implemented structured routing for documentation system
• CSS improvements: Enhanced styling system with better color scheme and layout improvements

Development Dependencies

• Markdown support: Added @types/marked dependency for TypeScript markdown processing
• Type safety: Improved TypeScript coverage for new documentation features

📋 What's Improved

This minor release introduces a comprehensive documentation system and significant UI improvements:

Enhanced User Experience

• Better organized landing page with improved visual hierarchy
• Dedicated documentation section for improved user guidance
• Consistent navigation through the new Header component
• Enhanced visual styling with improved color schemes

Developer Experience

• Modular component architecture for easier maintenance
• Type-safe markdown processing
• Structured documentation routing system
• AI-powered documentation support

🔄 Compatibility

This release maintains full backward compatibility:

• All existing CFDI generation features remain unchanged
• Customer-facing interfaces maintain existing functionality
• API endpoints preserve the same behavior
• Database schema remains compatible
• Existing merchant configurations are unaffected

📦 Version Information

• Previous Version: 1.10.0
• Current Version: 1.11.0
• Type: Minor (Feature Addition)
• Release Date: September 2025

🚀 What's Next

With version 1.11.0, CFDI Express now provides:

1. Enhanced user documentation and guidance
2. Improved visual experience with better UI components
3. Foundation for future documentation expansions
4. AI-powered support capabilities

📝 Technical Details

New Files Added

• app/components/Header.tsx - Reusable header component
• app/routes/docs.tsx - Main documentation layout
• app/routes/docs._index.tsx - Documentation index page
• app/routes/docs.$documento.tsx - Dynamic document pages
• app/routes/docs.$documento.llms[.]txt.tsx - AI-powered documentation endpoint
• app/routes/_index/route._index.tsx - Extracted landing page component
• app/styles/docs.css - Documentation-specific styles

Modified Files

• app/routes/_index/route.tsx - Refactored to use new component structure
• app/routes/_index/root.css - Enhanced with improved color scheme
• package.json - Added markdown processing dependencies

This release strengthens CFDI Express's foundation with better documentation and user experience while maintaining the robust Mexican electronic invoicing functionality that merchants rely on.

🚀 New Features

Shopify Developer Dashboard Migration

• Migrated to new Shopify Developer Dashboard: Updated app development workflow to use the latest Shopify developer tools and dashboard interface
• Enhanced development experience: Streamlined development and deployment processes with improved Shopify CLI integration
• Improved app configuration: Better management of app settings and configurations through the new dashboard

🔧 Technical Changes

Development Infrastructure Updates

• Build system improvements: Updated build configurations to work with the new Shopify development environment
• Extension optimizations: Enhanced extension build processes for better performance and compatibility
• Development dependencies: Updated development tools and dependencies to align with latest Shopify standards

Code Quality Improvements

• Extension builds: Regenerated extension builds with optimized bundling
• Source map updates: Updated source maps for better debugging experience
• TypeScript configuration: Enhanced TypeScript setup for improved development workflow

📋 What's Improved

This minor release focuses on modernizing the development infrastructure and ensuring compatibility with the latest Shopify development tools. The migration to the new Shopify Developer Dashboard provides:

Enhanced Developer Experience

• Faster development cycles with improved tooling
• Better debugging capabilities with updated source maps
• Streamlined deployment process

Future-Proofing

• Alignment with Shopify's latest development standards
• Better support for upcoming Shopify features
• Improved maintainability of the codebase

🔄 Compatibility

This release maintains full backward compatibility with existing functionality:

• All CFDI generation features remain unchanged
• Customer-facing interfaces are unaffected
• API endpoints maintain the same behavior
• Database schema remains compatible

⚠️ Important Notes

• This update primarily affects the development workflow
• No changes to user-facing functionality
• Merchants will not notice any differences in app behavior
• All existing configurations and data remain intact

📦 Version Information

• Previous Version: 1.9.1
• Current Version: 1.10.0
• Type: Minor (Infrastructure Update)
• Release Date: September 2025

🚀 Next Steps

After updating to version 1.10.0:

1. The app will continue to function exactly as before
2. Development team benefits from improved tooling
3. Foundation is set for future enhancements
4. No action required from merchants or end users

📝 Technical Details

Files Modified

• Extension build configurations
• Development environment settings
• Source map generations
• Build output optimizations

This release ensures CFDI Express stays aligned with Shopify's evolving platform while maintaining the reliability and functionality that merchants depend on for their Mexican electronic invoicing needs.

🐛 Bug Fixes

Certificate Upload Fix

• Fixed merchant lookup in CSD certificate management: Corrected database query in /api/csd endpoint to properly lookup merchants by shop identifier instead of RFC
• Improved merchant validation: Enhanced the merchant validation logic to ensure certificates are associated with the correct shop

🔧 Technical Changes

Database Query Optimization

• File: app/routes/api.csd.ts:98
• Change: Modified TaxableMerchant lookup query from rfc: data.Rfc to shop: body.get("shop") as string
• Impact: Ensures proper merchant identification during certificate upload and validation process

Documentation Updates

• Updated internal command documentation for release process

📋 What This Fixes

This patch release addresses a critical issue where the CSD (Certificado de Sello Digital) certificate management was not properly associating certificates with the correct merchant shop. The previous implementation was looking up merchants by RFC from the certificate data, which could lead to incorrect associations or failed lookups.

Before (v1.9.0)

const checkDb = await prisma.taxableMerchant.findFirst({
  where: {
    rfc: data.Rfc, // Looking up by RFC from certificate
  },
});

After (v1.9.1)

const checkDb = await prisma.taxableMerchant.findFirst({
  where: {
    shop: body.get("shop") as string // Looking up by shop identifier
  },
});

🔄 Compatibility

This release maintains full backward compatibility. Existing functionality remains unchanged, and this fix only improves the reliability of the certificate management system.

⚠️ Important Notes

• This fix ensures that CSD certificates are properly associated with the correct Shopify shop
• Merchants who experienced issues with certificate uploads should retry after this update
• No data migration is required for this update

📦 Version Information

• Previous Version: 1.9.0
• Current Version: 1.9.1
• Type: Patch (Bug Fix)
• Release Date: September 2025

🚀 Next Steps

After updating to version 1.9.1:

1. Certificate uploads should work more reliably
2. Existing certificate associations remain unchanged
3. No additional configuration is required

🎉 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.