AI Skill Report Card

Converting Cuenti Sales to Accounting FV Format

A-84·Nov 13, 2026·Source: Web
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.
13 / 15

Dado un export de Cuenti, el flujo mínimo es:

  1. 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).
  2. Calcular métricas (sección 6) y mostrarlas al usuario antes de generar archivos.
  3. 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).
  4. Generar las líneas contables por factura (sección 3), en centavos enteros, validando cuadre débito = crédito por factura.
  5. Partir en libros FV_<AAAA-MM>_01.xlsx, 02.xlsx... sin cortar facturas, más resumen_<AAAA-MM>.xlsx y para_revisar_<AAAA-MM>.xlsx.
  6. Responder con el resumen final (sección 7, punto 5).
Recommendation▾
Add 1-2 more concrete examples covering edge cases like negative returns (devoluciones) and tax rate exclusions to round out the examples section
14 / 15

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:

DatoColumna
Número de factura# Fact
FechaFecha Registro (sin hora)
TerceroIdentificacion Cliente (vacío → 222222222222)
ProductoProducto (sin espacios al final)
Centro de costonombre_centro_costo
Tarifa de impuestoimpuesto_facturado (0, 5, 8, 19) — no valor_impuesto
BaseT.Neto Antes de Impuestos
Total con impuestosT. Neto
CostoT. 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:

ColumnaValorFormato
FECHAFecha Registro sin horamm-dd-yy
TP.DOC.FVtexto
N°.DOC.# Facttexto
TERCEROIdentificacion Clientenúmero
CUENTAsegún regla de líneanúmero 8 dígitos
CONCEPTOver reglas (máx 255 caracteres)texto
CENTRO COSTOScódigo, sin espacio finaltexto (conserva ceros)
DEBITO / CREDITOpesos, 2 decimales, 0 si no aplica0.00
DOC.FNTvací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íneaCantidadCuentaDébitoCréditoConcepto
Cartera1/factura13050501Σ T. Neto0CARTERA
Ingreso1/productosegún tarifa0T.Neto Antes de ImpuestosINGRESO + producto
Impuesto1/producto si tarifa ≠ 0según tarifa0T. Neto − baseIVA + producto
Costo1/producto si T. Costo ≠ 0según tarifaT. Costo0COSTO + producto
Inventario1/producto si T. Costo ≠ 0según tarifa0T. CostoINVENTARIO + producto

Cuentas por tarifa:

TarifaIngresoImpuestoCostoInventario
041201420—6120090014051001
541201405240805056120090014050301
841201425249505016120090014050301
1941201435240805116120090114050601

Centros de costo (comparar sin mayúsculas/tildes; "OFICINA" ≠ "OFICINA 2"):

NombreCódigo
PLANTA0001
RIONEGRO0002
EAFIT0003
COPACABANA0005
ESTRELLA0009
OFICINA0016
OFICINA 20017
TUTUCAN0018
ARVI0021
UPB0026

Centro vacío/no mapeado: preguntar antes de convertir; por defecto va a «Para revisar».

4. Cálculos y cuadre

  1. Trabajar en centavos enteros: redondear base/total/costo a 2 decimales y multiplicar por 100.
  2. Impuesto por producto = total − base (garantiza ingreso + impuesto = T. Neto).
  3. 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:

  1. Líneas de producto y facturas distintas (# Fact).
  2. Registros contables = Σ por factura de: 1 (cartera) + por producto [1 si base≠0] + [1 si tarifa≠0 y hay impuesto] + [2 si costo≠0].
  3. Distribución por tarifa y por centro de costo (incluido vacío).
  4. Líneas con T. Costo = 0.
  5. Libros de hasta 15.000 registros, sin cortar facturas.
  6. 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

  1. Nombrar libros en orden: FV_<AAAA-MM>_01.xlsx, _02.xlsx... Cada libro cuadra por sí solo.
  2. Generar resumen_<AAAA-MM>.xlsx: libro, facturas, registros, primera/última factura, total débito/crédito.
  3. Generar para_revisar_<AAAA-MM>.xlsx si hay excluidas.
  4. Validar: Σ cartera de todos los libros + excluidas = Σ T. Neto del export.
  5. Responder: libros generados, registros, tiempo estimado, facturas excluidas con motivo, avisos relevantes (ej. % de líneas sin costo).
Recommendation▾
Fix the truncated final sentence under Common Pitfalls ('Tratar OFICINA y OFICINA 2 como el mismo' is cut off)
15 / 20

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).

Recommendation▾
Example 2's output is slightly confusing/incomplete ('más la línea de cartera... consolidada con otras facturas... línea por factura, no por producto' reads as an unfinished parenthetical) - clean this up for clarity
  • 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_impuesto en vez de impuesto_facturado para 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
0
Grade A-AI Skill Framework
Scorecard
Criteria Breakdown
Quick Start
13/15
Workflow
14/15
Examples
15/20
Completeness
18/20
Format
13/15
Conciseness
13/15