Saltar a contenido

Facturación — Apéndices Extendidos en DTE

El módulo de Facturación incorpora soporte para más de 10 apéndices en el DTE, con configuración de cuáles se incluyen en el JSON enviado al Ministerio de Hacienda y cuáles se reservan solo para la representación gráfica. Se ha agregado un función para centralizar el acceso a estos datos desde los reportes gráficos.

📌 Introducción

Apéndices extendidos y objeto oApendicesVN

Se extiende el sistema de apéndices DTE para soportar hasta 100 apéndices por factura, manteniendo el límite de 10 apéndices enviados al Ministerio de Hacienda. Los apéndices excluidos del JSON siguen disponibles para la representación gráfica (RG) mediante el objeto oApendicesVN, accesible desde cualquier reporte gráfico de DTE.

🎯 Objetivo

Propósito

  • Permitir más de 10 apéndices en el DTE manteniendo el límite normativo de 10 para el JSON enviado a MH.
  • Proveer el objeto oApendicesVN como punto de acceso unificado a todos los apéndices desde los reportes gráficos.
  • Integrar automáticamente con el módulo ConAgua al generar facturas en masa.

🔍 Alcance

Funciones afectadas

  • Módulo: Facturación Electrónica → configuración de apéndices DTE
  • Objeto nuevo: oApendicesVN — disponible en todos los reportes gráficos (RG) de DTE
  • Integración: El módulo/plugin ConAgua incluye esta funcion automáticamente al crear facturas masivas
  • Límite MH: máximo 10 apéndices enviados al JSON del Ministerio de Hacienda (sin cambio normativo)
  • Scope del apéndice: por cliente específico o comodín "*" para todos los clientes

✨ Solución Implementada

Descripción de la solución

Se implementa el nuevo objeto oApendicesVN como interfaz de acceso a los demas apendices, para poder utilizarlo en las representaciones gráficas del DTE. La lógica de sincronización inserta nuevos apéndices y actualiza el valor de los existentes con el mismo NombreCamp.

🔧 Objeto oApendicesVN

Acceso a apéndices desde reportes gráficos

El objeto oApendicesVN contiene los 100 apéndices de la factura. Está disponible en todos los reportes gráficos (RG) de DTE.

Sintaxis de acceso:

oApendicesVN.item("NombreCamp").Valor

Ejemplos de uso (basados en datos de la tabla apendice_vn):

oApendicesVN.item("Lecturaactual").Valor    && devuelve -> "347"
oApendicesVN.item("Lecturaanterior").Valor  && devuelve -> "332"
oApendicesVN.item("Medidor").Valor          && devuelve -> "58585"
oApendicesVN.item("Lote").Valor             && devuelve -> "4"
oApendicesVN.item("Saldopendiente").Valor   && devuelve -> "0"

Objeto oApendicesVN — test de desarrollo con estructura y datos

📤 Límite de envío a MH

Control del JSON enviado al Ministerio de Hacienda

Aunque la tabla apendice_vn puede contener hasta 100 apéndices, el JSON enviado al Ministerio de Hacienda mantiene el límite normativo de 10 apéndices. El checkbox y el orden de los apéndices determinan cuáles 10 se incluyen en el JSON.

Los apéndices excluidos del JSON siguen disponibles para la representación gráfica mediante oApendicesVN.

⚙️ Configuración Requerida

Configuración de apéndices

Campo Descripción
NombreCamp Identificador único del apéndice — se usa como llave en oApendicesVN.item()
Valor Valor del apéndice para la factura específica
Scope Cliente específico o comodín "*" para todos los clientes

Integración con ConAgua

El módulo/plugin ConAgua de la nueva estructura de cp365, implementa esta funcion automáticamente, sin necesidad de configuración adicional, permitiendo utilizar y mostrar en las RG los datos de lectura, consumo de agua,lectura actua, lectura anterior,medidor,lote, saldo pendiente,etc.

🔄 Flujo Funcional

Flujo de apéndices extendidos

  1. En la configuración de apéndices DTE, agregar los apéndices necesarios.
  1. Al crear facturas desde el módulo ConAgua, el sistema llena apendice_vn automáticamente.
  2. Los campos de lectura (medidor, lote, lecturas, saldo) se mapean a NombreCamp correspondientes.
  3. El objeto oApendicesVN queda disponible para el reporte gráfico de cada factura.
  1. En el editor de reportes gráficos (RG), usar oApendicesVN.item("NombreCamp").Valor.
  2. Acceder a cualquier apéndice por su nombre, independientemente de si fue incluido en el JSON.
  3. El objeto está disponible para todos las RG del DTE

☑️ Validaciones y Pruebas Realizadas 🧪

Compilado validado

Las pruebas se realizaron sobre el compilado EXE_2026_03_03_04.exe.

Tipos de validaciones y pruebas Realizadas

Objeto oApendicesVN — estructura y acceso por NombreCamp

Se validó que el objeto oApendicesVN se construye correctamente en base a IDVENTA y que el acceso por clave NombreCamp devuelve el valor esperado.

  • Construcción del objeto oApendicesVN por IDVENTA: confirmada
  • Acceso por clave NombreCamp: funcional
  • Integración automática desde módulo ConAgua: confirmada
  • Test confirmado por QA: aprobado

Test de desarrollo — objeto oApendicesVN con datos

Límite de 10 apéndices en JSON enviado a MH

Se confirmó que aunque se configuren más de 10 apéndices, solo se envían 10 en el JSON al Ministerio de Hacienda — comportamiento correcto según la normativa.

  • JSON enviado a MH con máximo 10 apéndices: confirmado
  • Apéndices adicionales accesibles en representación gráfica: confirmado

Test EXE_2026_03_03_04 — límite 10 apéndices en JSON (1)

Test EXE_2026_03_03_04 — límite 10 apéndices en JSON (2)

Pruebas en reportes gráficos (RG) con oApendicesVN

Se realizaron pruebas del formato RG utilizando el objeto oApendicesVN para mostrar datos de apéndices extendidos en la representación gráfica del DTE.

  • Datos de apéndices accesibles desde el RG: confirmado
  • Formato RG con apéndices extendidos generado correctamente: confirmado

Prueba en formato RG con oApendicesVN (1)

Prueba en formato RG con oApendicesVN (2)