PurpleMarket — Sistema de Documentación Excel

Versión: 1.0 | Última actualización: 2026-10-05

Este documento describe completamentemente el sistema de archivos Excel de PurpleMarket. Cada archivo representa una tabla del sistema con sus columnas, tipos de dato, reglas de validación, dependencias y errores comunes.

Resumen

#	Módulo	Archivos	Descripción
1	Configuración	8	Configuración general del sistema
2	Catálogo	7	Productos, categorías e impuestos
3	Inventario	4	Stock y movimientos de mercadería
4	Deudores	1	Clientes con cuenta corriente
5	ARCA/AFIP	3	Facturación electrónica
6	Métricas	3	Estadísticas y reportes
7	Ventas/Finanzas	1	Historial de ventas y movimientos
8	Proveedores	3	Proveedores y compras
Total	30

Mapa de Dependencias

Los archivos Excel tienen dependencias entre sí. Al importar, el orden importa:

Roles.xlsx → Usuarios.xlsx (Usuarios vincula con Roles por nombre)
Sucursales.xlsx → Usuarios.xlsx, Cajas_Configuracion.xlsx, Productos.xlsx
Categorias.xlsx → Productos.xlsx (Productos vincula con Categorias por nombre)
Proveedores.xlsx → Productos.xlsx (Productos vincula con Proveedores por nombre)
Productos.xlsx → Stock.xlsx, Movimientos_Y_Lotes.xlsx, Promociones_Productos.xlsx
Lotes.xlsx → Movimientos_Y_Lotes.xlsx, Stock.xlsx
Stock.xlsx → Transferencias.xlsx
Cupones.xlsx → Compras.xlsx (referencia por cuponId)
Cajas_Configuracion.xlsx → Cajas_Metricas.xlsx, Operaciones_Caja.xlsx

Módulo 1: Configuración

Configuración general del sistema

Archivos: 8

1.1 Roles.xlsx

Archivo: Roles.xlsx Nivel: Level 1 | Dependencias: Ninguna

Define los roles de usuario y sus permisos

Columnas: Nombre, Descripcion, Permisos

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre único del rol	Administrador	Identificador único del rol. Se usa para vincular usuarios con sus permisos y restricciones.
Descripcion	Texto	No	Texto libre	Acceso total al sistema	Descripción legible del propósito y alcance del rol dentro del sistema.
Permisos	Lista (coma)	No	Ver tabla de valores	ISSUE_BILLING, GET_EMPLOYEES	Lista de códigos que definen qué acciones y módulos puede acceder un usuario con este rol.

Valores posibles para "Permisos":

Valor	Descripción
`ISSUE_BILLING`	Emitir comprobantes fiscales
`MODULE_INVENTORY`	Módulo de inventario
`MP_VIEW_TERMINALS`	Ver terminales, stores y cajas de MercadoPago
`MP_MANAGE_CONFIG`	Editar configuración de MercadoPago
`MP_MANAGE_QR`	Cobrar por QR desde la caja
`MP_MANAGE_CREDIT_DEBIT`	Cobrar por débito o crédito desde la caja
`MP_MANAGE_TRANSFER`	Cobrar por transferencia desde la caja
`PROCESS_REFUND`	Crear y procesar reembolsos / notas de crédito
`VIEW_REFUNDS`	Ver historial de reembolsos
`MODULE_PAYWAY`	Módulo de pasarela de pago
`MODULE_PAYWAY_DEVICE`	Dispositivo de pasarela de pago
`MODULE_MODO`	Módulo modo de operación
`MODULE_SCANNER_GUN`	Módulo de escáner de barras
`MODULE_KRETZ`	Módulo Kretz (facturación)
`MODULE_SYSTEL`	Módulo Systel
`GET_EMPLOYEES`	Ver lista de empleados
`ADD_EMPLOYEES`	Crear nuevos empleados
`UPDATE_EMPLOYEES`	Editar empleados existentes
`DELETE_EMPLOYEES`	Eliminar empleados
`GET_ROLES`	Ver lista de roles
`ADD_ROLES`	Crear nuevos roles
`UPDATE_ROLES`	Editar roles existentes
`DELETE_ROLES`	Eliminar roles
`POS_ACCESS`	Acceso al punto de venta (caja)
`VIEW_MOVEMENTS`	Ver movimientos de caja
`VIEW_ACCOUNTS`	Ver cuentas
`MANAGE_ACCOUNTS`	Administrar cuentas
`VIEW_INVENTORY`	Ver el inventario (solo lectura)
`MANAGE_INVENTORY`	Administrar inventario (agregar, editar, eliminar)
`MANAGE_PROMOTIONS`	Administrar promociones
`MANAGE_CATEGORIES`	Administrar categorías de productos
`MANAGE_TAXES`	Administrar impuestos
`VIEW_BILLING`	Ver facturación
`MANAGE_SUPPLIERS`	Administrar proveedores
`VIEW_METRICS`	Ver métricas y estadísticas
`MANAGE_SUBSIDIARIES`	Administrar sucursales
`MANAGE_GENERAL_CONFIG`	Administrar configuración general del sistema
`MANAGE_ARCA_CONFIG`	Configurar integraciones con AFIP (ARCA)
`MODULE_CIERRE_CAJA`	Módulo de cierre de caja
`MODULE_ETIQUETAS_PDF`	Módulo de etiquetas PDF
`MODULE_CUPONES`	Módulo de cupones de descuento
`MODULE_PHONE_SCANNER`	Módulo de Phone Scanner (escáner con celular)
`MANAGE_PLANS`	Administrar planes de suscripción
`MANAGE_MOVEMENTS`	Crear y editar movimientos (ingresos/egresos)
`CC_SALE`	Realizar ventas a cuenta corriente
`VIEW_PROMOTIONS`	Ver listado de promociones
`DELETE_PROMOTIONS`	Eliminar promociones del sistema
`VIEW_CATEGORIES`	Ver listado de categorías
`DELETE_CATEGORIES`	Eliminar categorías del sistema
`VIEW_SUPPLIERS`	Ver listado de proveedores
`DELETE_SUPPLIERS`	Eliminar proveedores del sistema
`VIEW_COUPONS`	Ver listado de cupones
`MANAGE_COUPONS`	Crear y editar cupones
`DELETE_COUPONS`	Eliminar cupones del sistema
`MP_MANAGE_CONFIG`	Editar configuración de MercadoPago
`VIEW_COMPANIES`	Ver empresas
`CREATE_COMPANIES`	Crear empresas
`UPDATE_COMPANIES`	Editar empresas
`DELETE_COMPANIES`	Eliminar empresas
`VIEW_PROFILES`	Ver perfiles de facturación
`CREATE_PROFILES`	Crear perfiles de facturación
`UPDATE_PROFILES`	Editar perfiles de facturación
`DELETE_PROFILES`	Eliminar perfiles de facturación
`IMPORT_BACKUP`	Importar copia de seguridad (restaurar)
`EXPORT_BACKUP`	Exportar copia de seguridad
`COPY_INVENTORY`	Copiar inventario entre sucursales (stock llega en 0)
`MOVE_INVENTORY`	Mover inventario entre sucursales (transfiere stock y lotes)
`DELETE_INVENTORY`	Eliminar inventario de una sucursal (productos, lotes y stock)
`BULK_UPLOAD`	Carga masiva de productos (imágenes, Excel, lotes)

Ejemplo de datos:

Nombre	Descripcion	Permisos
Administrador	Acceso total	ventas.create,config.edit
Cajero	Solo ventas y caja	ventas.create,stock.read
Gerente	Lectura general	metricas.read,reportes.read

Reglas de validación:

Si el rol ya existe por nombre, se actualiza con los nuevos datos.

Si no existe, se crea automáticamente.

Los permisos son códigos como ventas.create, stock.read, config.edit.

Errores comunes:

Si se escribe un permiso inválido, simplemente se ignora ese permiso.

Los permisos deben seguir el formato: modulo.accion (ej: ventas.create).

1.2 Empresas.xlsx

Archivo: Empresas.xlsx Nivel: Level 1 | Dependencias: Ninguna

Define las empresas del sistema

Columnas: Empresa_Email, Empresa_Nombre, Empresa_Direccion, Empresa_Telefono, Empresa_CUIT

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Empresa_Email	Texto	No	Email de contacto	contacto@miempresa.com	Correo electrónico de contacto. Se usa para notificaciones del sistema y facturación electrónica.
Empresa_Nombre	Texto	SÍ	Nombre de la empresa	Mi Empresa SA	Razón social o nombre comercial. Identificador principal del negocio en el sistema.
Empresa_Direccion	Texto	No	Dirección fiscal	Calle Falsa 123	Dirección fiscal de la empresa. Se incluye en las facturas electrónicas emitidas.
Empresa_Telefono	Texto	No	Teléfono	+54 9 261 1234567	Teléfono de contacto de la empresa. Dato complementario en reportes.
Empresa_CUIT	Texto	No	CUIT (XX-XXXXXXXX-X)	30-12345678-9	Clave Única de Identificación Tributaria. Requerido para facturación electrónica ante AFIP.

Ejemplo de datos:

Empresa_Email	Empresa_Nombre	Empresa_Direccion	Empresa_Telefono	Empresa_CUIT
contacto@miempresa.com	Mi Empresa SA	Calle Falsa 123	+54 9 261 1234567	30-12345678-9

Reglas de validación:

Si el usuario no tiene empresa, se crea automáticamente con estos datos.

Si ya tiene empresa, los datos se actualizan (merge).

Solo se importa la primera fila del Excel.

Errores comunes:

Si no hay nombre de empresa y el usuario no tiene empresa, el restore falla.

1.3 Sucursales.xlsx

Archivo: Sucursales.xlsx Nivel: Level 1 | Dependencias: Empresas

Define las sucursales de cada empresa

Columnas: Sucursal_Nombre, Sucursal_Ubicacion, Sucursal_PtoVta, Sucursal_ID_MP

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Sucursal_Nombre	Texto	SÍ	Nombre único de sucursal	Sucursal Centro	Nombre único de la sucursal dentro de la empresa. Identifica cada punto de venta físico.
Sucursal_Ubicacion	Texto	No	Dirección física	Av. San Martín 123	Dirección física de la sucursal. Dato operativo para referencia interna.
Sucursal_PtoVta	Texto/Número	No	Número de punto de venta AFIP	001	Número de punto de venta asignado por AFIP. Se usa en la numeración de facturas electrónicas.
Sucursal_ID_MP	Texto	No	ID de terminal MercadoPago	POS-12345	Identificador de la terminal MercadoPago asociada a esta sucursal para cobros con QR.
Empresa_Nombre	Texto	Info	Solo lectura (referencia a Empresas.xlsx)	Mi Empresa SA	Nombre de la empresa propietaria. Solo lectura informativa, se ignora en la importación.

Ejemplo de datos:

