prDS CWA 16926-15:2025

Specifikimi i ndërfaqes së Zgjerimeve për Shërbimet Financiare (XFS) Versioni 3.51 Pjesa 15: Ndërfaqja e klasës së pajisjes së modulit të arketimit - Referencë për programuesit

Extensions for Financial Services (XFS) interface specification Release 3.51 - Part 15: Cash-In Module Device Class Interface - Programmer's Reference

Scope

Ky specifikim përshkruan funksionalitetin e një Ofruesi Shërbimi Cash-In Module (CIM) të pajtueshëm me XFS. Ai përcakton komandat specifike të shërbimit që mund t'i lëshohen Ofruesit të Shërbimit duke përdorur funksionet WFSGetInfo, WFSAsyncGetInfo, WFSExecute dhe WFSAsyncExecute.
Vlerat e vazhdueshme mbahen përmes ndërprerjeve të energjisë, seancave të hapura, seancave të mbyllura dhe rivendosjeve të sistemit.
Ky specifikim mbulon pranimin e artikujve. Një "artikull" përcaktohet si çdo media që mund të pranohet dhe përfshin kuponë, dokumente, kartëmonedha dhe monedha. Megjithatë, nëse monedhat dhe kartëmonedhat do të pranohen të dyja, duhet të zbatohen Ofrues të veçantë Shërbimesh për secilin.
Të gjithë parametrat e monedhës në këtë specifikim shprehen si një sasi e njësive minimale të shpërndarjes, siç përcaktohet në përshkrimin e komandës WFS_INF_CIM_CURRENCY_EXP.
Ekzistojnë dy lloje të CIM: CIM Vetë-Shërbimi dhe CIM i Arkëtarit. Një CIM Vetë-Shërbimi vepron në një mjedis të automatizuar, ndërsa një CIM i Arkëtarit ka një operator të pranishëm. Funksionaliteti i ofruar nga komandat e mëposhtme është i zbatueshëm vetëm për një CIM të Arkëtarit:
WFS_CMD_CIM_SET_TELLER_INFO
WFS_INF_CIM_SET_TELLER_INFO
Është e mundur që CIM të jetë pjesë e një pajisjeje të përbërë me Modulin e Shpërndarësit të Parave (CDM). Ky kombinim CIM\CDM referohet në të gjithë këtë specifikim si një "riciklues parash". Për detaje mbi ndërfaqen CDM shihni [Ref. 3].
Nëse pajisja është një riciklues parash, atëherë, nëse kërkohen shkëmbime të njësive të parave në të dyja ndërfaqet, shkëmbimet nuk mund të kryhen njëkohësisht. Një shkëmbim në njërën ndërfaqe duhet të jetë i plotë (WFS_CMD_CIM_END_EXCHANGE duhet të ketë përfunduar) përpara se një shkëmbim të mund të fillojë në ndërfaqen tjetër. Kodi i gabimit WFS_ERR_CIM_EXCHANGEACTIVE do të kthehet nëse nuk respektohet sekuenca e saktë. Ndërfaqja CIM mund të përdoret për të gjitha operacionet e këmbimit në pajisjet e riciklimit të parave të gatshme, dhe kjo ndërfaqe duhet të përdoret për njësitë e parave të gatshme të monedhave dhe/ose prerjeve të shumëfishta (duke përfshirë identifikues të shumëfishtë të kartëmonedhave të shoqëruara me të njëjtën prerje).
Ngjarja WFS_SRVE_CIM_COUNTS_CHANGED do të postohet nëse një operacion në ndërfaqen CDM ndikon në numërimin e njësive të parave të gatshme të ricikluara të cilat janë të disponueshme përmes ndërfaqes CIM.