Converting Cuenti Sales to Accounting Format
Markdown--- name: convirtiendo-cuenti-a-contable description: Convierte el export de "Ventas por producto" de Cuenti al archivo de carga del módulo contable (formato FV), aplicando reglas de omisión, cuentas por tarifa de IVA/consumo, centros de costo, cuadre por factura y partición en libros de hasta 15.000 registros. Úsalo cuando el usuario pida convertir ventas de Cuenti a contabilidad, generar libros FV, dimensionar la carga de un mes, o revisar facturas excluidas antes de contabilizar. Responde siempre en español. ---
Ante cualquier export de Cuenti, sigue este orden:
- Lee el archivo en streaming si pesa ≥100 MB (
openpyxlconread_only=True). Nunca lo cargues completo en el convertidor del navegador. - Aplica la regla de omisión (sección 1.1) antes de cualquier otra cosa.
- Calcula métricas (sección 6) y repórtalas al usuario.
- Si hay centros de costo sin cuenta de caja (vacío, OFICINA, OFICINA 2) o tarifas no contempladas (≠ 0,5,8,19), detente y pregunta antes de generar libros.
- Solo con esa información resuelta, genera los libros, el resumen y el archivo de "Para revisar".
No proceses nada "a medias": si falta una respuesta del usuario sobre un centro de costo, esas facturas van a "Para revisar" y lo demás sigue su curso normal.
Progreso:
- [ ] 1. Leer export y detectar columnas necesarias
- [ ] 2. Aplicar regla de omisión (sección 1.1) y reportar líneas/facturas/valor omitido
- [ ] 3. Calcular métricas de dimensionamiento (sección 6)
- [ ] 4. Detectar centros de costo sin cuenta (vacío, OFICINA, OFICINA 2) y tarifas no contempladas → preguntar y pausar si aplica
- [ ] 5. Agrupar líneas restantes por # Fact
- [ ] 6. Por cada factura: generar línea de caja, líneas de ingreso, líneas de impuesto (sección 3)
- [ ] 7. Validar cuadre por factura (Σ débitos = Σ créditos); si no cuadra, mandar a "Para revisar"
- [ ] 8. Particionar en libros sin cortar facturas (máx. 15.000 registros)
- [ ] 9. Generar FV_<AAAA-MM>_NN.xlsx, resumen_<AAAA-MM>.xlsx y para_revisar_<AAAA-MM>.xlsx
- [ ] 10. Validación final: caja de libros + excluido + omitido = Σ T. Neto del export
- [ ] 11. Responder al usuario con el resumen completo (sección 7.5)
Detalle de pasos clave
Regla de omisión (1.1): se omite una línea solo si id_producto=1 Y Vendedor="SOPORTE CUENTI" (sin importar mayúsculas/espacios) Y Producto vacío. Las tres a la vez. Aplica antes de agrupar por factura: si una factura se queda sin líneas, desaparece completa. Informa siempre cuántas líneas/facturas se omitieron y su T. Neto total.
Centros de costo: compara nombre_centro_costo sin mayúsculas ni tildes. Usa la tabla:
| Nombre | CENTRO COSTOS | Cuenta caja | Concepto caja |
|---|---|---|---|
| PLANTA | 0001 | 11050590 | CAJA PLANTA |
| RIONEGRO | 0002 | 11050515 | CAJA RIONEGRO |
| EAFIT | 0003 | 11050530 | CAJA EAFIT |
| COPACABANA | 0005 | 11050510 | CAJA COPACABANA |
| ESTRELLA | 0009 | 11050525 | CAJA ESTRELLA |
| TUTUCAN | 0018 | 11050516 | CAJA TUTUCAN |
| ARVI | 0021 | 11050521 | CAJA ARVI |
| UPB | 0026 | 11050531 | CAJA UPB |
| OFICINA | 0016 | preguntar | — |
| OFICINA 2 | 0017 | preguntar | — |
| (vacío) | preguntar | preguntar | — |
OFICINA, OFICINA 2 y vacío nunca se convierten sin respuesta explícita del usuario. Mientras tanto van a "Para revisar".
Cuentas por tarifa (impuesto_facturado, NO valor_impuesto):
| Tarifa | Ingreso | Impuesto | Concepto impuesto |
|---|---|---|---|
| 0 | 41201420 | — | — |
| 5 | 41201405 | 24080505 | IVA + producto |
| 8 | 41201425 | 24950501 | IMPUESTO AL CONSUMO + producto |
| 19 | 41201435 | 24080511 | IVA + producto |
Tarifa fuera de {0,5,8,19} → "Para revisar".
Construcción de cada factura (orden: caja, ingresos, impuestos):
- Caja: 1 línea, débito = Σ
T. Netode la factura, cuenta según centro, conceptoCAJA+ nombre centro en mayúsculas. - Por cada producto (orden del export): línea de ingreso, crédito =
T.Neto Antes de Impuestos, cuenta según tarifa, conceptoINGRESO+ producto. - Por cada producto con tarifa ≠ 0: línea de impuesto, crédito =
T. Neto− base, cuenta/concepto según tarifa. - Líneas en 0 se omiten; valores negativos (devoluciones) van al lado contrario en positivo.
T. Costose ignora siempre: nunca generar cuentas 61 ni 14.- Trabaja en centavos enteros (redondea cada valor a 2 decimales ×100) para evitar descuadres.
- Verifica Σ débitos = Σ créditos por factura. Si falla, la factura entera va a "Para revisar".
Partición en libros: acumula registros factura por factura; si la siguiente factura no cabe en el límite de 15.000, ciérralo y abre uno nuevo. Nunca cortar una factura entre dos libros. Nombra FV_<AAAA-MM>_01.xlsx, _02.xlsx, etc.
Ejemplo 1 — Tarifa 8%, consumidor final (EAFIT) Input: 3 líneas de la factura F6E-1539, centro EAFIT, tarifa 8, bases/totales de agua, gaseosa y torta. Output: 7 registros — 1 caja (11050530, débito 22700,00), 3 ingresos (41201425), 3 impuestos (24950501), todos con CENTRO COSTOS 0003, fecha 05-31-26, cuadra en $22.700.
Ejemplo 2 — Tarifas mixtas 19%/0%, costo ignorado Input: factura A1, centro "rionegro" (minúsculas), CAMISA (19%, base 10.000) y PAN (0%, base 2.000), con T. Costo presente. Output: 4 registros — caja 11050515 por 13.900, ingreso CAMISA 41201435, ingreso PAN 41201420 (sin línea de impuesto), IVA CAMISA 24080511 por 1.900. T. Costo no genera ninguna línea.
Ejemplo 3 — Devolución (negativos), tarifa 5% Input: factura A4, centro UPB, producto DEVOL, base −1.000, T. Neto −1.050. Output: caja en crédito 1050, ingreso en débito 1000, IVA en débito 50 (valores negativos invierten el lado).
Ejemplo 4 — Casos para "Para revisar"
Input: tarifa 16%, centro SABANETA (no está en tabla), centro vacío, tarifa 0 con impuesto cobrado, OFICINA 2, producto vacío con id_producto=57.
Output: cada factura aparece en para_revisar_<AAAA-MM>.xlsx con el motivo exacto; ninguna entra a los libros.
Ejemplo 7 — Regla de omisión aplicada a un mes Input: 372 líneas, 225 cumplen las tres condiciones de omisión (id_producto=1, SOPORTE CUENTI, producto vacío), por $523.307.383,71. Output: se omiten 225 líneas/facturas; de las 147 restantes, 49 facturas quedan en $0 y no generan registros; resultado final 1 libro, 257 registros, 73 facturas, $2.803.400; validación: caja + omitido = Σ T. Neto del export.
- Siempre aplicar la regla de omisión antes de agrupar por factura.
- Siempre informar, antes de generar libros, las métricas de la sección 6 (líneas, facturas, omitidas, registros, libros, tiempo).
- Preguntar y pausar ante cualquier centro de costo sin cuenta de caja definida (vacío, OFICINA, OFICINA 2) o tarifa fuera de {0,5,8,19}; nunca inventar una cuenta.
- Usar
impuesto_facturadopara decidir la cuenta, nuncavalor_impuesto. - Calcular el impuesto como
T. Neto− base, no recalcularlo con el porcentaje, para garantizar el cuadre al centavo. - Conservar el orden de productos del export dentro de cada factura.
- Conservar ceros a la izquierda en CENTRO COSTOS (texto, no número).
- Quitar espacios finales de
Productoy del código de centro de costo. - Validar Σ débitos = Σ créditos en cada factura antes de incluirla en un libro.
- Si un mes no cabe en una sola hoja de Excel (>1.048.576 filas), exportar por semanas.
- Entregar siempre: libros, resumen, archivo de revisión (si aplica) y la validación final cuadrada contra el
T. Netodel export completo.
- No usar
valor_impuesto(valor en pesos) en vez deimpuesto_facturado(tarifa) para decidir cuentas. - No generar líneas de costo (61) o inventario (14) a partir de
T. Costo: esa columna nunca se usa. - No omitir líneas que cumplen solo una o dos condiciones de la regla de omisión (deben cumplirse las tres).
- No inventar código o cuenta de caja para OFICINA, OFICINA 2 o centro vacío sin respuesta explícita del usuario.
- No cortar una factura entre dos libros al particionar.
- No convertir facturas que no cuadran (Σ débitos ≠ Σ créditos): deben ir a "Para revisar".
- No omitir el reporte de líneas/facturas omitidas, excluidas o en $0 en la respuesta final al usuario.
- No cargar archivos de 100 MB o más directamente en el convertidor del navegador.
- No procesar sin antes mostrar las métricas de dimensionamiento cuando el usuario solo pide "dimensionar" (no convertir).