Sucursal_Nombre	Sucursal_Ubicacion	Sucursal_PtoVta	Sucursal_ID_MP
Sucursal Centro	Av. San Martín 123	0001	POS-12345
Sucursal Norte	Belgrano 456	0002	POS-67890

Reglas de validación:

La sucursal se vincula automáticamente a la empresa del usuario.

Si el nombre de sucursal está duplicado, se sobrescribe.

La columna Empresa_Nombre es informativa.

Errores comunes:

Si no hay nombre de sucursal, la fila se ignora.

1.4 Usuarios.xlsx

Archivo: Usuarios.xlsx Nivel: Level 1 | Dependencias: Roles, Sucursales

Usuarios del sistema con sus datos personales, rol y sucursales

Columnas: Usuario, Email, Nombre, Apellido, Password, Email_Verificado, Rol, Sucursales

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Usuario	Texto	SÍ	Username único	jperez	Nombre de usuario único para iniciar sesión en el sistema. Debe ser distinto para cada persona.
Email	Texto	No	Email válido	juan@email.com	Correo electrónico del usuario. Se usa para recuperación de contraseña y notificaciones.
Nombre	Texto	No	Nombre	Juan	Nombre de pila del usuario. Se muestra en la interfaz y reportes.
Apellido	Texto	No	Apellido	Pérez	Apellido del usuario. Complementa la identificación en el sistema.
Password	Texto	No	Hash bcrypt (dejar vacío para default '123456')	$2b$10$...	Contraseña hasheada con bcrypt. Si se deja vacío, se asigna automáticamente la contraseña por defecto.
Email_Verificado	Booleano	No	SI / NO	SI	Indica si el correo electrónico del usuario fue verificado mediante el enlace de confirmación.
Edad	Número	No	Entero positivo	35	Edad del usuario. Dato complementario del perfil sin impacto funcional.
Ciudad	Texto	No	Ciudad	Mendoza	Ciudad de residencia del usuario. Dato complementario del perfil.
Pais	Texto	No	País	Argentina	País de residencia del usuario. Dato complementario del perfil.
Genero	Texto	No	Texto libre	Masculino	Género del usuario. Dato complementario del perfil sin impacto funcional.
Rol	Texto	No	Nombre de rol existente en Roles.xlsx	Administrador	Rol asignado al usuario. Determina los permisos y accesos que tendrá dentro del sistema.
Sucursales	Lista (coma)	No	Nombres de sucursales existentes	Sucursal Centro, Sucursal Oeste	Lista de sucursales a las que el usuario tiene acceso. Determina en qué puntos de venta puede operar.

Ejemplo de datos:

Usuario	Email	Nombre	Apellido	Password	Email_Verificado	Rol	Sucursales
jperez	juan@email.com	Juan	Pérez	$2b$10$...	SI	Administrador	Sucursal Centro
mgarcia	maria@email.com	María	García	NO	Cajero	Sucursal Norte

Reglas de validación:

Si el usuario ya existe por username, se actualiza.

Si es nuevo, se crea con contraseña por defecto 123456.

El rol debe existir previamente en Roles.xlsx.

Las sucursales deben existir previamente en Sucursales.xlsx.

Errores comunes:

Si el rol no existe, el usuario se crea sin rol asignado.

Si una sucursal no existe, se ignora esa sucursal del usuario.

El username debe ser único en todo el sistema.

1.5 Configuracion.xlsx

Archivo: Configuracion.xlsx Nivel: Level 1 | Dependencias: Ninguna

Configuración general de la empresa (intereses, recargos, facturación)

Columnas: Alias, Interes_Deudor, Recargo_Deudor, Facturar_Siempre

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Alias	Texto	No	Identificador de configuración	default	Identificador único de la configuración. Permite tener múltiples perfiles (por sucursal, por tipo de operación).
Interes_Deudor	Número	No	Porcentaje (0-100)	5.5	Porcentaje de interés mensual que se aplica automáticamente a las deudas de clientes.
Recargo_Deudor	Número	No	Porcentaje (0-100)	2.0	Porcentaje de recargo adicional que se aplica a las deudas vencidas de clientes.
Facturar_Siempre	Booleano	No	SI / NO	SI	Determina si cada venta debe generar obligatoriamente una factura electrónica, incluso para consumidor final.
Categoria	Texto	No	Categoría de configuración	General	Categoría para agrupar perfiles de configuración similares. Dato organizativo sin impacto funcional.
Empresa	Texto	Info	Solo lectura, se ignora	Mi Empresa SA	Nombre de la empresa asociada a esta configuración. Solo lectura, se ignora en la importación.

Ejemplo de datos:

Alias	Interes_Deudor	Recargo_Deudor	Facturar_Siempre
default	5.5	2.0	SI
sucursal_norte	4.0	1.5	NO

Reglas de validación:

Se busca por company.id + Alias.

Si no existe, se crea una nueva configuración.

La columna Empresa se ignora en la importación.

Errores comunes:

Los porcentajes deben estar entre 0 y 100.

Los valores SI/NO deben estar en mayúsculas.

1.6 MercadoPago.xlsx

Archivo: MercadoPago.xlsx Nivel: Level 1 | Dependencias: Ninguna

Credenciales de integración con MercadoPago

Columnas: Token_TG, Hereditario, Alias, Categoria

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Token_TG	Texto	SÍ	Token de acceso TG de MercadoPago	TG-abc123...	Token de acceso de MercadoPago. Se usa para autenticar las operaciones de cobro con la API de MP.
Hereditario	Booleano	No	SI / NO	NO	Indica si esta credencial se hereda automáticamente a las sucursales sin token propio.
Alias	Texto	No	Identificador de la credencial	mp-principal	Identificador legible de la credencial para referencia interna y asignación a cajas.
Categoria	Texto	No	Categoría de la credencial	Producción	Categoría de la credencial para distinguir entornos (ej: Producción vs Testing).
Empresa	Texto	Info	Solo lectura, se ignora	Mi Empresa SA	Nombre de la empresa asociada. Solo lectura informativa, se ignora en la importación.

Ejemplo de datos:

Token_TG	Hereditario	Alias	Categoria
TG-abc123...	NO	mp-principal	Producción
TG-def456...	SI	mp-sucursal	Testing

Reglas de validación:

Se busca por company.id + Token_TG.

La columna Empresa se ignora.

Errores comunes:

El token TG debe comenzar con 'TG-'.

Si el token ya existe, se actualiza la configuración.

1.7 Cajas_Configuracion.xlsx

Archivo: Cajas_Configuracion.xlsx Nivel: Level 1 | Dependencias: Sucursales, Configuracion, MercadoPago, Arca

Configuración de cada caja/punto de venta

Columnas: Nombre_Caja, Sucursal, MP_POS_ID, Configuracion_General_Modo

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre_Caja	Texto	SÍ	Nombre único dentro de sucursal	Caja 1	Nombre único de la caja dentro de su sucursal. Identifica el punto de cobro en reportes y operaciones.
Sucursal	Texto	SÍ	Nombre de sucursal existente	Sucursal Centro	Sucursal a la que pertenece la caja. Debe existir previamente en Sucursales.xlsx.
MP_POS_ID	Texto	No	ID de terminal MercadoPago	POS-12345	Identificador de la terminal MercadoPago asociada a esta caja para procesar cobros con QR.
MP_POS_NAME	Texto	No	Nombre de terminal	Caja Principal	Nombre descriptivo de la terminal MercadoPago. Se muestra en la app de MP al cobrar.
Configuracion_General_Modo	Texto	No	subsidiary o checkout	subsidiary	Modo de operación de la configuración general. Define si hereda la config de sucursal o usa una propia de caja.
Perfil_General_Nombre	Texto	No	Alias de configuración	default	Alias de la configuración general que aplica a esta caja. Debe existir en Configuracion.xlsx.
Configuracion_MP_Modo	Texto	No	subsidiary o checkout	subsidiary	Modo de operación de MercadoPago. Define si hereda la config de sucursal o usa una propia de caja.
Perfil_MP_Token	Texto	No	Token TG de MercadoPago	TG-abc123...	Token TG de MercadoPago asignado específicamente a esta caja. Debe existir en MercadoPago.xlsx.
Configuracion_AFIP_Modo	Texto	No	subsidiary o checkout	subsidiary	Modo de operación de AFIP. Define si hereda la config de sucursal o usa una propia de caja.
Perfil_AFIP_Alias	Texto	No	Alias de Arca configurado	arca-main	Alias de la configuración ARCA/AFIP asignada a esta caja. Debe existir en Arca.xlsx.

Ejemplo de datos:

Nombre_Caja	Sucursal	MP_POS_ID	Configuracion_General_Modo
Caja 1	Sucursal Centro	POS-12345	subsidiary
Caja 2	Sucursal Norte	POS-67890	checkout

Reglas de validación:

Se busca por Nombre_Caja + Sucursal.

Los perfiles referenciados deben existir en sus respectivos Excels.

La sucursal debe existir en Sucursales.xlsx.

Errores comunes:

Si la sucursal no existe, la caja se omite.

Si un perfil no existe, ese campo queda vacío.

El nombre de caja debe ser único dentro de cada sucursal.

1.8 Cajas_Metricas.xlsx

Archivo: Cajas_Metricas.xlsx Nivel: Level 1 | Dependencias: Sucursales, Cajas_Configuracion

Umbrales de alerta para métricas de caja

Columnas: Alcance, Objetivo_Nombre, Alerta_Discrepancia, Critico_Discrepancia

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Alcance	Texto	No	BRANCH / CHECKOUT	BRANCH	Define el nivel de aplicación de las métricas: a toda la sucursal (BRANCH) o a una caja específica (CHECKOUT).
Objetivo_Nombre	Texto	No	Nombre de caja (si alcance=CHECKOUT)	Caja 1	Nombre de la caja cuando el alcance es CHECKOUT. Debe coincidir con una caja en Cajas_Configuracion.xlsx.
Objetivo_ID	Número	No	ID numérico del objetivo	1	Identificador numérico del objetivo (sucursal o caja). Solo lectura informativa en el backup.
Alerta_Discrepancia	Número	No	Porcentaje de alerta	5.0	Porcentaje de discrepancia que activa una alerta de advertencia en el arqueo de caja.
Critico_Discrepancia	Número	No	Porcentaje crítico	10.0	Porcentaje de discrepancia que activa una alerta crítica. Indica una diferencia grave en el arqueo.
Alerta_Valor_Cero	Número	No	Valor numérico umbral	0	Umbral para alertar cuando el valor de ventas es cero en un período determinado.
Alerta_Ops_Internas	Número	No	Cantidad de operaciones	50	Cantidad máxima de operaciones internas (depósitos/retiros) antes de generar una alerta.
Alerta_Picos_Actividad	Número	No	Cantidad pico	100	Cantidad de operaciones que define un pico de actividad inusual y genera una alerta de monitoreo.

