Afstemming (eindtotaal van de dag)

Afstemming sluit en vereffent de huidige batch van transacties af — de eind-van-de-dag operatie die optelt wat er verwerkt is en het doorgeeft voor afwikkeling. Het is een enkele oproep met één betekenisvolle parameter: het type afstemming.

Vereiste: een actieve sessie.

De oproep

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

• reconciliationType — een RTRReconciliationType. SALERECONCILIATION stemt de verkoopbatch af. Zie de API-referentie voor andere afstemmingstypen.

Er is een optionele afstemmingsperiode-identificatie (poiReconciliationId) om naar een specifieke vorige periode te verwijzen; de meeste integraties laten dit weg en stemmen de huidige batch af.

Het resultaat lezen

when (message) {
    is SuccessRetailerReconciliationResponse -> { /* batch totalen / afwikkeling OK */ }
    is ErrorRetailerReconciliationResponse   -> { /* afstemming mislukt */ }
}

Een succesvolle respons bevat de afstemmingstotalen. Verwerk ook het foutgeval — afstemming kan mislukken als de terminal de host niet kan bereiken.

Wanneer oproepen

Afstemming wordt gewoonlijk eenmaal per werkdag uitgevoerd, bij sluiting. Sommige implementaties laten de terminal automatisch op een schema afstemmen; controleer je terminalconfiguratie voordat je een handmatige trigger bouwt, zodat je niet dubbel afstemt.

Gerelateerd

• Gids: een betaling uitvoeren — de transacties die afstemming vereisen.
• Hoe het berichtmodel werkt — omgaan met het responsetype super-type.
• API-referentie (sdk-doc.zip) — de volledige set RTRReconciliationType en optionele velden.