Estado actual del catastro

Cargar archivo de vinculación

Archivo de texto plano (.txt) separado por | con las columnas del catastro, en este orden:
NIU | MUNICIPIO | FECHA_INGRESO | TIPO_POBLACION | CLASE SERVICIO | IND_PREDIODESOCUPADO | ESTRATO | DIRECCION | BARRIO | TIPO_VINCULACION | FECHA_PRESTACION
Los NIU nuevos se insertan y los existentes se actualizan. El encabezado es opcional.
FECHA_PRESTACION (la columna Fecha Inicio de Operación de los archivos de la operación) es la fecha en que empieza a prestarse el servicio: es la que determina el prorrateo por días del primer mes. Es opcional — los archivos de 10 columnas siguen cargando igual, y si se deja vacía en un NIU que ya existía, se conserva la fecha que ya tenía (no se borra).

Periodo

El reporte cubre del día 1 al último día del mes (28, 29, 30 o 31 según el mes) y trae una sección por módulo — y las novedades del catastro, una sección por tipo (vinculación, inactivación, edición…), cada una con su total. Sale de dos lados: la bitácora, donde cada módulo registra lo que hace, y las tablas donde quedaron los datos — cada sección dice de dónde salió, para no confundir “no pasó nada” con “no se estaba registrando”.

Resumen del periodo

1. Cargar el archivo

Archivo de texto plano (.txt) separado por |, una línea por suscriptor:
NIU | OBSERVACION
El NIU es obligatorio. La observación es opcional por fila: si la traes en el archivo, manda esa; si no, se usa la que escribas abajo. Una de las dos tiene que existir — el cambio de estado queda auditado en catastro_novedades y una baja masiva no puede quedar peor registrada que una manual. El encabezado es opcional.
La fecha de retiro es una sola para todo el lote: es la fecha de corte del servicio, y es la que usa la liquidación para prorratear el último mes. Descargar plantilla de ejemplo

2. Revisar antes de aplicar

Al aplicar, el archivo se vuelve a leer y el estado se vuelve a consultar: si alguien cambió algo desde la hoja de vida entre los dos pasos, el informe final dice lo que de verdad pasó.

Resultado

1. Qué se reliquida

Recalcula uno o varios periodos ya facturados con el dato corregido y las tarifas de cada periodo, y registra la diferencia. La liquidación original no se modifica: se conserva para poder demostrar qué se le facturó al usuario ese mes. Si la diferencia es negativa hay crédito a favor del usuario; si es positiva, cargo.

Datos corregidos (deja vacío lo que no cambia)

2. Revisar antes de registrar

Registro

Reliquidaciones registradas

1. Cargar tarifas del municipio

Sube los archivos CSV (separados por ;) del municipio y periodo. Por municipio son 6 archivos: URBANA/RURAL × NORMAL/DESOCUPADO/SIN_PUERTA_A_PUERTA. La zona y el tipo se detectan por el nombre del archivo. Se reemplaza lo cargado antes para ese municipio+periodo.

Eliminar tarifas cargadas

Borra las tarifas del municipio y periodo seleccionados arriba. Sirve cuando un cargue quedó incompleto o con archivos equivocados — aunque para corregirlo normalmente basta con volver a cargar los 6 CSV, que reemplazan lo anterior sin necesidad de borrar. La observación es obligatoria: queda registrada con tu usuario y la fecha, y es lo que después permite saber por qué faltan esas tarifas. La liquidación de ese periodo NO se borra — si existe, se te avisa antes de confirmar.

¿Y liquidar el periodo?

Liquidar (aplicar las tarifas al catastro) ya no se hace desde acá: tiene su propia pantalla en el módulo Liquidación, con su propio municipio, año y mes. Este módulo es solo el cargue de las tarifas.

Se separaron porque para liquidar había que pasar por esta pantalla y el periodo salía de los selectores de arriba — era fácil liquidar el mes que quedó seleccionado en vez del que se quería.

Estado de tarifas y liquidaciones

La columna Archivos dice cuántas de las 6 combinaciones zona/tipo llegaron. Si dice menos de 6, ese cargue está incompleto y al liquidar van a aparecer "suscriptores sin tarifa". Ver detalle nombra el archivo que falta.

Cargar un reporte del periodo

Sube el .xlsx tal como lo manda EDEQ. No hay que decir qué reporte es: el archivo se identifica solo — facturación emitida, recaudo, cartera o recuperación de cartera — y de ahí salen también el municipio y el periodo. Se reconocen los tres formatos que EDEQ ha usado (marzo–abril con conceptos por nombre, mayo sin municipio, junio–julio con una hoja por municipio). Se reemplaza lo cargado antes de ese periodo + municipio.

Cargar nuestra facturación emitida por componentes

El «Reporte x Conceptos» que produce Área Limpia con lo que se le entregó a EDEQ. Es la mejor fuente que tenemos para el SUI, porque es la única que trae el periodo de prestación (columna FECHA_CORTE), los 9 componentes tarifarios por suscriptor con su subsidio y contribución, y el diferido separado del resto.

