> For the complete documentation index, see [llms.txt](https://senselab.gitbook.io/senselab-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://senselab.gitbook.io/senselab-docs/docs/archive/plan_llenado_tablas.md).

# Plan de Llenado de Tablas - api\_db (Testing Data)

## 📋 Estrategia

Llenar **todas las tablas** con datos realistas en orden de dependencias (relaciones):

### Fase 1: Tablas Maestras Básicas (Sin FK)

1. ✅ **empresas** - 2-3 empresas Demo
2. ✅ **roles** - 7-8 roles del sistema
3. ✅ **permisos** - Permisos por módulo
4. ✅ **tipos\_cuentas** - Tipos contables
5. ✅ **tipos\_clientes** - Tipo de cliente
6. ✅ **unidades\_medida** - Unidades producto
7. ✅ **regimenes\_tributarios** - Regímenes fiscales
8. ✅ **formas\_pago** - Formas de pago
9. ✅ **tipos\_impuesto** - Impuestos
10. ✅ **codigos\_actividad\_economica** - CIIU
11. ✅ **tipos\_comprobantes\_fe** - Tipos de comprobante
12. ✅ **cabys** - Códigos CABYS

### Fase 2: Tablas Estructurales (Dependen de Fase 1)

1. ✅ **usuarios** - Admin + trabajadores
2. ✅ **sucursales** - Sucursales de empresa
3. ✅ **almacenes** - Almacenes de sucursal
4. ✅ **cargos** - Cargos empleados
5. ✅ **cuentas\_contables** - Plan de cuentas

### Fase 3: Tablas de Catálogos Productos

1. ✅ **categorias\_productos** - Categorías
2. ✅ **marcas** - Marcas productos
3. ✅ **productos** - Productos (10-15)
4. ✅ **inventario\_productos** - Stock por almacén

### Fase 4: Tablas de Personas

1. ✅ **clientes** - 5-10 clientes
2. ✅ **proveedores** - 5-10 proveedores
3. ✅ **empleados** - 5-8 empleados
4. ✅ **zonas\_geograficas** - Zonas geográficas

### Fase 5: Transacciones Compras/Ventas

1. ✅ **ordenes\_compra** - 3-5 órdenes
2. ✅ **detalle\_ordenes\_compra** - Detalles de compra
3. ✅ **ventas** - 5-8 ventas
4. ✅ **detalle\_ventas** - Detalles de venta

### Fase 6: Inventario y Movimientos

1. ✅ **entradas\_inventario** - Entradas
2. ✅ **detalle\_entradas\_inventario** - Detalles
3. ✅ **salidas\_inventario** - Salidas
4. ✅ **detalle\_salidas\_inventario** - Detalles

### Fase 7: Contabilidad

1. ✅ **cuentas\_por\_cobrar** - Cuentas por cobrar
2. ✅ **cuentas\_por\_pagar** - Cuentas por pagar
3. ✅ **asientos\_contables** - Asientos
4. ✅ **detalle\_asientos** - Detalles asientos

### Fase 8: Nómina

1. ✅ **periodos\_nomina** - Períodos de nómina
2. ✅ **nomina\_empleados** - Nóminas
3. ✅ **deducciones\_legales** - Deducciones
4. ✅ **pagos\_nomina** - Pagos de nómina

### Fase 9: Facturación Electrónica

1. ✅ **consecutivos\_fe** - Consecutivos
2. ✅ **comprobantes\_electronicos\_fe** - Comprobantes
3. ✅ **fe\_lineas\_detalle** - Líneas de detalle
4. ✅ **mensajes\_hacienda** - Mensajes

### Fase 10: Otras Tablas

1. ✅ **cajas** - Cajas registradoras
2. ✅ **caja\_chica** - Cajas chicas
3. ✅ **movimientos\_caja\_chica** - Movimientos
4. ✅ **presupuestos** - Presupuestos
5. ✅ **notificaciones** - Notificaciones
6. ✅ **archivos** - Archivos
7. ✅ **logs\_acceso\_sistema** - Logs acceso
8. ✅ **auditoria\_actividades** - Auditoría
9. ✅ **rutas** - Rutas de transporte
10. ✅ **horarios\_ruta** - Horarios
11. ✅ **buses\_unidades** - Unidades de bus
12. ✅ **roles\_permisos** - Relación roles-permisos
13. ✅ **rol\_usuario** - Relación usuario-roles

### Fase 11: Tablas Transaccionales Avanzadas

1. ✅ **cuentas\_bancarias** - Cuentas bancarias
2. ✅ **movimientos\_bancarios** - Movimientos
3. ✅ **tipos\_cambio\_historial** - Tipos de cambio
4. ✅ **planillas\_ccss** - Planillas CCSS
5. ✅ **retenciones\_impuestos** - Retenciones
6. ✅ **tasas\_impuesto** - Tasas de impuesto
7. ✅ **configuraciones** - Configuraciones
8. ✅ **configuraciones\_api** - Config API
9. ✅ **comprobantes\_recibidos\_electronicos** - Comprobantes recibidos
10. ✅ **declaraciones\_tributarias** - Declaraciones
11. ✅ **fe\_certificados\_digitales** - Certificados
12. ✅ **fe\_oauth\_tokens** - Tokens OAuth
13. ✅ **modelos\_buses** - Modelos de bus
14. ✅ **entidad\_etiquetas** - Etiquetas
15. ✅ **etiquetas** - Definiciones etiquetas
16. ✅ **url\_shorter\_db** - URLs acortadas

## 📊 Resumen de Datos

| Tabla             | Registros | Tipo          |
| ----------------- | --------- | ------------- |
| **Maestras**      | 150+      | Catálogos     |
| **Estructurales** | 30+       | Configuración |
| **Productos**     | 15        | Inventario    |
| **Personas**      | 28        | Contactos     |
| **Transacciones** | 50+       | Operación     |
| **Contabilidad**  | 40+       | Finanzas      |
| **Nómina**        | 20+       | RH            |
| **FE**            | 15        | Facturación   |
| **Misc**          | 100+      | Otros         |
| **TOTAL**         | 500+      | Datos Falsos  |

## 🔄 Orden de Ejecución

1. Ejecutar seeders existentes del proyecto
2. Llenar tablas faltantes con SQL directo
3. Verificar integridad referencial
4. Hacer dump de la data

## 🚀 Próximos Pasos

1. Crear script SQL comprensivo
2. Ejecutarlo contra api\_db
3. Validar datos
4. Crear backup


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://senselab.gitbook.io/senselab-docs/docs/archive/plan_llenado_tablas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.