Rapprochement (totaux de fin de journée)

Le rapprochement clôture et règle le lot actuel de transactions — l'opération de fin de journée qui totalise ce qui a été traité et le transmet pour règlement. C'est un appel unique avec un paramètre significatif : le type de rapprochement.

Prérequis : une session active.

L'appel

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

• reconciliationType — un RTRReconciliationType. SALERECONCILIATION rapproche le lot de ventes. Consultez la référence API pour les autres types de rapprochement.

Il existe un identifiant optionnel de période de rapprochement (poiReconciliationId) pour référencer une période passée spécifique ; la plupart des intégrations l'omettent et rapprochent le lot en cours.

Lecture du résultat

when (message) {
    is SuccessRetailerReconciliationResponse -> { /* totaux du lot / règlement OK */ }
    is ErrorRetailerReconciliationResponse   -> { /* échec du rapprochement */ }
}

Une réponse réussie contient les totaux du rapprochement. Gérez également le cas d'erreur — le rapprochement peut échouer si le terminal ne peut pas joindre l'hôte.

Quand l'appeler

Le rapprochement s'effectue généralement une fois par jour ouvrable, à la fermeture. Certaines installations font rapprocher automatiquement le terminal selon un planning ; vérifiez la configuration de votre terminal avant de créer un déclencheur manuel, afin d'éviter un double rapprochement.

Articles liés

• Guide : effectuer un paiement — le rapprochement des transactions que cela règle.
• Comment fonctionne le modèle de message — gestion du super-type de réponse.
• Référence API (sdk-doc.zip) — l'ensemble complet RTRReconciliationType et les champs optionnels.