Converting Cuenti Sales to Accounting FV Format
Markdown--- name: convirtiendo-ventas-cuenti-a-fv-contable description: Convierte el export de Ventas por producto de Cuenti al formato FV del módulo contable, aplicando reglas de cuentas por tarifa de impuesto, centros de costo y partición en libros de hasta 15.000 registros. Úsala cuando el usuario pida dimensionar, convertir, cuadrar o explicar la carga mensual de ventas de Cuenti al contable, o pregunte por cuentas, centros de costo, facturas excluidas o número de libros necesarios. --- # Cuenti → módulo contable (formato FV) Responde siempre en español. No conviertas nada sin antes dimensionar y, si hay facturas sin centro de costo definido, sin preguntar primero.
Dado un export de Cuenti, el flujo mínimo es:
- Leer
Hoja1, validar columnas clave (# Fact,Fecha Registro,Identificacion Cliente,Producto,nombre_centro_costo,impuesto_facturado,T.Neto Antes de Impuestos,T. Neto,T. Costo). - Calcular métricas (sección 6) y mostrarlas al usuario antes de generar archivos.
- Si hay líneas con centro de costo vacío o no mapeado, detenerse y preguntar qué hacer con ellas (van a «Para revisar» por defecto).
- Generar las líneas contables por factura (sección 3), en centavos enteros, validando cuadre débito = crédito por factura.
- Partir en libros
FV_<AAAA-MM>_01.xlsx,02.xlsx... sin cortar facturas, másresumen_<AAAA-MM>.xlsxypara_revisar_<AAAA-MM>.xlsx. - Responder con el resumen final (sección 7, punto 5).
Progress:
- Leer y validar el export (tamaño, columnas, modo streaming si ≥100 MB)
- Calcular métricas de dimensionamiento y reportarlas
- Confirmar con el usuario el tratamiento de centros de costo vacíos/no mapeados
- Generar líneas contables por factura (cartera, ingresos, impuestos, costo, inventario)
- Validar cuadre por factura (Σ débito = Σ crédito, en centavos)
- Separar líneas que van a «Para revisar»
- Partir en libros de hasta 15.000 registros sin cortar facturas
- Generar resumen y archivo de revisión
- Validar cuadre global contra el export original
- Entregar respuesta final con libros, tiempos y avisos
1. Archivo de entrada
Export de Ventas por producto de Cuenti, hoja única (Hoja1), ~52 columnas, una fila por producto vendido. Columnas usadas:
| Dato | Columna |
|---|---|
| Número de factura | # Fact |
| Fecha | Fecha Registro (sin hora) |
| Tercero | Identificacion Cliente (vacío → 222222222222) |
| Producto | Producto (sin espacios al final) |
| Centro de costo | nombre_centro_costo |
| Tarifa de impuesto | impuesto_facturado (0, 5, 8, 19) — no valor_impuesto |
| Base | T.Neto Antes de Impuestos |
| Total con impuestos | T. Neto |
| Costo | T. Costo |
Se procesan todas las filas (incluidas anuladas). Si un mes supera 1.048.576 filas, pedir exportar por semanas. Archivos ≥100 MB: leer en streaming (ej. openpyxl read_only=True), nunca cargarlos completos en memoria del navegador.
2. Archivo de salida
Hoja Hoja1 con 10 columnas en este orden:
| Columna | Valor | Formato |
|---|---|---|
| FECHA | Fecha Registro sin hora | mm-dd-yy |
| TP.DOC. | FV | texto |
| N°.DOC. | # Fact | texto |
| TERCERO | Identificacion Cliente | número |
| CUENTA | según regla de línea | número 8 dígitos |
| CONCEPTO | ver reglas (máx 255 caracteres) | texto |
| CENTRO COSTOS | código, sin espacio final | texto (conserva ceros) |
| DEBITO / CREDITO | pesos, 2 decimales, 0 si no aplica | 0.00 |
| DOC.FNT | vacío | — |
3. Reglas por factura
Orden: cartera → ingresos → impuestos → costo → inventario; dentro de cada grupo, orden del export. Líneas en 0 se omiten. Negativos (devoluciones) pasan al lado contrario en positivo.
| Línea | Cantidad | Cuenta | Débito | Crédito | Concepto |
|---|---|---|---|---|---|
| Cartera | 1/factura | 13050501 | Σ T. Neto | 0 | CARTERA |
| Ingreso | 1/producto | según tarifa | 0 | T.Neto Antes de Impuestos | INGRESO + producto |
| Impuesto | 1/producto si tarifa ≠ 0 | según tarifa | 0 | T. Neto − base | IVA + producto |
| Costo | 1/producto si T. Costo ≠ 0 | según tarifa | T. Costo | 0 | COSTO + producto |
| Inventario | 1/producto si T. Costo ≠ 0 | según tarifa | 0 | T. Costo | INVENTARIO + producto |
Cuentas por tarifa:
| Tarifa | Ingreso | Impuesto | Costo | Inventario |
|---|---|---|---|---|
| 0 | 41201420 | — | 61200900 | 14051001 |
| 5 | 41201405 | 24080505 | 61200900 | 14050301 |
| 8 | 41201425 | 24950501 | 61200900 | 14050301 |
| 19 | 41201435 | 24080511 | 61200901 | 14050601 |
Centros de costo (comparar sin mayúsculas/tildes; "OFICINA" ≠ "OFICINA 2"):
| Nombre | Código |
|---|---|
| PLANTA | 0001 |
| RIONEGRO | 0002 |
| EAFIT | 0003 |
| COPACABANA | 0005 |
| ESTRELLA | 0009 |
| OFICINA | 0016 |
| OFICINA 2 | 0017 |
| TUTUCAN | 0018 |
| ARVI | 0021 |
| UPB | 0026 |
Centro vacío/no mapeado: preguntar antes de convertir; por defecto va a «Para revisar».
4. Cálculos y cuadre
- Trabajar en centavos enteros: redondear base/total/costo a 2 decimales y multiplicar por 100.
- Impuesto por producto = total − base (garantiza ingreso + impuesto =
T. Neto). - Por factura: Σ débitos = Σ créditos; si no cuadra, excluir a «Para revisar», no exportar.
5. Exclusiones a «Para revisar»
- Tarifa distinta de 0/5/8/19.
- Centro de costo vacío o no mapeado.
- Producto tarifa 0 con impuesto cobrado, o línea sin tarifa con impuesto.
- Fecha ilegible o factura descuadrada.
Entregar siempre con número de factura y motivo.
6. Métricas previas (dimensionamiento)
Antes de generar archivos, calcular y reportar:
- Líneas de producto y facturas distintas (
# Fact). - Registros contables = Σ por factura de: 1 (cartera) + por producto [1 si base≠0] + [1 si tarifa≠0 y hay impuesto] + [2 si costo≠0].
- Distribución por tarifa y por centro de costo (incluido vacío).
- Líneas con
T. Costo= 0. - Libros de hasta 15.000 registros, sin cortar facturas.
- Tiempo estimado ≈ libros × 3 minutos.
Referencia real (oct-2026): 65.319 líneas, 38.880 facturas → 239.642 registros → 16 libros, ~48 min. Para 8 meses similares: ~128 libros, 6-7 horas.
Si el volumen es inmanejable, alternativas solo con aprobación del contador: agrupar por cuenta dentro de factura (oct: 166.343 registros, 12 libros) o resumen diario por sede para consumidor final + facturas de clientes identificados aparte (oct: ~3.000 registros).
7. Partición y entrega
- Nombrar libros en orden:
FV_<AAAA-MM>_01.xlsx,_02.xlsx... Cada libro cuadra por sí solo. - Generar
resumen_<AAAA-MM>.xlsx: libro, facturas, registros, primera/última factura, total débito/crédito. - Generar
para_revisar_<AAAA-MM>.xlsxsi hay excluidas. - Validar: Σ cartera de todos los libros + excluidas = Σ
T. Netodel export. - Responder: libros generados, registros, tiempo estimado, facturas excluidas con motivo, avisos relevantes (ej. % de líneas sin costo).
Example 1:
Input: Export de octubre 2026 con 65.319 líneas y 38.880 facturas, 15% con nombre_centro_costo vacío.
Output: Reporte previo: "239.642 registros contables estimados, 16 libros (~48 min de carga). 15% de líneas (≈9.800) sin centro de costo definido irán a 'Para revisar' salvo que definan el código a usar. ¿Confirman tratamiento antes de convertir?"
Example 2: Input: Una factura con producto tarifa 19, base $100.000, total $119.000, costo $60.000. Output: 4 líneas: Ingreso 41201435 crédito 100.000; IVA 24080511 crédito 19.000; Costo 61200901 débito 60.000; Inventario 14050601 crédito 60.000; más la línea de cartera 13050501 débito 119.000 (consolidada con otras facturas... línea por factura, no por producto).
- Siempre reportar métricas de dimensionamiento antes de convertir; nunca generar libros "a ciegas".
- Trabajar en centavos enteros durante todo el cálculo para evitar descuadres por redondeo acumulado.
- Preguntar explícitamente qué hacer con centros de costo vacíos/no mapeados antes de procesar, no asumir un código.
- Verificar cuadre por factura y cuadre global contra el export original antes de entregar.
- Usar streaming de lectura para archivos grandes (≥100 MB).
- Usar
valor_impuestoen vez deimpuesto_facturadopara determinar la cuenta (son conceptos distintos: valor en pesos vs. tarifa). - Cortar una factura entre dos libros al particionar los 15.000 registros.
- Tratar "OFICINA" y "OFICINA 2" como el mismo