Análisis Funcional: Pago con documentos (datos, soportes y papeleta)

Date: 2026-08-07 · Actualizado: 2026-09-14 Status: Vigente — documenta las entregas E5a y E5b, mergeadas a main, más ADR-008 (2026-09-12), que cambió qué documentos bloquean el pago. Ver Preguntas Abiertas. Autor: Product Owner Agent (metodología Raxar Factory) Fuentes: material de CIS-EC del 2026-08-07 (mail de Maggie: Soterex - GT Detalle requerimientos.xlsx, hojas Requerimientos y Módulo caja, y los dos modelos Word de papeleta y formulario de enrolamiento), el análisis de ese material y el diseño técnico de E5a (doc/plans/2026-08-07-analisis-definiciones-cis-ec.md y doc/plans/2026-08-07-e5a-datos-y-documentos-del-pago-diseno-tecnico.md, ambos en revisión en el PR #17), las decisiones de Carlos del 2026-08-07, y el código de main.

Por qué existe este paquete aparte

El Análisis Funcional original describe el pago como un acto de un solo paso: se busca el MTCN, se aprieta Pagar, la transacción queda PAID. Eso era todo lo que se sabía en julio.

El material que mandó CIS-EC el 2026-08-07 lo cambió de tamaño. En ventanilla el operador no solo paga: identifica al cliente contra la carta, completa una docena de datos que Soterex no manda y que el reporte al regulador necesita, elige el medio de pago, imprime una papeleta, la hace firmar, y guarda entre cuatro y ocho documentos escaneados. El Módulo Caja cubre de dónde sale la plata; este paquete cubre qué pasa arriba del mostrador mientras se entrega.

No reemplaza a ninguno de los dos: los complementa.

Cómo leer este documento

Marca	Significa
✅ Implementado	Está en main. Es la mayor parte del paquete.
📋 Sin implementar	Decidido o pedido por el cliente, todavía sin código.
⚠️ Sin definir	El cliente no lo respondió. Va a Preguntas Abiertas, no se inventa.

Corregido el 2026-09-14. Este paquete decía "nada de esto está en main todavía" y marcaba como en revisión todo lo que describía. E5a y E5b se mergearon poco después de escribirlo, así que durante más de un mes el documento negaba la existencia de funcionalidad que estaba en producción. Las marcas 🟡 pasaron a ✅.

Índice

1. Resumen del alcance — qué problema resuelve, quién lo opera, qué queda afuera, y el glosario. Empezá por acá.
2. El flujo del pago — la ventanilla de punta a punta, qué era el PIN y por qué se sacó, y por qué el pago no se frena por un escaneo faltante.
3. Datos y documentos — los campos que completa el operador, los nueve tipos de soporte, la completitud derivada y el tratamiento de PII.
4. La papeleta — el comprobante que firman cliente y operador: qué replica del modelo del cliente y qué no.
5. Preguntas Abiertas — lo que el cliente todavía no definió y lo que se resolvió por criterio propio sin validar.