Convirtiendo Ventas Cuenti a FV Contable
YAML--- name: convirtiendo-ventas-cuenti-a-fv-contable description: Convierte el Excel 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 15.000 registros sin cortar facturas. Úsala para dimensionar la carga, generar los libros FV, o explicar/depurar esta conversión contable. --- # Cuenti → módulo contable (formato FV) Responde siempre en español. Conversión de ventas exportadas de Cuenti al formato FV que recibe el módulo contable.
Ante un export de Cuenti, primero dimensiona (sección 4) antes de convertir:
1. Leer "Ventas por producto" (Hoja1, streaming si ≥100MB)
2. Contar líneas, facturas, registros contables resultantes
3. Detectar excepciones (tarifas inválidas, centros vacíos/desconocidos)
4. Si hay excepciones sin definir → preguntar antes de generar libros
5. Si usuario solo pide dimensionar → entregar solo las métricas
6. Si pide generar → aplicar reglas de conversión, partir en libros, validar cuadre
Export "Ventas por producto" de Cuenti: una hoja (Hoja1), una fila por producto vendido, ~52 columnas. Se procesan todas las filas (no se filtran anuladas).
| 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 (sin impuestos) | T.Neto Antes de Impuestos |
| Total con impuestos | T. Neto |
| Costo | T. Costo |
Un mes que no cabe en 1.048.576 filas: exportar por semanas. Archivos ≥100MB: leer en streaming (openpyxl read_only=True), nunca cargar en convertidor de navegador.
Hoja Hoja1, columnas en este orden exacto: FECHA (mm-dd-yy), TP.DOC. (FV), N°.DOC., TERCERO, CUENTA (8 dígitos), CONCEPTO (máx 255 car.), CENTRO COSTOS (conserva ceros, sin espacio final), DEBITO, CREDITO (2 decimales, 0 si no aplica), DOC.FNT (vacío).
Orden de líneas: cartera → ingresos → impuestos → costo → inventario; dentro de cada grupo, orden del export. Líneas con valor 0 se omiten.
| Línea | Cantidad | Cuenta | Débito | Crédito | Concepto |
|---|---|---|---|---|---|
| Cartera | 1 por factura | 13050501 siempre | Σ T. Neto | 0 | CARTERA |
| Ingreso | 1 por producto | según tarifa | 0 | T.Neto Antes de Impuestos | INGRESO + producto |
| Impuesto | 1 por producto, si tarifa ≠ 0 | según tarifa | 0 | T. Neto − base | IVA + producto |
| Costo | 1 por producto, si T. Costo ≠ 0 | según tarifa | T. Costo | 0 | COSTO + producto |
| Inventario | 1 por producto, si T. Costo ≠ 0 | según tarifa | 0 | T. Costo | INVENTARIO + producto |
Negativos (devoluciones): se invierte el lado, valor positivo.
Cuentas según impuesto_facturado
| 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)
| 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: pendiente por definir con la empresa. Hasta entonces, esas facturas van a «Para revisar»; preguntar antes de convertir.
- Trabajar en centavos enteros: redondear base/total/costo a 2 decimales, ×100.
- Impuesto por producto = total − base (así ingreso + impuesto =
T. Neto). - Verificar por factura: Σ débitos = Σ créditos. Si no cuadra → «Para revisar», no se exporta.
- Tarifa distinta de 0, 5, 8, 19.
- Centro de costo vacío o desconocido.
- Tarifa 0 que cobra impuesto, o línea sin tarifa con impuesto.
- Fecha ilegible o factura descuadrada.
Entregar listado con número de factura y motivo.
Progress para dimensionar:
- Contar líneas de producto y facturas distintas (
# Fact) - Calcular registros contables: por factura, 1 (cartera) + por producto [1 si base≠0] + [1 si tarifa≠0 e impuesto≠0] + [2 si costo≠0]
- Distribución por tarifa y por centro de costo (incluido vacío)
- Contar líneas con
T. Costo= 0 - Particionar en libros ≤15.000 registros sin cortar facturas
- Tiempo de carga ≈ libros × 3 min
Referencia real (oct 2026): 65.319 líneas, 38.880 facturas → 239.642 registros → 16 libros, ~48 min.
Si el volumen es inmanejable, alternativas solo con aprobación del contador: agrupar por cuenta dentro de cada factura, o resumen diario por sede (consumidor final) + facturas identificadas por separado.
- Nombrar libros:
FV_<AAAA-MM>_01.xlsx,_02.xlsx... Cada libro cuadra por sí solo. resumen_<AAAA-MM>.xlsx: libro, facturas, registros, primera/última factura, total débito/crédito.para_revisar_<AAAA-MM>.xlsxsi hay excluidas.- Validación final: Σ cartera de libros + Σ excluido = Σ
T. Netodel export. - Responder: libros generados, registros, tiempo estimado, excluidas con motivo, avisos relevantes.
Ejemplo 1 — Consumidor final, tarifa 8%, sin costo: 3 productos en factura F6E-1539, EAFIT, sin T. Costo. Resultado: 7 registros (1 cartera + 3 ingreso + 3 IVA), cuadra en $22.700. Fecha 05-31-26, centro 0003, tercero 222222222222.
Ejemplo 2 — Cliente identificado, tarifas 19%/0%, con costo: CAMISA (19%, costo 6.000) + PAN (0%, costo 800), centro «oficina 2» → 0017. PAN no genera línea de IVA (tarifa 0). Resultado: 8 registros, cuadra en $20.700.
Ejemplo 3 — Devolución (negativos), tarifa 5%: base −1.000, total −1.050, costo −500 → todo se invierte a positivo en el lado contrario (cartera crédito 1.050, ingreso débito 1.000, etc.).
Ejemplo 4 — Exclusiones: tarifa 16% (sin cuentas), centro «SABANETA» (sin código), centro vacío (pendiente definir), tarifa 0% que cobra impuesto → todas a para_revisar, nunca a los libros.
Ejemplo 5 — Dimensionar mes real: 65.319 líneas, 38.880 facturas, 10.180 líneas (15%) con centro vacío, 30.051 líneas (46%) sin costo → 239.642 registros → 16 libros, 48 min. Avisar el % sin centro antes de convertir.
Ejemplo 6 — Llenado de libros: con límite 20 (ilustrativo), facturas de 7,8,6,9,5 registros → libro 01: facturas 1-2 (15 reg.), libro 02: facturas 3-5 (20 reg.). Nunca se corta una factura entre libros.
Ejemplo 7 — Conversación típica:
- "Solo dime en cuántos libros" → aplicar solo sección 6, no convertir.
- "Genérame los libros" → si hay centros vacíos/tarifas inválidas, preguntar primero; luego aplicar secciones 3-5-7 y confirmar validación final.
- Siempre dimensionar (sección 6) antes de generar archivos reales.
- Preguntar ante cualquier excepción no cubierta por las tablas (centro vacío, tarifa nueva) — nunca asumir un valor.
- Trabajar en centavos enteros para evitar errores de redondeo que descuadren facturas.
- Verificar cuadre por factura antes de incluirla en un libro.
- Nunca cortar una factura entre dos libros.
- Usar
valor_impuestoen vez deimpuesto_facturadopara determinar la cuenta. - Confundir «OFICINA» (0016) con «OFICINA 2» (0017) — no son el mismo centro.
- Generar línea de IVA cuando la tarifa es 0 (no debe existir).
- Generar costo/inventario cuando
T. Costo= 0 (se omite la línea). - Cargar archivos grandes completos en memoria/navegador en vez de streaming.
- Exportar facturas descuadradas o con datos faltantes sin pasarlas por «Para revisar».