Ejemplo de datos:

Alcance	Objetivo_Nombre	Alerta_Discrepancia	Critico_Discrepancia
BRANCH	—	5.0	10.0
CHECKOUT	Caja 1	3.0	7.0

Reglas de validación:

Si Alcance es CHECKOUT, se busca la caja por Objetivo_Nombre.

Si Alcance es BRANCH, aplica a toda la sucursal.

Errores comunes:

El alcance debe ser BRANCH o CHECKOUT (en mayúsculas).

Si CHECKOUT pero la caja no existe, se ignora la métrica.

Módulo 2: Catálogo

Productos, categorías e impuestos

Archivos: 7

2.1 Impuestos.xlsx

Archivo: Impuestos.xlsx Nivel: Level 2 | Dependencias: Sucursales

Definición de impuestos y tributos

Columnas: Nombre, Valor, Tributo, Hereditario

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre único del impuesto	IVA 21%	Nombre único del impuesto. Se usa para vincularlo a categorías y productos.
Valor	Número	No	Porcentaje o monto fijo	21.0	Valor del impuesto expresado como porcentaje. Se aplica sobre el precio de venta para calcular el precio final.
Tributo	Texto	No	Tipo de tributo AFIP o null	Nacional	Clasificación del tributo según AFIP. Determina cómo se informa en la factura electrónica.
Hereditario	Booleano	No	SI / NO	NO	Indica si este impuesto se hereda automáticamente a todas las sucursales de la empresa.
Editable	Booleano	No	SI / NO	SI	Determina si el impuesto puede ser modificado por el usuario desde la interfaz del sistema.
Sucursales	Lista (coma)	No	Nombres de sucursales	Sucursal Centro, Sucursal Oeste	Lista de sucursales donde aplica este impuesto. Si se deja vacío, aplica a todas.

Ejemplo de datos:

Nombre	Valor	Tributo	Hereditario
IVA 21%	21.0	Nacional	NO
IVA 10.5%	10.5	Nacional	NO
Impuesto Interno	10.0	Provincial	SI

Reglas de validación:

Se busca por Nombre. Si existe, se actualiza.

Si no existe, se crea un nuevo impuesto.

Errores comunes:

El valor del impuesto debe ser un número positivo.

Si se duplica el nombre, se sobrescribe el impuesto anterior.

2.2 Categorias.xlsx

Archivo: Categorias.xlsx Nivel: Level 2 | Dependencias: Impuestos, Sucursales

Categorías de productos con sus impuestos

Columnas: Nombre, Hereditario, Impuestos, Sucursales

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre único de categoría	Bebidas	Nombre único de la categoría. Los productos se agrupan bajo una categoría para organizar el catálogo.
Hereditario	Booleano	No	SI / NO	SI	Indica si la categoría y sus impuestos se heredan automáticamente a todas las sucursales.
Impuestos	Lista (coma)	No	Nombres de impuestos existentes	IVA 21%, Impuesto Interno	Lista de impuestos que aplican a todos los productos de esta categoría. Deben existir en Impuestos.xlsx.
Sucursales	Lista (coma)	No	Nombres de sucursales	Sucursal Centro	Lista de sucursales donde está disponible esta categoría. Si se deja vacío, aplica a todas.

Ejemplo de datos:

Nombre	Hereditario	Impuestos	Sucursales
Bebidas	SI	IVA 21%	Sucursal Centro
Snacks	SI	IVA 21%	Sucursal Centro
Lácteos	SI	IVA 10.5%	Sucursal Norte

Reglas de validación:

Elimina y recrea todos los vínculos de impuestos en cada importación.

Los impuestos referenciados deben existir en Impuestos.xlsx.

Errores comunes:

Si un impuesto no existe, simplemente no se vincula.

Los vínculos anteriores se reemplazan completamente.

2.3 Productos.xlsx

Archivo: Productos.xlsx Nivel: Level 2 | Dependencias: Categorias, Impuestos, Sucursales

Catálogo completo de productos con precios y códigos

Columnas: Nombre, Codigo_Barras, Categoria, Precio_Venta, Precio_Proveedor

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre del producto	Coca Cola 500ml	Nombre del producto tal como se muestra en el punto de venta y en los reportes.
Codigo_Barras	Texto	No	Código de barras único	7790001000015	Código de barras único del producto. Se usa para escanear en el punto de venta y como identificador principal.
Categoria	Texto	SÍ	Nombre de categoría existente	Bebidas	Categoría a la que pertenece el producto. Debe existir en Categorias.xlsx. Si no existe, el producto se omite.
Pesa_en_Balanza	Booleano	No	SI / NO	NO	Indica si el producto se pesa en balanza. Afecta cómo se registra la cantidad en el punto de venta.
Es_Especial	Booleano	No	SI / NO	NO	Marca el producto como especial. Los productos especiales pueden tener comportamiento diferenciado en promociones.
Utilidad	Número	No	Porcentaje de ganancia	30.0	Porcentaje de ganancia estimado sobre el costo. Se usa para métricas y análisis de rentabilidad.
Precio_Recomendado	Número	No	Precio en ARS	1500.00	Precio de venta recomendado por el proveedor o fabricante. Sirve como referencia para fijar el precio final.
Precio_Venta	Número	No	Precio en ARS	1400.00	Precio de venta base del producto antes de impuestos. Es el precio que se cobra en el punto de venta.
Precio_Final	Número	No	Precio en ARS (con impuestos)	1694.00	Precio final del producto con todos los impuestos incluidos. Es el precio que ve el cliente.
Precio_Proveedor	Número	No	Costo en ARS	900.00	Costo de compra del producto al proveedor. Se usa para calcular márgenes de ganancia.
Exento_IVA	Booleano	No	SI / NO	NO	Indica si el producto está exento de IVA. Afecta el cálculo de impuestos en la factura.
Seguimiento_Por_Lote	Booleano	No	SI / NO	NO	Indica si el producto requiere seguimiento por número de lote para control de vencimientos y trazabilidad.
Habilitado	Booleano	No	SI / NO (default: SI)	SI	Determina si el producto está activo y visible en el punto de venta. Productos deshabilitados no se pueden vender.
Impuestos	Lista (coma)	No	Nombres de impuestos existentes	IVA 21%	Lista de impuestos adicionales específicos del producto, más allá de los heredados de la categoría.
Sucursales	Lista (coma)	No	Nombres de sucursales	Sucursal Centro, Sucursal Oeste	Lista de sucursales donde está disponible el producto. Si se deja vacío, aplica a todas.

Ejemplo de datos:

Nombre	Codigo_Barras	Categoria	Precio_Venta	Precio_Proveedor
Coca Cola 500ml	7790001000015	Bebidas	1500.00	900.00
Pepsi 2L	7790002000021	Bebidas	2200.00	1400.00
Agua Mineral 500ml	7790003000038	Bebidas	800.00	500.00

Reglas de validación:

Se busca primero por Codigo_Barras, luego por Nombre.

Si la categoría no se encuentra, el producto se OMITE completamente.

Los impuestos referenciados deben existir en Impuestos.xlsx.

Errores comunes:

Si la categoría no existe, el producto NO se importa.

Si el código de barras ya existe, se sobrescribe el producto.

Los precios deben ser números positivos.

2.4 Promociones.xlsx

Archivo: Promociones.xlsx Nivel: Level 2 | Dependencias: Ninguna

Promociones activas con su configuración

Columnas: Nombre, Codigo, Tipo, Configuracion

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre de la promoción	2x1 Bebidas	Nombre descriptivo de la promoción. Se muestra en el punto de venta y en los reportes.
Codigo	Texto	SÍ	Código único de la promoción	PROMO-2X1-BEB	Código único que identifica la promoción en el sistema. Se usa para vincular productos y aplicar descuentos.
Tipo	Texto	No	Ver tabla de valores	DISCOUNT_DIRECT	Tipo de promoción que define la mecánica de descuento. Determina cómo se calcula el precio final.
Configuracion	JSON	No	JSON string con configuración	{"minQty":2,"discount":50}	Configuración de la promoción en formato JSON. Los parámetros varían según el tipo de promoción.

Valores posibles para "Tipo":

Valor	Descripción
`DISCOUNT_DIRECT`	Descuento directo sobre el precio final
`BUY_X_GET_Y`	Comprá X unidades y llevá Y gratis (ej: 2x1)
`BULK_PRICE`	Precio especial por compra al por mayor (ej: 3 unidades por $1000)
`COMBO`	Combination de productos a precio fijo (ej: hamburguesa + papas + gaseosa)
`GIFT`	Regalo gratis con compra (ej: comprá y llevá un producto gratis)
`DAY_OFFER`	Oferta válida solo un día específico
`TIERED_DISCOUNT`	Descuento escalonado según cantidad (ej: 1-5 un 10%, 6-10 un 20%)
`WEIGHT_RANGE`	Precio según rango de peso (ej: frutas/verduras por kg)

Ejemplo de datos:

Nombre	Codigo	Tipo	Configuracion
2x1 Bebidas	PROMO-2X1-BEB	2X1	{"minQty":2,"discount":50}
Descuento 10%	PROMO-DESC10	DESCUENTO	{"percent":10}

Reglas de validación:

Se busca por Codigo.

Configuracion debe ser JSON válido.

Errores comunes:

Si el JSON es inválido, la configuración queda vacía.

El código debe ser único en todo el sistema.

2.5 Cupones.xlsx

Archivo: Cupones.xlsx Nivel: Level 2 | Dependencias: Sucursales.xlsx (referencia opcional)

Cupones de descuento y regalo para clientes

Columnas: Codigo, Monto, Tipo, Motivo, Fecha_Expiracion, Estado, DNI, Nombre_Cliente, Email_Cliente, Sucursal

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Codigo	Texto	SÍ	Código XXX-XXX-XXX único por empresa	ABC-123-XYZ	Código alfanumérico de 9 caracteres con formato XXX-XXX-XXX. El cliente lo ingresa en el POS para aplicar el descuento.
Monto	Número	SÍ	Monto en ARS	100.00	Monto del cupón en pesos argentinos. Para cupones de descuento es el vuelto × multiplicador. Para regalos es el monto ingresado manualmente.
Tipo	Texto	SÍ	DESCUENTO / REGALO	DESCUENTO	DESCUENTO = cupón generado desde el POS como vuelto en efectivo. REGALO = cupón creado manualmente desde la ventana de cupones.
Motivo	Texto	No	Texto libre	Vuelto en efectivo	Motivo o razón del cupón. Para DESCUENTO es automáticamente 'Vuelto en efectivo'. Para REGALO es obligatorio y descriptivo.
Fecha_Expiracion	Fecha	SÍ	Formato ISO 8601	2026-12-31T23:59:59.000Z	Fecha y hora de vencimiento del cupón. Después de esta fecha, el cupón deja de ser válido.
Estado	Texto	Info	ACTIVO / CANJEADO / VENCIDO / ANULADO	ACTIVO	Estado calculado del cupón. Solo lectura en importación — se determina automáticamente por el sistema.
DNI	Texto	No	DNI del cliente	12345678	Documento del cliente destinatario. Solo informativo, se muestra al canjear el cupón.
Nombre_Cliente	Texto	No	Nombre completo	Juan Perez	Nombre del cliente destinatario. Solo informativo.
Email_Cliente	Texto	No	Email válido	juan@email.com	Email del cliente destinatario. Si se provee, se envía el cupón por email automáticamente.
Sucursal	Texto	No	Nombre de sucursal	Sucursal Centro	Sucursal donde se emitió el cupón. Solo lectura informativa, se ignora en la importación.

