Datos y documentos
Análisis Funcional: Pago con documentos — parte 3 de 5. ← El flujo del pago · Índice · Siguiente: La papeleta →
Actualizado el 2026-10-05 (G3, ajustes v3 del cliente): el medio de pago es solo efectivo. Donde este documento dice «efectivo o transferencia», lo tachado ya no rige: la transferencia se lee (las
PAIDviejas) pero no se escribe (el backend responde422). Ver Preguntas Abiertas, #3.
Dos cosas distintas que el operador produce en el mismo momento: datos que tipea y archivos que sube. Se tratan aparte porque tienen dueños distintos —los datos son del reporte regulatorio, los archivos son del legajo de auditoría— y reglas distintas.
2.1 Los campos que completa el operador
El requerimiento #1 de CIS-EC es tajante: "Si Soterex no envía la columna por la API, favor incluir los campos en la pestaña del pago de la tx (Módulo Cajero)".
La migración 2026_08_07_100000_e5a_datos_del_pago_en_transacciones.php agrega 13 columnas, de las cuales 11 las tipea el operador en ventanilla y 2 vienen de Soterex o se derivan. Desde B4.0 (2026-10-02) son 13 los que tipea el operador: se suman nationality, que E5a daba por un dato de Soterex, y birth_date, que ya existía en el modelo — ver la actualización de B4.0 más abajo.
Los 13 que se cargan en ventanilla
| Campo | Rótulo en pantalla | Para qué sirve |
|---|---|---|
birth_date | Fecha de nacimiento | B4.0. Columna 3 del reporte de Cumplimiento. Una fecha pasada, d/m/Y en el reporte. |
nationality | Nacionalidad | B4.0. Columna 4 del reporte. Desde el Pago 13 (2026-10-13, D4-2) es el código de país de dos letras, de la misma lista global que identification_country y con un desplegable igual (el texto libre de antes no se migra: se conserva en las pagadas y una ACCEPTED con texto viejo tiene que elegir un país para pagar). Es la del beneficiario, distinta de destination_country (la del giro) y de identification_country. |
delivery_type | Medio de pago | EFECTIVO o TRANSFERENCIA.EFECTIVO (ver la actualización de G3, más abajo). Columna AA del reporte. Define qué documentos son obligatorios. |
bank_account | Cuenta bancaria | Columna AB. PAID viejas por transferencia, en solo lectura. |
identification_type | Tipo de identificación | DPI, Pasaporte… (el catálogo del país, A4). Va al reporte y a la papeleta. Desde G11 trae el formato de su número y su país emisor: ver la actualización de G11, más abajo. |
identification_number | N° de identificación | Ídem. Es el dato con el que se coteja al beneficiario. Desde G11 tiene que cumplir el formato de su tipo (DPI: 13 dígitos; Pasaporte: 7 a 13 letras o números). |
identification_country | País de la identificación | Dos letras, de la lista de países de Cumplimiento (G10). Distinto de la nacionalidad y del país de destino. Desde G11, si el tipo tiene un país emisor fijo, tiene que ser ese (DPI: GT). |
beneficiary_address | Dirección | Columna Address del reporte. |
beneficiary_city | Ciudad | Columna City. |
beneficiary_state | Provincia / Estado | Columna State. |
phone_2 | Teléfono adicional | "SOTEREX ENVÍA UN TELÉFONO, AGREGAR UN TELÉFONO 2". Es para poder ubicar al beneficiario. |
email_2 | Mail adicional | "SOTEREX ENVÍA UN MAIL, AGREGAR UN MAIL 2". Ídem. |
notes | Notas | "gestiones de contacto adicional", columna AC. Texto libre, hasta 2000 caracteres. |
El formulario está en frontend/src/components/DatosPagoForm.vue, y la validación en backend/app/Http/Controllers/TransactionController.php:469-481.
El que no tipea el operador
| Campo | De dónde sale |
|---|---|
expires_at | La carta al beneficiario indica 60 días de plazo para retirar. |
nationality figuraba acá como "la manda Soterex". No era así: SendRequest no la define y nada la escribía. Desde B4.0 la carga el cajero (ver abajo).
Para qué sirve todo esto: el reporte regulatorio
De las 48 columnas del reporte que hoy Soterex manda por Excel, 36 se quedan en el reporte transaccional que CIS le presenta al regulador. Buena parte de esas 36 son datos que Soterex no expone por API, y hasta E5a simplemente no existían en el modelo.
El reporte ya existe: es el reporte de Cumplimiento (B4, 2026-10-02; ver la sección 5.7 de secuencias de pantalla). Lo que E5a hizo fue asegurar que, cuando llegara, los datos estuvieran. Cargarlos retroactivamente sobre transacciones ya pagadas es imposible: el cliente ya no está.
Tres columnas del reporte se decidieron NO guardar en E5a: Payout Currency, Ex. Rate y Beneficiary Destination Amount. Con el cambio de moneda diferido a MVP2, las tres eran derivables (USD, 1.0 y el principal). Eso cambió con el módulo Caja (E4b): hoy el reporte las toma del movimiento de caja del pago, donde el tipo de cambio queda congelado. Solo cuando no hay movimiento (país sin Caja, o una transacción que todavía no se pagó) vuelve a la regla de antes: si el país paga en dólares, USD, 1 y el principal; si paga en moneda local, quedan vacías, porque sin movimiento no se sabe a qué tipo de cambio ni por cuánto se entregó. Ver las columnas 25 a 27 en la sección 5.7.
Actualización (A3, 2026-09-28): todos son obligatorios salvo Notas
Lo de abajo describía el diseño original de E5a: ninguna columna era obligatoria y se podían cargar antes o después de pagar. Ya no es así. A3 (doc/plans/2026-09-28-ajustes-v1-cliente-gt.md, D3/D4, ADR-011) movió la carga a antes de pagar y la hizo obligatoria: TransactionController::pay() ahora guarda estos datos y paga en la misma llamada, y rechaza con 422 MISSING_PAYMENT_DATA si falta alguno (todos salvo notes; desde G3 la cuenta ya no se pide). bank_account solo si el medio es TRANSFERENCIAdatosPago() (guardado parcial mientras se completa el formulario) sigue aceptando cualquier subconjunto — la obligatoriedad se exige recién al confirmar.
identification_type, identification_country, beneficiary_state y beneficiary_city dejaron de ser texto libre: A4 (doc/plans/2026-09-28-ajustes-v1-cliente-gt.md) los convirtió en combos contra un catálogo (catalog_items, ver el módulo Catálogos en el manual), y el backend valida que el código enviado exista activo para el país correcto. Los datos ya cargados en texto libre antes de A4 quedan como están — la validación contra catálogo solo corre sobre lo que se envía en la request, nunca reevalúa lo que ya estaba guardado.
La única regla de coherencia adicional: la cuenta bancaria se borra si el medio de pago no es transferencia, tanto en el backend como en el formulario, para no ensuciar el reporte con un dato colgado de un pago en efectivo. (Desde G3 el medio es siempre efectivo y la regla se simplificó: la cuenta se descarta en toda escritura, sin mirar el medio, ni siquiera la de un borrador TRANSFERENCIA de antes de G3.)
Actualización (B1, 2026-10-01): la obligatoriedad se ve en pantalla
A3 dejó la regla en el backend, pero la pantalla no la mostraba: el operador se enteraba de qué era obligatorio cuando "Iniciar pago" no se habilitaba, y ni siquiera ahí se leía por qué. En la revisión del 2026-10-01 el cliente confirmó la regla —"Sí, todos son obligatorios salvo notas y deben marcarse como tal"— y B1 (doc/plans/2026-10-01-ajustes-v2-cliente-gt.md, B1.3 y B1.4) lo resuelve del lado de la pantalla. La regla no cambia; cambia lo que se lee.
Los obligatorios se marcan. Con el formulario editable, cada campo obligatorio lleva un asterisco rojo junto al rótulo y, arriba del formulario, la leyenda * obligatorio. Son ocho: Dirección, Provincia / Estado, Ciudad, Tipo de identificación, N° de identificación, País de la identificación, Teléfono adicional y Mail adicional. Notas es el único sin asterisco. (Desde B4.0 son diez: se suman Fecha de nacimiento y Nacionalidad.)
- La lista no está copiada en la pantalla: sale de
CAMPOS_OBLIGATORIOS_PAGO(frontend/src/services/transactionDocuments.ts), la misma que decide si el botón de pagar se habilita. La marca y el bloqueo no se pueden desalinear. - Medio de pago y
Cuenta bancariase marcan en el modal de confirmación, que es donde se piden con la transacciónACCEPTED(ADR-011 §3).La cuenta, solo si el medio es transferencia.(Desde G3 no hay cuenta bancaria en el modal.) El motivo de cancelación también. - Con la transacción
PAIDoCANCELLED, o sin permiso de escritura, el formulario es de solo lectura y no lleva asteriscos ni leyenda: no hay nada que completar. - El asterisco es solo visual (
aria-hidden). En el formulario y en el modal de confirmación, cada control llevaaria-required="true"y su rótulo está enlazado al control. El selector del motivo de cancelación lleva el asterisco pero noaria-requiredni rótulo enlazado: el componente de selección (NSelect) deja ese atributo en un contenedor que no es un control, y sería ARIA inválido. Ahí lo obligatorio lo dice un aviso en texto visible ("Tenés que elegir un motivo…") mientras no haya motivo. El rótulo con asterisco es un componente propio,frontend/src/components/FieldLabel.vue, que comparten los tres.
Qué falta para pagar se lee en pantalla. Hasta B1 el motivo por el que "Iniciar pago" estaba deshabilitado era solo el title del botón, que en una tablet no se ve. Ahora es un recuadro ámbar justo debajo del botón (MatchResultCard.vue), en texto, con cada motivo en su línea:
Faltan documentos: Carta de Soterex, Identificación (anverso), Identificación (reverso)
Faltan datos: Dirección, Ciudad, Teléfono adicional- Documentos: los tres que bloquean (ADR-008), solo los que todavía no están subidos.
- Datos: los obligatorios que no están guardados, con los rótulos del formulario. No incluye Medio de pago, porque se confirma recién en el modal.
- Pueden aparecer las dos líneas a la vez (transacción recién encontrada, sin nada cargado).
- El botón apunta al recuadro con
aria-describedby, así que el lector de pantalla lo lee al llegar al botón.
Cambios sin guardar. "Iniciar pago" se habilita con lo que está guardado, no con lo que hay tipeado: es lo que viaja al backend al pagar. Sin un aviso aparte, el operador veía un campo completo y, al lado, un "Faltan datos" que lo nombraba; y si pagaba con algo tipeado sin guardar, ese dato quedaba afuera sin avisarle. Ahora DatosPagoForm compara lo tipeado contra lo último guardado y avisa a la pantalla (sinGuardar). Con algo sin guardar, el botón queda deshabilitado y el recuadro dice:
Tenés cambios sin guardar en los datos del pago: tocá "Guardar datos" para poder pagar
Ese texto reemplaza al "Faltan datos": la lista de faltantes se calcula sobre lo guardado y podría nombrar un campo que el operador ya completó. Al guardar, si todavía falta algo, vuelve a aparecer "Faltan datos" con el detalle. Es un bloqueo de pantalla; el backend sigue siendo quien decide: ante un pago con datos o documentos faltantes responde 422 MISSING_PAYMENT_DATA o MISSING_REQUIRED_DOCUMENTS, igual que antes.
- Vale en las dos pantallas que usan el formulario: Pago y la ficha de la transacción (Transacciones › detalle, donde Supervisor y Admin pagan con "Cambiar a PAID"). En la ficha el texto va en la línea junto a los botones, con los motivos separados por " · " en vez de uno por renglón.
- Si el backend bloquea la edición mientras había algo tipeado (409
PAYMENT_DATA_LOCKED: otro usuario pagó o canceló la transacción), el formulario pasa a solo lectura, ya no hay botón "Guardar datos" y el aviso de cambios sin guardar desaparece: no tendría a dónde mandar al operador.
Catálogo de tipos de identificación vacío. Si el país de la transacción no tiene tipos de identificación cargados, el desplegable dice "Sin tipos cargados" en lugar de "Elegí uno" (que sobre una lista vacía no explica nada), y debajo del par Tipo / N° aparece, a ancho completo:
Falta cargar los tipos de identificación de este país. Avisale a un administrador: se cargan en Parámetros › Catálogos.
Sin ese tipo el operador no puede completar el formulario y, por lo tanto, no puede pagar: es el estado en que quedó Staging cuando A4 se desplegó sin sus datos de referencia (ver Catálogos en el manual y doc/environments/staging.md). Si la carga de los catálogos falla (error de red o de la API), el desplegable dice "Error al cargar" y el aviso, en rojo, pide recargar la pantalla y, si sigue igual, avisar a un administrador. En solo lectura no se avisa nada.
Actualización (B4.0, 2026-10-02): fecha de nacimiento y nacionalidad las carga el cajero
Decisión de Carlos del 2026-10-02 (P12 de doc/plans/2026-10-01-ajustes-v2-cliente-gt.md; nota fechada en ADR-011). El reporte de Cumplimiento pide la fecha de nacimiento y la nacionalidad del beneficiario (columnas 3 y 4) y la API de Soterex no las manda, así que se cargan en ventanilla como el resto de los datos del pago.
| Campo | Rótulo | Regla |
|---|---|---|
birth_date | Fecha de nacimiento | Obligatoria. Una fecha anterior a hoy (ayer o antes, en la zona horaria de la app), formato AAAA-MM-DD. Sin edad mínima ni máxima: ninguna cota de edad es una regla que el cliente haya pedido. |
nationality | Nacionalidad | Obligatoria. |
- Obligatorios por la misma regla que el resto (C1 / ADR-011 §2).
pay()los exige y, si faltan, responde 422MISSING_PAYMENT_DATAnombrándolos enfaltan. No hay lista aparte en el backend: salen deTransaction::CAMPOS_DEL_PAGO. En la pantalla se marcan con asterisco y entran en elCAMPOS_OBLIGATORIOS_PAGOdel frontend, así que el texto "Faltan datos: Fecha de nacimiento, Nacionalidad" de "Iniciar pago" los nombra como a cualquier otro. - La fecha se valida en los dos lados. El input de fecha del formulario no deja elegir hoy ni el futuro (
max= ayer); como un navegador igual deja tipear una fecha mayor, la pantalla además avisa "La fecha de nacimiento tiene que ser anterior a hoy." y deshabilita Guardar datos mientras sea inválida. El backend rechaza con 422 endatosPago()y enpay(): es quien manda. - Inmutables con
PAIDyCANCELLED(409PAYMENT_DATA_LOCKED), igual que los demás datos del pago: alimentan el reporte al regulador y no hay flujo de corrección. - Quién los ve. En la búsqueda de Pago solo los ve quien puede operar la transacción (viajan en
datos_pago, el mismo gate de PII que el resto): fuera de ese alcance no viajan. La ficha de la transacción (GET /transacciones/{id}) es otra cosa: devuelve la fila completa —estos dos datos, el documento, la dirección, el contacto— a quien tiene lectura de Transacciones sobre ese país y PDV, como ya pasaba conidentification_number; ahí el control es el alcance, no un gate por poder operar. El listado (GET /transacciones) no los devuelve nunca: es una lista blanca (TransactionListResource) con solo lo que muestra la tabla. Bajar los datos de muchas personas exige el reporte de Cumplimiento —permiso propio, solo Admin, auditado— o abrir las fichas de a una. - Salieron del bloque "Datos enviados por Soterex", que los mostraba como si fueran de Soterex y no editables, y de la sección "Contacto" de la ficha. Ahora están una sola vez, en el formulario.
- Si Soterex algún día los mandara, el formulario los muestra precargados (vienen de las mismas columnas) y el cajero los confirma o los corrige. Hoy
SendRequestno los define, así que llegan vacíos. - Ni los valores ni la fecha formateada van a la auditoría ni a los logs. El evento
TRANSACTION_PAYMENT_DATA_UPDATEDregistra únicamente quebirth_dateynationalitycambiaron. - Transacciones que ya estaban
ACCEPTED(por ejemplo las que esperan en staging) no tienen estos dos datos: piden ambos antes de pagarse. Es esperado. En los pagos hechos antes de B4.0 quedan vacíos y, comoPAIDes inmutable, no hay forma de completarlos después; el reporte de Cumplimiento los lleva en blanco solo en esos casos.
Actualización (G3, 2026-10-05): el medio de pago es solo efectivo
El cliente pidió sacar la transferencia de los medios de pago (RV3-12) o, si no, que no afectara el saldo del PDV (RV3-13), y Carlos ya había dejado dicho que el medio de pago es siempre efectivo (C13 del plan de ajustes v2). Se sacó de la pantalla y del backend (D3-4 b del plan de ajustes v3). El detalle de la decisión y de lo que no se definió está en Preguntas Abiertas, #3. Lo que cambia en este documento:
| Cosa | Hoy |
|---|---|
| Qué acepta el backend al escribir | Solo EFECTIVO (Transaction::DELIVERY_TYPES_ACEPTADOS). PATCH /transacciones/{id}/pay y /datos-pago responden 422 con errors.delivery_type («El medio de pago solo puede ser efectivo.») si mandan TRANSFERENCIA u otro valor, antes de tocar la caja o el prefondeo. datosPago() también acepta null (el borrador todavía sin medio) |
pay() sin medio | Sigue siendo 422 MISSING_PAYMENT_DATA con faltan: ['delivery_type']: la pantalla manda siempre EFECTIVO |
| Qué se lee | DELIVERY_TRANSFERENCIA se queda para leer: la completitud de una PAID vieja, las columnas 16 y 17 del reporte de Cumplimiento y la ficha. DELIVERY_TYPES se conserva como registro de los valores que puede traer una fila, pero ninguna lógica recorre esa lista hoy |
bank_account | Ya no se pide ni se guarda con ningún medio: pay() y datosPago() la descartan en toda escritura. Se sacó la rama que la pedía con TRANSFERENCIA (no tenía camino de entrada ni test) |
| «Confirmar pago» | Muestra el control Medio de pago con Efectivo como única opción y ya elegido (QC-7: se dejó visible, que es lo que pidió el cliente; ocultarlo es una línea). Sin bloque de cuenta bancaria. Se puede confirmar sin tocar nada |
| Formulario de datos del pago | La opción Transferencia y la cuenta bancaria solo se dibujan, en solo lectura, si el valor guardado es TRANSFERENCIA (una PAID vieja) |
Una ACCEPTED con borrador TRANSFERENCIA | No es historia: datosPago() lo guardaba mientras no se pagaba. El formulario la abre con Efectivo, no cuenta como «cambios sin guardar» y se paga con Efectivo (pay() guarda lo que manda): al guardar o pagar deja de pedir los cuatro documentos de transferencia. Hasta que eso pasa, GET /transacciones/{id}/documentos sigue devolviendo en faltan los cuatro, porque se derivan del delivery_type guardado y la lectura no lo cambia |
Una PAID vieja por transferencia | No se reescribe (los datos del pago son inmutables, ADR-011). Se ve en solo lectura con su cuenta y sigue pidiendo sus cuatro documentos |
| Los cuatro tipos de documento de transferencia | Siguen en el catálogo cerrado (hay historia que los usa). No hay forma de que una transacción nueva los pida |
Actualización (G11, 2026-10-07): el número y el país de la identificación respetan el formato del tipo
Decisión de Carlos del 2026-10-05 (D3-15 a) sobre lo que pidió el cliente en la hoja Catálogo Tipos ID (RV3-79 a 82), con el valor por defecto de QC-30. El diseño y las alternativas están en ADR-023; acá, lo que cambia en el flujo del operador. Hasta G11 el número era un texto de hasta 60 caracteres y el país, cualquiera de la lista: se podía guardar un DPI de 4 dígitos o uno emitido por Ecuador.
| Tipo | Formato del número | País emisor |
|---|---|---|
| DPI | 13 caracteres, solo números | Guatemala (GT), siempre |
| Pasaporte | de 7 a 13 caracteres, letras y números | cualquiera (sin país fijo) |
- El formato es un dato del catálogo, no del código. Son cuatro columnas del tipo (caracteres permitidos, largo mínimo, largo máximo y país emisor) que un Admin edita desde Catálogos y que quedan auditadas. Un tipo nuevo o sin reglas no valida nada. La regla no es una expresión regular que escriba una persona: es un conjunto cerrado de campos.
- El servidor valida en
datosPago()y enpay(), con el mismo código, contra el tipo efectivo: el que viene en ese pedido o, si no viene, el que la transacción ya tiene guardado (así un guardado parcial que solo cambia el número se juzga con el tipo ya elegido). Lo compara con el ítem activo del catálogo del país de la transacción. Sin tipo resoluble o sin reglas no valida. Responde 422 con el texto de la regla enidentification_numberoidentification_country, y ese texto no repite lo que se tipeó, ni siquiera el largo (ADR-016). - El servidor es estricto con los separadores (QC-30, por defecto).
2999 99999 0101y2999-99999-0101dan 422. Quien los quita es el formulario: espacios y guiones se sacan al tipear, pegar o insertar un texto entero, así que el operador nunca ve ese rechazo. Si el cliente prefiriera que el servidor los acepte, se normaliza en el backend antes de validar y la regla no cambia. - El formulario lee las reglas del combo (
GET /catalogosdevuelve las cuatro columnas) y no tiene nada escrito de «13» ni de «Guatemala»: con DPI completa el país y lo bloquea («El DPI lo emite Guatemala.»); al pasar a Pasaporte lo desbloquea y conserva el valor; marca el campo y avisa debajo («El número de DPI tiene que tener 13 dígitos, solo números.»), y bloquea «Guardar datos» hasta que cumpla. Los ceros a la izquierda se conservan. - Los datos viejos no se revalidan (D9). Una
PAIDoCANCELLEDresponde 409 antes de validar nada: su número es inmutable y el reporte de Cumplimiento lo exporta como quedó, aunque hoy no pasara la regla. UnaACCEPTEDcon un número viejo fuera de formato muestra el aviso apenas se abre y «Iniciar pago» queda deshabilitado con el motivo escrito; si de todos modos llegara apay(), el servidor lo rechaza con 422 (el número que se reenvía se juzga como cualquier valor nuevo). El operador lo corrige y guarda. - No se valida el dígito verificador del DPI. El cliente pidió largo y caracteres, no el algoritmo.
- Si un Admin desactiva
GTen la lista de países, ningún DPI se puede guardar: el país emisor del DPI esGTy un país desactivado no pasa la reglaexistsdeidentification_country. El ABM no lo impide; se arregla reactivándolo (manual de Catálogos).
La lista de países es la de G10 (251 ítems: la ISO con los 23 renombres del cliente y Kosovo y Antillas Holandesas), no la ISO a secas; el A4 y Cumplimiento muestran la etiqueta que tenga ahora (ver la papeleta).
2.2 Los nueve tipos de documento
El catálogo sale del requerimiento #5 y de la hoja Módulo caja, filas 15 a 24. Son constantes en el modelo, no una tabla de configuración — mismo criterio que los motivos de caja: son conceptos del dominio, no algo que un administrador deba poder inventar (backend/app/Models/TransactionDocument.php:27-43).
| Tipo | Rótulo en pantalla | ¿Obligatorio (completitud)? | ¿Bloquea el pago? | ¿Cuándo aplica? |
|---|---|---|---|---|
CARTA | Carta de Soterex | Sí | Sí — ADR-008 | Siempre |
IDENTIFICACION_ANVERSO | Identificación (anverso) | Sí | Sí — ADR-008 | Siempre |
IDENTIFICACION_REVERSO | Identificación (reverso) | Sí | Sí — ADR-008 | Siempre |
SELFIE | Foto del cliente con la identificación | No — "DESEABLE, no es obligatorio" | No | Siempre (opcional) |
PAPELETA_FIRMADA | Papeleta firmada | Sí | No — no puede: se firma después de pagar | Siempre |
FORMULARIO_ENROLAMIENTO | Formulario de enrolamiento | Sí | No | Solo TRANSFERENCIA (desde G3, solo las PAID viejas) |
CARTOLA_BANCARIA | Cartola bancaria | Sí | No | Solo TRANSFERENCIA (desde G3, solo las PAID viejas) |
SOLICITUD_TRANSFERENCIA | Solicitud de pago por transferencia | Sí | No | Solo TRANSFERENCIA (desde G3, solo las PAID viejas) |
CONFIRMACION_ACREDITACION | Confirmación de acreditación | Sí | No | Solo TRANSFERENCIA (desde G3, solo las PAID viejas) |
"¿Obligatorio?" y "¿Bloquea el pago?" dejaron de ser la misma pregunta desde ADR-008 (2026-09-12): los ocho no-selfie siguen siendo obligatorios para la completitud posterior (§2.3), pero solo los tres de identificación bloquean confirmar el pago. TransactionDocument::REQUERIDOS_ANTES_DE_PAGAR es ese subconjunto — no reutiliza REQUERIDOS_SIEMPRE directamente porque excluye PAPELETA_FIRMADA a propósito.
Los rótulos son los de frontend/src/services/transactionDocuments.ts:8-18.
La selfie es el único opcional
El cliente lo escribió con esas palabras en la fila 18 de la hoja Módulo caja: junto al ítem "Foto del cliente con la identificación junto al rostro (Selfie)" aclara "*DESEABLE, no es obligatorio". Coincide con la decisión #17 del plan v2, que ya lo había anticipado.
Se refleja en tres lugares:
- No está en
REQUERIDOS_SIEMPRE(TransactionDocument.php:50-55). - En pantalla lleva el sufijo
· opcionaly un ícono neutro en vez del triángulo de advertencia (frontend/src/components/DocumentacionPago.vue:171-183). - Un test explícito garantiza que nunca afecta la completitud.
Los cuatro de transferencia no se muestran en pagos en efectivo
Listarlos siempre daría la impresión de que faltan documentos que nadie espera. La lista de casilleros se arma según el medio de pago elegido (DocumentacionPago.vue:41-49). (Desde G3 el medio siempre es efectivo, así que estos cuatro casilleros solo aparecen en la ficha de una PAID vieja que se pagó por transferencia.)
2.3 Cómo se calcula la completitud
// backend/app/Models/Transaction.php:99-105
public function faltanDocumentos(): array
{
$requeridos = TransactionDocument::requeridosPara($this->delivery_type);
$subidos = $this->documents->pluck('type')->unique()->all();
return array_values(array_diff($requeridos, $subidos));
}Con EFECTIVO (o sin medio de pago elegido todavía) los requeridos son 4; con TRANSFERENCIA son 8 (TransactionDocument::requeridosPara(), líneas 83-88).
Consecuencia que vale tener presente: cambiar el medio de pago cambia la completitud retroactivamente. Una transacción completa en efectivo pasa a incompleta apenas se la marca como transferencia. Es el comportamiento correcto —los cuatro documentos extra efectivamente hacen falta— pero puede sorprender. Desde G3 (2026-10-05) el backend no deja marcar una transacción como transferencia, así que esa consecuencia no se puede dar de nuevo. Queda el sentido inverso: una ACCEPTED con un borrador TRANSFERENCIA pasa a pedir 4 documentos (en lugar de 8) apenas se la guarda con Efectivo. Ver Preguntas Abiertas, #8.
2.4 "Pagada pero incompleta" no es un estado
El cliente lo planteó como una posibilidad abierta: "podría evaluarse la posibilidad de que la tx se quede pagada pero incompleta" (hoja Módulo caja, fila 14). La tentación evidente era agregar un valor más a status.
Se decidió no hacerlo. status sigue siendo ACCEPTED / PAID / CANCELLED, y "incompleta" se deriva de los documentos que la transacción tiene contra los que su medio de pago exige.
Las razones, en orden de peso:
Un estado nuevo obligaría a revisar cada consulta que hoy filtra por
status. Listado, dashboard, reportes, prefondeo, caja, el buscador de la pantalla Pago: todos preguntanstatus = 'PAID'en algún lado. Un cuarto valor los rompe a todos en silencio — el peor tipo de rotura, porque no falla, devuelve de menos.No es una propiedad de la transacción, es una pregunta sobre otra tabla. El estado de una transacción describe qué pasó con la plata. Cuántos escaneos tiene es información de
transaction_documents. Meterlo enstatusmezcla dos ejes que se mueven por separado: una transacción puede volverse completa sin que nada cambie en su pago.Sería un estado que cambia solo. Subir un archivo tendría que mutar el estado de la transacción, y cambiar el medio de pago tendría que mutarlo de vuelta. Un
statusque se recalcula por efectos laterales de otra tabla no es un estado: es una vista con nombre engañoso.
Se expone entonces como dos cosas derivadas, en cada respuesta de la API: documentacion_completa (booleano) y faltan (los tipos que restan). El listado lo ofrece como filtro.
2.5 Los documentos son PII sensible
Es el punto más delicado de la entrega, y conviene decir por qué antes de decir cómo.
Lo que se guarda son documentos de identidad y fotografías de personas migrantes en proceso de salida voluntaria. Una filtración no es un incidente de privacidad genérico: es exponer la identidad y la ubicación de una población vulnerable. El propio material de referencia del proyecto lo trató con ese criterio — el reporte real de 2.957 transacciones y los siete documentos de ejemplo no se subieron al repositorio justamente por eso.
Cinco defensas, todas verificables en el código:
1. Nunca se sirve una URL directa al archivo. El contenido pasa siempre por TransactionDocumentController::download(), que valida permiso y alcance antes de leer el disco. El modelo esconde disk y path de toda serialización:
// backend/app/Models/TransactionDocument.php:100-101
/** El contenido no se serializa nunca: el path es interno. */
protected $hidden = ['disk', 'path'];En el frontend, ni siquiera el preview usa un <img src> apuntando al archivo: se trae como blob con el Bearer y se libera al desmontar (DocumentacionPago.vue:108-130).
2. Alcance por país y por PDV, y desde A3 también por quién puede subir. Ver §1.6. Un operador de la sucursal A no alcanza los documentos de la sucursal B, ni por pantalla ni por API conociendo el id. Además, desde A3 (D5, ADR-011 §4), una vez resuelta la transacción solo pueden subir quien la pagó, un Supervisor con alcance sobre esa estación, o un Admin — el resto de los usuarios con alcance sigue pudiendo ver y descargar, pero no subir (PermissionService::canManageTransactionDocuments). Antes de resolver (bolsa compartida) sigue rigiendo solo el alcance por país, sin esa restricción adicional — todavía no hay "quien pagó" definido.
La única excepción al acotamiento por PDV es quien pagó (o canceló) esa transacción (G2.1, 2026-10-06): entra a esa transacción aunque su PDV no sea el que fijó el primer documento, o aunque la transacción haya quedado sin PDV. Es por transacción y no por PDV, y siempre después del permiso por país: no abre las demás transacciones del PDV ajeno ni le da nada a quien no la resolvió. Ver §1.6.
Desde G5 (2026-10-06) esa lista de arriba es la de subir un tipo que falta, no la de reemplazar uno ya cargado: reemplazar, con la transacción pagada o cancelada, es solo del Supervisor con alcance sobre el PDV y del Admin, y quien pagó queda afuera. Además, «Supervisor con alcance» se evalúa dentro de una misma asignación (no sumando las de varios perfiles), y eso también cambia quién puede subir: un Supervisor del PDV B que es Cajero del PDV A ya no sube en A lo que pagó otro. Ver el punto 5 bis, más abajo, y la actualización G5 del ADR-011.
3. Cada acceso queda auditado. No solo la subida: la lectura.
// backend/app/Http/Controllers/TransactionDocumentController.php:109-116
AuditLog::record(
user: $user,
action: 'TRANSACTION_DOCUMENT_VIEWED',
entityType: 'transaction_document',
entityId: $documento->id,
transactionId: $transaction->id,
metadata: ['type' => $documento->type],
);Es el registro de quién miró el documento de identidad de una persona — exactamente lo que una auditoría de seguridad va a querer revisar. Y no es gratis: implica que la tabla de auditoría crece con cada preview.
4. La ruta la arma el servidor, siempre. Nada de lo que manda el usuario entra en el path: transacciones/{transaction_id}/{tipo}-{uuid}.{ext}. El nombre original del archivo se conserva para que el operador reconozca lo que subió, pero nunca se usa para construir la ruta (backend/app/Services/TransactionDocumentService.php:39-48). El almacenamiento es un disco documents: local en desarrollo y un bucket S3 privado en Staging y producción — acceso público bloqueado, cifrado en reposo (SSE-S3), versionado y un acceso del backend, por el task role de ECS, que puede guardar, leer y listar pero no borrar (ADR-019).
Corrección (2026-10-06, G1): hasta G1 esta defensa describía algo que no existía. El análisis decía "S3 privado con cifrado at-rest" y la entrega de infra nunca construyó el bucket: no había ninguno, nadie definía
DOCUMENTS_DISK_DRIVER=s3y la librería de S3 ni siquiera estaba instalada. Los soportes se guardaban en el disco local del contenedor y se perdían en cada deploy. La fila detransaction_documentsquedaba en Aurora, así que la pantalla seguía diciendo «Completa» (la completitud se calcula sobre filas, §2.3) y abrir el documento daba «No se pudo abrir el documento» (RV3-07). Lo cierra G1; el bucket llega con su despliegue, que corre Carlos (runbook en Staging). Lo que se subió antes no se recupera: las filas quedan y el archivo se vuelve a subir.
5. No hay borrado. No existe endpoint de baja. Un soporte contable no se borra: reemplazarlo es subir otro del mismo tipo, y el anterior queda en la base y en el almacenamiento. El modelo ni siquiera tiene updated_at (TransactionDocument.php:20). Desde G1 tampoco puede borrar la app misma: el rol con el que entra al bucket no tiene s3:DeleteObject (si algún día hace falta borrar, se hace con credenciales de administración).
5 bis. Subir lo que falta no es reemplazar lo cargado (G5, 2026-10-06). El backend distingue los dos casos por si ya existe un documento de ese tipo en la transacción:
| Estado de la tx | Subir un tipo que falta | Reemplazar uno ya cargado |
|---|---|---|
ACCEPTED | Cualquiera con transacciones:write en el país | Igual: el Cajero corrige hasta «Confirmar pago» |
PAID / CANCELLED | Quien la pagó o canceló, el Supervisor con alcance del PDV, el Admin | Solo el Supervisor con alcance del PDV y el Admin |
Si quien no puede reemplazar lo intenta, POST /transacciones/{id}/documentos responde 403 CANNOT_REPLACE_DOCUMENTS, sin fila nueva y sin archivo en el almacenamiento; GET /transacciones/{id}/documentos devuelve puede_reemplazar junto a puede_subir para que la pantalla ofrezca Reemplazar solo a quien puede. No se aplica literal «una pagada no se toca» porque la papeleta firmada se escanea después de pagar y el cierre de caja la exige: quien pagó tiene que poder subirla. «Supervisa el PDV» se evalúa dentro de una misma asignación (fondeo_caja:read más transacciones:write y que esa asignación cubra el PDV de la tx): el Supervisor de otro PDV recibe 404, un Cajero que además es Tesorería (o Supervisor de otro PDV) no gana nada sobre lo de otros. La regla y lo que descartó están en la actualización G5 del ADR-011.
Auditoría de la subida (H3-09). Una subida deja TRANSACTION_DOCUMENT_UPLOADED con el tipo y el tamaño, y un reemplazo deja TRANSACTION_DOCUMENT_REPLACED (tipo, id del documento reemplazado, estado de la tx y tamaño), una sola constancia por reemplazo. Ninguna guarda el nombre original del archivo: lo elige quien lo sube y suele traer el nombre del beneficiario. El nombre sigue en el propio documento, para que quien lo sube lo reconozca. Los asientos anteriores a G5 que lo guardaron no se reescriben (un asiento es inmutable), pero se ocultan al leer: el listado de Auditoría, su PDF exportado y el historial de la ficha pasan la metadata por AuditLog::withoutFileName(), que saca la clave original_name.
Lo que esto NO cubre, y hay que decirlo: no hay expiración ni política de retención del soporte vigente (el bucket sí expira las versiones no vigentes: 90 días en Staging, 365 en Producción), no hay cifrado a nivel aplicación sobre el contenido (el cifrado en reposo es SSE-S3, con claves administradas por S3, no una clave propia), y cualquier operador con
transacciones:writeen su PDV puede descargar cualquier documento de ese PDV. La auditoría es detectiva, no preventiva — te dice quién miró, no impide que mire. Ver Preguntas Abiertas #7.
2.6 Qué se acepta al subir
| Regla | Valor | Por qué |
|---|---|---|
| Formatos | PDF, JPG, PNG | "los soportes pueden ser fotos, escaneos o pdfs" (hoja Módulo caja, fila 14) |
| Tamaño máximo | 20 MB (hasta 2026-10-01 era 10 MB — ver nota abajo) | Son escaneos y fotos de teléfono, no videos |
| Validación de tipo | MIME real, no la extensión | Renombrar un ejecutable a .pdf es trivial |
La validación de MIME real usa la regla mimetypes de Laravel, que inspecciona el archivo, y no mimes, que confía en el nombre (TransactionDocumentController.php:52-61 y TransactionDocumentService.php:29-33). Hay un test dedicado a un archivo que dice ser PDF y no lo es.
Si el archivo no pasa, el frontend traduce el 422 a un mensaje concreto en vez de repetir el error del backend: "El archivo no es válido: tiene que ser PDF, JPG o PNG, de hasta 20 MB" (frontend/src/utils/soporteDocumento.ts, desde G1; antes estaba en DocumentacionPago.vue).
Qué dice la pantalla cuando algo falla (G1)
Desde G1 la pantalla no manda al servidor lo que sabe que va a rechazar y distingue la causa de cada falla, en vez de un «No se pudo…» que no dice qué hacer. Debajo de la lista de documentos, quien puede subir ve «PDF, JPG o PNG, de hasta 20 MB».
| Qué pasa | Qué dice | Dónde se corta |
|---|---|---|
| El archivo pesa más de 20 MB | «El archivo pesa N MB y el máximo es 20 MB. Probá con uno más chico.» | La pantalla: no se envía |
| No es PDF, JPG ni PNG (se mira el tipo y, si el sistema no lo informa, la extensión) | «El archivo tiene que ser PDF, JPG o PNG.» | La pantalla: no se envía |
| El backend lo rechaza por su tipo real o su tamaño (422) | «El archivo no es válido: tiene que ser PDF, JPG o PNG, de hasta 20 MB.»; si el 422 trae code, el mensaje del backend más «(código X)» (salvo el de la fila siguiente, que tiene su propio aviso) | Backend (finfo y max:20480) |
Un 422 ACTIVE_STATION_REQUIRED (G2.2): el primer documento fija el PDV y quien tiene dos o más sin ninguno activo ni caja abierta no tiene cuál | Aviso titulado «Falta tu PDV activo» con el mensaje del backend, que dice dónde se fija. No se lee como un archivo inválido: el PDF está bien | Backend, antes de guardar nada |
| Sin conexión o cortada a medias, un 413, o un 403 sin cuerpo (lo rechazó el WAF o el balanceador, no la app) | «No se pudo enviar el archivo: revisá la conexión o probá con uno más chico» | Red, nginx o WAF |
Un 403 de la app (CANNOT_MANAGE_DOCUMENTS) | «No tenés permiso para subir soportes en esta transacción.» y la pantalla vuelve a pedir lo que puede hacer | Backend |
Un 403 CANNOT_REPLACE_DOCUMENTS (G5): el tipo ya está cargado y quien sube no puede reemplazarlo | Aviso titulado «No se puede reemplazar ese documento» con el mensaje del backend (a quién pedir la corrección y que lo que falta sí se puede subir), y la pantalla vuelve a pedir lo que puede hacer | Backend, antes de validar el archivo |
Un 5xx al subir (S3 o IAM caídos, por ejemplo: el backend contesta 503 con DOCUMENT_STORAGE_UNAVAILABLE y el detalle va al log, no a la respuesta) | «Error del servidor, avisá a soporte» | Backend o almacenamiento |
Al abrir: el 404 DOCUMENT_FILE_MISSING | «El archivo no está disponible. Un Supervisor o Admin puede volver a subirlo.» | Backend: la fila existe y el archivo no |
| Al abrir: sin conexión o cortada a medias | «No se pudo abrir el documento: revisá la conexión» | Red |
| Al abrir: un 5xx (el almacenamiento no responde) | «Error del servidor, avisá a soporte» | Backend o almacenamiento |
| Al abrir: cualquier otro error | «No se pudo abrir el documento» | — |
Las capas de límite, de la de adentro hacia la de afuera: la pantalla corta en 20 MB; Laravel valida el mismo tope (max:20480 KB); PHP descarta lo que pasa de 25 MB (upload_max_filesize) y nginx contesta 413 por encima de 30 MB (client_max_body_size). Las dos últimas existen para que la validación de la app sea la que manda (backend/docker/php-uploads.ini y backend/docker/nginx.conf), y delante de todo está el WAF, que solo mira los primeros 8 KB del cuerpo.
Cuando el archivo ya no está
DOCUMENT_FILE_MISSING es el caso en que la fila existe y el archivo no: la respuesta es un 404 controlado, no un 500, y la pantalla lo dice. Reintentar no lo arregla; hay que volver a subirlo, y como la fila vigente de ese tipo existe, subirlo es un reemplazo (§2.5, punto 5 bis): con la transacción ACCEPTED, cualquier Cajero con escritura; pagada o cancelada, un Supervisor con alcance sobre el PDV o un Admin. Quien pagó no puede reemplazar un soporte ya cargado, aunque su archivo falte (recibe CANNOT_REPLACE_DOCUMENTS): tiene que pedírselo a uno de ellos. Mientras no se suba, la pantalla sigue mostrando «Completa» porque la completitud mira filas (§2.3).
Y el chequeo que bloquea el pago también mira filas, no archivos (ADR-008): una transacción ACCEPTED con la Carta y la identificación subidas antes de G1, con el archivo ya perdido, pasa esa compuerta y se puede pagar sin ningún soporte guardado. Hasta que se decida otra cosa (verificar el archivo en cada pago cuesta una consulta al almacenamiento por documento), se cubre a mano: antes de dejar que el cliente pague, se vuelve a subir la Carta y la identificación de las ACCEPTED que figuran en documentos:verificar.
La medida del daño es el comando de solo lectura php artisan documentos:verificar (--detalle para ver cuáles): cuenta los soportes sin archivo sin tocar nada y sin imprimir datos personales. «Sin archivo» cuenta solo el soporte vigente de cada tipo: reemplazar inserta una fila nueva y deja la anterior, y esa se cuenta aparte como «reemplazada», para que reparar un soporte baje el número. Cómo correrlo, en el runbook de Staging.
Corrección (2026-10-01): el límite de 10 MB de TransactionDocumentService::MAX_BYTES nunca fue el que de verdad decidía — PHP-FPM corría con los defaults de la imagen base (upload_max_filesize=2M, post_max_size=8M), muy por debajo. Cualquier archivo de más de ~2 MB (una foto de teléfono común) se descartaba antes de que esta validación llegara a correr, y el fallo se veía como un error genérico, no como el 422 claro de acá arriba — encontrado en Staging tras pedirle a un usuario real que subiera un archivo propio. Se subió el límite de la app a 20 MB y se agregó backend/docker/php-uploads.ini (con client_max_body_size de nginx también subido) para que ESTA validación sea la que realmente manda.
2.7 Cómo se ve en pantalla
Los nueve tipos se muestran como una secuencia de pasos numerados (1, 2, 3...) — un stepper visual, no una lista plana. Sigue sin ser un wizard bloqueante: cualquier paso se sube en cualquier orden, incluso días después, y nunca hay un paso deshabilitado ni un "Siguiente" que dependa de completar el anterior. El número es solo para guiar el ojo por la lista; no marca un camino obligatorio, y por eso el conector entre los círculos es siempre de un color neutro, nunca una barra de progreso que se "completa" de arriba hacia abajo. Sigue siendo la misma decisión de §1.4 (R3): el pago no depende de esto.
Cada paso es un círculo numerado que se convierte en tilde cuando el documento está — mismo criterio de siempre: tilde si está, borde de alerta si falta y es obligatorio, borde neutro si es la selfie. Junto al número va el nombre del tipo, el nombre del archivo subido (clickeable, abre el preview) y una sola acción por fila (G5.4, §2.5, punto 5 bis): Subir en el hueco vacío, si puede_subir, y Reemplazar en uno ya cargado, solo si puede_reemplazar. Antes de G5 la misma etiqueta cambiaba según hubiera o no documento, sin mirar quién era la persona.
- Quien puede reemplazar (el Cajero mientras la tx está
ACCEPTED; pagada, el Supervisor con alcance y el Admin) ve además, debajo del nombre de cada archivo, «Subido pormailel dd/mm» (con el año si es de otro): es lo que necesita para decidir un reemplazo. Solo viaja el mail de quien subió, nunca algo del beneficiario. - Quien no puede (por ejemplo, el Cajero que pagó) ve los documentos y los puede abrir, sin botón en los cargados, y debajo de la lista una línea: «Solo consulta: los documentos cargados no se modifican; si hay un error, pedíselo a un Supervisor o Admin». La línea aparece solo si hay algún documento cargado, y el texto «podés completar los soportes que falten» solo se le muestra a quien de verdad puede subir.
- Si de todos modos la subida falla con
CANNOT_REPLACE_DOCUMENTS(el permiso cambió con la pantalla abierta), el aviso es el mensaje del backend —quién puede corregirlo y que lo que falta sí se puede subir—, no el genérico de permisos. - Los campos de Datos del pago de una pagada o cancelada se ven deshabilitados de verdad: fondo gris, texto atenuado y cursor de «no permitido», en claro y en oscuro (G5.6). El backend ya los rechazaba con
PAYMENT_DATA_LOCKED; el preflight de Tailwind dejaba un controldisabledidéntico a uno editable y por eso el cliente los leía como modificables.
Arriba a la derecha, un badge dice Completa o Faltan N. Abajo, cuando falta algo, un texto que importa por lo que evita:
"El pago ya quedó registrado. Podés completar los soportes que falten desde acá cuando los tengas — no hace falta rehacer nada." —
DocumentacionPago.vue
Es la traducción a la pantalla de la decisión de §1.4: el operador tiene que entender que la falta de un escaneo es una tarea pendiente, no un pago fallido. Sin esa frase, el badge rojo invita a pensar que algo salió mal y a intentar pagar de nuevo.
Si no se puede ni consultar el estado de los documentos, la pantalla no muestra el stepper ni el badge. Mostrar Faltan 0 en ese caso sería peor que no mostrar nada — se leería como "no falta nada" cuando en realidad no se sabe. Hay dos formas de que no se pueda consultar, y desde G2.3 (2026-10-06) la pantalla las distingue, porque no se resuelven igual:
| Qué pasó | Qué ve el operador | Qué ofrece la pantalla |
|---|---|---|
404 en la lista de soportes: una transacción PAID de otro PDV que la búsqueda sí encontró (acota por país) pero cuyos documentos están fuera de alcance (§1.6), y a la que el usuario no pagó | En gris, no en rojo: "Esta transacción se pagó en otro punto de venta: sus soportes y su papeleta los ven ese PDV, un Supervisor o un Administrador." | Nada para reintentar. Sin los botones de Imprimir papeleta (ni el de tirilla ni el de A4): la papeleta cae bajo el mismo alcance y ofrecerla sería ofrecer un 404 |
| Otra falla (red caída, 5xx, 403) | En rojo: "No se pudo cargar la documentación de esta transacción." | Volver a buscar la transacción o recargar la pantalla. La papeleta sigue ofrecida, porque ahí sí puede funcionar |
El 404 es el alcance, no una falla: reintentar no lo arregla. Quien sí pagó la transacción nunca ve el primer caso aunque su PDV sea otro: entra por la excepción de §1.6, ve el stepper y puede subir lo que falte. Con la papeleta pasa lo mismo, y el aviso también distingue: con un 404 dice "No tenés acceso a la papeleta de esta transacción: se pagó en otro punto de venta" y no sugiere reintentar; con una falla de red o un 5xx dice "No se pudo generar la papeleta, probá de nuevo".
El bloque previo al pago (Documentos para poder pagar, los tres bloqueantes) no cambia en lo que bloquea: ahí un 404 sigue diciendo "No se pudo cargar la documentación de esta transacción", porque el mensaje de «se pagó en otro punto de venta» no corresponde a una transacción que todavía no se pagó. Sí cambia en lo que muestra (G5.7, RV3-11):
- Cada documento dice quién lo subió y cuándo («Subido por
mailel dd/mm»), para todos: acá nadie decide un reemplazo, pero todos tienen que poder cotejar. - Los documentos de un intento anterior se mantienen y se avisan. Los tres se guardan contra la transacción desde la primera subida (ADR-008, §1), así que al volver a buscar una transacción que alguien dejó a medias la tarjeta los trae. El cliente no quiere verlos como si fueran de este intento ("Si se busca una tx y no se la paga, la herramienta no debería traerme cargados los documentos"); como la frase admite dos lecturas —no ver los de un intento anterior, o no ver la sección al solo consultar—, se implementó lo que sirve en las dos (D3-10, opción 1) y la pregunta quedó hecha al cliente (QC-3). Sobre la lista, una línea: «Estos documentos ya estaban cargados desde el dd/mm. Verificá que correspondan a quien tenés enfrente.» (en singular si es uno).
- «De un intento anterior» es lo que ya estaba cuando se abrió la tarjeta para esa transacción. Lo que se sube después, en la misma pantalla, no lleva el aviso; reemplazar el último documento previo lo hace desaparecer. «Desde» es la fecha del más antiguo. El cliente contestó QC-3 el 2026-10-14 con la lectura (b): la sección no se muestra hasta tocar Iniciar pago, y el pago se confirma con un botón Pagar debajo de ella (L2, 2026-10-19; ver la actualización de ADR-008). Cambió cuándo se pide y se muestra la lista, no el backend.
Análisis Funcional: Pago con documentos — parte 3 de 5. ← El flujo del pago · Índice · Siguiente: La papeleta →

