GatewayPrismaQR · traspaso para el equipo del POS · borrador para revisión · 2026-10-29

Imputación del recargo o descuento QR en el POS

Cómo debe imputar un POS DOS, después del pago, el recargo o descuento que GatewayPrismaQR le devuelve en un pago QR: la referencia es la implementación de la rama del cliente DINO (solo descuentos), con lo que falta para llevarla al POS de Almacor y soportar recargos.

Regla central
INV-06 · nunca registrar una venta por otro importe que el cobrado
Referencia
rama del cliente DINO · solo descuentos ejecutados
Destino
POS de Almacor · 20261003 · rama feat/qr-imputation
Estado del documento
borrador, sin confirmar por el responsable del proyecto ni por el equipo del POS

Documento de traspaso para el equipo del POS. Describe cómo un POS DOS debe imputar, después del pago, el recargo o descuento que GatewayPrismaQR le devuelve en un pago QR, tomando como referencia la implementación que ya existe en la rama del cliente DINO (solo descuentos), y qué falta para llevarla al POS de Almacor y para soportar recargos.

Estado: borrador para revisión (2026-10-29). No está confirmado por el responsable del proyecto ni por el equipo del POS.

Estado del port a Almacor (2026-10-31; actualizado el 2026-11-01). El código fuente de Almacor está ahora en el repositorio privado tipre/POS_ALMACOR; la línea base es la versión 20261003, intacta en main, y la compilación es reproducible con DOSBox-X y bcc286 (receta en el BUILD.md de ese repositorio). G-01 (sección 1.5) está corregido en la rama fix/g01-consulta-amounts: los montos de la consulta se copian con una verificación de coherencia (importe + recdesc == final, y importe igual al de la venta). El responsable decidió el 2026-10-31 que los recargos terminan en falla explícita (el POS rechaza y pide trxanulacion) y que los descuentos se imputan como en la rama del cliente DINO; ese trabajo está implementado en la rama feat/qr-imputation, sin integrar. Los resultados de las pruebas en el kit y los defectos abiertos están en SISTEMA.md §2. El traspaso de G-01 para la rama del cliente DINO ya se entregó a esa sesión.

Cómo leer este documento