Ejemplo de datos:

Codigo	Monto	Tipo	Motivo	Fecha_Expiracion	Estado	DNI	Nombre_Cliente	Email_Cliente	Sucursal
ABC-123-XYZ	100.00	DESCUENTO	Vuelto en efectivo	2026-12-31T23:59:59.000Z	ACTIVO
DEF-456-UVM	500.00	REGALO	Cumpleaños	2027-06-30T23:59:59.000Z	ACTIVO	12345678	Juan Perez	juan@email.com	Sucursal Centro

Reglas de validación:

Se busca por Codigo + empresa.

La columna Estado se ignora (se calcula automáticamente).

La columna Sucursal se ignora (solo informativa).

El Tipo debe ser DESCUENTO o REGALO.

La Fecha_Expiracion debe estar en formato ISO 8601.

Errores comunes:

Si el cupón ya existe (mismo código en la empresa), se sobrescribe.

Código con formato inválido (debe ser XXX-XXX-XXX).

Tipo no válido (debe ser DESCUENTO o REGALO).

2.6 Descuentos.xlsx

Archivo: Descuentos.xlsx Nivel: Level 2 | Dependencias: Productos

Descuentos específicos por producto

Columnas: Producto, Valor

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Producto	Texto	SÍ	Nombre de producto existente	Coca Cola 500ml	Nombre del producto al que se aplica el descuento. Debe coincidir exactamente con el nombre en Productos.xlsx.
Valor	Número	No	Monto del descuento en ARS	200.00	Monto del descuento en pesos argentinos que se resta del precio del producto en el punto de venta.

Ejemplo de datos:

Producto	Valor
Coca Cola 500ml	200.00
Pepsi 2L	300.00

Reglas de validación:

Si el producto no existe, el descuento se OMITE.

El nombre del producto debe coincidir exactamente con Productos.xlsx.

Errores comunes:

Si hay un error de tipeo en el nombre, el descuento no se aplica.

El valor del descuento debe ser un número positivo.

2.7 Promociones_Productos.xlsx

Archivo: Promociones_Productos.xlsx Nivel: Level 2 | Dependencias: Promociones, Productos

Vincula productos a promociones

Columnas: Promocion_Nombre, Producto_Codigo_Barras, Promocion_ID, Producto_Nombre

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Promocion_Nombre	Texto	SÍ	Nombre de promoción existente	2x1 Bebidas	Nombre de la promoción a la que se vincula el producto. Debe existir en Promociones.xlsx.
Producto_Codigo_Barras	Texto	SÍ	Código de barras del producto	7790001000015	Código de barras del producto que participa en la promoción. Debe existir en Productos.xlsx.
Promocion_ID	Número	Info	Solo lectura	1	Identificador numérico interno de la promoción. Solo lectura, se incluye como referencia en el backup.
Producto_Nombre	Texto	Info	Solo lectura	Coca Cola 500ml	Nombre del producto vinculado. Solo lectura informativa para facilitar la revisión del archivo.
Producto_ID	Número	Info	Solo lectura	42	Identificador numérico interno del producto. Solo lectura, se incluye como referencia en el backup.

Ejemplo de datos:

Promocion_Nombre	Producto_Codigo_Barras	Promocion_ID	Producto_Nombre
2x1 Bebidas	7790001000015	1	Coca Cola 500ml
2x1 Bebidas	7790002000021	1	Pepsi 2L

Reglas de validación:

La promoción debe existir en Promociones.xlsx.

El producto debe existir en Productos.xlsx.

Las columnas *_ID y Producto_Nombre son informativas.

Errores comunes:

Si la promoción no existe, la vinculación se omite.

Si el código de barras no existe, la vinculación se omite.

Módulo 3: Inventario

Stock y movimientos de mercadería

Archivos: 4

3.1 Stock.xlsx

Archivo: Stock.xlsx Nivel: Level 2 | Dependencias: Productos, Sucursales

Stock de productos por sucursal

Columnas: Codigo_Barras, Producto, Sucursal, Cantidad, Precio_Especifico

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Codigo_Barras	Texto	No	Código de barras del producto	7790001000015	Código de barras del producto. Se usa como identificador principal; si no se proporciona, se busca por nombre.
Producto	Texto	No	Nombre de producto	Coca Cola 500ml	Nombre del producto. Se usa como identificador secundario si no se proporciona código de barras.
Sucursal	Texto	SÍ	Nombre de sucursal existente	Sucursal Centro	Sucursal donde se registra el stock. El stock es independiente por sucursal.
Cantidad	Número	No	Cantidad en stock	150	Cantidad actual del producto en stock. Este valor sobrescribe el stock existente en la sucursal.
Precio_Especifico	Número	No	Precio en ARS para esta sucursal	1500.00	Precio de venta específico para esta sucursal. Permite tener precios diferentes por sucursal.
Habilitado	Booleano	No	SI / NO (default: SI)	SI	Determina si el producto está habilitado para la venta en esta sucursal específica.

Ejemplo de datos:

Codigo_Barras	Producto	Sucursal	Cantidad	Precio_Especifico
7790001000015	Coca Cola 500ml	Sucursal Centro	150	1500.00
7790002000021	Pepsi 2L	Sucursal Centro	80	2200.00
7790003000038	Agua Mineral 500ml	Sucursal Norte	300	800.00

Reglas de validación:

Se requiere al menos uno de Codigo_Barras o Producto.

Si se proporcionan ambos, se usa Codigo_Barras como prioridad.

Errores comunes:

Si no se proporciona ningún identificador, la fila se omite.

Si la sucursal no existe, el stock no se importa.

3.2 Movimientos_Y_Lotes.xlsx

Archivo: Movimientos_Y_Lotes.xlsx Nivel: Level 2 | Dependencias: Productos, Sucursales

Movimientos de stock (entradas, salidas, mermas)

Columnas: Producto, Sucursal, Tipo, Fecha, Cantidad

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Producto	Texto	SÍ	Nombre de producto	Coca Cola 500ml	Nombre del producto involucrado en el movimiento. Debe existir en Productos.xlsx.
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal donde se registró el movimiento de stock.
Tipo	Texto	SÍ	Ver tabla de valores	INGRESO	Clasificación del movimiento de stock. Determina si es una entrada, salida, ajuste o pérdida de mercadería.
Fecha	Fecha	SÍ	Formato ISO 8601	2026-06-15T10:30:00.000Z	Fecha y hora en que se realizó el movimiento de stock.
Cantidad	Número	No	Cantidad del movimiento	5	Cantidad de unidades movidas. Para ingresos es positiva, para egresos y mermas representa la cantidad perdida.
Motivo	Texto	No	Texto libre	Producto vencido	Motivo del movimiento. Útil para justificar ajustes y mermas ante auditorías.
Observaciones	Texto	No	Texto libre	Lote 2024-A	Observaciones adicionales sobre el movimiento. Se puede usar para notas internas.
Stock_Anterior	Número	No	Cantidad antes del movimiento	155	Cantidad en stock antes de aplicar el movimiento. Informativo, el sistema lo calcula automáticamente.
Stock_Posterior	Número	No	Cantidad después del movimiento	150	Cantidad en stock después de aplicar el movimiento. Informativo, el sistema lo calcula automáticamente.
Usuario	Texto	No	Username existente	jperez	Usuario que registró el movimiento. Debe existir en Usuarios.xlsx.

Valores posibles para "Tipo":

Valor	Descripción
`INGRESO`	Entrada de mercadería al stock (compra, devolución, etc.)
`EGRESO`	Salida de mercadería del stock (venta, transferencia, etc.)
`AJUSTE`	Ajuste manual de stock (corrección de conteo, etc.)
`MERMA_PERDIDA`	Pérdida o merma de mercadería (vencimiento, rotura, etc.)

Ejemplo de datos:

Producto	Sucursal	Tipo	Fecha	Cantidad
Coca Cola 500ml	Sucursal Centro	MERMA_PERDIDA	2026-06-15	5
Pepsi 2L	Sucursal Norte	COMPRA	2026-06-14	100

Reglas de validación:

Siempre CREA registros nuevos (nunca actualiza).

Si Tipo es MERMA_PERDIDA, crea un StockLoss.

Cualquier otro valor de Tipo crea un StockMovement.

Errores comunes:

Si el producto no existe, el movimiento se omite.

La fecha debe estar en formato ISO 8601.

Siempre se crean nuevos registros, no se actualizan.

3.3 Lotes_Productos.xlsx

Archivo: Lotes_Productos.xlsx Nivel: Level 2 | Dependencias: Productos, Sucursales

Lotes de productos con cantidades y vencimientos

Columnas: Producto, Numero_Lote, Cantidad_Total, Fecha_Vencimiento

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Producto	Texto	SÍ	Nombre de producto	Coca Cola 500ml	Nombre del producto asociado al lote. Debe existir en Productos.xlsx.
Numero_Lote	Texto	SÍ	Identificador único de lote	LOT-2026-001	Número o código único que identifica el lote. Se usa para trazabilidad y control de vencimientos.
Cantidad_Total	Número	No	Cantidad total del lote	500	Cantidad total de unidades recibidas en este lote al momento de la compra.
Cantidad_Disponible	Número	No	Cantidad disponible	450	Cantidad de unidades que aún están disponibles para la venta de este lote.
Ganancias	Número	No	Monto en ARS	50000.00	Ganancia total generada por las ventas de productos de este lote.
Precio_Compra_Lote	Número	No	Monto total de compra en ARS	450000.00	Monto total pagado por la compra completa del lote al proveedor.
Precio_Unitario_Compra	Número	No	Precio unitario en ARS	900.00	Precio de compra por unidad. Se usa para calcular el costo y los márgenes de ganancia.
Fecha_Vencimiento	Fecha	No	ISO 8601	2027-06-15T00:00:00.000Z	Fecha de vencimiento del lote. Los productos vencidos no deberían venderse.
Fecha_Creacion	Fecha	No	ISO 8601	2026-01-15T00:00:00.000Z	Fecha en que se creó el registro del lote en el sistema.
Sucursales	Lista (coma)	No	Nombres de sucursales	Sucursal Centro, Sucursal Oeste	Lista de sucursales donde está distribuido el stock de este lote.