El año y mes que elegís acá son los de la EMISIÓN, no los de la prestación — hay dos meses de desfase y el periodo de prestación lo dice el archivo. No se toma de la hoja RESUMEN porque esa etiqueta está escrita a mano y no siempre corresponde. Al cargar se cruza VR TOTAL FACT contra lo que emitió EDEQ, NIU por NIU: si el periodo estuviera equivocado, el cruce no da.

Lo que hay cargado

El municipio y el periodo se leen del archivo: del encabezado («DESDE … HASTA … EMPRESA AREA LIMPIA municipio» o «PERIODO : JUN de 2026»), de la columna de municipio, o —para el formato de mayo, que no trae municipio en ninguna parte— del catálogo de cuentas que se va llenando con los meses que sí lo traen. Si el periodo del archivo no coincide con el que elegiste, el cargue se detiene.

Archivo del SUI (Facturación de aseo por unidad)

Arma el archivo plano del SUI desde lo que ya está cargado. Los componentes tarifarios salen del «Reporte x Conceptos» —tal como se facturaron, con el prorrateo por días ya aplicado y el diferido excluido—, el número y la fecha de factura de lo que emitió EDEQ, las toneladas y el factor de subsidio de las tarifas del periodo de prestación, y la mora y los pagos de la cartera del mes anterior y del recaudo del mes.

El periodo que elegís es el de emisión. Mirá siempre la previa antes de bajar: dice cuántas filas quedan, cuántas se descartan y por qué, y qué campos van en cero por falta de fuente. Si la validación del formato encuentra algo, el archivo no se genera.

Cruce: lo liquidado por el sistema vs. lo que reportó EDEQ

Compara suscriptor por suscriptor el total liquidado (total_factura, que es el mismo VR TOTAL FACT del Reporte x Conceptos: incluye el IAT y la cuota del diferido) contra el total que EDEQ reporta como emitido en su reporte de facturación. Si una cuenta trae más de una factura en el mes, se suman.

El periodo que se escribe es el de PRESTACIÓN, en formato YYYYMM — es el que tiene la liquidación. El periodo de emisión de EDEQ es otro: en Quindío emite dos meses después. No se supone en silencio: sale del «Reporte x Conceptos» cargado de esa prestación (que es el único archivo que trae los dos calendarios), o se escribe a mano acá. Si no hay ninguno cargado, se asume prestación + 2 meses y el resultado lo dice. Comparar el mismo YYMM de los dos lados compara meses distintos: ese error ya se cometió una vez y el hallazgo hubo que retirarlo.

Gestión de pagos por consecutivo

Por número de factura: cuánto se emitió, cuánto se ha pagado y cuánto queda. El cruce es por consecutivo, que es lo único que enlaza el reporte de facturación con el de recaudo. Las facturas de marzo y abril no traen número (ese formato no lo incluía): se cuentan aparte y no aparecen como impagas.

Eliminar un periodo cargado

Borra lo cargado de un periodo + municipio. Sirve para limpiar cargues equivocados — incluidas las filas cuyo «municipio» quedó siendo el nombre de una hoja de Excel. Se puede escribir cualquier municipio tal como aparece en la tabla de arriba: el borrado no lo valida, porque si lo validara la fila mala sería imposible de borrar. Queda registrado en la bitácora con el responsable y el motivo.

Cargar diferidos

Archivo con las columnas NIU | CARGO_FIJO | CARGO_VARIABLE | CARGO_VARIABLE_APROVE | VALOR_SUB (separado por |, ; o ,; encabezado opcional). El valor de cada columna es el total a diferir: se divide entre el número de cuotas y se suma una cuota por período, a partir del período de inicio, a la liquidación del suscriptor.

Diferidos cargados

Resumen

1. Buscar facturas pendientes

Refinancia cartera YA facturada y vencida en cuotas pactadas -- distinto de "Diferidos" (eso reparte cargos futuros antes de facturarlos, y solo aplica a Quindío).

2. Crear acuerdo con las facturas seleccionadas

Acuerdos existentes

Detalle del acuerdo

Catálogo de ciclos

Cada suscriptor trae su ciclo (1 a 6, heredado de Seacor) en el catastro. Aquí se le da significado de negocio: si es de facturación conjunta (con un tercero como Afinia) o directa (propia).

Cierre por período

Bloquea un ciclo para un período puntual, para que no se le apliquen cambios (novedades/PQR) mientras se hace el proceso de liquidación de ese ciclo. El bloqueo es solo para ese período — se reabre automáticamente al pasar al siguiente.

Datos del suscriptor

Registra un suscriptor nuevo en el catastro de Córdoba (empresa AFINIA). La cuenta/NIU no puede repetirse con una ya existente.

Estado actual del catastro

Cargar archivo(s) de vinculación (Afinia)

