Importar el histórico
Para el equipo técnico: cómo cargar las planillas de gastos de 2024–2026, una por cuenta, sin duplicar.
Para el equipo técnico
Esta carga no tiene pantalla: se corre desde la consola del servidor, una vez por planilla. Quien opera el sistema no necesita esta página; lo que importa saber es que los gastos importados se ven como cualquier otro, con la marca importado en el detalle y sin comprobante adjunto.
Antes de empezar
- La cuenta de origen de la planilla tiene que existir y estar activa en
Cuentas bancarias, con su código corto (
6101). - También las cuentas que la planilla nombra en PAGO A CUENTA de las transferencias PROPIAS y en PRESTAMO: se buscan por su código corto.
- El archivo es .xlsx o .csv.
Cómo se corre
Primero, siempre, en modo prueba: valida todo y no escribe nada.
pnpm --filter=api exec tsx scripts/import-expenses.ts --file <planilla.xlsx> --account 6101 --dry-runSi el reporte está bien, la misma línea sin --dry-run importa.
| Opción | Para qué |
|---|---|
--file | La planilla. Obligatoria |
--account | El código corto de la cuenta de origen. Obligatoria |
--dry-run | Valida y muestra el reporte, sin escribir |
--sheet | La hoja del Excel. Si no se indica, la primera |
--user | El correo de quien figura como que registró. Si no, el primer administrador activo |
--company | El id de la empresa, sólo si el mismo código corto existe en dos empresas |
--skip-invalid | Importa lo válido aunque haya filas con error |
Las columnas
El encabezado se busca solo en las primeras 30 filas: los títulos o filas vacías de arriba no molestan.
| Columna de la planilla | Va a | Notas |
|---|---|---|
| FECHA | Fecha | Fecha de Excel o texto dd/mm/aaaa |
| NOMBRE | Beneficiario | |
| TRANSFERENCIA | Tipo | DIRECTA o PROPIA |
| NO. REFERENCIA | Referencia | |
| PAGO A CUENTA | Cuenta destino | En una PROPIA se busca la cuenta de la empresa por su código corto y es obligatoria; en una DIRECTA queda como texto |
| CONCEPTO | Concepto | |
| PRESTAMO | Préstamo sin monto | Puede traer varias cuentas (3042/6510). El histórico nunca tuvo el monto: quedan todos en la pestaña Préstamos sin monto |
| MONTO RD$ | Monto | Mayor que cero |
| IMPUESTO BAN | Impuesto | Se toma el de la planilla, no se recalcula. Vacío = 0.00 |
Obligatorias en el encabezado: FECHA, NOMBRE, TRANSFERENCIA, NO. REFERENCIA, CONCEPTO y MONTO.
Qué revisa
Errores (la fila no entra): fecha inválida, tipo que no es DIRECTA ni PROPIA, falta el nombre o el concepto, monto inválido o en cero, impuesto negativo, PROPIA sin cuenta de destino, una cuenta de destino o prestadora que no existe, está inactiva, es la misma de origen o es de otra moneda, y una referencia repetida dentro del archivo.
Avisos (la fila entra igual): el impuesto no cuadra con la tasa, una DIRECTA sin impuesto (se importa en 0.00) o una PROPIA con impuesto.
Al final, el resumen: filas leídas, a importar, ya importadas, con error y con aviso.
Correr dos veces no duplica
Una fila cuya referencia ya existe en la cuenta se salta como ya importado. Se puede corregir la planilla y volver a correr sin miedo.
Todo o nada
- Si hay un solo error, no se escribe nada. Se corrige la planilla y se
repite, o se usa
--skip-invalidpara dejar fuera las filas con error. - Lo válido se escribe en una sola operación: entra todo o no entra nada.
- Los gastos importados toman números
GAS-…correlativos, en orden de fecha.
Reportes y corte de las 5:00 PM
Las seis pestañas: el libro por cuenta, los resúmenes diario, semanal y mensual, los préstamos, la clasificación por proyecto o categoría, los pagos fijos y la caja chica, y los cortes automáticos.
Introducción
La parte del sistema que paga sueldos y atiende al personal: empleados, nómina, préstamos y sus solicitudes.