Ejemplo de datos:

Producto	Numero_Lote	Cantidad_Total	Fecha_Vencimiento
Coca Cola 500ml	LOT-2026-001	500	2027-06-15
Pepsi 2L	LOT-2026-002	300	2027-03-10

Reglas de validación:

El producto debe existir en Productos.xlsx.

El número de lote debe ser único.

Errores comunes:

Si el producto no existe, el lote se omite.

Las fechas deben estar en formato ISO 8601.

3.4 Categorias_Movimientos.xlsx

Archivo: Categorias_Movimientos.xlsx Nivel: Level 2 | Dependencias: Ninguna

Categorías para clasificar movimientos de caja

Columnas: Nombre, Descripcion

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Nombre	Texto	SÍ	Nombre único de categoría	Gastos Operativos	Nombre único de la categoría de movimiento. Se usa para clasificar ingresos y egresos en el libro mayor.
Descripcion	Texto	No	Texto libre	Luz, agua, alquiler	Descripción detallada de qué tipo de movimientos agrupa esta categoría.

Ejemplo de datos:

Nombre	Descripcion
Gastos Operativos	Luz, agua, alquiler
Compras Mercadería	Reposición de stock

Reglas de validación:

Si el nombre ya existe, se actualiza la descripción.

Errores comunes:

El nombre debe ser único en todo el sistema.

Módulo 4: Deudores

Clientes con cuenta corriente

Archivos: 1

4.1 Deudores.xlsx

Archivo: Deudores.xlsx Nivel: Level 3-4 | Dependencias: Productos (Level 3 base, Level 4 historial)

Clientes con deudas y pagos (se procesa en 2 pasadas)

Columnas: Deudor_Nombre, Deudor_DNI, Deuda_Total_Actual, Movimiento_Tipo

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Deudor_Nombre	Texto	SÍ	Nombre del deudor	Juan Pérez	Nombre completo del cliente con deuda. Se usa como identificador principal del deudor en el sistema.
Deudor_DNI	Texto	No	DNI o CUIT	30123456	Documento Nacional de Identidad o CUIT del deudor. Se usa para identificarlo en facturas y reportes.
Deudor_Telefono	Texto	No	Teléfono	+54 9 261 1234567	Teléfono de contacto del deudor. Útil para gestiones de cobranza.
Deudor_Direccion	Texto	No	Dirección	Calle Falsa 123	Dirección física del deudor. Se incluye en las facturas electrónicas.
Deudor_Ciudad	Texto	No	Ciudad	Mendoza	Ciudad de residencia del deudor. Dato complementario para el perfil del cliente.
Deuda_Total_Actual	Número	No	Monto total adeudado en ARS	15000.00	Monto total que el deudor debe actualmente. Incluye capital, intereses y recargos.
Limite_Maximo	Número	No	Límite de crédito en ARS	50000.00	Límite máximo de crédito permitido para este deudor. Ventas a cuenta corriente no pueden superar este monto.
Condicion_IVA	Texto	No	Ver tabla de valores	CONSUMIDOR_FINAL	Condición fiscal del deudor ante AFIP. Determina el tipo de factura que se emite.
Habilitado	Booleano	No	SI / NO	SI	Determina si el deudor está activo. Deudores deshabilitados no pueden realizar nuevas compras a cuenta corriente.
Cargo	Número	No	Monto en ARS	500.00	Cargo fijo mensual que se aplica a la cuenta del deudor independientemente de su saldo.
Cargos_Extra	Número	No	Monto en ARS	200.00	Cargos adicionales por mora o gestiones de cobranza que se suman a la deuda.
Recargo	Número	No	Porcentaje de recargo	5.0	Porcentaje de recargo personalizado para este deudor. Sobrescribe el recargo de la configuración general.
Empresa	Texto	Info	Solo lectura (referencia a Empresas.xlsx)	Mi Empresa SA	Nombre de la empresa a la que pertenece el deudor. Solo lectura informativa.
Movimiento_Tipo	Texto	SÍ	Deuda / Compra, Pago Recibido, Calculo_Interes_Mensual, Base, Sin Historial	Deuda / Compra	Clasifica el tipo de registro en el historial: deuda original, pago recibido, cálculo de interés o registro base sin historial.
Monto_Original	Número	No	Monto original en ARS	5000.00	Monto original de la deuda o del pago antes de aplicar intereses, descuentos o asignaciones.
Saldo_Pendiente	Número	No	Saldo pendiente en ARS	3000.00	Saldo que aún queda por pagar de esta deuda específica después de aplicar los pagos recibidos.
Fecha_Vencimiento	Fecha	No	ISO 8601	2026-07-15T00:00:00.000Z	Fecha límite para el pago de la deuda. Después de esta fecha se pueden aplicar recargos por mora.
Completamente_Pagado	Booleano	No	SI / NO	NO	Indica si la deuda fue completamente saldada. Las deudas pagadas no generan más intereses.
Pagado_Total	Número	No	Monto pagado en ARS	2000.00	Monto total que se ha pagado hasta el momento sobre esta deuda.
Referencia_Venta	Texto	No	ID de venta en Finanzas_Y_Ventas	VENTA-001	Identificador de la venta que originó esta deuda. Permite trazabilidad entre ventas y cuentas corrientes.
Fecha	Fecha	No	ISO 8601	2026-06-01T00:00:00.000Z	Fecha en que se registró el movimiento (compra, pago o cálculo de interés).
Asignado_Interes	Número	No	Monto en ARS	100.00	Porción del pago que se asignó al pago de intereses acumulados de la deuda.
Asignado_Capital	Número	No	Monto en ARS	500.00	Porción del pago que se asignó al pago del capital original de la deuda.
Asignado_Monto_Total	Número	No	Monto total en ARS	600.00	Monto total asignado en esta operación de pago (capital + intereses).
Asignado_Referencia_Deuda	Texto	No	ID de deuda en Deudores.xlsx	42	Identificador de la deuda específica a la que se asignó este pago. Permite conciliar pagos con deudas.
Metodo_Pago	Texto	No	Ver tabla de valores	efectivo	Medio de pago utilizado por el deudor para saldar su deuda.

Valores posibles para "Condicion_IVA":

Valor	Descripción
`RESPONSABLE_INSCRIPTO (1)`	Responsable Inscripto — factura con IVA. Para empresas grandes.
`SUJETO_EXENTO (4)`	Sujeto Exento — no paga IVA. Utilidades públicas, salud, educación.
`CONSUMIDOR_FINAL (5)`	Consumidor Final — persona común que compra para uso personal.
`MONOTRIBUTO (6)`	Monotributista — pago fijo mensual simplificado. Micro y pequeños negocios.
`MONOTRIBUTISTA_SOCIAL (13)`	Monotributista Social — categoría especial con beneficios para emprendedores.

Valores posibles para "Metodo_Pago":

Valor	Descripción
`efectivo`	Pago en dinero en efectivo
`tarjeta`	Pago con tarjeta de débito o crédito
`transferencia`	Transferencia bancaria o depósito

Ejemplo de datos:

Deudor_Nombre	Deudor_DNI	Deuda_Total_Actual	Movimiento_Tipo
Juan Pérez	30123456	15000.00	Deuda / Compra
María López	27654321	8500.00	Pago Recibido

Reglas de validación:

Pass 1: Crea/actualiza la base del deudor.

Pass 2: Agrega el historial de movimientos.

Los tipos Base y Sin Historial se ignoran.

Referencia_Venta debe coincidir con una venta en Finanzas_Y_Ventas.

Errores comunes:

Si el tipo de movimiento es inválido, la fila se omite.

Si la referencia de venta no existe, el movimiento se ignora.

Deudor_Nombre es requerido en ambas pasadas.

Módulo 5: ARCA/AFIP

Facturación electrónica

Archivos: 3

5.1 Arca.xlsx

Archivo: Arca.xlsx Nivel: Level 1 | Dependencias: Ninguna

Configuración de conexión con ARCA para facturación electrónica

Columnas: CUIT, Certificado, Llave, Alias

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
CUIT	Texto	SÍ	CUIT con guiones	30-12345678-9	CUIT de la empresa para facturación electrónica. Debe coincidir con el registrado en AFIP.
Certificado	Texto	No	Contenido del certificado PEM	-----BEGIN CERTIFICATE-----...	Certificado digital PEM emitido por AFIP para firmar electrónicamente los comprobantes.
Llave	Texto	No	Contenido de la llave privada PEM	-----BEGIN PRIVATE KEY-----...	Llave privada PEM asociada al certificado. Se usa junto con el certificado para la firma digital.
Estado_Sincronizacion	Texto	No	Estado de sincronización	PENDING	Estado actual de la sincronización con los servidores de ARCA/AFIP para facturación electrónica.
Hereditario	Booleano	No	SI / NO	NO	Indica si esta configuración ARCA se hereda automáticamente a las sucursales sin configuración propia.
Alias	Texto	No	Identificador de la configuración	arca-main	Identificador legible de la configuración ARCA. Se referencia desde Cajas_Configuracion.xlsx.
Categoria	Texto	No	Categoría	Producción	Categoría de la configuración para distinguir entornos (ej: Producción vs Homologación).
Empresa	Texto	Info	Solo lectura, se ignora	Mi Empresa SA	Nombre de la empresa asociada. Solo lectura informativa, se ignora en la importación.

Ejemplo de datos:

CUIT	Certificado	Llave	Alias
30-12345678-9	-----BEGIN...	-----BEGIN...	arca-main

Reglas de validación:

Se busca por company.id + Alias.

La columna Empresa se ignora.

Errores comunes:

El CUIT debe tener formato XX-XXXXXXXX-X.

Los certificados PEM deben ser válidos.

5.2 Facturas_AFIP.xlsx

Archivo: Facturas_AFIP.xlsx Nivel: Level 1 | Dependencias: Ninguna

Comprobantes emitidos ante ARCA/AFIP

