Conciliación: reglas de producto y negocio

Define los flujos de clientes, estados, cálculos, efectos de derechos, mensajes y casos excepcionales para la conciliación. Esta referencia fija el límite de adopción, el comportamiento ante fallos y la evidencia observable, dejando configurables los límites específicos del entorno.

Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.

Decisión

Para la Conciliación, adopte un libro mayor interno duradero reconciliado con eventos autenticados del proveedor. Haga explícita la promesa visible para el usuario, exclusiones, autoridad y respuesta ante fallos, dejando los umbrales medidos como opciones de adopción. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos basándose en la evidencia de su propio entorno.

Alcance

• Los actores, entradas, salidas, estados, versiones de políticas o esquemas y resultados visibles externamente descritos por este bloque de requisitos.
• Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que puedan ejercer el mismo límite.
• Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.

Fuera de este bloque

• Elegir un proveedor universal, marco, jurisdicción, umbral numérico, período de retención u objetivo de nivel de servicio para todos los adoptantes.
• Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o accesibilidad.

Contrato

• Representar el dinero con una moneda explícita y un valor decimal exacto o en unidades menores; nunca usar punto flotante binario para aritmética del libro mayor.
• Dar a cada intención financiera visible externamente una clave única duradera retenida durante la vida útil relevante del libro mayor y auditoría.
• Autenticar las devoluciones de llamada del proveedor, persistir la referencia del evento en bruto y aplicar transiciones de estado de forma idempotente tras la validación del estado actual.
• Separar los estados orientados al cliente, proveedor, derechos, factura, liquidación, reembolso y conciliación en lugar de tratar un único estado como autoritativo para todos.
• Indicar qué actor recibe qué resultado bajo cada estado material, incluyendo condiciones de no disponible, no autorizado, vacío y parcial.
• Marcar los límites y políticas configurables como opciones con responsables; no presentar valores de ejemplo como requisitos universales.
• Emparejar intenciones internas, entradas del libro mayor, objetos del proveedor, pagos, disputas, tarifas, impuestos y reembolsos con categorías explícitas de no coincidentes.
• Las correcciones añaden asientos compensatorios y preservan la evidencia original; nunca editan el historial liquidado en el lugar.

Guía de implementación

• Revisar el contrato con producto, implementación, operaciones, seguridad y usuarios afectados antes de promoverlo más allá de la revisión.
• Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de la Conciliación antes de seleccionar detalles de marco o proveedor.
• Almacenar la versión aplicable del contrato o política de Conciliación con el estado material para que migraciones, reproducción y decisiones de soporte sean atribuibles.
• Introducir la ruta detrás de un despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta que la evidencia de adopción esté completa.

Manejo de fallos y salvaguardas

• Un resultado ambiguo del proveedor permanece pendiente de conciliación; el sistema no concede valor duplicado ni descarta silenciosamente una obligación financiera.
• El estado de Conciliación inválido o contradictorio se rechaza o pone en cuarentena; la implementación nunca adivina un valor que amplíe autoridad o duplique un efecto.
• Los reintentos están limitados y usan identidad duradera; tras agotarlos, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.

Verificación y operaciones

• Mapear cada promesa y exclusión a al menos un escenario observable y confirmar que no haya dos estados que requieran resultados contradictorios.
• Monitorizar éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación de la Conciliación por versión de contrato sin dimensiones sensibles de carga útil.
• Reejecutar los fixtures positivos y negativos emparejados tras cambios en política, esquema, dependencia, migración o límite y preservar la evidencia resultante.

Suposiciones de adopción

• Los nombres y valores en el ejemplo son un fixture concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y responsabilidad.
• El sistema adoptante puede proporcionar identidad autenticada, versiones duraderas de operación o registro, telemetría limitada y una ruta controlada para el cambio.

Los ejemplos con apariencia ejecutable en este paquete son fixtures y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio destino antes de registrar evidencia de implementación.

Referencias

• PCI Security Standards Council, PCI DSS (aplica desde 2026-09-08)