# Handoff — Plazas AI

**Cliente:** Lic. Salvador C. Gutiérrez González, para sus empresas GCS Terra S. de R.L. de C.V. y Plaza Amistad AC
**Proyecto:** Plazas AI — administración de arrendamientos de plazas comerciales
**Fecha de levantamiento:** 2026-11-02

**Origen de este documento:** se armó a partir de documentos ya confirmados por el equipo:
- `procesos-as-is.md` y `oportunidades-automatizacion.md` (primera reunión, 2026-10-29, con las capturas de los Excel del cliente en `screenshots/`);
- `to-be.md`, incluida su sección "Ajustes tras la presentación del POC (2026-11-02)";
- `prototipo-venta.html` (prototipo presentado y aprobado);
- la sesión de presentación del POC del 2026-11-02 (`transcripciones/transcripcion_2026-11-02.md`).

No agrega alcance que no esté en esos documentos. Lo marcado **[Confirmar]** es una propuesta del equipo que todavía no valida el cliente.

---

## 1. Generalidades

**Qué existe hoy:**
- Toda la operación de las plazas vive en más de 10 archivos de Excel que se alimentan a mano unos a otros: facturas mensuales, bancos, incrementos por plaza, gastos mensuales por plaza, un Excel por servicio, mejoras pagadas por GCS Terra, flujo de efectivo y reportes para el despacho.
- **Diana Rodríguez** lleva la cobranza, los contratos, los incrementos y los gastos.
- **Maria Castro** captura los bancos movimiento por movimiento y arma el flujo de efectivo y los reportes contables.

**Entidades del cliente:**
- **GCS Terra S. de R.L. de C.V.:** cobra renta y mantenimiento. Cuentas Banregio MN y USD, BBVA MN y USD. Plaza El Refugio, Las Quintas, Jibarito y agencias Honda/Kia.
- **Plaza Amistad AC:** solo cobra mantenimiento. Cuenta Scotiabank. Plaza Amistad (~28 locales) y Plaza Jalisco.
- Una tercera razón social que solo cobra rentas `[No especificado el nombre]`.
- Un mismo inquilino puede pagar la renta a una razón social y el mantenimiento a otra, en pesos o en dólares.

**Relación con Tribu:**
- Primera reunión de levantamiento: 2026-10-29.
- Presentación del POC (prototipo HTML): 2026-11-02, con Miguel Sauceda y Flavio Borquez.
- El cliente aprobó el POC y quiere arrancar al inicio de mes.

**Qué se va a construir:** una plataforma web, Plazas AI, que ordena la operación como **Razón social → cuentas bancarias → Centro de costo (plaza) → Local → Inquilino → Contrato**. La plataforma:
- genera los cobros del mes desde los contratos;
- concilia los pagos contra el estado de cuenta;
- calcula intereses moratorios;
- avisa de los incrementos con la inflación del INEGI;
- registra los gastos desde la factura;
- arma el cashflow y el reporte para el despacho.

Módulos:
1. Usuarios y permisos
2. Estructura: razones sociales, plazas, locales e inquilinos
3. Contratos e incrementos
4. Cobranza
5. Bancos y conciliación
6. Morosidad e intereses
7. Gastos
8. Cashflow y reporte para el despacho
9. Tablero, avisos y exportaciones (transversal)

Ver detalle en `Modulos_y_funcionalidad-Plazas-AI.md`.

**Integraciones de terceros:**
- **Estados de cuenta bancarios** (Banregio, BBVA, Scotiabank): carga de archivo, no conexión directa con el banco. Excel de preferencia, PDF como respaldo.
- **INEGI:** inflación anual (INPC) por mes, actualizada sola.
- **Facturas de proveedores:** lectura de CFDI XML, y PDF como respaldo.
- **Correo saliente:** cartas de aviso de incremento y tablas de intereses.
- **IA:** para leer estados de cuenta y facturas en PDF y para interpretar conceptos libres del banco. El servicio de IA lo **contrata y paga el cliente** aparte (confirmado 2026-11-02).

**Lo que sigue siendo humano (acordado):**
- Timbrar y entregar las facturas a inquilinos, en su sistema actual. La plataforma solo registra el folio y las marcas T/E.
- La contabilidad la sigue llevando el contador.
- La plataforma propone; el equipo decide:
  - confirmar pagos dudosos;
  - el porcentaje de las renovaciones;
  - la renta inicial de cada inquilino nuevo;
  - el centro de costo cuando un proveedor sirve a varias plazas;
  - condonar o ajustar intereses.

