# Resumen de archivos y mapeo para SIIGO

## Lo que revisé

### 1. **BASE PROVEEDORES.xlsx** (hoja PROVEEDORES)
- **302 filas** de proveedores con sus características y **plan de cuentas por impuesto**.
- **Columnas clave:**
  - **NIT** – Identificación para cruce.
  - **PROVEEDOR** / **RAZON SOCIAL** – Nombre.
  - **CATEGORIA** – Ej.: Compras, Arriendos.
  - **CONCEPTO** – Costo vs Gasto (define tipo de cuenta).
  - **ENTIDAD** – Ej.: ORLANDO.
  - **Cuentas contables por impuesto (códigos SIIGO):**
    - **Base** – Cuenta de costo/gasto (ej. 14350101 inventario, 522010 arriendos, 52055101 calzado).
    - **CxPagar** – Cuentas por pagar (ej. 22050501, 233540).
    - **IVA** – Cuenta IVA (ej. 24081001, 52157001).
    - **ICA** – Código cuenta ICA (ej. 2).
    - **IC**, **INC**, **Timbre**, **INC Bolsas**, **IN Carbono**, **IN Combustibles**, **IC Datos**, **ICL**, **INPP**, **IBUA**, **ICUI** – Resto de impuestos.
    - **Rete IVA**, **Rete Renta**, **Rete ICA**, **Fedepapa** – Retenciones.

Cada proveedor tiene ya asignadas las cuentas que se deben usar al contabilizar sus facturas.

---

### 2. **ESTRUCTURA PLANO SIIGO.xlsx** (hoja Datos)
- Es la **plantilla oficial** descargada de SIIGO: una fila de encabezados con los nombres exactos que espera el aplicativo.
- **Columnas relevantes para compras:**
  - **Tipo de comprobante** – Ej. 9.
  - **Consecutivo comprobante** – Número único por documento.
  - **Fecha de elaboración**
  - **Código cuenta contable**
  - **Identificación tercero** – NIT del proveedor.
  - **Prefijo**, **Consecutivo** – Prefijo y número de factura (ej. FE, 7907).
  - **No. cuota** – Ej. 1.
  - **Fecha vencimiento**
  - **Código impuesto** – Ej. 1 = IVA, 14 = ICA, etc.
  - **Descripción**
  - **Código centro/subcentro de costos** – Cuando aplica (ej. línea de ICA).
  - **Débito**, **Crédito**
  - **Observaciones**
  - **Base gravable libro compras/ventas** – Para líneas de IVA.
  - **Base exenta libro compras/ventas**
  - **Mes de cierre**

---

### 3. **EJEMPLO ARCHIVO DE COMPRAS.xlsx** (hoja DFFC)
- **Ejemplo real** de cómo debe quedar el archivo para cargar en SIIGO (~2311 filas).
- **Patrón por factura:**
  1. **Línea 1 – Débito a cuenta Base (costo/gasto):**  
     Cuenta 14350101, Débito = valor base, Descripción ej. "LECHUGA-ESPINACA FE-7907", Identificación tercero = NIT, Prefijo/Consecutivo = FE 7907.
  2. **Si hay IVA:**  
     Línea con cuenta 24081001, Débito = IVA, Código impuesto = 1, Base gravable = base.
  3. **Si hay ICA:**  
     Línea con cuenta 23680513, Crédito = ICA, Código impuesto = 14, Código centro/subcentro.
  4. **Línea final – Crédito a proveedores:**  
     Cuenta 22050501, Crédito = Total, mismo Prefijo/Consecutivo, No. cuota = 1, Fecha vencimiento.

- **Tipo de comprobante** = 9, **Consecutivo comprobante** secuencial por documento, **Fecha de elaboración** = fecha del documento.

---

### 4. **COMPRAS Y VENTAS ORLANDO CAMACHO FEBRERO.xlsx** (hoja COMPRAS)
- **Origen de datos** a transformar: **916 filas** de facturas recibidas (más fila de encabezado).
- **Columnas que usamos:**
  - **Fecha Emisión** – Para fecha de elaboración y vencimiento.
  - **NIT Emisor**, **Nombre Emisor** – Tercero.
  - **Prefijo**, **Folio** – Para Prefijo + Consecutivo del plano SIIGO.
  - **Total** – Valor total factura.
  - **BASE** – Base gravable (ya viene en el archivo).
  - **IVA**, **ICA**, **IC**, **INC**, **Timbre**, **INC Bolsas**, **IN Carbono**, **IN Combustibles**, **IC Datos**, **ICL**, **INPP**, **IBUA**, **ICUI**, **Rete IVA**, **Rete Renta**, **Rete ICA** – Importes por impuesto/retención (varios en 0 en el ejemplo).

Con esto se puede armar cada factura como varias líneas del plano SIIGO, tomando las cuentas del proveedor desde BASE PROVEEDORES.

---

## Mapeo lógico (qué hay que hacer)

| Origen (COMPRAS Orlando) | Acción | Destino (plano SIIGO) |
|--------------------------|--------|------------------------|
| NIT Emisor               | Cruce con BASE PROVEEDORES | Obtener Base, CxPagar, IVA, ICA, etc. (códigos de cuenta) |
| Fecha Emisión            | Usar tal cual             | Fecha de elaboración, Fecha vencimiento |
| Prefijo + Folio          | Identificador documento   | Prefijo, Consecutivo |
| BASE                     | Débito cuenta **Base** del proveedor | Línea 1: Débito |
| IVA > 0                  | Débito cuenta **IVA** del proveedor, Código impuesto = 1 | Línea IVA, Base gravable = BASE |
| ICA > 0                  | Crédito cuenta **ICA**, Código impuesto = 14 | Línea ICA |
| Otros impuestos > 0       | Igual: una línea por cada cuenta del proveedor | Según EJEMPLO |
| Total                    | Crédito cuenta **CxPagar** del proveedor | Última línea del documento |
| Si no está en BASE PROVEEDORES | Usar cuentas por defecto o marcar para revisión | Definir regla |

**Tipo de comprobante** = 9 (como en el ejemplo). **Consecutivo comprobante** = número secuencial por documento (uno por factura, repetido en todas las líneas de esa factura).

---

## Próximo paso

Adaptar el notebook `generar_movimiento_siigo.ipynb` para que:

1. Lea **COMPRAS** desde **COMPRAS Y VENTAS ORLANDO...** (y opcionalmente permita otro archivo).
2. Lea **BASE PROVEEDORES** y use **NIT** normalizado (sin guiones/espacios) para el cruce.
3. Por cada fila de COMPRAS genere las líneas del plano SIIGO:
   - Una línea débito a **Base** (monto BASE).
   - Una línea por cada impuesto con valor > 0 (cuenta e importe desde BASE PROVEEDORES y columnas IVA, ICA, etc. de COMPRAS).
   - Una línea crédito a **CxPagar** (monto Total).
4. Respete **exactamente** los nombres de columnas de **ESTRUCTURA PLANO SIIGO** en el Excel/TXT de salida.
5. Exporte en el mismo orden de columnas que la estructura (o que el EJEMPLO) para poder importar en SIIGO sin errores.

Si estás de acuerdo con este mapeo, el siguiente paso es implementar este flujo en el notebook y probar con un subconjunto de la hoja COMPRAS.