Notas de Lanzamiento para v1.1.3 - Implementación de Notas de Crédito

Notas de Lanzamiento para v1.1.3 - Implementación de Notas de Crédito

Introducción

La versión v1.1.3 de boilerplateSells introduce la funcionalidad de notas de crédito, una adición clave que permite gestionar ajustes de ventas, devoluciones y correcciones, cumpliendo con los estándares de facturación electrónica CFDI 4.0 requeridos en México. Esta actualización amplía las capacidades del sistema para generar documentos fiscales en formatos PDF y XML, mejorando la experiencia para usuarios que necesitan herramientas robustas para la gestión de ventas.

Cambios Realizados

Los cambios principales se centran en la adición de nuevas rutas en el archivo src/Config/Routes.php y actualizaciones en controladores, modelos, vistas y la base de datos para soportar la funcionalidad de notas de crédito. A continuación, se detallan los cambios específicos basados en el commit 84b72249259196bc228e99a95be3599fdacd3023:

Nuevas Rutas para Notas de Crédito

• Recurso Principal
  notascredito
  Métodos: GET, POST, PUT, DELETE
  Descripción: Maneja la lista, creación, edición y eliminación de notas de crédito. Incluye un filtro de permiso permission:listaNotaCredito-permission (excepto para el método show).
  Ejemplo de uso: Listar todas las notas de crédito o crear una nueva.
• Filtro de Notas de Crédito
  GET notasCredito/(:any)/(:any)/(:any)/(:any)/(:any)/(:any)
  Descripción: Permite filtrar notas de crédito con múltiples parámetros.
  Ejemplo: Buscar por fecha, cliente u otros criterios.
• Edición de Nota de Crédito
  GET editNotaCredito/(:any)
  Descripción: Muestra el formulario para editar una nota específica.
• Eliminación de Pagos
  DELETE pagos/delete/(:any)
  Descripción: Permite eliminar pagos asociados a una nota de crédito.
• Timbrado de Nota de Crédito
  GET timbrarNotaCredito/(:any)
  Descripción: Timbra (certifica) una nota de crédito para cumplir requisitos del SAT.
• Generación de PDF
  • GET xml/generarPDFDesdeNotaCredito/(:any) - Genera PDF desde datos XML.
  • GET xml/generarPDFNotaCredito/(:any) - Genera PDF directamente desde la nota.
  • GET xml/generarPDFDesdeRemNotaCredito/(:any) - PDF desde remisión vinculada.
• Creación de Nueva Nota de Crédito
  GET newNotaCredito
  Descripción: Formulario para emitir una nueva nota.
• Guardado de Nota de Crédito
  POST notasCredito/save
  Descripción: Guarda o actualiza una nota existente.
• Obtención de XML Enlazados
  GET xmlenlace/getXMLEnlazadosNotaCredito/(:any)
  Descripción: Obtiene archivos XML vinculados, útil para auditorías.

Otros Cambios

• Controladores, Modelos y Vistas: Se crearon o actualizaron archivos como NotasCreditoController, FacturaElectronicaController y XmlController. Se adaptaron modelos y vistas para soportar esta nueva funcionalidad.
• Base de Datos: Nuevas migraciones para la tabla credit_notes u otros campos relacionados.
• Cumplimiento con CFDI 4.0: Incluye timbrado, generación de XML y validaciones necesarias.

Impacto

• Gestionar notas de crédito de forma integral (crear, editar, eliminar, filtrar).
• Generar documentos fiscales PDF/XML compatibles con CFDI 4.0.
• Cumplir normativas fiscales del SAT, útil para devoluciones o ajustes.

Imágenes

A continuación, se incluyen capturas de pantalla que ilustran las nuevas funcionalidades:

1. Lista de Notas de Crédito
   
   Descripción: Captura de pantalla de la interfaz que muestra el listado de notas de crédito.
2. Formulario de Creación de Nota de Crédito
   
   Descripción: Formulario para ingresar los detalles de una nueva nota de crédito.
3. Formulario de Edición de Nota de Crédito
   
   Descripción: Interfaz para modificar una nota de crédito existente.
4. PDF Generado de Nota de Crédito
   
   Descripción: Ejemplo de un documento PDF generado para una nota de crédito.

Conclusión

La versión v1.1.3 de boilerplateSells introduce una funcionalidad robusta para la gestión de notas de crédito, alineada con los requisitos del CFDI 4.0. Esta adición mejora la capacidad del sistema para manejar transacciones como devoluciones y ajustes, reforzando su valor para negocios que requieren cumplimiento fiscal en México.

Referencia al Commit: 84b72249259196bc228e99a95be3599fdacd3023

Full Changelog: https://github.com/julio101290/boilerplateSells/compare/v1.1.2...v1.1.3