lopezsoft/ubl21dian

Core for electronic invoicing pre-validation - DIAN UBL 2.1

Maintainers

Details

github.com/lopezsoft/ubl21dian

Homepage

Source

Issues

Installs: 113

Dependents: 1

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 4

Open Issues: 0

pkg:composer/lopezsoft/ubl21dian

3.6.1 2025-11-17 17:14 UTC

Requires

Requires (Dev)

MIT c03750473b7d276f068a424bc1147ce3743581c3

xmlweb servicecoreublsoap diandian

This package is auto-updated.

Last update: 2025-11-17 17:18:19 UTC

README

Core for electronic invoicing pre-validation - DIAN UBL 2.1.

Latest Release

Version 3.6.1 (2025-11-17)

Extensión del fix crítico: Esta versión extiende la corrección de formateo a 2 decimales a TODOS los archivos de firma XAdES.

Changed

  • Formateo completo a 2 decimales en todos los tipos de documentos:
    • SignAttachedDocument.php - CUFE/CUDE formateados correctamente
    • SignDocumentSupport.php - CUDS, CUDE y eventos formateados correctamente
    • SignPayroll.php - CUNE con valores de nómina formateados a 2 decimales

Added

  • Métodos auxiliares reutilizables en SignAttachedDocument.php
  • Métodos auxiliares completos en SignDocumentSupport.php (CUDS + eventos)
  • Método específico buildDocumentSupportHashString() para documentos soporte

Improved

  • Refactorización completa aplicada a todos los archivos XAdES
  • Consistencia total en formateo de 2 decimales en todos los tipos de documentos
  • Código más limpio y mantenible en toda la librería

Version 3.6.0 (2025-11-17)

⚠️ BREAKING FIX: Corrección del cálculo de CUFE/CUDE para cumplir con la especificación de la DIAN (2 decimales exactos en SignInvoice.php).

Changed

  • Formateo correcto de valores monetarios: Todos los valores monetarios y de impuestos ahora se formatean con exactamente 2 decimales en el cálculo de CUFE/CUDE
    • LineExtensionAmount y PayableAmount formateados a 2 decimales
    • Todos los impuestos (TaxAmount) formateados a 2 decimales
    • Previene errores cuando los XML contienen valores con hasta 6 decimales

Added

  • Métodos auxiliares privados para mejorar mantenibilidad y reutilización de código
  • Mejor arquitectura interna siguiendo principios SOLID y DRY

Improved

  • Refactorización completa de generación de CUFE/CUDE
  • Código más limpio, testeable y mantenible
  • Eliminación de duplicación de código

Nota: Si anteriormente usaba valores con más de 2 decimales, el CUFE/CUDE generado será diferente (ahora correcto según especificación DIAN).

Tags

  • 3.6.1: Extensión del fix - Formateo a 2 decimales en TODOS los archivos XAdES (AttachedDocument, DocumentSupport, Payroll).
  • 3.6.0: Fix crítico - Formateo correcto a 2 decimales para CUFE/CUDE. Refactorización de código.
  • 3.5.1: Ajustes en la nómina de ajustes de eliminación.
  • 3.5.0: Calcular y setear SoftwareSecurityCode, CUNE, URL de consulta CUNE en CodigoQR, función para obtener información del QR.
  • 3.4.0: GetAcquirer para obtener datos de entidad adquirente (Resolución 000202 de 2025).
  • 3.2.11: FIX - Formato dateTime en XML para SigningTime. Feature - Mejora descripción errores DIAN.
  • 3.2.6: Ajustes en SignInvoice para generar acuse de recibo.
  • 3.2.3: Ajustes en SignInvoice para obtener CUFE y QR.
  • 3.2.0: Control de errores en las solicitudes.
  • 3.1.9: Ajustes en la firma de eventos.
  • 3.1.5-3.1.8: Eventos para envío de facturas, notas crédito y débito.
  • 2.0: Notas débito y estándar de nombres de documentos.
  • 1.3: Licencia LGPL.
  • 1.2: Notas crédito y cálculo del CUDE.
  • 1.1.1: Solución error canonización.
  • 1.1: Templates para Web Service, require curl.
  • 1.0: Tests válidos con binary security token (SOAP) y firma XAdES (XML) con sha1, sha256, sha512.

Resources

Installation

composer require lopezsoft/ubl21dian

Requirements

  • PHP >= 8.0
  • Extensions: dom, xml, curl, libxml, openssl, xmlwriter, json
  • nesbot/carbon ^2.19 || ^3.8

Authors

License

MIT License - see LICENSE file for details

Support