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
- Verificado en ejecución: la rama del cliente DINO lo ejecutó en un POS de prueba (matriz de escenarios e invariantes I1 a I15 de esa rama). Solo cubre descuentos.
- Verificado en código: leído en el código fuente en esta revisión; no ejecutado.
- Calculado: resultado de aplicar las fórmulas de la rama DINO en una hoja de cálculo propia; no se ejecutó en ningún POS.
- no verificado: no se pudo confirmar con el código ni con evidencia. Hay que comprobarlo antes de apoyarse en ello.
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
- 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_recdesceimporte_finalconimporte + importe_recdesc == importe_finalal centavo (INV-04). - 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). - 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íneaRec/Descy 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. - 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_finaleimporte_recdesc(sección 4, G-01); (b) el motor de percepciones y el origen defRecDescMPPde Almacor son distintos de los de DINO (G-05, G-06); (c) no existe en Almacor una llamada programática atrxanulacion, imprescindible para la falla explícita (G-11). - 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
- Las cuotas y el medio los elige el cliente en la billetera. El POS no calcula nada por cuota: recibe el ajuste ya resuelto.
icuotasse lee pero ninguno de los dos POS lo persiste hoy (verificado en código). - Un plan de 1 cuota con recargo es rechazado por el gateway al leerse (siempre se ofrece 1 pago sin ajuste). Un plan de 1 cuota puede ser descuento. El medio 112 (transferencia) solo admite 1 cuota sin banco ni BIN.
importe_finales el monto de la compra con ajuste. El valor de la cuota (importe_final / cuotas) no vuelve al POS; el resto de redondeo por cuota no se concilia (D-S3-5) y el POS no lo necesita.- Recargos y descuentos están activos desde el diseño (2026-10-02); su uso en producción depende de que Prisma confirme que
total_amountpuede diferir deoriginal_amount(pregunta 10, PRISMA-PREGUNTAS.md).
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
- El cajero carga el medio de pago QR (una sola vez por ticket:
[DINO] pos_mppo.cppActiveDMdeP, igual que[ALM] pos_mppo.cpp:3231-3233) con el saldo del ticket como importe. La fila queda en el browse de medios condImporte= importe original. - Al apretar TOTAL, el lazo de
[DINO] pos_mppo.cpp:3819-3963recorre las filas QR sin autorizar (iPeriodo == 0), armatrxpagoqr.importe = dImportey llamaPAGOQR_Op. 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. Leeimporte_recdesc(3515). Acepta el pago solo conPAGO_APROBADOoAUTORIZACION_DE_PAGO_APROBADA(3551-3557).- Se cobra
importe_final: la fila del medio QR pasa dedImporte = importe originaladImporte = importe_final, ydRecDesc = importe_recdesc([DINO] pos_mppo.cpp:3713-3714, dentro de la imputación; y el espejo endE_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:
tick->PagoQR_AppendFilasDescuento(dTotalAntes, r, trx.mediodepago)(3665-3666): escribe las filas de detalle (3.3).- 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 leeTicket.Percepciony el recómputo la reescribe; al revés el ticket queda corto (bug F13, 275,65 en vez de 275,00). PagoQR_ProrratearDataRedondeos(r)(3688): ajusta los buckets de redondeo fiscal (3.5).- Acumuladores
dQRDto_Descuento,dQRDto_TotalAntes,cQRDto_TrxId(3691-3695). ViewSaldo(-D)(3700):TotRecDesc += -D,TotalNeto = TotalInicial + TotRecDesc,TotalCobrar = TotalNeto.Ticket.Saldono se toca: el pago y el total bajan lo mismo y el saldo sigue en 0.- Para la fila del medio QR en
Ticket.total[n]:importe -= D,recdesc += importe_recdesc(3704-3710). De ahí sale, enUpdateTMdeP, la acciónidRECARGO_DESCUENTOdedE_TMdeP(3.7). mbase->assign(dImporte, importe_final)ydRecDesc = 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):
- Monto del lado venta:
dDVenta = ROUND((TotalAntes - Percepcion) × r). ElDque informa la billetera se calculó sobre el total con percepción; a la percepción le baja su parteRecomputePercepcionxPromoMdePpor separado. Sin percepción,dDVenta == D(997-998). - Barrido de las filas de ítem (
bAcumulado == 0, sin percepciones): por bucket, precio fiscalP, IVAT, impuestos internosIIy netoN = P - (T + II)(1008-1036). - Ratio efectivo
r_eff = dDVenta / ΣPcontra el bruto real de las filas (1040). No se reusarglobal: un ticket que ya trae una promoción por medio de pago clásica tiene su monto enTotalCobrarpero todavía no como fila. Conr_efflas filas suman exactamente-dDVenta. Sir_eff > 1 + 1e-9no se escribe nada; sir_eff > 1se limita a 1 (beneficio del 100 %). - 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). - Centavo residual:
residuo = (-dDVenta) - ΣΔP(1074). Se asigna entero a un solo bucket: el de mayor netoNentre 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 += residuosin tocarΔII, ni el IVA) (1075-1094, fix//20260923 PERC3 P10). El residuo nunca va al IVA. - Una fila por bucket con
ΔP != 0. Campos:bAcumulado = 1,fPrecio = PrecioFiscal = ΔP,fNetoFiscal = ΔP - (ΔT + ΔII),fImpInterno = ΔII,Tax0Fiscal/Tax2Fiscal = ΔTsegún el bucket,Cantidad = Unidades = 1,iNroTicket,cFecha,iPromoPrior = 0, descripción =mediodepagode la respuesta (oDTO 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.
- Modos: 0 = consulta, 1 = actualiza, 2 = revierte la última entrada (
percepcionPromoArray.RecoverLast), 3 = actualiza ignorando el mínimo para las percepciones que el ticket ya tenía. - Regla de producto (2026-09-22): como la billetera ya cobró el total incluida la percepción, una percepción preexistente solo se reescala por el ratio y nunca se anula por mínimo; una percepción que el ticket no tenía sigue sujeta al mínimo, es decir, nunca se inventa una.
- Cada percepción (IIBB, ComInd, IVA 21, IVA 10,5) es un
PercepcionesElement(2060-2143):nuevoNeto = netoPrevio × (1 + ratio),nuevaPercepcion = ROUND(nuevoNeto × alícuota / 100). El ratio que recibe es-r, porque se le pasa-r × NetoSinPercepciony divide porNetoSinPercepcion. - Guarda de entrada del llamador: solo si
POSConPercepcionesHabilitadas() && VALIDAR(Ticket.Percepcion)(3677). Sin percepción previa no se llama a la función. - El historial de
percepcionPromoArray.Add(2160) se captura antes de la actualización; por eso la reversa (modo 2) restaura el valor previo al QR. - Ejemplo real de la matriz (descuento, ejecutado): ítems 2750,00; percepción IIBB 3 % = 64,36; total 2814,36; descuento del 10 % de la billetera
D = 281,44;importe_final = 2532,92. Las filas suman −275,00 (dDVenta), la percepción baja a 57,92 (Δ −6,44) y 275,00 + 6,44 = 281,44. Con mínimo 2000 que el neto ajustado cruza (M4m) la percepción se conserva en 57,92; con mínimo 3000 que ni antes ni después se alcanza (M4n) sigue en cero. - Percepciones y redondeo fiscal:
ImprimirIVASresta la percepción del cálculo de impuestos internos por diferencia para todo tipo de comprobante y manda el residuo≤ dPerc3_MaxResiduoal neto del bucket mayor ([DINO] pos_inve.cpp:4671-4709,//20260923 PERC3 P9/P10).
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:
PagoQR_ProrratearDataRedondeos(r)([DINO] pos_mppo.cpp:3591-3621) ajusta por alícuota los buckets dedataRedondeos(neto, precio, impuestos internos,dTax,dAcum_*) con la misma fórmula del punto 4 de 3.3. Es un NOP salvo queprofile.iAjustaRedondeFiscal && profile.HayImpresoraFiscal(si no,CalcularRedondeosno cargó nada). Atención a los índices: aquí0 = 21 %, 1 = exento, 2 = 10,5 %, distinto de los buckets del detalle (0 = 21 %, 1 = 10,5 %, 2 = exento). No se revierte al borrar el medio de pago.PrintRecDescMdePsale sin hacer nada si hay impresora fiscal ([DINO] pos_vnta.cpp:4285-4286): no se emite ningún comando fiscal de descuento por medio de pago para el QR.- La reconciliación genérica
FinalPrintAjusteDiferencias([ALM] pos_taxs.cpp:2693-2869, mismo diseño en DINO) compara el subtotal real de la fiscal conTicket.TotalCobrary, si difieren en 0,01 o más, mandaAJUSTE_DIFERENCIASrotuladoREDONDEO FISCAL(Dsi la fiscal está por encima,Rsi por debajo, en EPSON;M0Ten HASAR). Es posible que eso absorba el ajuste QR, pero con un rótulo equivocado y no está comprobado. - El script
REPORTER/FISCAL/TIC_VDET.SCPya tiene la ramaSF_Status == 3(recargo/descuento por medio de pago): con el modeloFisEps2000mandaPAGO_FISCONTXToPAGOFISFACT_TXTcon parámetroRsiSF_GranTotal > 0(recargo) yDsi no (descuento); para los demás modelos mandaMen ambos casos. Esa rama existe pero DINO nunca la invoca para el QR.
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:
- Factura A / monotributo (
EsFacturaTipo2_3):Σ fNetoFiscalde las filas QR, porque el detalle va neto y el SUBTOTAL ya es el neto posterior al beneficio. - Factura B / consumidor final:
Σ PrecioFiscalde las filas QR (PagoQR_SumaFilasDescuento,[DINO] pos_tic2.cpp:1292-1331). - Si no hay filas QR conserva
dE_MdeP.dRecDesc.
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:
- Borrar el medio QR antes de autorizar: no hay nada imputado; se borra normal (escenario MPDEL).
- 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 lazoswhile(!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). - Reversa QR del cajero (
kbANULACION_PAGOQR→PAGOQR_MenuAnulacion,[DINO] pos_ctoq.cpp:4006-4135): consulta el pago, pide confirmación, mandatrxanulacion, e imputa (ImputaAnulacionPagoQR, 3883-3985) un movimiento negativo endE_MdeP/dE_DMdePy una acciónANULACION TARJETAendE_TMdePpor 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:
importe_finalausente, no numérico oimporte + importe_recdesc != importe_final(≥ 0,005);- un ajuste que el POS todavía no soporta (por ejemplo un recargo antes de completar G-03/G-04);
- un descuento mayor que el total del ticket;
- error al escribir las filas o al reconstruir los totales (por ejemplo bruto 0 o ratio fuera de rango);
- cualquier otra excepción de la imputación.
Acción, sin cerrar el ticket:
- No marcar la fila QR como autorizada (
iPeriodoqueda en 0) ni asignarlIdTrx/vData. Si ya se hizo, deshacerlo. - Mostrar al cajero un mensaje claro de que el pago QR no se registró y se está devolviendo.
- Mandar la reversa:
POST /api/trxanulacioncon{"id": <id del pago>, "trxidoriginal": 0, "nropv": ..., "nroticketfiscal": ...}. Es la forma nativa de Almacor ([ALM] pos_ctoq.cpp:3449-3455; ADR-004; SISTEMA.md). Elides el id que devolviótrxid, noautorizadortrxid. - Repetir hasta un 2xx. Reglas:
- Éxito: HTTP 200 o 201 con
estadoAUTORIZACION_DE_ANULACION_APROBADAoREFUND_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_POSSIBLEno 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_APROBADAo porquetrxanulacionexpiró. La lógica actual delocalAnulacionQR_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 atrxanulacion, no a la consulta.
- Éxito: HTTP 200 o 201 con
- Solo con el 2xx, devolver el control al flujo de "pago denegado" (el que hoy sigue
return 6en[ALM] pos_mppo.cpp:3718) con la fila QR borrable (no bloqueada por G-16). - 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
- Un solo redondeo del cociente, no
RoundExp100(que redondea dos veces: impuestos, límites de vuelto y recargo fijo del medio cuando las promociones por medio están apagadas). ROUND_DOUBLEredondea a dos decimales hacia afuera de cero (mitad lejos de cero) sobredouble:signo × floor(|x| × 100 + 0,5 + 1e-10) / 100([ALM] pos_misc.cpp:978-1017,ROUND_DOUBLE3). El porcentaje se redondea primero a dos decimales ([ALM] pos_prom.cpp:4417) y el redondeo final se omite si el resultado es ≤ 0,0099999 ([ALM] pos_prom.cpp:4683-4698).- El gateway usa la misma fórmula (
PosRounding.adjustmentOf) y AC-14 está cerrado por medición el 2026-10-29 en el POS de Almacor para recargos y descuentos, incluidos los casos de sub-centavo y de empate de medio centavo (1234,56 → 135,80 al 11 %; 1250,50 → 137,56; −10 %: 1234,56 → −123,46; −10,01 %: 1250,00 → −125,13 y 163850,00 → −16401,38). El empate exacto que cae justo por debajo endouble(173244,75 al 10 % = 17324,47) confirma que el POS redondea condoubleIEEE y no con mitad-arriba exacta (D-133). - El POS no recalcula el ajuste. Toma
importe_recdescdel gateway. Esta fórmula la necesita el POS solo para repartir y para verificar. Un POS no debe volver a calcularimporte × porcentaje.
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):
- Tomar
dDVenta = ROUND((TotalAntes − Percepcion) × r)conr = importe_recdesc_con_signo / TotalAntesy signo tal que el descuento sea positivo (convención de DINO). Para un recargodDVentayrson negativos. - Calcular
r_eff = dDVenta / ΣPrecioFiscal(ítems)y repartir con la misma fórmula por bucket. - El IVA de cada fila se recalcula desde el neto ajustado:
T' = ROUND(N' × (1 + tasa)) − N'. Nunca se prorratea el IVA original. - El residuo
(−dDVenta) − ΣΔPse 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. - 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_TResuy 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.
- Q1. IVA del recargo. La distribución espejo (filas positivas por alícuota, IVA recalculado desde el neto) es el comportamiento por defecto aquí especificado. Un recargo financiero también puede considerarse un servicio gravado al 21 % con independencia de los ítems. PLANES-CUOTAS §10.2 lo marca como "definición impositiva pendiente". Hace falta una decisión con el área contable/impositiva.
- Q2. Percepciones con recargo. ¿Crecen en proporción al neto, quedan como estaban (como hace el recargo de tarjeta clásico, que no recalcula percepciones) o se evalúa si el recargo cruza un mínimo y crea una percepción nueva? ¿Dónde se asigna el centavo de diferencia de 5.3?
- Decidido para descuentos (2026-10-31, Almacor). La pregunta del recargo no aplica mientras los recargos sigan con falla explícita.
- Base. Se usa la regla que ya tiene el motor de Almacor: con
ClienteTienePercepcionPVta(tipos de cliente decClientesPercepcionPrVenta), la percepción de IIBB se calcula sobre el precio de venta; sin él, sobre el neto. Una percepción preexistente solo se reescala y nunca se anula por el mínimo, y no se crea una que el ticket no tenía (la regla de DINO del 2026-09-22). El motivo: la billetera ya cobróimporte_final, calculado sobre un total que incluye la percepción. - Centavo. Cada percepción nueva se calcula una sola vez,
ROUND(base × alícuota). Las filas valen(importe_final − total original) − Δpercepcionesy se reparten con la regla del centavo residual (5.2), así queΣ filas + percepciones == importe_finales exacto por construcción. En el ejemplo de 5.3 al −12 %, las filas quedan en −329,99 y la percepción en 56,63. El centavo no va a la percepción, porque dejaría de salir de la fórmula, ni queda sin asignar, porque lo registrado diferiría de lo cobrado.
- Base. Se usa la regla que ya tiene el motor de Almacor: con
- Decidido para descuentos (2026-10-31, Almacor). La pregunta del recargo no aplica mientras los recargos sigan con falla explícita.
- Q3. Rótulos. ¿Se imprime "Recargo" / "Descuento" o se deja
Rec/Descgenérico? Idem en el voucher. Puede haber una exigencia legal de informar el recargo financiero. - Q4. Impresora fiscal. ¿Qué modelos hay en los clientes de Almacor y qué comando debe emitirse para el ajuste QR? ¿Se emite una línea propia con el ajuste o se acepta el
AJUSTE_DIFERENCIASgenérico? Ninguno está probado. - Q5. Diseño de la falla. Tope de tiempo y cadencia del lazo de
trxanulacion(el barrido de RouterQR repite cada 5 s); qué ve el cajero mientras tanto; qué pasa si no se logra el 2xx (¿bloquea el POS, exige supervisor, deja el pendiente persistido?). - Q6. Qué se exige a una aprobación sin ajuste. ¿Se acepta una aprobación sin
importe_final(hoy, "sin ajuste") o se trata siempre como error (G-01)? - Q7. Pago parcial y más de un QR. DINO calcula
r = D / TotalCobrarsobre todo el ticket y admite un solo QR por ticket (ActiveDMdeP: "solo permitido ingreso PAGOQR una vez"). ¿Se admite QR por una parte del ticket combinado con otro medio? Con varios QR,dQRDto_TotalAntesse fija en el primero (no probado). - Q8. Tope del descuento. DINO rechaza un descuento mayor que el total. ¿Se quiere un tope equivalente para el recargo?
- Q9. Qué se persiste de la elección. Cuotas (
icuotas) ypayment_method_*hoy no se persisten en el ticket. ¿Se necesitan para el reporte? - Q10. Cancelación del cajero durante la espera. Con el perfil 543 (
PAGOQR_CANCELENABLED) el cajero puede cancelar con la consulta pendiente; AC-31 prevétrxanulacionpara el pago en vuelo. Confirmar que el POS lo envía en ese camino. - Q11. Habilitación de planes. El gateway no sabe qué versión de POS tiene cada comercio. Los planes con ajuste distinto de cero se deben habilitar a mano, solo después de completar las brechas P0 de este documento (D-133). ¿Quién autoriza y registra ese paso?
- Q12. Solución de
fRecDescMPPen Almacor. ¿Se replica la solución de DINO (dTotalRecDescMPPsin QR) o se prefiere otra? Ver G-05. - Q13. Control diario (D-S4-11). El POS directo de Almacor no repite una anulación que expiró. RUNBOOK §9 prescribe el control diario "anulaciones registradas en el POS sin reversa en el gateway". Ese control y el pedido de que el POS repita
trxanulacion(R-07) siguen pendientes. - Q14. Pregunta 10 a Prisma. Que
total_amountpueda diferir deoriginal_amountestá pendiente de confirmación; sin ella los recargos y descuentos no deben usarse en producción.
Apéndice A. Conflictos entre las fuentes y el contrato
- Aprobación por consulta: el contrato dice que la consulta devuelve la misma forma que
trxpago(AC-05), pero ambos POS descartanimporte_final/importe_recdescen ese camino (1.5, G-01). - 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 > 0como "dato inválido" y no falla de forma explícita (INV-06). - Respuesta de anulación: DINO la trata como no confiable (placeholder
importe_final = 1observado contra otro procesador); GatewayPrismaQR envíaimporte_finaleimporte_recdescreales para un pago pagado (PosAnnulmentResponses). No es un conflicto de dinero si el POS calcula el neto con los datos del pago. - 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).
- Nombres de campos:
PAGOQR::Opde ambos POS prefieretotal,paymentid,merchantorderidytotalitemsobreimporte_final,autorizadortrxid,autorizadorintencionideimporte. 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. base_amount: la rama DINO lo envía; el gateway lo ignora por diseño (AC-18). Almacor no debe implementarlo.- 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
- Todo lo referido a recargos en un POS (ningún caso ejecutado).
- La impresora fiscal en cualquiera de los dos árboles.
- La causa del truncado del prompt del importe (ancho del control en el recurso del diálogo).
- El comportamiento de la Z con el perfil 171 en 0.
- La Nota de Crédito de un ticket con ajuste, y la recuperación del ticket tras un corte, en Almacor.
- La reversa de percepciones (modo 2) en Almacor y en DINO (solo por lectura de código).
- El mapa de segmentos de Almacor y la disponibilidad real de los ids de perfil 564-567 en la tabla de perfiles de cada cliente.
- Si el formato del script de ticket muestra el signo "+" de un recargo.
- El timeout real de la lectura de
trxanulacionen el perfil 496 de Almacor (el comentario D-118 habla de 5 s, el código usa el perfil 496). - Los puntos de inserción son de la versión 20261003 de Almacor y de la rama DINO de 2026-10-29; deben reconfirmarse contra el árbol que se vaya a modificar.