Convención de rutas: [DINO] es el árbol de la rama del cliente DINO; [ALM] es el árbol src/ALMACOR de la versión 20261003 del POS de Almacor. Los números de línea corresponden a los árboles leídos el 2026-10-29 y se desplazan con cualquier edición; los marcadores de la rama DINO (//20260903 QRDTO, //20260913 QRFILA, //20260917 QRDTO impresion neto, //20260922 QRDTO percepcion minimo, //20260922 F19, //20260923 PERC3, //20261013 QRVOU) son más estables.

Resumen

  1. El gateway decide el ajuste (recargo o descuento) con los planes que el comercio configuró en su consola; el cliente elige el plan en la billetera. El POS envía solo el importe original y recibe importe, importe_recdesc e importe_final con importe + importe_recdesc == importe_final al centavo (INV-04).
  2. Hoy el POS de Almacor lee importe_recdesc ([ALM] pos_ctoq.cpp:3508) y lo ignora: registra la venta por el importe original mientras la billetera cobró otro. Eso viola INV-06. Mientras no se corrija, no se debe habilitar ningún plan con ajuste distinto de cero (ISSUES-DEFERRED D-133).
  3. La rama DINO ya imputa descuentos: cobra importe_final, baja el total del ticket, escribe una fila de detalle negativa por alícuota de IVA (el IVA se recalcula desde el neto, no se prorratea), reescala las percepciones, imprime una línea Rec/Desc y deja el voucher con original, ajuste y final. Rechaza los recargos devolviendo 0 y el llamador ignora ese 0, de modo que tampoco falla de forma explícita.
  4. Hay tres brechas que no se resuelven trasladando el código y que este documento destaca: (a) cuando el pago se aprueba por la consulta, ambos POS descartan importe_final e importe_recdesc (sección 4, G-01); (b) el motor de percepciones y el origen de fRecDescMPP de Almacor son distintos de los de DINO (G-05, G-06); (c) no existe en Almacor una llamada programática a trxanulacion, imprescindible para la falla explícita (G-11).
  5. Los recargos no están ejecutados en ningún POS. Dos decisiones no son técnicas y las debe tomar una persona: el tratamiento de IVA del recargo y qué hacer con las percepciones cuando el ajuste es positivo (sección 7).

1. Flujo completo

1.1 Quién decide qué

Paso Quién Qué decide
Planes (cuotas, banco, rango de BIN, porcentaje con signo, vigencia, días, mínimo) El comercio, en la consola del gateway El ajuste posible para cada tarjeta. Gana el plan más específico (rango de BIN, luego banco, luego medio; sucursal antes que comercio). ADR-003: Modo B únicamente; lo que un POS envíe sobre planes (promos, base_amount) se ignora (AC-18).
Elección del plan El cliente, en la billetera Cuántas cuotas y con qué medio de pago.
Monto del ajuste El gateway ajuste = ROUND((ROUND(importe) × ROUND(porcentaje)) / 100), un solo redondeo, mitad hacia afuera de cero (sección 5).
Imputación en el ticket El POS Registrar la venta por importe_final, repartir el ajuste por alícuota, recalcular percepciones, imprimir, acumular.
Falla de imputación El POS Fallar de forma explícita y pedir la reversa (INV-06). El gateway no puede saber que el POS falló.

1.2 Secuencia

sequenceDiagram
    participant C as Cajero / POS
    participant G as GatewayPrismaQR
    participant B as Billetera (Prisma)
    C->>G: POST /api/trxid {pos, sucursal, comercio}
    G-->>C: 201 {id}
    C->>G: POST /api/trxpago {id, totalitem, totalcashback, nropv, nroticketfiscal}
    G->>B: intención de pago
    B-->>G: BINs de la billetera
    G->>B: intención completa (planes con ajuste)
    B-->>G: el cliente paga con un plan
    G-->>C: AUTORIZACION_DE_PAGO_APROBADA {importe, importe_recdesc, importe_final, ...}
    Note over C: Imputa el ajuste y cierra por importe_final
    alt no puede imputar (INV-06)
        C->>G: POST /api/trxanulacion {id}
        G-->>C: 200 AUTORIZACION_DE_ANULACION_APROBADA
    end

Si el POS no recibe la aprobación en trxpago, consulta GET /api/trxes/{id} cada 10 s (sección 1.4). La aprobación puede llegar recién por la consulta, con los mismos campos.

1.3 Qué envía el POS

Solo el importe original. En Almacor ([ALM] pos_ctoq.cpp:3430-3456, PAGOQR::Op):

Operación Campos
POST /api/trxid pos, sucursal, comercio
POST /api/trxpago id, totalitem (importe original), totalcashback, nropv, nroticketfiscal
POST /api/trxanulacion id = id del pago, trxidoriginal = 0, nropv, nroticketfiscal
GET /api/trxes/{id} sin cuerpo

El POS no envía planes, porcentajes ni cuotas. La rama DINO además envía base_amount (//20261001 QRBASE); el gateway lo ignora (AC-18) y el POS de Almacor no lo envía ni lo necesita.

1.4 Qué recibe el POS

La respuesta de trxpago y la de la consulta tienen la misma forma (SISTEMA.md, "La respuesta"):

Campo Tipo Signo y significado
id número id del pago en el gateway
estado texto ver tabla de estados
statuscode número 0 correcto, 1 denegado
importe número importe original enviado por el POS, sin ajuste y sin cashback
importe_recdesc número con signo positivo = recargo, negativo = descuento, 0 si no hay ajuste
importe_final número lo que cobró la billetera por la compra: importe + importe_recdesc. Nunca incluye totalcashback
cuotas, paymentinstallments número cuotas elegidas (el POS lee paymentinstallments, [ALM] pos_ctoq.cpp:3485)
payment_method_id, payment_method_type texto medio de pago de la billetera
mediodepago texto rótulo del procesador que se imprime en el voucher (por defecto PRISMA)
autorizadortrxid, autorizadorintencionid cadena de dígitos ids de la billetera. No se deben convertir a otro tipo
mensajevarios texto, a lo sumo 79 bytes UTF-8 en una aprobación, el código de autorización; en una denegación, el motivo
totalcashback número solo si el pago pidió cashback: lo que el cliente retiró. Una denegación o anulación nunca lo lleva

Solo un pago que la billetera pagó (APPROVED, ANNULLED, REFUNDED) lleva el resultado de la billetera.

Estados y qué hace el POS de Almacor con cada uno ([ALM] pos_ctoq.cpp:3511-3556, localPAGOQR_Op_v2 3625-3792):

estado En trxpago En la consulta El POS
AUTORIZACION_DE_PAGO_APROBADA venta venta termina la espera, aprobado
AUTORIZACION_DE_ANULACION_APROBADA pago anulado o en anulación ídem termina la espera, no es venta
REFUND_DENEGADO no se usa pago decidido como "sin venta" termina la espera, denegado (AC-05, ADR-004)
AUTORIZACION_DE_PAGO_DENEGADA, INTENCION_DE_PAGO_RECIBIDA_DENEGADA denegado no se usa sigue consultando
INTENCION_DE_PAGO_RECIBIDA_APROBADA, OBTENCIONIDTRX, INTENCION_DE_PAGO_ENVIADA pago no liquidado todavía ídem sigue consultando

Solo tres estados cortan el ciclo de consultas: REFUND_DENEGADO, AUTORIZACION_DE_PAGO_APROBADA y AUTORIZACION_DE_ANULACION_APROBADA. INTENCION_DE_PAGO_RECIBIDA_APROBADA (statuscode 0) es el estado diferido de ADR-004: el gateway no pudo registrar su intención de responder "aprobado" y pide que el POS vuelva a preguntar; no es una aprobación y el POS no debe imputar nada con ella.

Tiempos del POS de Almacor: la primera lectura de trxpago dura max(perfil 496 / 3, 30) s; si la respuesta no es una aprobación, el POS espera 10 s y consulta (lectura de 5 s, perfil 497), y repite hasta (496 / 3) × 2 s (unos 100 s) después de la primera respuesta; luego pregunta al cajero "Reintenta via Consulta del PAGO?". El perfil recomendado del gateway para ese llamador está en RUNBOOK §3.

1.5 Hallazgo: la aprobación por consulta pierde los montos (ambos árboles)

Caso real documentado (E2E del 2026-10-04, D-105): el POS oye "denegado" en trxpago y después "aprobado" en la consulta. Cuando la consulta devuelve la aprobación, localPAGOQR_Op_v2 copia a trxpagoqr solo estado, statuscode, los dos ids, mediodepago, payment_method_* e icuotas ([ALM] pos_ctoq.cpp:3766-3773; [DINO] pos_ctoq.cpp:3773-3780). No copia importe, importe_final, importe_recdesc, importe_cashback ni mensajevarios. El gancho de imputación recibe entonces importe_recdesc == 0, lo toma como "sin ajuste" y registra la venta por el importe original. Es una violación de INV-06 que sobrevive a cualquier port que solo agregue la imputación. Lo mismo ocurre con la consulta de localAnulacionQR_Op ([ALM] pos_ctoq.cpp:3836-3843). Verificado en código; no ejecutado. Ver G-01 y el caso T-12.


2. Contrato del gateway

Fuentes: CONSTITUTION.md, ACCEPTANCE.md, ADR-003, ADR-004, SISTEMA.md, PLANES-CUOTAS.md.

2.1 Invariantes que tocan al POS

Invariante Texto Consecuencia para el POS
INV-04 importe + importe_recdesc == importe_final al centavo en toda respuesta. El POS debe verificarlo de todos modos (tolerancia 0,005) y rechazar la respuesta si no cierra: es la defensa ante un gateway distinto o una respuesta mal formada.
INV-06 El POS nunca registra una venta QR por un importe distinto del que cobró la billetera; si no puede imputar el ajuste, falla de forma explícita y el pago se revierte. Es la regla que ordena este trabajo. El código vive en el POS.
INV-01 Lo que cuenta es la última respuesta que oyó el POS. Si el gateway le dijo "aprobado" (en trxpago o en la consulta), es una venta y el gateway nunca la compensa como "sin venta". Si el POS decide no registrar una venta que ya oyó aprobada, debe pedir la reversa él mismo con trxanulacion. Nadie más lo hará.
AC-17 El ajuste nunca se aplica al cashback. El ajuste se calcula sobre importe únicamente. importe_final no incluye totalcashback. El efectivo se imputa aparte.
AC-23 / AC-24 trxanulacion es idempotente y responde 2xx (AUTORIZACION_DE_ANULACION_APROBADA) también para un pago nunca aprobado. Para un pago aprobado agenda anulación forzada o reembolso. Es seguro repetirlo hasta recibir un 2xx.

2.2 Cuotas, medio y planes

2.3 Qué vuelve en una anulación

La respuesta de trxanulacion (PosAnnulmentResponses) lleva importe (original) y, si el pago fue pagado por la billetera, importe_final e importe_recdesc reales; si el pago se canceló o nunca fue venta, no lleva resultado. El POS acepta como anulada solo una respuesta HTTP 200 o 201 con REFUND_APROBADO o AUTORIZACION_DE_ANULACION_APROBADA ([ALM] pos_ctoq.cpp:3551-3555). Un 409 ANNULMENT_NOT_POSSIBLE no es éxito (D-S4-8).


3. Cómo lo resuelve la rama del cliente DINO

Orden de ejecución dentro de _ProcessKeyTOTAL ([DINO] pos_mppo.cpp, desde la línea 3722).

3.1 Cobro

  1. El cajero carga el medio de pago QR (una sola vez por ticket: [DINO] pos_mppo.cpp ActiveDMdeP, igual que [ALM] pos_mppo.cpp:3231-3233) con el saldo del ticket como importe. La fila queda en el browse de medios con dImporte = importe original.
  2. Al apretar TOTAL, el lazo de [DINO] pos_mppo.cpp:3819-3963 recorre las filas QR sin autorizar (iPeriodo == 0), arma trxpagoqr.importe = dImporte y llama PAGOQR_Op.
  3. PAGOQR::Op ([DINO] pos_ctoq.cpp:3405-3570) parsea la respuesta (3481-3515). Prefiere los nombres de campo de otro procesador (total, paymentid, merchantorderid, totalitem) sobre los del gateway (importe_final, autorizadortrxid, autorizadorintencionid, importe) y cae a los del gateway si faltan; con GatewayPrismaQR se usan los del gateway. Lee importe_recdesc (3515). Acepta el pago solo con PAGO_APROBADO o AUTORIZACION_DE_PAGO_APROBADA (3551-3557).
  4. Se cobra importe_final: la fila del medio QR pasa de dImporte = importe original a dImporte = importe_final, y dRecDesc = importe_recdesc ([DINO] pos_mppo.cpp:3713-3714, dentro de la imputación; y el espejo en dE_DMdeP, 3943-3949).

3.2 Imputación como descuento por medio de pago

Función PagoQR_ImputarDescuento ([DINO] pos_mppo.cpp:3625-3718, marcador //20260903 QRDTO), llamada en 3895 antes de mbase->Update(). Define D = -importe_recdesc redondeado (magnitud positiva del descuento) y aplica estas guardas, en orden:

Guarda Efecto en DINO Línea
importe_recdesc == 0 (!VALIDAR) no hace nada; flujo normal 3629
D < 0 (llegó un recargo) log [QRDTO] RECHAZADO ... recdesc positivo, devuelve 0 3633-3636
abs(importe_final - (importe + importe_recdesc)) >= 0.005 rechazo importe_final incoherente, devuelve 0 3637-3641
D > Ticket.TotalCobrar rechazo descuento mayor al total, devuelve 0 3642-3645
misma autorizadortrxid ya imputada (cQRDto_TrxId[26]) log ya imputado, devuelve 0 (idempotencia) 3648-3651

El llamador (3895) usa el valor devuelto solo para decidir si espeja dImporte/dRecDesc en dE_DMdeP (3946). Un rechazo no detiene la venta: el ticket se cierra por el importe original mientras la billetera cobró importe_final. Para un descuento rechazado el POS registra más de lo que cobró la billetera; para un recargo, menos. Es el "peligro de hoy" de PLANES-CUOTAS §10.3.

Si todas las guardas pasan, calcula r = D / Ticket.TotalCobrar (ratio global único, 3654) y ejecuta, en este orden que importa:

  1. tick->PagoQR_AppendFilasDescuento(dTotalAntes, r, trx.mediodepago) (3665-3666): escribe las filas de detalle (3.3).
  2. Si hay percepciones habilitadas y el ticket ya tiene percepción (POSConPercepcionesHabilitadas() && VALIDAR(Ticket.Percepcion)): RecomputePercepcionxPromoMdeP(3, -r × NetoSinPercepcion, ...) (3677-3686) (3.4). Va después del paso 1: el paso 1 lee Ticket.Percepcion y el recómputo la reescribe; al revés el ticket queda corto (bug F13, 275,65 en vez de 275,00).
  3. PagoQR_ProrratearDataRedondeos(r) (3688): ajusta los buckets de redondeo fiscal (3.5).
  4. Acumuladores dQRDto_Descuento, dQRDto_TotalAntes, cQRDto_TrxId (3691-3695).
  5. ViewSaldo(-D) (3700): TotRecDesc += -D, TotalNeto = TotalInicial + TotRecDesc, TotalCobrar = TotalNeto. Ticket.Saldo no se toca: el pago y el total bajan lo mismo y el saldo sigue en 0.
  6. Para la fila del medio QR en Ticket.total[n]: importe -= D, recdesc += importe_recdesc (3704-3710). De ahí sale, en UpdateTMdeP, la acción idRECARGO_DESCUENTO de dE_TMdeP (3.7).
  7. mbase->assign(dImporte, importe_final) y dRecDesc = importe_recdesc (3713-3714).

Hay dos caminos disjuntos que coinciden en el mismo número y no se duplican: ViewSaldo mueve los totales en memoria del ticket (TOTAL impreso, saldo, impuestos internos por diferencia); ComputarBinario arma dE_TResu exclusivamente desde las filas de ETdet y no lee Ticket.*. El único lugar donde se encuentran es ImprimirIVAS.

Dos debilidades de DINO, verificadas en código: (a) se ignora el valor devuelto por PagoQR_AppendFilasDescuento (3665-3666), que devuelve 0 si el bruto de los ítems es 0 o si el ratio efectivo supera 1; el total baja pero no hay filas; (b) la idempotencia es por ticket en memoria (cQRDto_TrxId), y se reinicia en COBRO ([DINO] pos_mppo.cpp:4776-4778).

3.3 Reparto por alícuota de IVA y centavo residual

Función TICKET::PagoQR_AppendFilasDescuento ([DINO] pos_tic2.cpp:987-1157, marcador //20260913 QRFILA). El beneficio se materializa como filas de detalle (ETdet → dB_TDeta/dE_TDeta), una por alícuota con monto distinto de cero, con bAcumulado = 1 y montos negativos, igual que una promoción por medio de pago clásica. Con eso, ComputarBinario, el Informe Impositivo y la Nota de Crédito ven el descuento sin parches.

Algoritmo (buckets del detalle: 0 = IVA 21 %, 1 = IVA 10,5 %, 2 = exento):

  1. Monto del lado venta: dDVenta = ROUND((TotalAntes - Percepcion) × r). El D que informa la billetera se calculó sobre el total con percepción; a la percepción le baja su parte RecomputePercepcionxPromoMdeP por separado. Sin percepción, dDVenta == D (997-998).
  2. Barrido de las filas de ítem (bAcumulado == 0, sin percepciones): por bucket, precio fiscal P, IVA T, impuestos internos II y neto N = P - (T + II) (1008-1036).
  3. Ratio efectivo r_eff = dDVenta / ΣP contra el bruto real de las filas (1040). No se reusa r global: un ticket que ya trae una promoción por medio de pago clásica tiene su monto en TotalCobrar pero todavía no como fila. Con r_eff las filas suman exactamente -dDVenta. Si r_eff > 1 + 1e-9 no se escribe nada; si r_eff > 1 se limita a 1 (beneficio del 100 %).
  4. Por bucket: K = ROUND(N × r_eff); N' = ROUND(N - K); II' = ROUND(II × (1 - r_eff)); T' = ROUND(N' × (1 + tasa)) - N' (el IVA se recalcula desde el neto ya ajustado, nunca se prorratea); fila ΔT = ROUND(T' - T), ΔII = ROUND(II' - II), ΔP = ROUND(-K + ΔT + ΔII) (1050-1068).
  5. Centavo residual: residuo = (-dDVenta) - ΣΔP (1074). Se asigna entero a un solo bucket: el de mayor neto N entre los buckets que tienen ítems (desempate: el primero en el orden 21 %, 10,5 %, exento, porque la comparación es > estricta). Dentro de ese bucket va a los impuestos internos (ΔII += residuo) si el bucket tiene impuestos internos; si no los tiene, queda solo en el neto de la fila (ΔP += residuo sin tocar ΔII, ni el IVA) (1075-1094, fix //20260923 PERC3 P10). El residuo nunca va al IVA.
  6. Una fila por bucket con ΔP != 0. Campos: bAcumulado = 1, fPrecio = PrecioFiscal = ΔP, fNetoFiscal = ΔP - (ΔT + ΔII), fImpInterno = ΔII, Tax0Fiscal/Tax2Fiscal = ΔT según el bucket, Cantidad = Unidades = 1, iNroTicket, cFecha, iPromoPrior = 0, descripción = mediodepago de la respuesta (o DTO BILLETERA QR). La identidad de la fila (EAN, artículo, depto, número de promoción) sale de los perfiles 564 a 567 con valores por defecto (PagoQR_FilaIds, 962-985) y es la misma para alta, baja e impresión.

Con el residuo asignado así, los tres libros (detalle, dE_TResu, pagos) cierran; la invariante I2 de la matriz (|IVA − ROUND(neto × tasa)| ≤ 0,01) admite el centavo que el residuo pone en el neto. Ver la sección 5.

3.4 Percepciones

RecomputePercepcionxPromoMdeP(UpdatePercepcion, dRecDescPromo, &dRecDescPorPercep) ([DINO] pos_tic2.cpp:2210-2276). La imputación QR lo llama con modo 3 (3684), introducido por //20260922 QRDTO percepcion minimo.

3.5 Impresora fiscal

No verificado. La rama DINO nunca se ejecutó contra una impresora fiscal (el entorno de prueba no la tiene). Lo que hay en el código:

3.6 Ticket y voucher

Ticket (sin impresora fiscal). PrintRecDescMdeP ([DINO] pos_vnta.cpp:4279-4322, llamada desde ControlDeMdeP::UpdateTMdeP, [DINO] pos_mppo.cpp:910, justo antes de FinalPrintAjusteDiferencias) imprime una línea Rec/Desc <rótulo> <importe> con SF_Status = 3 entre el SUBTOTAL y el TOTAL, solo para la fila cuyo medio es QR (EsPagoQR, fix F19 //20260922). El importe impreso es lo realmente imputado al detalle, no el D bruto:

Con percepción la línea es −275,00 (el lado venta) y no −281,44 (el D completo); así el pie de la Factura B cierra: SUBTOTAL - promo previa + Rec/Desc + percepción == TOTAL (invariante I5).

Voucher QR ([DINO] pos_ctoq.cpp:4160-4200, PAGOQR_Voucher; helper PagoQR_VoucherMontos, 3996-4003; script REPORTER/NOFISCAL/VO_QR.SCP, //20261013 QRVOU). Si hay ajuste imprime tres líneas: Importe original (SF_fTotal), Dto. beneficio (SF_MontoOferta, con signo) e Importe pagado (SF_GranTotal); sin ajuste, una sola línea Importe. En el voucher de anulación las mismas tres con Importe anulado. El rótulo Dto. beneficio está fijo en el script y es incorrecto para un recargo (ver G-10). La reimpresión (_PAGOQR_RePrintUltVoucher) lee dRecDesc e dImporte de dE_MdeP/dE_DMdeP (4186-4187, 4326-4327).

3.7 Acumuladores de cierre (Z)

Dónde Qué queda Verificado
dE_MdeP / dE_DMdeP dImporte = importe_final, dRecDesc = importe_recdesc, cCuenta = id, vData = autorizadortrxid (habilita la anulación), cPlan = autorizadorintencionid ejecución
dE_DDMP (Dump2DDMP, [DINO] pos_misc.cpp:4640-4754) misma fila; no acumula dRecDesc en dTotalRecDescMPP si el medio es QR (4718) ejecución
dE_TResu neto, vía las filas. fRecDescMPP queda en 0 para el QR ([DINO] pos_tic2.cpp:1479-1488) para que ReadTRESU_Totals no reste dos veces ejecución
dE_TMdeP (ControlDeMdeP::UpdateTMdeP) acción VENTA por el neto (importe_final) y acción RECARGO/DESCUENTO (id 17) por importe_recdesc con signo ejecución
Z financiera Pago QR = ventas (neto) − anulaciones (neto): las acciones de id 17 se omiten cuando el perfil 171 (PermitePromosXMdeP) vale 1 (pos_valo.cpp, pos_info.cpp) ejecución (perfil 171 = 1)

Evidencia de cierre: en el POS de prueba el medio QR acumuló VENTA 10.175,00 / 4 operaciones (neto), RECARGO/DESCUENTO −825,00 / 3 operaciones, ANULACIÓN TARJETA 7.700,00 / 3 operaciones; las anulaciones netean a cero contra sus ventas. Con el perfil 171 en 0 el comportamiento de la acción 17 en la Z no está verificado.

3.8 Anulación y borrado

DINO distingue tres situaciones:

  1. Borrar el medio QR antes de autorizar: no hay nada imputado; se borra normal (escenario MPDEL).
  2. Borrar el medio QR ya autorizado (DeleteLastMDEP, [DINO] pos_mppo.cpp:1576-1616): PagoQR_BloquearBorradoMdeP ([DINO] pos_tic2.cpp:1181-1198) lo impide y manda al cajero a la Reversa QR; devuelve 1 y no 0 para no colgar los lazos while(!DeleteLastMDEP(...)). Si de todos modos se borra, PagoQR_RevertirImputacionMdeP (1208-1228) quita las filas, llama al recómputo de percepción en modo 2 y limpia los acumuladores. Esa reversa interna es en la práctica inalcanzable por la guarda; su recorrido está verificado solo por lectura de código (F20).
  3. Reversa QR del cajero (kbANULACION_PAGOQR → PAGOQR_MenuAnulacion, [DINO] pos_ctoq.cpp:4006-4135): consulta el pago, pide confirmación, manda trxanulacion, e imputa (ImputaAnulacionPagoQR, 3883-3985) un movimiento negativo en dE_MdeP/dE_DMdeP y una acción ANULACION TARJETA en dE_TMdeP por el neto |importe + importe_recdesc| (3921). Para el monto y el voucher usa los datos del pago obtenidos en la consulta previa, no los de la respuesta de la anulación (4070-4079, //20261013 QRVOU). La reversa es financiera (del medio de pago): no revierte el ticket ni la mercadería.

La Nota de Crédito no llama nunca al gateway y siempre imputa el reembolso como efectivo; con las filas bAcumulado = 1 debería devolver el neto, pero no se probó en vivo (NC necesita el servidor central del POS).

3.9 Qué cubre DINO solo para descuentos y qué cambia con un recargo

Pieza DINO (descuento) Para un recargo
Signo D = -importe_recdesc; D < 0 se rechaza ([DINO] pos_mppo.cpp:3633) Permitir importe_recdesc > 0; conservar el signo de dD en todo el camino
Total y saldo ViewSaldo(-D); Ticket.total[n].importe -= D ViewSaldo(+R); el importe del pago sube a importe_final. Simétrico (el POS ya hace recargos clásicos por medio de pago)
Guarda de monto D > TotalCobrar rechaza No aplica a un recargo; definir un tope si el equipo lo quiere (sección 7)
Filas de detalle negativas; dDVenta < 0 retorna 0 y r_eff > 1 retorna 0 ([DINO] pos_tic2.cpp:997, 1041-1045) Filas positivas; dDVenta y r negativos; sin tope en 1. Las demás fórmulas son simétricas (calculado, T-05/T-06)
Consumidores de bAcumulado == 1 (nota de crédito, borrado de filas, informe impositivo) Asumen descuento Revisar uno por uno o usar otro marcador
Residuo al bucket de mayor neto (II o neto) igual; con r negativo el residuo también puede ser ±0,01
Impuestos internos II' = ROUND(II × (1 − r)) II crece. Funciona con r negativo
IVA recalculado desde el neto ajustado el mismo recálculo si se decide gravar el recargo con las alícuotas del ítem; ver pregunta Q1
Percepciones se reescalan hacia abajo, nunca se inventan, el mínimo se ignora si ya existían crecen en proporción (nuevoNeto = neto × (1 + r)); nunca se crea una percepción nueva por la guarda VALIDAR(Ticket.Percepcion) y el TODO_PERCEPCIONES_IVA ([DINO] pos_tic2.cpp:2285); hay un posible centavo de diferencia (T-09); ver Q2
Línea del ticket Rec/Desc <rótulo> −X Rec/Desc <rótulo> +X con el mismo script (sin signo "+" en el formato ~99999999~, no verificado); decidir si se quiere el rótulo "Recargo" (Q3)
Comando fiscal ninguno (no verificado) el script fiscal ya manda R con SF_GranTotal > 0 (EPSON); falta invocarlo y validarlo (G-09)
Voucher Dto. beneficio fijo necesita rótulo condicionado al signo (G-10)
Anulación abs(importe + importe_recdesc) sirve igual (da importe_final para ambos signos)
Z acción 17 con signo, omitida con perfil 171 = 1 idem con signo positivo; sin verificar

4. Qué falta en el POS de Almacor

4.1 Mapa de piezas de DINO a Almacor

Pieza de DINO Equivalente en Almacor (donde va)
Parseo de la respuesta ya está: [ALM] pos_ctoq.cpp:3481-3508 (PAGOQR::Op). Lee importe_final (3488-3490) e importe_recdesc (3508)
PagoQR_ImputarDescuento (guardas + orquestación) función nueva (llamarla PagoQR_ImputarAjuste) llamada desde _ProcessKeyTOTAL, [ALM] pos_mppo.cpp:3640-3663
TICKET::PagoQR_AppendFilasDescuento, PagoQR_FilaIds, PagoQR_RemoveFilasDescuento, PagoQR_SumaFilasDescuento métodos nuevos de TICKET en [ALM] pos_tic2.cpp, junto a ImputaPromocionesXCodigoDescuento (688-916); declarar en [ALM] pcpos.h (hoy 939)
ViewSaldo(-D) [ALM] pos_mppo.cpp:392-435 (ViewSaldo(double Tax)): ya recibe el ajuste con signo
Ticket.total[n] y acción 17 [ALM] pos_mppo.cpp:1212-1227 (ControlDeMdeP::UpdateTMdeP), ya con signo
RecomputePercepcionxPromoMdeP modo 3 [ALM] pos_tic2.cpp:1271-1488; motor distinto (G-06)
PagoQR_ProrratearDataRedondeos [ALM] pos_mppo.cpp:4400-4514 (CalcularRedondeos, llamada desde COBRO 4598); consumidores ProcesarRedondeos_y_Descuentos ([ALM] pos_tic2.cpp:1187) y FinalPrintAjusteDiferencias ([ALM] pos_taxs.cpp:2693)
PrintRecDescMdeP función nueva; llamarla desde ControlDeMdeP::UpdateTMdeP, [ALM] pos_mppo.cpp:921, antes de FinalPrintAjusteDiferencias (922). En Almacor no existe
Voucher con tres líneas [ALM] pos_ctoq.cpp:4114-4155 (PAGOQR_Voucher), 4176-4297 (reimpresión) y VO_QR.SCP
Guarda de borrado y reversa interna [ALM] pos_mppo.cpp:1533-1667 (DeleteLastMDEP): hoy sin ninguna guarda QR
Reversa del cajero con neto [ALM] pos_ctoq.cpp:3876-3972 (ImputaAnulacionPagoQR, hoy fabs(importe) en 3923-3924) y 3976-4089 (PAGOQR_MenuAnulacion)
Reinicio de acumuladores [ALM] pos_mppo.cpp:4521 (COBRO)
Perfiles 564-567 [ALM] pos_prof.h (los ids 564-567 están libres en el encabezado; en la tabla de perfiles de cada cliente no verificado)

4.2 Brechas, con punto de inserción

Prioridad P0 = obligatoria antes de habilitar cualquier plan con ajuste distinto de cero. P1 = obligatoria antes de habilitar recargos. P2 = recomendada.

G-01 (P0). Copiar los montos cuando el pago se aprueba por la consulta. [ALM] pos_ctoq.cpp:3766-3773 (localPAGOQR_Op_v2): agregar a la copia desde trxconsulta los campos importe, importe_final, importe_recdesc, importe_cashback (totalcashback) y mensajevarios. Lo mismo en la consulta de localAnulacionQR_Op ([ALM] pos_ctoq.cpp:3836-3843). Además la imputación debería exigir importe_final > 0 (o el campo presente) antes de aceptar una aprobación: una respuesta aprobada sin importe_final es un error, no "sin ajuste". Ver T-12.

G-02 (P0). Gancho de imputación. [ALM] pos_mppo.cpp:3640-3663, dentro de if(!PAGOQR_Op(trxpagoqr)). En DINO el gancho corre después de asignar iPeriodo (3655 en Almacor) y antes de mbase->Update() (3663). Para poder fallar sin dejar la fila marcada como autorizada, en Almacor conviene validar primero (guardas puras de 3.2) antes de las asignaciones a mbase (3642-3657) y solo imputar después. Si la imputación (que puede fallar después de las guardas: filas no escritas, bruto 0) falla, deshacer lo hecho (quitar filas, ViewSaldo inverso) y seguir por G-11. Pasar el cuerpo a [ALM] pos_tic2.cpp (ver G-18). En el mismo bloque, espejar dImporte = importe_final y dRecDesc = importe_recdesc en dE_DMdeP (bloque de 3678-3714, como DINO 3943-3949).

G-03 (P0 para descuento, P1 para recargo). Signo. Compuertas que hoy rechazan el recargo en DINO y que no deben copiarse tal cual: D < 0 ([DINO] pos_mppo.cpp:3633), D > TotalCobrar (3642, solo para descuentos) y dDVenta < 0 ([DINO] pos_tic2.cpp:997) más el tope r_eff > 1 (1041-1045, solo para descuentos). Mientras no estén validados los recargos, el recargo debe seguir por la falla explícita (G-11), no por el descarte silencioso.

G-04 (P0). Filas por alícuota. Método nuevo en [ALM] pos_tic2.cpp con el algoritmo de 3.3 y la regla de residuo. Reutilizar el patrón de campos de ImputaPromocionesXCodigoDescuento ([ALM] pos_tic2.cpp:860-909, bAcumulado = 1). En Almacor el IVA de las promociones usa el orden de índices i: 0 = 21 %, 1 = exento, 2 = 10,5 % (comentario en 888), distinto del orden del detalle de DINO; no mezclar. ComputarBinario de Almacor ([ALM] pos_tic2.cpp:924-1083) suma las filas bAcumulado sin suponer signo.

G-05 (P0, riesgo de doble resta). fRecDescMPP. En DINO, ComputarBinario escribe fRecDescMPP = dTotalRecDescMPP y Dump2DDMP excluye al QR de ese acumulador ([DINO] pos_tic2.cpp:1479-1488, pos_misc.cpp:4718). En Almacor es distinto: ComputarBinario escribe fRecDescMPP = Ticket.TotRecDesc (menos el redondeo; [ALM] pos_tic2.cpp:1063-1066) y el acumulador de Dump2DDMP está comentado ([ALM] pos_misc.cpp:4713). Si se agregan las filas y se llama a ViewSaldo(±D), Ticket.TotRecDesc incluye el ajuste, fRecDescMPP también, y ReadTRESU_Totals ([ALM] pos_vnta.cpp:4606-4618, RealBigTotal = RTotal + RTotalOferta + RTotalPercepciones + RRecDescMPP) lo resta dos veces en la recuperación del ticket. La solución de DINO no se traslada tal cual. El camino de recuperación en Almacor no está verificado y hay que probarlo (T-16). El mismo hueco ya existe en Almacor para las promociones por medio de pago clásicas.

G-06 (P1; P0 si hay clientes con percepciones). Percepciones. El RecomputePercepcionxPromoMdeP de Almacor ([ALM] pos_tic2.cpp:1271, cuatro parámetros) no es el de DINO: no tiene PercepcionesElement, ni percepcionPromoArray (RecoverLast), ni modo 3; el modo 2 recalcula desde TotalInicial en lugar de restaurar un historial ([ALM] pos_prom.cpp:2720). Portar el modo 3 es reescribir esa regla en el motor de Almacor ("una percepción preexistente solo se reescala, nunca se anula por el mínimo; no se inventa una"), no copiar la función. Los chequeos de mínimo de Almacor están en 1329-1363 y 1385-1396. La reversa por modo 2 es no verificada. Las dos guardas (POSConPercepcionesHabilitadas, VALIDAR(Ticket.Percepcion)) y el TODO_PERCEPCIONES_IVA ([ALM] pos_tic2.cpp:1494) aplican igual.

G-07 (P1 si hay impresora fiscal). Redondeos fiscales. Análogo a PagoQR_ProrratearDataRedondeos (3.5) sobre dataRedondeos de CalcularRedondeos ([ALM] pos_mppo.cpp:4400-4514). Es NOP sin impresora fiscal con iAjustaRedondeFiscal.

G-08 (P0 si el comercio usa ticket no fiscal). Línea Rec/Desc. PrintRecDescMdeP nueva (3.6), llamada en [ALM] pos_mppo.cpp:921. El script de tickets (REPORTER/NOFISCAL/TIC_VDET.SCP, rama SF_Status == 3) es idéntico al de DINO en el kit de pruebas de Almacor. Incluir el fix F19 (solo la fila QR imprime la línea, para no duplicar la de una promoción por medio de pago clásica) y la elección bruto/neto por tipo de factura.

G-09 (P1; no verificado). Impresora fiscal. Decidir y validar con cada modelo instalado cómo se informa el ajuste QR: (a) invocar el script SF_Status == 3 con SF_GranTotal con signo desde PrintRecDescMdeP (quitando la salida anticipada por HayImpresoraFiscal); (b) confiar en AJUSTE_DIFERENCIAS de FinalPrintAjusteDiferencias ([ALM] pos_taxs.cpp:2772-2848), que rotula REDONDEO FISCAL; (c) otra. El despachador de comandos está en [ALM] pos_fien.cpp:3820-3836. Solo FisEps2000 distingue R de D; los demás mandan M en ambos casos.

G-10 (P1). Voucher y rótulos. [ALM] pos_ctoq.cpp:4114-4155 y 4176-4297 hoy imprimen un solo Importe con dImporte; con la imputación dImporte pasa a ser importe_final, y el voucher dejaría de mostrar el importe original. Traer el helper PagoQR_VoucherMontos y el VO_QR.SCP de DINO, y condicionar el rótulo al signo: Dto. beneficio para SF_MontoOferta < 0 y Recargo para > 0 (el script de DINO solo compara con != "0").

G-11 (P0). Falla explícita y reversa (INV-06). Es la brecha central; detalle en 4.3.

G-12 (P0). Reversa del cajero con neto. [ALM] pos_ctoq.cpp:3923-3924 y 3946-3960 usan fabs(trxnanulacionqr.importe): con la imputación en pie, se reversaría el bruto (sobre-reembolso en un descuento, sub-reembolso en un recargo). Cambiar a |importe + importe_recdesc| con los datos del pago (consulta previa), y propagar importe_recdesc en PAGOQR_MenuAnulacion ([ALM] pos_ctoq.cpp:4025-4031, hoy solo copia importe e importe_final). Conflicto de fuentes: DINO desconfía de importe_final de la respuesta de anulación (lo observó como placeholder 1 contra otro procesador, [DINO] pos_ctoq.cpp:3917-3921); GatewayPrismaQR devuelve el real en un pago pagado. Aun así el POS debe calcular neto = importe + importe_recdesc con los datos del pago: no depende de lo que conteste la anulación.

G-13 (P2). Mostrar mensajevarios de una denegación (D-117). Se parsea en [ALM] pos_ctoq.cpp:3486 pero el cajero solo ve el texto propio de sterror (estado). Puntos de inserción: PAGOQR::Op tras el log "NO ACEPTADO" (3558+, copiar a cMensajeRta[100]), y los diálogos de localPAGOQR_Op_v2: obtención de id (3650-3656), REFUND_DENEGADO (3712-3719), denegado tras la consulta (3727-3731) y "no está aprobada" (3755-3763). El texto es ASCII (79 bytes máx.; la consola OEM del POS muestra mal el resto).

G-14 (P1). Truncado del importe en el diálogo QR. El valor prellenado 4234.56 se muestra como 4234. y ENTER acepta 4234,00 (D-133, evidencia de la corrida integrada). El prellenado es correcto en el código: sprintf(cii, formato2lf, cobro + dRecDesc) seguido de SetData(RES_ID_IMPORTE, cii) ([ALM] pos_mppo.cpp:3086-3091 y 3111-3117, dentro de VerificarDMP, 2919). La causa más probable es el ancho visible del control de importe del diálogo del medio QR (recurso del diálogo, no del código fuente leído): no verificado. Opciones: ensanchar el control, o no prellenar y exigir tipear el importe, o validar tras ENTER que el importe tipeado sea igual al saldo. Con saldo pendiente _ProcessKeyTOTAL ya bloquea el cierre (Ticket.Saldo, 3509), así que el riesgo es operativo, no de dinero perdido.

G-15 (P0). Cashback. El ajuste va sobre importe y importe_final no incluye cashback. Almacor ya imputa el efectivo aparte ([ALM] pos_mppo.cpp:3658-3676, ImputaAccionFinancieraExtraccion). Con la aprobación por consulta, importe_cashback queda con lo que el POS pidió, no con lo que el cliente retiró (D-S3-15: el POS debe leer totalcashback de la respuesta); resuelto por G-01.

G-16 (P0). Guarda de borrado de un QR autorizado. Hoy un cajero puede borrar la fila QR ya autorizada (DeleteLastMDEP, [ALM] pos_mppo.cpp:1590-1591 no consulta nada): la billetera cobró y el POS pierde el vínculo. Portar PagoQR_BloquearBorradoMdeP y PagoQR_RevertirImputacionMdeP, devolviendo 1 (no 0) para no colgar los lazos while(!DeleteLastMDEP(...)), y guardar vData en un buffer de 160 bytes (el campo mide 150; con 60 hubo un GPF 286.3330, //20260915). Diseño: después de una reversa 2xx (G-11) la fila autorizada debe quedar borrable.

G-17 (P1). Perfiles 564 a 567 (EAN, artículo, depto y número de promoción de la fila QR): [ALM] pos_prof.h, lectura en pos_main.cpp y campos en GLOBALPROFILE (pcpos.h). Con valores por defecto si faltan (3.3). Hay que definir los valores reales del comercio.

G-18 (P0 de construcción). Restricciones de compilación. En DINO: los datos compartidos EXE→DLL se exportan a mano en pos_main.def ([DINO] pos_main.def:162); el segmento POS_MPPO_TEXT estaba a 97 bytes del límite de 64 KB y el enlazador no avisa si envuelve (se ve en pos_main.map), por eso los cuerpos nuevos viven en pos_tic2.cpp; DGROUP casi lleno, todo literal nuevo como static char _far; las herramientas de edición alteran los bytes latin1/CP437: editar con un script que preserve la codificación y buscar Error: (enlazador) y Error (compilador) en los .err. El mapa de segmentos de Almacor es no verificado; revisar POS_MPPO_TEXT antes de agregar código allí.

G-19 (P2; no verificado). Nota de Crédito. Con filas bAcumulado = 1 ([ALM] pos_ncre.cpp:961-963, 3100, 3933, 3996) la NC debería devolver el neto, pero no está probado; además la NC imputa siempre efectivo y no llama al gateway. Confirmar qué se hace con un ticket que tuvo ajuste.

G-20 (P2). Z con el perfil 171 en 0. Las acciones de id 17 se omiten de la Z solo con PermitePromosXMdeP == 1 ([ALM] pos_valo.cpp:1718, 2224, pos_info.cpp:1532, 2555, 2675, pos_vnta.cpp:4380). Verificar que ningún cliente de Almacor tenga el perfil en 0 o definir qué se espera en la Z.

4.3 Falla explícita más reversa (INV-06)

Condiciones para entrar a la rama de falla, cualquiera de ellas con la aprobación ya oída:

Acción, sin cerrar el ticket:

  1. No marcar la fila QR como autorizada (iPeriodo queda en 0) ni asignar lIdTrx/vData. Si ya se hizo, deshacerlo.
  2. Mostrar al cajero un mensaje claro de que el pago QR no se registró y se está devolviendo.
  3. Mandar la reversa: POST /api/trxanulacion con {"id": <id del pago>, "trxidoriginal": 0, "nropv": ..., "nroticketfiscal": ...}. Es la forma nativa de Almacor ([ALM] pos_ctoq.cpp:3449-3455; ADR-004; SISTEMA.md). El id es el id que devolvió trxid, no autorizadortrxid.
  4. Repetir hasta un 2xx. Reglas:
    • Éxito: HTTP 200 o 201 con estado AUTORIZACION_DE_ANULACION_APROBADA o REFUND_APROBADO. La operación es idempotente (AC-23): repetirla no duplica la reversa.
    • Reintentar ante timeout, error de E/S o 5xx. La llamada al gateway usa el timeout del perfil 496 para operaciones que no son consulta ni obtención de id ([ALM] pos_ctoq.cpp:3303); definir un tope menor para el lazo (decisión del equipo, sección 7).
    • Un 409 ANNULMENT_NOT_POSSIBLE no es éxito (D-S4-8): la reversa falló o el gateway se rindió. Hay que alertar al cajero y al operador; una persona la termina contra Prisma (RUNBOOK §9).
    • Nunca dar por anulado un pago porque la consulta devuelva AUTORIZACION_DE_PAGO_APROBADA o porque trxanulacion expiró. La lógica actual de localAnulacionQR_Op ([ALM] pos_ctoq.cpp:3813-3852) pregunta la consulta tras un timeout y trata un estado aprobado como "anulada por consulta"; con la consulta aprobada el cliente sigue cobrado (D-118, D-S4-11). El lazo debe llamar de nuevo a trxanulacion, no a la consulta.
  5. Solo con el 2xx, devolver el control al flujo de "pago denegado" (el que hoy sigue return 6 en [ALM] pos_mppo.cpp:3718) con la fila QR borrable (no bloqueada por G-16).
  6. Si no se logra el 2xx en el tiempo previsto, persistir un pendiente de reversa (un valor persistente con el id, análogo a pro_PAGOQR_IDTRX_A_ANULAR, [ALM] pos_mppo.cpp:1218, 1249) y reintentar al volver a cargarse el POS, para que no dependa de la memoria. Dejar un aviso visible y un registro. El diseño de este pendiente es una decisión abierta (Q5).

Hace falta una llamada programática nueva: Almacor solo tiene la reversa interactiva PAGOQR_MenuAnulacion (lee pro_PAGOQR_IDTRX_A_ANULAR) y localPAGOQR_Op_v2 rechaza cualquier operación que no sea PAGOQR_PAGO ([ALM] pos_ctoq.cpp:3627-3630). Agregar en pos_ctoq.cpp un export (por ejemplo PAGOQR_Reversa(stTrxPagoQR&), extern "C" _loadds _export como PAGOQR_Op, 4158) y cargarlo en [ALM] pos_main.cpp junto a PAGOQR_Op/PAGOQR_MenuAnulacion (declaraciones 304-307, LoadDLLfunction 536-539).

Esto cubre a la vez el recargo no soportado: mientras el POS no complete los puntos P1, un recargo debe terminar en esta rama, nunca registrarse por el importe original.


5. Reglas de redondeo y reparto

5.1 Redondeo

El POS tiene tres maneras de convertir un importe y un porcentaje en un monto (CONVENTIONS 9a). Las cuotas de un plan usan el motor de promociones por medio de pago:

ajuste = ROUND_DOUBLE( ROUND_DOUBLE(base) × ROUND_DOUBLE(porcentaje) / 100 )
total  = base + ajuste

5.2 Reparto por alícuota

Objetivo: que las filas por alícuota sumen exactamente importe_recdesc (cuando no hay percepción, dDVenta == |importe_recdesc|) y que las identidades fiscales del ticket cierren.

Reglas (3.3, con el signo generalizado):

  1. Tomar dDVenta = ROUND((TotalAntes − Percepcion) × r) con r = importe_recdesc_con_signo / TotalAntes y signo tal que el descuento sea positivo (convención de DINO). Para un recargo dDVenta y r son negativos.
  2. Calcular r_eff = dDVenta / ΣPrecioFiscal(ítems) y repartir con la misma fórmula por bucket.
  3. El IVA de cada fila se recalcula desde el neto ajustado: T' = ROUND(N' × (1 + tasa)) − N'. Nunca se prorratea el IVA original.
  4. El residuo (−dDVenta) − ΣΔP se suma entero a un solo bucket: el de mayor neto entre los que tienen ítems, a sus impuestos internos si los tiene y, si no, al neto de la fila.
  5. Invariantes de control: Σ filas = −dDVenta; para cada bucket |T' − ROUND(N' × tasa)| ≤ 0,01; Σ(detalle neteado) + percepciones = lo que cobró la billetera (I1, I3d); detalle, dE_TResu y pagos coinciden (I13).

5.3 Diferencia de un centavo con percepciones (calculado)

Las filas y la percepción se redondean por separado. Con percepción, Σ filas + percepción' puede quedar 0,01 por encima o por debajo de importe_final, incluso en descuentos. Con las fórmulas de DINO y el ticket del ejemplo (ítems 2750,00; percepción 64,36; neto de percepción 2145,21):

Ajuste importe_final Filas Percepción nueva Filas + percepción Diferencia
−10 % 2532,92 −275,00 57,92 2532,92 0,00 (es el caso real ejecutado)
−12 % 2476,64 −330,00 56,63 2476,63 0,01
+10 % 3095,80 +275,00 70,79 3095,79 0,01
+5 % 2955,08 +137,50 67,57 2955,07 0,01
+12 % 3152,08 +330,00 72,08 3152,08 0,00

DINO absorbe la diferencia en lo impreso y en el CAE (ImprimirIVAS, //20260923 PERC3 P10); lo persistido en dE_TResu puede quedar 0,01 corto respecto de lo cobrado (no verificado en el POS). Decisión: dónde se asigna el centavo cuando hay percepción (Q2).


6. Casos de prueba para el POS

Los importes de T-01 a T-03 son los del E2E del gateway. Las filas son calculadas con las fórmulas de DINO (convención de la tabla: fila = ΔPrecio / ΔIVA / ΔNeto, ya con el residuo aplicado). T-07 y T-08 son escenarios ejecutados en la rama DINO (descuento). Ningún caso de recargo fue ejecutado en un POS.

Para cada caso, además de lo indicado, verificar: el ticket cierra por importe_final; SU PAGO = importe_final; la Z cierra (VENTA neto + acción 17); detalle, dE_TResu y pagos coinciden; el CAE (si lo hay) informa lo cobrado; la línea Rec/Desc aparece una sola vez.

6.1 Importes del gateway (un solo bucket de IVA 21 %)

ID Entrada importe_recdesc importe_final Fila de detalle (precio / IVA / neto)
T-01 +10 % sobre 4234,56, 3 cuotas +423,46 4658,02 +423,46 / +73,50 / +349,96 (residuo −0,01 al neto)
T-02 −10 % sobre 1234,56, 1 pago −123,46 1111,10 −123,46 / −21,42 / −102,04 (residuo −0,01 al neto)
T-03 +10,01 % sobre 1250,00 (empate: 125,125) +125,13 1375,13 +125,13 / +21,72 / +103,41

El mismo importe en un ticket exento da una sola fila sin IVA: T-01 +423,46; T-02 −123,46; T-03 +125,13.

6.2 Tickets con IVA mixto (calculado)

ID Ticket (precio con IVA por alícuota 21 % / 10,5 % / exento) Ajuste Filas (21 % / 10,5 % / exento) Σ Notas
T-04a 1210,00 / 1105,00 / 500,00 = 2815,00 −10 % → D = 281,50, final 2533,50 −121,00 / −110,50 / −50,00 −281,50 residuo 0; IVA −21,00 / −10,50 / 0
T-04b idem +10 % → R = 281,50, final 3096,50 +121,00 / +110,50 / +50,00 +281,50 simétrico
T-05a 1005,31 / 495,01 / 524,24 = 2024,56 +10 % → R = 202,46, final 2227,02 +100,53 / +49,50 / +52,43 +202,46 residuo +0,01 al neto del bucket 21 % (mayor neto, sin II); IVA +17,44 / +4,70 / 0
T-05b 1675,59 / 224,38 / 456,71 = 2356,68 −15 % → D = 353,50, final 2003,18 −251,33 / −33,66 / −68,51 −353,50 residuo +0,01 al bucket 21 %; IVA −43,62 / −3,20 / 0
T-06 1500,00 con 100,00 de impuestos internos / 600,00 / 200,00 = 2300,00 −10 % → D = 230,00 −150,00 (II −10,00; IVA −24,30) / −60,00 / −20,00 −230,00 II se reduce II × (1−r)
T-06b idem +10 % → R = 230,00 +149,99 (II +10,00; IVA +24,29) / +60,01 / +20,00 +230,00 la asimetría de ±0,01 entre filas es normal; la suma es exacta

Verificar en cada uno: Σ filas = −(ajuste con signo), cada IVA ≈ ROUND(neto × tasa) con tolerancia 0,01, y que el residuo se haya asignado a un solo bucket.

6.3 Percepciones

ID Escenario Esperado
T-07 (ejecutado, descuento) Ítems 2750,00; percepción IIBB 3 % = 64,36; mínimo 1000; billetera −10 % sobre el total 2814,36 D = 281,44; importe_final = 2532,92; filas −275,00; percepción 57,92; la línea Rec/Desc de Factura B dice −275,00 (no −281,44); pie SUBTOTAL − promo previa + Rec/Desc + percepción == TOTAL
T-08 (ejecutado, mínimos) Igual pero con mínimo 2000 que el neto ajustado cruza hacia abajo; y con mínimo 3000 que ni antes ni después se alcanza percepción se conserva reescalada (57,92) con 2000; con 3000 sigue en cero, no se crea
T-08b (ejecutado) −100 % (r = 1) filas = −ítems exactos, percepción 0 por neto cero (no por el mínimo), total 0,00
T-09 (calculado, recargo) Ítems 2750,00; percepción 64,36; billetera +10 % sobre 2814,36 R = 281,44; importe_final = 3095,80; filas +275,00; percepción 70,79 → Σ = 3095,79: 0,01 de diferencia. Debe definirse (Q2) si la percepción crece y dónde se asigna el centavo
T-09b Ticket sin percepción previa cuyo neto con el recargo cruza el mínimo por la guarda VALIDAR(Ticket.Percepcion) no se crea percepción; definir si es lo esperado (Q2)

6.4 Cashback, aprobación por consulta, anulación y fallas

ID Escenario Esperado
T-10 Cashback: ticket 1000,00 con totalcashback pedido 500,00 y plan −10 % de 1 pago ajuste sobre 1000,00 únicamente: importe_recdesc = −100,00, importe_final = 900,00, totalcashback = 500,00 aparte. El POS no calcula ni reparte nada sobre los 500,00; el efectivo se imputa por ImputaAccionFinancieraExtraccion. Un cashback con otro método o con cuotas lo compensa el gateway (nunca llega aprobado)
T-11 Reversa del cajero de la venta de T-02 (y de T-01) la anulación imputa 1111,10 (neto) en T-02 y 4658,02 en T-01, no los brutos 1234,56 / 4234,56; voucher: original / ajuste / anulado; la Z netea a cero (ventas netas − anulaciones netas)
T-12 Aprobación por consulta con ajuste: el gateway responde "denegado" en trxpago y "aprobado" en la consulta con descuento el POS imputa con los montos de la consulta; si faltan, falla explícito; no registra la venta por el importe original
T-12b Respuesta INTENCION_DE_PAGO_RECIBIDA_APROBADA (aprobación diferida) el POS sigue consultando; no imputa ni cierra
T-13a importe_final ≠ importe + importe_recdesc (≥ 0,005) no se vende; falla explícita; trxanulacion hasta 2xx
T-13b Descuento mayor que el total del ticket ídem
T-13c Recargo en un POS cuya versión todavía no lo soporta ídem: nunca registrar por el importe original
T-13d Error al escribir las filas (bruto 0 / ratio fuera de rango) ídem; los totales vuelven al estado previo
T-14a trxanulacion sin respuesta (timeout) se reintenta la misma llamada, no la consulta; al 2xx se sigue; no se da por anulado
T-14b trxanulacion responde 409 ANNULMENT_NOT_POSSIBLE no es éxito; alerta al cajero y al operador; queda el pendiente persistido
T-14c El POS se apaga con la reversa pendiente al reiniciar sigue intentando
T-15 Prompt del importe QR con 4234,56 se ve completo (o se exige tipearlo); ENTER no acepta 4234,00
T-16 Recuperación del ticket tras un corte (camino de ReadTRESU_Totals) con ajuste imputado el total recuperado es importe_final, sin restar el ajuste dos veces (G-05; no verificado)
T-17 Reimpresión del último voucher y de la anulación muestra original / ajuste / final con el rótulo correcto para ambos signos
T-18 Borrado del medio QR ya autorizado impedido; tras una reversa 2xx (G-11) la fila queda borrable
T-19 Nota de Crédito de un ticket con ajuste no verificado: debe devolver el neto cobrado
T-20 Ticket con impresora fiscal y ajuste no verificado: comando y rótulo según modelo (G-09)

7. Preguntas abiertas

Las decide una persona del proyecto o del equipo del POS; este documento no las resuelve.


Apéndice A. Conflictos entre las fuentes y el contrato

  1. Aprobación por consulta: el contrato dice que la consulta devuelve la misma forma que trxpago (AC-05), pero ambos POS descartan importe_final/importe_recdesc en ese camino (1.5, G-01).
  2. Recargo: ADR-003 dice que el signo es "hacia el POS" y los recargos están activos desde el diseño; la imputación de DINO rechaza importe_recdesc > 0 como "dato inválido" y no falla de forma explícita (INV-06).
  3. Respuesta de anulación: DINO la trata como no confiable (placeholder importe_final = 1 observado contra otro procesador); GatewayPrismaQR envía importe_final e importe_recdesc reales para un pago pagado (PosAnnulmentResponses). No es un conflicto de dinero si el POS calcula el neto con los datos del pago.
  4. Residuo de centavo: PLANES-CUOTAS §10.1 decía que "el centavo de residuo va al bucket de mayor neto"; esa redacción se retiró y ahora remite a este documento. En DINO va a los impuestos internos de ese bucket, o al neto de la fila si el bucket no tiene impuestos internos (nunca al IVA).
  5. Nombres de campos: PAGOQR::Op de ambos POS prefiere total, paymentid, merchantorderid y totalitem sobre importe_final, autorizadortrxid, autorizadorintencionid e importe. El gateway solo envía los segundos; hoy no hay conflicto, pero si el gateway agregara alguno de los primeros con otro significado cambiaría lo que el POS lee.
  6. base_amount: la rama DINO lo envía; el gateway lo ignora por diseño (AC-18). Almacor no debe implementarlo.
  7. Motor de percepciones y fRecDescMPP: los dos árboles divergen (G-05, G-06); la documentación de DINO no es aplicable literalmente a Almacor.

Apéndice B. Lo que no se pudo confirmar