Riconciliazione (totali di fine giornata)

La riconciliazione chiude e regola il batch corrente di transazioni — l’operazione di fine giornata che totalizza ciò che è stato processato e lo consegna per la regolazione. È una singola chiamata con un parametro significativo: il tipo di riconciliazione.

Prerequisito: una sessione attiva.

La chiamata

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

• reconciliationType — un RTRReconciliationType. SALERECONCILIATION riconcilia il batch di vendita. Vedi il riferimento API per altri tipi di riconciliazione.

Esiste un identificatore opzionale del periodo di riconciliazione (poiReconciliationId) per fare riferimento a un periodo passato specifico; la maggior parte delle integrazioni lo omette e riconcilia il batch corrente.

Lettura del risultato

when (message) {
    is SuccessRetailerReconciliationResponse -> { /* totali batch / regolamento OK */ }
    is ErrorRetailerReconciliationResponse   -> { /* riconciliazione fallita */ }
}

Una risposta di successo riporta i totali della riconciliazione. Gestire anche il caso di errore — la riconciliazione può fallire se il terminale non riesce a raggiungere l’host.

Quando chiamarla

La riconciliazione viene tipicamente eseguita una volta al giorno lavorativo, alla chiusura. Alcune installazioni fanno sì che il terminale riconcili automaticamente secondo un programma; verifica la configurazione del terminale prima di implementare un trigger manuale, per evitare doppie riconciliazioni.

Correlati

• Guida: effettuare un pagamento — le transazioni che la riconciliazione regola.
• Come funziona il modello di messaggio — gestione del supertipo di risposta.
• Riferimento API (sdk-doc.zip) — l’insieme completo di RTRReconciliationType e campi opzionali.