eCashPoint - Interface
Einleitung
Das Programm "eCashPoint" ist zunächst ein unabhängiges Programm, d.h. es kann als eigenständiges Programm für die Abwicklung bargeldloser Zahlungen eingesetzt werden. Zusätzlich stellt es ein COM-Interface bereit, mit dem wichtige Funktionen angesprochen werden können. Dabei werden die entsprechenden Dialoge aus dem Programm per COM-Interface aufgerufen.
Dadurch ist eine Integration in alle Windows-Programme möglich, wo bargeldlose Zahlungsvorgänge benötigt werden.
Die Architektur von eCashPoint
EcashPoint ist für einen Mehrmandantenbetrieb ausgelegt, d.h. es können für verschiedene Zwecke unabhängige Datenbestände verwaltet werden (z.B.: Praxen mit mehreren Ärzten). Für jeden Mandant wird ein so genanntes Terminal angelegt. Hinter einem Terminal verbirgt sich immer ein Bankkonto, auf dem die Zahlungen gutgeschrieben werden.
Sind mehrere Terminals in eCashPoint angelegt, muss vor jeder Zahlung das gewünschte Terminal gewählt werden. Bei nur einem Terminal entfällt diese Auswahl.
Zahlungen per EC-Karte werden offline durchgeführt, d.h. es erfolgt keine Autorisierung per per Telefonanruf. Trotzdem erfolgt bei jeder Zahlung eine Prüfung gegen aktuelle Sperrlisten. Die Sperrlisten werden bei jedem Kassenschnitt aktualisiert.
Zahlungen per Kreditkarte werden online bei der Kreditkartenorganisation autorisiert.
Die Zahlungen werden zunächst gesammelt und im Rahmen eines "Kassenschnitts" an das Rechenzentrum übertragen. Der Kassenschnitt muss täglich vorgenommen werden. ECashPoint weist darauf hin, wenn das Programm beendet wird und Zahlungen vorliegen.
ECashPoint kann nach der Installation mit sogenannten Testterminals betrieben werden. Das sind Terminals, mit denen alle Funktionen ausgeführt werden können einschließlich Kassenschnitt. Es erfolgt jedoch keinerlei echte Zahlung, d.h. die Zahlungen werden vom Rechenzentrum nicht in Umlauf gebracht.
Die benutzten Programmteile
Konfiguration
Für die Konfiguration stellt das Interface verschiedene Funktionen bereit. Da die Terminalnummern von 1-49 für externen Betrieb reserviert sind, können diese Terminalnummern auch nicht innerhalb der normalen Konfiguration von eCashPoint vergeben werden. Aus diesem Grund stellt das Interface Funktionen bereit, um diese Terminals anzulegen. Auf diese Weise können externe Datenbestände besser Terminals zugeordnet werden.
Außerdem kann die Grundkonfiguration von eCashPoint abgefragt werden und wenn sie unvollständig ist, der Konfigurations-Assistent aufgerufen werden. Dabei werden alle Werte bis auf die Terminals einbezogen (Telefon, Lesegerät, Drucker). Folgende Dialoge werden dabei aufgerufen:
Zahlungen
Um eine Zahlung vorzunehmen, werden die folgenden Dialoge aus eCashPoint benutzt.
Im ersten Dialog werden die vorher übergebenen Werte (Betrag und Identifikationstext) in die entsprechenden Felder übernommen.
Das Interface
Das Interface ist ein COM-Objekt, welches mit Hilfe von Attributen und Membern das Bezahlen mit EC- oder Kreditkarten ermöglicht. Das COM-Objekt wird unter Verwendung des symbolischen Namens "ecashpoint.MainObj" referenziert. Mit dieser Referenz hat man Zugriff auf die Attribute und Member des Objekts. Im folgenden Abschnitt werden die Funktionen und Eigenschaften aufgelistet. Genaue Angaben zu Parametern, Rückgabewerten und Handhabung entnehmen Sie bitte der Hilfedatei des Developer-Packs.
Konfigurationsfunktionen
|
Member
|
getConfigStatus
|
Liefert den Status der Konfiguration von eCashPoint ohne Terminals.
|
|
Member
|
doConfig
|
ruft den Konfigurations-Assistent auf
|
|
Member
|
getAnzahlExtTerminals
|
Liefert die Anzahl der installierten Terminals, die über das Interface erreichbar sind (1-49).
|
|
Member
|
getExtTerminalStatus (short terminalNr)
|
Gibt Auskunft über den Status eines Terminals.
|
|
Member
|
addExtTerminal (short terminalNr, char Name)
|
Legt ein Terminal mit der Terminal-Nummer und der Bezeichnung als Test-Terminal an.
|
Zahlungsfunktionen
|
Attribut
|
terminalNr
|
Legt das Terminal fest, auf das gebucht werden soll.
|
|
Attribut
|
betrag
|
Übergibt den Betrag in Euro-Cent, der gebucht werden soll. Nach erfolgter Buchung enthält das Attribut den tatsächlich gebuchten Betrag, da es möglich ist, den Betrag vor der Buchung in eCashPoint zu verändern.
|
|
Attribut
|
identText
|
In diesem Attribut kann ein beliebiger Text übergeben werden, an dem die Buchung im Buchungsprotokoll identifiziert werden kann (z.B.: Name, Rechnungs-Nr.).
|
|
Member
|
doBuchung
|
Löst den Buchungsvorgang aus. Dadurch wird der Asisstent für die Buchung aufgerufen. Das Ende kann mit dem Attribut "buchungFertig" abgefragt werden.
|
|
Attribut
|
buchungFertig
|
Zeigt an, ob eine mit doBuchung angestossene Buchung fertig ist.
|
|
Attribut
|
buchungErgebnis
|
Liefert das Ergebnis der Buchung. Der zugehörige Klartext ist im Attribut buchungErgebnisText abgelegt.
|
|
Attribut
|
buchungErgebnisText
|
Liefert das Ergebnis der Buchung als Klartext.
|
|
Attribut
|
belegNr
|
Liefert die Belegnummer, die durch die Buchung vergeben wurde.
|
|
Attribut
|
kartenTyp
|
Liefert den Kartentyp der durchgeführten Buchung als numerischen Wert.
|
|
Attribut
|
kartenTypText
|
Liefert den Kartentyp in Textform.
|
Developerpack
Der eCashPoint-Developerpack enthält neben einer Hilfedatei mit der genauen Beschreibung des Interface vorgefertigte Wrapperklassen für die Integration in MS C++, eine TLB-Datei für die Integration in andere Programmiersprachen sowie ein Testprogramm in MS VC++, was die Handhabung der Funktionen des Interface veranschaulicht.
Weiterhin steht ein email-support zu Fragen rund um die Integration zur Verfügung.
|