Columnas: Comprobante_Nro, Comprobante_Tipo, Total, CAE

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Comprobante_Nro	Número	SÍ	Número de comprobante	1	Número del comprobante dentro del punto de venta. Junto con PtoVta y tipo forma el identificador único fiscal.
Comprobante_Tipo	Número	SÍ	Ver tabla de valores	6	Código de tipo de comprobante según AFIP. Determina si es Factura A, B, C, Nota de Crédito, etc.
PtoVta	Número	No	Punto de venta	1	Número de punto de venta asignado por AFIP. Identifica la sucursal que emitió el comprobante.
Concepto	Número	No	1=Productos, 2=Servicios, 3=Ambos	1	Concepto del comprobante según AFIP. Define si la factura es por productos, servicios o ambos.
Documento_Tipo	Número	No	80=CUIT, 96=DNI, 99=Cons.Final	99	Código de tipo de documento del cliente (80=CUIT, 96=DNI, 99=Consumidor Final).
Documento_Nro	Número	No	Número de documento	30123456	Número de documento del cliente registrado en la factura.
Fecha	Texto	No	Fecha del comprobante	2026-06-15	Fecha de emisión del comprobante fiscal.
Total	Número	No	Monto total en ARS	1694.00	Importe total del comprobante incluyendo todos los impuestos.
Importe_Neto	Número	No	Monto neto en ARS	1400.00	Importe neto gravado del comprobante antes de impuestos.
Importe_IVA	Número	No	Monto IVA en ARS	294.00	Importe total de IVA discriminado en el comprobante.
CAE	Texto	No	CAE asignado por AFIP	12345678901234	Código de Autorización Electrónica asignado por AFIP. Valida la factura fiscalmente.
Vencimiento_CAE	Texto	No	Fecha vencimiento CAE	2026-06-25	Fecha de vencimiento del CAE. Después de esta fecha el comprobante pierde validez fiscal.
Moneda	Texto	No	Ver tabla de valores	PESOS	Moneda en la que está expresado el comprobante fiscal.
Anulado	Booleano	No	SI / NO	NO	Indica si el comprobante fue anulado mediante una nota de crédito o débito.
Cantidad_Registros	Número	No	Cantidad de registros del lote	1	Cantidad de comprobantes incluidos en el lote de facturación electrónica.
Comprobante_Desde	Número	No	Número desde	1	Número del primer comprobante en el lote de facturación.
Comprobante_Hasta	Número	No	Número hasta	1	Número del último comprobante en el lote de facturación.
Importe_Neto_No_Gravado	Número	No	Neto no gravado en ARS	0.00	Importe neto no gravado del comprobante (conceptos que no pagan IVA).
Importe_Exento	Número	No	Importe exento en ARS	0.00	Importe exento de impuestos en el comprobante.
Importe_Tributos	Número	No	Tributos en ARS	0.00	Importe total de otros tributos en el comprobante.
Cotizacion	Número	No	Cotización de moneda	1.00	Cotización de la moneda extranjera respecto al peso para facturas en moneda extranjera.
Anulado_Comprobante_Nro	Número	No	Nro comprobante de anulación	2	Número del comprobante de anulación (nota de crédito/débito) asociado.
Anulado_Comprobante_Tipo	Número	No	Tipo comprobante de anulación	211	Tipo de comprobante de anulación (ej: 211=Nota de Crédito A).
Anulado_Total	Número	No	Total del comprobante anulado en ARS	-1694.00	Importe total anulado. Suele ser negativo porque revierte el comprobante original.
Anulado_Importe_Neto	Número	No	Neto del anulado en ARS	-1400.00	Importe neto del comprobante de anulación.
Anulado_Importe_IVA	Número	No	IVA del anulado en ARS	-294.00	Importe de IVA del comprobante de anulación.
Anulado_Documento_Tipo	Número	No	Tipo doc del anulado	80	Tipo de documento del cliente en el comprobante de anulación.
Anulado_Documento_Nro	Número	No	Nro doc del anulado	30123456	Número de documento del cliente en el comprobante de anulación.

Valores posibles para "Comprobante_Tipo":

Valor	Descripción
`1`	Factura A (Responsable Inscripto, tributa IVA)
`2`	Factura B (Monotributista o exento)
`3`	Factura C (Consumidor Final)
`6`	Factura A por cuenta de orden
`7`	Factura B por cuenta de orden
`8`	Factura C por cuenta de orden
`11`	Factura A - exportación
`12`	Factura B - exportación
`13`	Factura C - exportación
`201`	Nota de Débito A
`202`	Nota de Débito B
`203`	Nota de Débito C
`211`	Nota de Crédito A
`212`	Nota de Crédito B
`213`	Nota de Crédito C

Valores posibles para "Moneda":

Valor	Descripción
`PESOS`	Pesos argentinos (default)
`USD`	Dólares estadounidenses

Ejemplo de datos:

Comprobante_Nro	Comprobante_Tipo	Total	CAE
1	6	1694.00	12345678901234
2	6	2420.00	98765432109876

Reglas de validación:

Si Anulado = SI, también crea registro en VoidedVouchers.

Comprobante_Tipo debe ser un código AFIP válido.

Errores comunes:

Si el tipo de comprobante es inválido, la factura se omite.

Si Anulado es SI, se crea automáticamente el registro de anulación.

5.3 Reembolsos.xlsx

Archivo: Reembolsos.xlsx Nivel: Level 2 | Dependencias: Finanzas_Y_Ventas, Sucursales

Notas de crédito y devoluciones sobre ventas

Columnas: Sucursal, Fecha, Venta_ID_Original, Monto_Devuelto

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal donde se realizó el reembolso o devolución.
Fecha	Fecha	SÍ	ISO 8601	2026-06-15T14:30:00.000Z	Fecha y hora en que se procesó el reembolso.
Venta_ID_Original	Texto	SÍ	ID de venta en Finanzas_Y_Ventas	VENTA-001	Identificador de la venta original que se está reembolsando. Debe existir en Finanzas_Y_Ventas.xlsx.
Usuario	Texto	No	Username del cajero	jperez	Usuario que procesó el reembolso. Debe existir en Usuarios.xlsx.
Monto_Devuelto	Número	No	Monto en ARS	1500.00	Monto total devuelto al cliente en pesos argentinos.
Razon	Texto	No	Texto libre	Producto defectuoso	Motivo del reembolso. Sirve para auditoría y análisis de devoluciones.
Metodo_Pago	Texto	No	Ver tabla de valores	Cash	Medio por el cual se devolvió el dinero al cliente.
CAE_Nota_Credito	Texto	No	CAE de la nota de crédito	98765432101234	Código de Autorización Electrónica de la nota de crédito fiscal emitida por el reembolso.
Productos_Devueltos	JSON	No	JSON array con productos	[{"producto":"Coca Cola","cantidad":2}]	Lista en formato JSON de los productos devueltos con sus cantidades.

Valores posibles para "Metodo_Pago":

Valor	Descripción
`Cash`	Efectivo
`Debtor`	Cuenta corriente / deudor
`Transfer`	Transferencia bancaria
`QrPrinted`	QR impreso de MercadoPago
`PostnetDebit`	Tarjeta de débito por Postnet
`PostnetCredit`	Tarjeta de crédito por Postnet
`PostnetQr`	QR por Postnet
`MP`	MercadoPago (app o link)
`DEBIT`	Tarjeta de débito (otro medio)
`CREDIT`	Tarjeta de crédito (otro medio)

Ejemplo de datos:

Sucursal	Fecha	Venta_ID_Original	Monto_Devuelto
Sucursal Centro	2026-06-15	VENTA-001	1500.00
Sucursal Norte	2026-06-14	VENTA-042	800.00

Reglas de validación:

Venta_ID_Original debe coincidir con una venta importada.

Si la venta no se encuentra, el reembolso se OMITE.

Errores comunes:

Si la referencia de venta no existe, el reembolso no se importa.

El JSON de Productos_Devueltos debe ser válido.

Módulo 6: Métricas

Estadísticas y reportes

Archivos: 3

6.1 Metricas.xlsx

Archivo: Metricas.xlsx Nivel: Level 2 | Dependencias: Sucursales

Métricas generales diarias por sucursal

Columnas: Fecha, Sucursal, Valor_Inventario, Ganancia_Promedio

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Fecha	Fecha	SÍ	ISO 8601	2026-06-15T00:00:00.000Z	Fecha del registro de métricas. Generalmente representa el cierre diario de la sucursal.
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal a la que corresponden las métricas.
Balance_Deudores	Número	No	Monto total deudores en ARS	150000.00	Saldo total de todas las cuentas corrientes de la sucursal al cierre del día.
Ganancia_Promedio	Número	No	Porcentaje promedio	25.5	Porcentaje de ganancia promedio sobre todas las ventas del día en la sucursal.
Valor_Inventario	Número	No	Valor total en ARS	5000000.00	Valor total del inventario a precio de costo en la sucursal al cierre del día.
Total_Productos_Vendidos	Número	No	Cantidad total	350	Cantidad total de unidades vendidas en la sucursal durante el día.
Valor_Venta_Promedio	Número	No	Promedio en ARS	8500.00	Valor promedio de cada venta individual en la sucursal durante el día.
Precio_Venta_Promedio	Número	No	Promedio en ARS	1200.00	Precio unitario promedio de los productos vendidos en la sucursal durante el día.

Ejemplo de datos:

Fecha	Sucursal	Valor_Inventario	Ganancia_Promedio
2026-06-15	Sucursal Centro	5000000.00	25.5
2026-06-15	Sucursal Norte	3200000.00	22.0

Reglas de validación:

Se busca por Fecha + Sucursal.

Si ya existe, se actualiza.

Errores comunes:

La fecha debe estar en formato ISO 8601.

La sucursal debe existir.

6.2 Metricas_Categorias.xlsx

Archivo: Metricas_Categorias.xlsx Nivel: Level 2 | Dependencias: Categorias, Sucursales

Ventas agrupadas por categoría y sucursal

Columnas: Fecha, Sucursal, Categoria_Nombre, Total_Ventas

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Fecha	Fecha	SÍ	ISO 8601	2026-06-15T00:00:00.000Z	Fecha del registro de métricas por categoría.
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal a la que corresponden las métricas por categoría.
Categoria_Nombre	Texto	SÍ	Nombre de categoría	Bebidas	Categoría de productos sobre la que se informan las ventas.
Total_Ventas	Número	No	Monto total en ARS	250000.00	Monto total vendido de productos de esta categoría en la sucursal durante el día.

Ejemplo de datos:

Fecha	Sucursal	Categoria_Nombre	Total_Ventas
2026-06-15	Sucursal Centro	Bebidas	250000.00
2026-06-15	Sucursal Centro	Snacks	120000.00

Reglas de validación:

Se busca por Fecha + Sucursal + Categoria_Nombre.

Errores comunes:

La categoría debe existir en Categorias.xlsx.

6.3 Metricas_Productos.xlsx

Archivo: Metricas_Productos.xlsx Nivel: Level 2 | Dependencias: Productos, Sucursales

Unidades vendidas y ganancias por producto