---

## 2. Alcance

**Incluido en esta etapa:**
- Los 9 módulos de la sección 1.
- Categorías configurables para los movimientos bancarios que no son cobranza (inversiones, rendimientos, comisiones, traspasos entre cuentas).
- Filtro por razón social y por centro de costo (plaza) en todas las secciones.
- Cashflow con rubros padre/hijo a la medida del Excel de Maria.
- Reporte para el despacho con fecha de emisión y fecha de pago.
- Exportación a Excel de las tablas principales.
- Vista de ocupación de locales por mes y año.
- Acompañamiento en la primera configuración (Tribu guía; el cliente da de alta su información).
- Importación inicial de inquilinos, locales y montos vigentes desde sus Excel actuales (Facturas Mensuales e Incrementos por plaza) — confirmado 2026-11-02.

**Fuera de esta etapa:**
- Timbrado de facturas a inquilinos.
- Prediales y valores catastrales (aunque las claves catastrales sí se guardan en cada plaza).
- Documentación general de las plazas (construcción, trámites).
- Conciliación bancaria contra el auxiliar de CONTPAQi.
- Pagos provisionales y contabilidad de la persona física del licenciado.
- Reparto interno 70/30 de mejoras (el cliente lo excluyó).
- Conexión directa (API) con los bancos.

**Siguiente ronda (acordado con Flavio):** usar la plataforma 1–2 meses y luego juntar mejoras y nuevos reportes en una segunda etapa.

---

## 3. Reglas de negocio clave

- **Días de gracia:** 5 días naturales (configurable).
- **Interés moratorio:** 1% por día de atraso sobre el saldo insoluto, según el contrato.
  - Se calcula desde el día siguiente a la gracia.
  - Al registrar el pago se agrega como línea "Intereses [mes]" al cobro, para timbrarse junto con la renta o el mantenimiento.
  - `[Confirmar]` si la base es el subtotal o el total con IVA.
- **Incremento anual:**
  - Renta actual × inflación anual INEGI del mes de referencia del contrato.
  - Aplica a la renta y, solo si el contrato lo prevé, al mantenimiento.
  - En renovaciones el % se negocia y se edita (ej. 5%, 6%, 10%).
  - El nuevo monto aplica a los cobros desde el mes de aniversario; el contrato no se modifica.
  - `[Confirmar]` el mes de referencia de INPC por contrato: en los ejemplos varía entre julio, septiembre y marzo.
- **Retenciones:** algunos inquilinos llevan retención de IVA y de ISR.
- **Moneda:** algunos clientes pagan la renta en USD, pero el mantenimiento siempre se factura en pesos. La plataforma alerta si un mantenimiento se registra en USD.
- **Facturación:** a algunos clientes (corporativos) se les factura a inicio de mes; al resto, cuando pagan. Hay facturas PPD con abonos parciales y complemento de pago, y pagos por adelantado.
- **Empate de pagos:** por folio en el concepto, por nombre del ordenante + monto, o por monto exacto o aproximado (depósitos en efectivo sin nombre).
  - Lo dudoso lo confirma el equipo.
  - Las confirmaciones se recuerdan para siguientes cargas.
  - La lógica debe ser genérica por banco, sin depender de los archivos de muestra.
- **Re-carga del estado de cuenta:** se puede subir el mismo estado de cuenta varias veces (ej. a diario). Solo entran los movimientos nuevos.
- **Cambio de inquilino:** se cierra el contrato; el historial del local se conserva.

---

## 4. Pendientes del cliente

- Conceptos o categorías de movimientos que no son cobranza (Maria, de su archivo de bancos).
- Excel de flujo de efectivo, consolidado y por centro de costo (Maria).
- Excel de Facturas Mensuales completo y un estado de cuenta de cada banco de un mes cerrado, para validar contra lo hecho a mano.
- Excel de gastos fijos y variables de cada plaza (formato final).
- Word de Diana con el paso a paso y el link del INEGI.
- Nombre de la tercera razón social y alcance de "Modan".
- Sistema con el que timbran (solo referencia; no se integra en esta etapa).