Archivo(s) de texto plano (.txt) en el mismo formato AS/400 que entrega Afinia, separado por |, sin encabezado, 14 campos por línea (código de tarifa, documento, cuenta/NIU, nombre, dirección, municipio, barrio y situación -- el mismo formato del catastro que ya cargamos). Puedes seleccionar varios archivos a la vez. Las cuentas que ya existen en el catastro se omiten -- este módulo solo agrega suscriptores nuevos, no actualiza los existentes.

Radicar PQR

Ingresa el NIU y el sistema recupera la cuenta; solo registras el tipo, el medio de recepción, las pretensiones y los hechos.

PQR radicadas

1. Cambiar datos del suscriptor

2. Ajuste a período anterior

Valor positivo = cargo; negativo = crédito/nota crédito. Queda asociado a la PQR.

3. Responder / cerrar

Al marcar CERRADA se registra la fecha de cierre.

4. Visitas técnicas y soportes

5. Notificaciones

Actuaciones de notificación (personal, electrónica o por aviso) y generación de citaciones/avisos (Ley 1437 de 2011).

6. Asistente IA (Chat Bot)

Pregúntale sobre esta PQR o pídele que redacte una respuesta según las plantillas y la Ley 1437. Requiere ANTHROPIC_API_KEY en el servidor.

7. Eliminar radicado

Elimina la PQR y sus ajustes asociados. Queda registro de quién autoriza y la observación. Acción irreversible.

Variables: {radicado} {niu} {tipo} {fecha_radicacion} {descripcion} {pretensiones} {municipio} {clase_servicio} {estrato} {direccion} {barrio} {fecha}

Radicar PQR

Ingresa la cuenta contrato y el sistema recupera el suscriptor; solo registras el tipo, el medio de recepción, las pretensiones y los hechos.

PQR radicadas

1. Ajuste a período anterior

Valor positivo = cargo; negativo = crédito/nota crédito. Queda asociado a la PQR.

2. Responder / cerrar

Al marcar RESUELTA o CERRADA se registra la fecha de cierre.

3. Visitas técnicas y soportes

4. Notificaciones

Actuaciones de notificación (personal, electrónica o por aviso) y generación de citaciones/avisos (Ley 1437 de 2011).

5. Asistente IA (Chat Bot)

Pregúntale sobre esta PQR o pídele que redacte una respuesta según las plantillas y la Ley 1437. Requiere ANTHROPIC_API_KEY en el servidor.

6. Eliminar radicado

Requiere quién autoriza y una observación; queda auditado y se eliminan también sus ajustes, visitas, soportes y notificaciones.

Variables: {radicado} {cuenta_contrato} {empresa} {nombre} {tipo} {fecha_radicacion} {descripcion} {pretensiones} {municipio} {uso} {estrato} {direccion} {barrio} {fecha}

Saldos pendientes por estrato y edad de vencimiento

Catastro de usuarios a corte del mes

Excel con los suscriptores que tenían prestación en el mes elegido: la prestación empezó antes o durante el mes, y no se retiraron antes del día 1. Es el mismo universo que liquida el módulo de Liquidación, así que los conteos siempre coinciden.

Trae dos hojas: RESUMEN (qué es el corte, cuántos entraron, cuántos quedaron afuera y por qué, y los totales por municipio, clase y estrato) y CATASTRO con una fila por suscriptor, incluida la columna DIAS_CON_SERVICIO_EN_EL_MES.

Ojo: los datos de cada suscriptor (dirección, estrato, clase) salen como están hoy, no como estaban en el mes del corte — el sistema no guarda una fotografía mensual del catastro. Lo que sí corresponde al mes es quiénes aparecen.

Los que vienen

Acá se van sumando los demás planos. Cada uno se agrega en app/services/planos_quindio.py y aparece en esta lista sin tocar la pantalla.

1. Cargue de variables de costo

Costos fijos ($/suscriptor-mes)

Costos variables ($/tonelada) y aprovechamiento

2. Factores por clase de uso (toneladas/suscriptor y subsidio/contribución)

3. Cargues guardados — simular y aplicar al catastro

2. Aplicar al catastro

Con las tarifas cargadas arriba, ve al menú Liquidación para crear el período (año/mes) y presionar Liquidar: cruza cada suscriptor activo con la tarifa vigente de su municipio, empresa y estrato, y genera las facturas del período (por ahora solo suscriptores residenciales en zona urbana con condición normal — comercial/industrial/oficial, zona rural, deshabitado y puerta a puerta quedan cargados pero aún no los aplica el motor de liquidación).

Estado de tarifas y liquidaciones

Crear usuario

Usuarios existentes

Credenciales y accesos — dónde viven

Por seguridad esta pantalla no muestra contraseñas ni tokens: solo el servidor, el esquema y el nombre de la variable, para saber dónde buscarlos. Los datos salen de la configuración que el servicio está usando en este momento, no de una lista escrita a mano.