Columnas: Fecha, Sucursal, Producto_Codigo_Barras, Unidades_Vendidas, Ganancias

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Fecha	Fecha	SÍ	ISO 8601	2026-06-15T00:00:00.000Z	Fecha del registro de métricas por producto.
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal a la que corresponden las métricas por producto.
Producto_Codigo_Barras	Texto	SÍ	Código de barras	7790001000015	Código de barras del producto sobre el que se informan las métricas de venta.
Producto_Nombre	Texto	Info	Solo lectura (referencia a Productos.xlsx)	Coca Cola 500ml	Nombre del producto. Solo lectura informativa.
Unidades_Vendidas	Número	No	Cantidad	50	Cantidad total de unidades vendidas de este producto en la sucursal durante el día.
Valor_Ventas	Número	No	Monto en ARS	75000.00	Valor total de las ventas de este producto en la sucursal durante el día.
Costo	Número	No	Monto en ARS	45000.00	Costo total de las unidades vendidas (precio de compra × cantidad).
Ganancias	Número	No	Monto en ARS	30000.00	Ganancia total generada por este producto (valor de ventas menos costo).
Margen	Número	No	Porcentaje	40.0	Margen de ganancia porcentual del producto (ganancias / valor de ventas × 100).

Ejemplo de datos:

Fecha	Sucursal	Producto_Codigo_Barras	Unidades_Vendidas	Ganancias
2026-06-15	Sucursal Centro	7790001000015	50	30000.00
2026-06-15	Sucursal Centro	7790002000021	35	28000.00

Reglas de validación:

Se busca por Fecha + Sucursal + Producto_Codigo_Barras.

Errores comunes:

El código de barras debe existir en Productos.xlsx.

Módulo 7: Ventas/Finanzas

Historial de ventas y movimientos

Archivos: 1

7.1 Finanzas_Y_Ventas.xlsx

Archivo: Finanzas_Y_Ventas.xlsx Nivel: Level 2 | Dependencias: Sucursales, Cajas_Configuracion

Registro completo de operaciones financieras

Columnas: Tipo_Registro, Fecha, Sucursal, Venta_Total, Caja_Nombre

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Tipo_Registro	Texto	SÍ	INGRESO_EGRESO_MANUAL, VENTA, MOVIMIENTO_CAJA	VENTA	Clasificación principal del registro financiero. Determina cómo se procesa la fila en el sistema.
Fecha	Fecha	SÍ	ISO 8601	2026-06-15T10:30:00.000Z	Fecha y hora en que se realizó la operación financiera o venta.
Sucursal	Texto	SÍ	Nombre de sucursal	Sucursal Centro	Sucursal donde se registró la operación.
Caja_Nombre	Texto	Condicional	Nombre de caja (requerido para VENTA y MOVIMIENTO_CAJA)	Caja 1	Caja registradora donde se realizó la operación. Requerido para ventas, opcional para ingresos/egresos manuales.
Cajero	Texto	No	Username del cajero	jperez	Usuario que operó la caja o registró el movimiento.
Operacion_Caja	Texto	No	Ver tabla de valores	Sell	Tipo de operación realizada en la caja: apertura, cierre, venta, depósito o retiro.
Ledger_Categoria	Texto	No	Nombre de categoría de movimiento	Gastos Operativos	Categoría del movimiento en el libro mayor. Clasifica ingresos y egresos para reportes financieros.
Ledger_Tipo	Texto	No	Ver tabla de valores	INCOME	Tipo de movimiento contable: ingreso de dinero o egreso/gasto.
Ledger_Metodo_Pago	Texto	No	Ver tabla de valores	Cash	Medio de pago utilizado en el movimiento del libro mayor.
Ledger_Monto	Número	No	Monto en ARS	5000.00	Monto del movimiento en el libro mayor. Para ingresos es positivo.
Ledger_Moneda	Texto	No	Ver tabla de valores	PESOS	Moneda en la que está expresado el movimiento del libro mayor.
Venta_ID	Texto	No	Identificador único de venta	VENTA-001	Identificador único de la venta. Se usa como referencia en reembolsos y deudas.
Venta_Subtotal	Número	No	Subtotal en ARS	14000.00	Subtotal de la venta antes de impuestos y descuentos.
Venta_Total	Número	No	Total con impuestos en ARS	16940.00	Total final de la venta incluyendo todos los impuestos y descuentos aplicados.
Venta_Metodo_Pago	Texto	No	Ver tabla de valores	Cash	Medio de pago utilizado por el cliente para pagar la venta.
Producto_Nombre	Texto	No	Nombre de producto	Coca Cola 500ml	Nombre del producto vendido. Una venta puede tener múltiples filas, una por cada producto.
Producto_Cantidad	Número	No	Cantidad vendida	10	Cantidad de unidades vendidas de este producto en la transacción.
Producto_Precio	Número	No	Precio unitario en ARS	1500.00	Precio unitario al que se vendió el producto en esta transacción.
Producto_Descuento	Número	No	Descuento del producto en ARS	200.00	Descuento aplicado al producto por promociones u ofertas activas.
Producto_Descuento_Manual	Número	No	Descuento manual en ARS	50.00	Descuento adicional aplicado manualmente por el cajero sobre este producto.
Producto_Cantidad_Devuelta	Número	No	Cantidad devuelta	2	Cantidad de unidades de este producto que fueron devueltas por el cliente.
Ledger_Descripcion	Texto	No	Descripción del movimiento	Compra de mercadería	Descripción en texto libre del movimiento en el libro mayor.
Venta_Promociones	Texto	No	Códigos de promociones aplicadas	PROMO-2X1-BEB	Lista de códigos de promociones que se aplicaron a esta venta.
Cliente_Deudor	Texto	No	Nombre del deudor	Juan Pérez	Nombre del deudor cuando la venta se realizó a cuenta corriente.
Arqueo_Subtotal	Número	No	Subtotal del arqueo en ARS	14000.00	Subtotal registrado en el arqueo al cierre de caja, antes de impuestos.
Arqueo_Total	Número	No	Total del arqueo en ARS	16940.00	Total registrado en el arqueo al cierre de caja, incluyendo impuestos.
Arqueo_Diferencia	Número	No	Diferencia en ARS	0.00	Diferencia entre el dinero contado y el total esperado según el sistema al cierre de caja.
Arqueo_Cerrado	Booleano	No	SI / NO	SI	Indica si el arqueo de caja fue cerrado exitosamente al final del turno.
Fiscal_Impuestos	Número	No	Total impuestos en ARS	294.00	Monto total de impuestos (incluyendo IVA y otros) aplicados a la venta.
Fiscal_IVA	Número	No	Monto IVA en ARS	294.00	Monto total de IVA discriminado en la venta.
Fiscal_Neto_Gravado	Número	No	Neto gravado en ARS	1400.00	Base imponible sobre la que se calcula el IVA en la venta.
Fiscal_Neto_No_Gravado	Número	No	Neto no gravado en ARS	0.00	Porción del importe que no está gravada con IVA.
Fiscal_Exento_IVA	Número	No	Monto exento de IVA en ARS	0.00	Porción del importe exenta de IVA por condición fiscal del producto o cliente.
Fiscal_Otros_Impuestos	Número	No	Otros impuestos en ARS	0.00	Monto de otros impuestos aplicados a la venta.
Fiscal_Monto_Recargo	Número	No	Monto recargo en ARS	0.00	Monto de recargo adicional aplicado a la venta.
Fiscal_Vuelto	Número	No	Vuelto entregado en ARS	0.00	Monto del vuelto entregado al cliente cuando pagó con un importe mayor al total.
Fiscal_Lista_IVA	JSON	No	JSON con desglose de IVA	[{"rate":21,"amount":294}]	Desglose detallado del IVA en formato JSON con alícuotas y montos.
Fiscal_Lista_Impuestos	JSON	No	JSON con desglose de impuestos	[{"name":"IVA 21%","amount":294}]	Desglose detallado de todos los impuestos en formato JSON.

Valores posibles para "Operacion_Caja":

Valor	Descripción
`Open`	Apertura de caja — inicio del turno
`Close`	Cierre de caja — fin del turno
`Deposit`	Depósito de dinero en la caja
`Withdraw`	Retiro de dinero de la caja
`Sell`	Operación de venta

Valores posibles para "Ledger_Tipo":

Valor	Descripción
`INCOME`	Ingreso de dinero (venta, cobro, etc.)
`EXPENSE`	Egreso de dinero (gasto, compra, etc.)

Valores posibles para "Ledger_Metodo_Pago":

Valor	Descripción
`Cash`	Efectivo
`Debtor`	Cuenta corriente / deudor
`Transfer`	Transferencia bancaria
`QrPrinted`	QR impreso de MercadoPago
`PostnetDebit`	Tarjeta de débito por Postnet
`PostnetCredit`	Tarjeta de crédito por Postnet
`PostnetQr`	QR por Postnet
`MP`	MercadoPago (app o link)
`DEBIT`	Tarjeta de débito (otro medio)
`CREDIT`	Tarjeta de crédito (otro medio)

Valores posibles para "Ledger_Moneda":

Valor	Descripción
`PESOS`	Pesos argentinos (default)
`USD`	Dólares estadounidenses

Valores posibles para "Venta_Metodo_Pago":

Valor	Descripción
`Cash`	Efectivo
`Debtor`	Cuenta corriente / deudor
`Transfer`	Transferencia bancaria
`QrPrinted`	QR impreso de MercadoPago
`PostnetDebit`	Tarjeta de débito por Postnet
`PostnetCredit`	Tarjeta de crédito por Postnet
`PostnetQr`	QR por Postnet
`MP`	MercadoPago (app o link)
`DEBIT`	Tarjeta de débito (otro medio)
`CREDIT`	Tarjeta de crédito (otro medio)

Ejemplo de datos:

Tipo_Registro	Fecha	Sucursal	Venta_Total	Caja_Nombre
VENTA	2026-06-15	Sucursal Centro	16940.00	Caja 1
INGRESO_EGRESO_MANUAL	2026-06-15	Sucursal Centro	5000.00	—
MOVIMIENTO_CAJA	2026-06-15	Sucursal Centro	—	Caja 1

Reglas de validación:

Siempre CREA registros nuevos (nunca actualiza).

Las filas se agrupan por Fecha + Sucursal (manual) o Fecha + Caja_Nombre (otros).

Para INGRESO_EGRESO_MANUAL, Caja_Nombre no es requerido.

Errores comunes:

Si la sucursal no existe, el registro se omite.

Si la caja no existe para VENTA/MOVIMIENTO_CAJA, el registro se omite.

Los montos deben ser numéricos positivos.

Módulo 8: Proveedores

Proveedores y compras

Archivos: 3

8.1 Proveedores_E_Historial.xlsx

Archivo: Proveedores_E_Historial.xlsx Nivel: Level 1 | Dependencias: Ninguna

Proveedores con info base e historial financiero (2 pasadas)

