Conciliación (totales de fin de día)

La conciliación cierra y liquida el lote actual de transacciones — la operación de fin de día que totaliza lo procesado y lo entrega para liquidación. Es una única llamada con un parámetro significativo: el tipo de conciliación.

Requisito previo: una sesión activa.

La llamada

viewModelScope.launch {
    clientSDK.sendReconciliationRequest(
        RetailerMessageArguments.ReconciliationRequestMessageArguments(
            reconciliationType = RTRReconciliationType.SALERECONCILIATION
        )
    )
}

• reconciliationType — un RTRReconciliationType. SALERECONCILIATION concilia el lote de ventas. Consulte la referencia de la API para otros tipos de conciliación.

Existe un identificador opcional de período de conciliación (poiReconciliationId) para hacer referencia a un período pasado específico; la mayoría de las integraciones lo omiten y concilian el lote actual.

Lectura del resultado

when (message) {
    is SuccessRetailerReconciliationResponse -> { /* totales del lote / liquidación OK */ }
    is ErrorRetailerReconciliationResponse   -> { /* la conciliación falló */ }
}

Una respuesta exitosa contiene los totales de la conciliación. Maneje también el caso de error — la conciliación puede fallar si el terminal no puede conectarse al host.

Cuándo llamarla

La conciliación normalmente se ejecuta una vez por día hábil, al cierre. Algunas implementaciones hacen que el terminal concilie automáticamente según un horario; revise la configuración de su terminal antes de crear un disparador manual, para no conciliar dos veces.

Relacionado

• Guía: realizar un pago — la conciliación de transacciones que se liquida.
• Cómo funciona el modelo de mensajes — manejo del supertipo de respuesta.
• Referencia de la API (sdk-doc.zip) — el conjunto completo de RTRReconciliationType y campos opcionales.