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
Se añadieron las siguientes rutas en src/Config/Routes.php para gestionar 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étodoshow). - 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, útil para búsquedas avanzadas.
- Ejemplo de uso: Filtrar notas de crédito 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 de crédito específica.
- Ejemplo de uso: Modificar los detalles de una nota de crédito existente.
- Eliminación de Pagos
DELETE pagos/delete/(:any)- Descripción: Permite eliminar pagos asociados a una nota de crédito.
- Ejemplo de uso: Cancelar un pago relacionado con una devolución.
- Timbrado de Nota de Crédito
GET timbrarNotaCredito/(:any)- Descripción: Timbra (certifica) una nota de crédito para cumplir con requisitos fiscales del SAT.
- Ejemplo de uso: Generar un comprobante fiscal válido para una nota de crédito.
- Generación de PDF
GET xml/generarPDFDesdeNotaCredito/(:any)- Descripción: Genera un PDF a partir de una nota de crédito utilizando datos XML.
- Ejemplo de uso: Crear un documento PDF para enviar al cliente.
GET xml/generarPDFNotaCredito/(:any)- Descripción: Genera un PDF directamente para una nota de crédito.
- Ejemplo de uso: Visualizar o descargar el PDF de una nota de crédito.
GET xml/generarPDFDesdeRemNotaCredito/(:any)- Descripción: Genera un PDF a partir de una remisión vinculada a una nota de crédito.
- Ejemplo de uso: Crear un PDF para una nota de crédito relacionada con una remisión.
- Creación de Nueva Nota de Crédito
GET newNotaCredito- Descripción: Muestra el formulario para crear una nueva nota de crédito.
- Ejemplo de uso: Iniciar el proceso de emisión de una nota de crédito.
- Guardado de Nota de Crédito
POST notasCredito/save- Descripción: Guarda una nueva nota de crédito o actualiza una existente.
- Ejemplo de uso: Confirmar los datos de una nota de crédito.
- Obtención de XML Enlazados
GET xmlenlace/getXMLEnlazadosNotaCredito/(:any)- Descripción: Obtiene los archivos XML vinculados a una nota de crédito, útil para auditorías fiscales.
- Ejemplo de uso: Descargar XML para cumplir con requisitos del SAT.
Otros Cambios
- Controladores, Modelos y Vistas:
- Se actualizaron o crearon nuevos controladores (por ejemplo,
NotasCreditoController,FacturaElectronicaController,XmlController) para manejar la lógica de las notas de crédito. - Los modelos se modificaron para incluir consultas relacionadas con la gestión de notas de crédito.
- Se añadieron o actualizaron vistas en
app/Views/para soportar los formularios y la generación de documentos PDF. - Base de Datos:
- Se incluyeron migraciones en
app/Database/Migrations/para agregar tablas o campos necesarios para almacenar datos de notas de crédito, como una posible tablacredit_noteso campos adicionales en tablas existentes. - Cumplimiento con CFDI 4.0:
- La funcionalidad se diseñó para cumplir con los requisitos de facturación electrónica del SAT en México, incluyendo el timbrado y la generación de XML.
Impacto
Esta actualización mejora significativamente boilerplateSells, permitiendo a los usuarios:
- Gestionar notas de crédito de manera integral (crear, editar, eliminar, filtrar).
- Generar documentos fiscales en PDF y XML, compatibles con CFDI 4.0.
- Cumplir con normativas fiscales mexicanas, ampliando la utilidad del sistema para negocios que manejan devoluciones o ajustes.
Imágenes
A continuación, se incluyen marcadores de posición para capturas de pantalla que ilustran las nuevas funcionalidades. Reemplaza las rutas con las imágenes reales generadas desde el sistema.
- Lista de Notas de Crédito
Descripción: Captura de pantalla de la interfaz que muestra el listado de notas de crédito.
- Formulario de Creación de Nota de Crédito
Descripción: Formulario para ingresar los detalles de una nueva nota de crédito.
- Formulario de Edición de Nota de Crédito
Descripción: Interfaz para modificar una nota de crédito existente. - 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 de CFDI 4.0. Esta adición mejora la capacidad del sistema para manejar transacciones complejas, como devoluciones y ajustes, y refuerza su valor para negocios que requieren cumplimiento fiscal en México. Los usuarios ahora pueden generar documentos fiscales válidos en formatos PDF y XML, con una interfaz optimizada para la gestión de notas de crédito.
Referencia al Commit: 84b72249259196bc228e99a95be3599fdacd3023
Full Changelog: https://github.com/julio101290/boilerplateSells/compare/v1.1.2…v1.1.3
Deja un comentario