Columnas: Proveedor_Nombre, Proveedor_CUIT, Monto_Total, Movimiento_Tipo

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Proveedor_Nombre	Texto	SÍ	Nombre del proveedor	Distribuidora XYZ	Nombre o razón social del proveedor. Identificador principal en el sistema.
Proveedor_CUIT	Texto	No	CUIT con guiones	30-98765432-1	CUIT del proveedor. Se usa para identificarlo en comprobantes fiscales y reportes.
Proveedor_Telefono	Texto	No	Teléfono	+54 9 261 7654321	Teléfono de contacto del proveedor para gestiones de compra.
Proveedor_Email	Texto	No	Email	ventas@xyz.com	Correo electrónico de contacto del proveedor para órdenes de compra.
Proveedor_Direccion	Texto	No	Dirección	Av. Industrial 456	Dirección fiscal o comercial del proveedor.
Proveedor_Ciudad	Texto	No	Ciudad	Mendoza	Ciudad donde se encuentra el proveedor. Dato complementario para logística.
Proveedor_Info_Adicional	Texto	No	Texto libre	Entrega lunes y jueves	Información adicional relevante sobre el proveedor (días de entrega, condiciones, etc.).
Movimiento_Tipo	Texto	SÍ	Compra / Deuda, Pago Realizado, Recepcion Mercaderia, Base, Sin Historial	Compra / Deuda	Clasifica el tipo de registro: compra a cuenta, pago realizado, recepción de mercadería o registro base.
Fecha	Fecha	SÍ	ISO 8601	2026-06-01T00:00:00.000Z	Fecha en que se registró la compra, el pago o la recepción de mercadería.
Monto_Total	Número	No	Monto total en ARS	500000.00	Monto total de la compra o del pago realizado al proveedor.
Monto_Pagado	Número	No	Monto pagado en ARS	300000.00	Monto acumulado que ya se ha pagado de esta compra específica.
Monto_Pendiente	Número	No	Monto pendiente en ARS	200000.00	Saldo que aún queda por pagar de esta compra al proveedor.
Producto_Detalle	Texto	No	Nombre de producto	Coca Cola 500ml	Nombre o descripción del producto incluido en la compra al proveedor.
Producto_Cantidad	Número	No	Cantidad	100	Cantidad de unidades compradas de este producto al proveedor.
Producto_Precio_Unitario	Número	No	Precio en ARS	900.00	Precio unitario de compra del producto. Se usa para actualizar el costo en el sistema.
Metodo_Pago	Texto	No	Ver tabla de valores	Cash	Medio de pago utilizado para pagar al proveedor.
Estado	Texto	No	Ver tabla de valores	OPEN	Estado del pago de la compra: abierta, parcialmente pagada o completamente saldada.
Estado_Recepcion	Texto	No	Ver tabla de valores	PENDING	Estado de la recepción física de la mercadería comprada.
Referencia_Pago	Texto	No	Referencia del pago	PAY-001	Código o referencia del pago realizado. Útil para conciliaciones bancarias.
Notas	Texto	No	Notas del pago o compra	Entrega programada	Notas u observaciones adicionales sobre la compra, el pago o la recepción.
Fecha_Vencimiento	Fecha	No	ISO 8601	2026-07-15T00:00:00.000Z	Fecha de vencimiento del pago de la compra al proveedor.
Proxima_Recepcion	Fecha	No	ISO 8601	2026-06-20T00:00:00.000Z	Fecha estimada para la próxima recepción de mercadería pendiente.
Tipo_Comprobante	Texto	No	Tipo de comprobante	Factura A	Tipo de comprobante fiscal recibido del proveedor (Factura A, B, C, etc.).
Numero_Comprobante	Texto	No	Número de comprobante	0001-00012345	Número del comprobante fiscal emitido por el proveedor.
Producto_Cantidad_Recibida	Número	No	Cantidad recibida	100	Cantidad de unidades efectivamente recibidas del producto.
Producto_Vencimiento	Fecha	No	ISO 8601	2027-06-15T00:00:00.000Z	Fecha de vencimiento del producto recibido. Relevante para productos perecederos.
Producto_Monto_Total	Número	No	Monto total del ítem en ARS	90000.00	Monto total del ítem (precio unitario × cantidad) dentro de la compra.
Asignado_Monto	Número	No	Monto asignado al pago en ARS	50000.00	Monto de este pago que se asignó específicamente a una compra determinada.
Asignado_Referencia_Compra	Texto	No	ID de compra referenciada	42	Identificador de la compra a la que se asignó este pago. Permite conciliar pagos con compras.

Valores posibles para "Metodo_Pago":

Valor	Descripción
`Cash`	Efectivo
`Debtor`	Cuenta corriente / deudor
`Transfer`	Transferencia bancaria
`QrPrinted`	QR impreso de MercadoPago
`PostnetDebit`	Tarjeta de débito por Postnet
`PostnetCredit`	Tarjeta de crédito por Postnet
`PostnetQr`	QR por Postnet
`MP`	MercadoPago (app o link)
`DEBIT`	Tarjeta de débito (otro medio)
`CREDIT`	Tarjeta de crédito (otro medio)

Valores posibles para "Estado":

Valor	Descripción
`OPEN`	Compra abierta — pendiente de pago total
`PARTIALLY_PAID`	Parcialmente pagada — se pagó parte del monto
`PAID`	Pagada completamente

Valores posibles para "Estado_Recepcion":

Valor	Descripción
`PENDING`	Esperando recepción — la mercadería aún no llegó
`PARTIAL`	Recepción parcial — llegó parte de la mercadería
`COMPLETED`	Recepción completa — llegó toda la mercadería

Ejemplo de datos:

Proveedor_Nombre	Proveedor_CUIT	Monto_Total	Movimiento_Tipo
Distribuidora XYZ	30-98765432-1	500000.00	Compra / Deuda
Mayorista ABC	30-11223344-5	350000.00	Pago Realizado

Reglas de validación:

Pass 1: Crea o actualiza los proveedores.

Pass 2: Agrupa movimientos por proveedor + fecha + tipo.

Los tipos Base y Sin Historial se ignoran.

Errores comunes:

Si el tipo de movimiento es inválido, la fila se omite.

Proveedor_Nombre es requerido en ambas pasadas.

La fecha es requerida para los movimientos (Pass 2).

8.2 Compras_Antiguas.xlsx

Archivo: Compras_Antiguas.xlsx Nivel: Level 1 | Dependencias: Proveedores_E_Historial

Historial de compras anteriores al sistema

Columnas: Proveedor_Nombre, Cajero_Username, Fecha, Recibo, Total

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Proveedor_Nombre	Texto	SÍ	Nombre de proveedor	Distribuidora XYZ	Nombre del proveedor al que se le realizó la compra. Debe existir en Proveedores_E_Historial.xlsx.
Cajero_Username	Texto	No	Username del cajero	jperez	Usuario que registró la compra antigua. Debe existir en Usuarios.xlsx.
Fecha	Fecha	No	ISO 8601	2025-01-15T00:00:00.000Z	Fecha en que se realizó la compra antigua.
Recibo	Texto	No	Número de recibo	REC-001	Número de recibo o comprobante interno de la compra antigua.
Total	Número	No	Monto total en ARS	250000.00	Monto total de la compra antigua en pesos argentinos.

Ejemplo de datos:

Proveedor_Nombre	Cajero_Username	Fecha	Recibo	Total
Distribuidora XYZ	jperez	2025-01-15	REC-001	250000.00
Mayorista ABC	mgarcia	2025-02-20	REC-002	180000.00

Reglas de validación:

El proveedor debe existir en Proveedores_E_Historial.xlsx.

Son registros históricos, siempre se crean nuevos.

Errores comunes:

Si el proveedor no existe, la compra se omite.

8.3 Proveedores_Productos.xlsx

Archivo: Proveedores_Productos.xlsx Nivel: Level 2 | Dependencias: Proveedores_E_Historial, Productos

Vincula productos a proveedores con precios de compra

Columnas: Proveedor_Nombre, Producto_Codigo_Barras, Precio_Proveedor

Columna	Tipo	Requerido	Valores	Ejemplo	Descripción
Proveedor_Nombre	Texto	SÍ	Nombre de proveedor existente	Distribuidora XYZ	Nombre del proveedor que suministra el producto. Debe existir en Proveedores_E_Historial.xlsx.
Proveedor_CUIT	Texto	No	CUIT del proveedor	30-98765432-1	CUIT del proveedor. Solo lectura informativa, se ignora en la importación.
Producto_Codigo_Barras	Texto	SÍ	Código de barras del producto	7790001000015	Código de barras del producto que el proveedor suministra. Debe existir en Productos.xlsx.
Producto_Nombre	Texto	Info	Solo lectura (referencia a Productos.xlsx)	Coca Cola 500ml	Nombre del producto. Solo lectura informativa.
Precio_Proveedor	Número	No	Precio de compra en ARS	900.00	Precio de compra del producto a este proveedor. Se usa para calcular costos y comparar proveedores.

Ejemplo de datos:

Proveedor_Nombre	Producto_Codigo_Barras	Precio_Proveedor
Distribuidora XYZ	7790001000015	900.00
Distribuidora XYZ	7790002000021	1400.00
Mayorista ABC	7790003000038	500.00

Reglas de validación:

Agrupa por proveedor y reemplaza completamente su lista de productos.

El proveedor y el producto deben existir.

Errores comunes:

Si el proveedor no existe, todas sus filas se omiten.

Si el código de barras no existe, esa vinculación se omite.

La lista anterior de productos del proveedor se elimina.

Referencia de Tipos de Dato

Tipo	Descripción	Formato esperado
Texto	Cadena de texto libre	Cualquier texto sin comas ni pipes
Número	Valor numérico entero o decimal	100, 1500.50
Decimal	Número con decimales	12.5, 0.15
Booleano	Verdadero o falso	true/false, SÍ/No, 1/0
Fecha	Fecha en formato ISO	2026-01-15, 15/01/2026
Email	Correo electrónico válido	usuario@ejemplo.com
Teléfono	Número de teléfono	+5491155551234
URL	Dirección web	https://ejemplo.com
JSON	Objeto JSON válido	{"key": "value"}
Lista (coma)	Valores separados por coma	valor1, valor2, valor3
Moneda	Valor monetario en ARS	1500.00
UUID	Identificador único	550e8400-e29b-41d4-a716-446655440000

Notas Técnicas

Backend关联

Cada archivo Excel se mapea a una tabla TypeORM en el backend.

El servicio backup.service.ts genera los .xlsx usando la librería ExcelJS.

El servicio restore.service.ts parsea los .xlsx durante la importación.

El controlador backup.controller.ts maneja la subida de archivos .xlsx.

Convenciones de nombres

Los nombres de archivo usan PascalCase con snake_case para subcategorías (ej: Cajas_Configuracion.xlsx).

Los nombres de columna coinciden exactamente con los campos de la entity TypeORM.

Las foreign keys usan el patrón nombreEntidadId (ej: sucursalId, productoId).

Validación

Las columnas marcadas como "SÍ" en requerido son obligatorias durante la importación.

Las foreign keys deben apuntar a registros existentes en la tabla referenciada.

Los valores enum deben coincidir exactamente con los valores permitidos.

Las fechas deben ser parseables por JavaScript Date.

*Generado automáticamente desde landing/src/data/excel-modules.tsx*