0 CZK
Přihlášení / Registrace
Kategorien anzeigen

Tagesabschluss

Was genau ist ein Batch? Jede von Ihnen erstellte Transaktion gehört zu einem sogenannten Batch. Genau wie ein Kassenbon hat jeder Batch eine eigene Nummer und ist im Grunde ein Bündel von Transaktionen. Ein Abschluss ist ein administrativer Vorgang, mit dem das Terminal einen Stapel abschließt und die Systeme auffordert, den Stapel zu schließen und einen neuen zu eröffnen. In den Systemen von Global Payments kann bei jeder Transaktion die Abschlussnummer eingesehen werden, und es ist möglich, Transaktionen nach dieser Nummer zu filtern.

Anmeldung & Authentifizierung

Für alle nicht öffentlichen Endpunkte ist eine Authentifizierung mittels JWT-Token erforderlich. Das Token (mit einer Gültigkeitsdauer von 90 Tagen) erhalten Sie über den Endpunkt /cloud/oauth/token mit den folgenden übergebenen Argumenten:

Beantragung eines Zugriffstokens

Beispielanfrage:

POST {{apiCloudHost}}/cloud/oauth/token
Autorisierung: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Inhalt-Typ: anwendung/x-www-form-urlencoded

grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888

Beispielantwort:

{
"access_token": "eyJh…", // Zugriffstoken, das bei authentifizierten API-Anfragen verwendet wird
"token_type": "bearer",
"refresh_token": "GciO…",
"expires_in": 3600,
"scope": "read write",
"tid": "999888",
}

Token zurücksetzen

Nach Ablauf des access_tokens steht ein refresh_token zur Verfügung.

Beispielanfrage:

POST {{apiHost}}/api/oauth/token
Autorisierung: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Inhalt-Typ: anwendung/x-www-form-urlencoded

grant_type=refresh_token&refresh_token=GciO…

GPTomAuth

Art des Sicherheitsschemas
Schema der HTTP-Autorisierung
HTTP
Inhaber

Erstellen eines Ordners

Rufen Sie den Endpunkt POST /v1/tasks/BATCH auf und verwenden Sie CreateCloudTaskTransactionApiRequest mit den folgenden Angaben, um die Anfrage zu erstellen:

Variabel
Datum
VERPFLICHTUNG
apiKey
VERPFLICHTUNG
tid
VERPFLICHTUNG
Initiator
VERPFLICHTUNG
Titel
VERPFLICHTUNG
timeToLive
Format
String
String
String
String
String
Ganzzahl
Beschreibung
Transaktionen mit einem früheren oder gleichen Datum werden abgeschlossen. Es werden alle Transaktionen bis zu diesem Datum seit dem letzten erfolgreich abgeschlossenen Stapel berücksichtigt.
Den API-Schlüssel finden Sie in der App im Bereich „Konto – Cloud-API“. Er dient vor allem in der Cloud-API zur Identifizierung bei der Anmeldung.
Ziel-TID für die jeweilige Aufgabe. TID = Terminal-ID, die für jedes Gerät eindeutig ist. Auf allen installierten Geräten kann jeweils nur eine TID verwendet werden.
Die Beschreibung des Initiators sollte für jede Instanz des Subsystems, die eine Aufgabe initiieren kann, eindeutig sein. Beispiel: „Server XY“ oder „Kasse 1“
Ein für Menschen lesbarer Name für die Aufgabe. Er sollte eine Identifikation der Aufgabe enthalten.
Beispiel: „Rechnung 37364FD“
Zeitlimit für das Ablaufen eines Cloud-Auftrags. Es dürfen Werte im Bereich von Sekunden eingegeben werden.
Beispiel
2025-12-18T08:21:39.427Z
333W212J3
483590
Kasse 12
Abschluss 36744
10

Inhalt der Antwort [CloudTaskDetailApiResponse]:

Mögliche Antwortcodes sind:

Antwort
RC200
RC403
RC406
RC 502
Bericht
OK – Die Aufgabe wurde registriert
Der Benutzer ist nicht berechtigt, einen Auftrag auf diesem Terminal zu registrieren
Der Auftrag kann für dieses Terminal nicht angenommen werden
Die Push-Benachrichtigung wurde nicht gesendet
Beschreibung
Die Aufgabe wurde erfolgreich erstellt und wird bearbeitet.
Wenn Ihre API-Anmeldedaten nicht mit dem übermittelten TID-Wert übereinstimmen (beispielsweise wenn der TID-Inhaber ein anderer ist).
Dies geschieht in der Regel, wenn TID die Anfrage nicht bearbeiten kann.
Die Push-Benachrichtigung wurde aufgrund eines Ausfalls des Upstream-Dienstes nicht gesendet.
Wie man sich verhält
Fahren Sie mit dem nächsten Schritt im Transaktionsablauf fort.
Bitte überprüfen Sie, ob Sie die richtige TID eingegeben haben, und versuchen Sie es erneut.
Überprüfen Sie die Fehlermeldung.

Nachfolgend finden Sie die in der Antwort verwendeten Variablen:

Variabel
Titel
taskId
erstellt
Aufgabenklasse
Status
Initiator
contextId
Nutzlast
exceptionId
Typ
Nachricht
Kontext
Format
String
String
String
String
String
String
String
Objekt
String
String
String
String
Beschreibung
Ein für Menschen lesbarer Name für den Ordner. Wird aus dem Wert der Anforderung übernommen.
Interne ID des Tasks
Datum und Uhrzeit der Erstellung der Aufgabe.
Nutzlastklasse Mögliche Werte: [TRANSACTION, BATCH, DUMMY]
Status der Cloud-Aufgabe. Mögliche Werte: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Beschreibung des Initiators auf der Client-Seite. Wird aus dem Wert der Anfrage übernommen.
ID der betreffenden Zielentität, falls vorhanden (transactionId / batchId)
Der Hauptteil der kontextbezogenen Aufgabe – abhängig von der taskClass
Pseudo-eindeutige Ausnahme-IDs. Diese können als „Support-ID“ dienen, die der Benutzer dem Support mitteilen kann, damit dieser den Fehler untersuchen kann.
Ausnahmetyp.
Meldung einer Ausnahme.
Kontext der Ausnahme. Weitere Informationen.
Beispiel
Abschluss 123
dFd3sda
BATCH
GESCHAFFEN
Kasse 12
{...}
FujIk6
VALIDATION_EXCEPTION
Das Passwort ist zu schwach
[INSUFFICIENT_DIGIT]:{minimumRequired=1, matchingCharacterCount=0, validCharacters=0123456789, matchingCharacters=}
RC200
JA
JA
JA
JA
JA
JA
JA
JA
NA
NA
NA
NA
RC403
NA
NA
NA
NA
NA
NA
NA
NA
JA
JA
JA
JA
RC406
NA
NA
NA
NA
NA
NA
NA
NA
JA
JA
JA
JA
RC502
NA
NA
NA
NA
NA
NA
NA
NA
JA
JA
JA
JA

Überprüfung des Taschenzustands

Im nächsten Schritt überprüfen Sie den Status der Aufgabe am Endpunkt GET /v1/tasks/{taskID} mithilfe einer Anfrage, die Folgendes enthält:

Variabel
taskId
Format
String
Beschreibung
Die ID des Tasks, den Sie im vorherigen Schritt erhalten haben.
Beispiel
dFd3sda

Mögliche Rückgabecodes:

Antwort
RC200
RC403
Bericht
OK – Status der Tasche verfügbar
Für das aktuelle Terminal wurde keine Cloud-Aufgabe gefunden.
Bericht
Die Aktualisierung des Auftragsstatus wurde erfolgreich durchgeführt.
Sie sollten Ihre Task-ID überprüfen und den richtigen Wert erneut übermitteln.
Beschreibung
Falls Sie keinen endgültigen Status erhalten (siehe unten), wiederholen Sie diesen Schritt.
Bitte überprüfen Sie, ob Sie die richtige Task-ID eingegeben haben, und versuchen Sie es erneut.

Variablen in der Antwort:

Variabel
Titel
taskId
erstellt
Aufgabenklasse
Status
Initiator
contextID
Nutzlast
exceptionId
Typ
Nachricht
Kontext
Format
String
String
String
String
String
String
String
String
String
String
String
Beschreibung
Ein für Menschen lesbarer Name für die Aufgabe. Wird aus dem Wert der Anforderung zur Erstellung der Aufgabe übernommen.
Interne ID der Aufgabe
Datum und Uhrzeit der Erstellung der Aufgabe.
Mögliche Werte: [TRANSACTION, BATCH, DUMMY]
Mögliche Werte: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Beschreibung des Initiators auf der Client-Seite. Wird aus dem Wert der Anfrage übernommen.
ID der betreffenden Zielentität, falls vorhanden (transactionId / batchId)
Pseudo-eindeutige Ausnahme-IDs. Diese können als „Support-ID“ dienen, die der Benutzer dem Support mitteilen kann, damit dieser ein eventuelles Problem untersuchen kann.
Ausnahmetyp.
Ausnahmemeldung.
Kontext der Ausnahme – weitere Informationen.
Beispiel
Rechnung 36744
dFd3sda
2025-12-18T08:21:39.427Z
BATCH
IN_PROGRESS
Kasse 12
12DFSFSSF
FujIk6
VALIDATION_EXCEPTION
Das Passwort ist zu schwach
[INSUFFICIENT_DIGIT]:{minimumRequired=1, matchingCharacterCount=0, validCharacters=0123456789, matchingCharacters=}
RC200
JA
JA
JA
JA
JA
JA
JA
JA
NA
NA
NA
NA
RC404
NA
NA
NA
NA
NA
NA
NA
NA
JA
JA
JA
JA

Die Abfrage des Tasks-Status sollte so lange wiederholt werden, bis Sie einen der folgenden endgültigen Antwortcodes erhalten:

Status
INIT_ERROR
ABGESCHLOSSEN
ABGESAGT
ERROR
Beschreibung
Die Initiierung des Zahlungsvorgangs ist fehlgeschlagen. Überprüfen Sie den empfangenen Fehler.
Sobald Sie diesen Status erhalten, ist Ihre Aufgabe abgeschlossen und das Ergebnis liegt vor.
Die Aufgabe wurde vom Benutzer gelöscht.
Bei der Verarbeitung des Auftrags ist ein Fehler aufgetreten.
Wie man sich verhält
Befolgen Sie die Anweisungen für den Fehler.
Sie können mit dem nächsten Schritt fortfahren.
Sie sollten eine neue Aufgabe starten, da diese Aufgabe vom Benutzer abgebrochen wurde.
Befolgen Sie die Anweisungen für den Fehler.

Sie können erst dann mit dem nächsten Schritt fortfahren, wenn der Status der Antwort „COMPLETED“ lautet.

Ermittlung des Bilanzergebnisses

Wir wissen nun, dass der Abschluss genehmigt wurde. Ziel dieses Schritts ist es, den Status des Abschlusses und die dazugehörigen Daten abzurufen. Für die neue Anfrage rufen Sie den Endpunkt GET /v1/batches/{batchId} auf, wobei Sie die folgenden Variablen verwenden:

Variabel
batchId
Format
String
Beschreibung
Die ID der Charge, die Sie in den vorherigen Schritten erhalten haben.
Beispiel
12DFSFSSF

Mögliche Antwortcodes sind:

Antwort
RC200
RC404
Bericht
OK – Details zum Redaktionsschluss wurden bereitgestellt
Für die aktuelle TID wurde kein Stichtag gefunden.
Bericht
Erfolgreiche Bearbeitung Ihrer Anfrage bezüglich des Stichtags.
Dieser Zustand tritt ein, wenn für Ihr Gerät die entsprechende Sperr-ID nicht gefunden wurde.
Beschreibung
Die Transaktion ist abgeschlossen!
Überprüfen Sie die Transaktions-ID.

Die Antwort enthält je nach Antwortcode die folgenden Variablen:

Variabel
batchid
communicationId
batchNumber
Datum
vorheriges Chargendatum
firstTransactionDate
totalAmount
Währung
totalCount
Verkaufszahl
Verkaufsbetrag
voidCount
voidAmount
invalidCount
amsBatchNumber
Teilchargen
Format
String
String
String
String
String
String
Zahl
String
Zahl
Zahl
Zahl
Zahl
Zahl
Zahl
String
Objekt
Beschreibung
Interne Chargen-ID, „OPEN“ für eine Pseudo-Charge mit offenen Transaktionen.
Kann für den technischen Support verwendet werden. Pseudo-eindeutige ID für Protokollierungszwecke.
Die Chargennummer für das jeweilige TID.
Das genaue Datum und die Uhrzeit, zu der die Dosis abgeschlossen wurde.
Datum und Uhrzeit des Beginns der abgeschlossenen Charge. Sie haben einen Zeitraum für diese Charge (OD: Wert von „previousBatchDate“ bis TO: Datum des Werts).
Datum der ältesten Transaktion.
Gesamtbetrag für alle Transaktionsarten.
Währung zum Bilanzstichtag
Gesamtzahl der Transaktionen im Batch
Anzahl der Transaktionen vom Typ „Verkauf im Stapel“.
Volumen der Transaktionen vom Typ „Batch-Verkauf“.
Anzahl aller Stornotransaktionen im Stapel.
Gesamtvolumen aller Stornotransaktionen im Stapel.
Anzahl der ungültigen Transaktionen im Stapel
Interne Chargen-ID, „OPEN“ für eine Pseudo-Charge mit offenen Transaktionen.
Grunddaten innerhalb eines Meta-Batches – Aufschlüsselung nach Transaktionsart, einschließlich statistischer Informationen zu untergeordneten Batches nach Zahlungsart. Enthält:
-closeBatchNumber (Zeichenkette) – closeBatchNumber des untergeordneten Batches
- totalCount (number) – Gesamtzahl der Transaktionen im Batch
- saleCount (number) – Anzahl der Verkaufstransaktionen im Batch
- saleAmount (number) – Betrag der Verkaufstransaktionen im Stapel
- voidCount (number) – Anzahl der stornierten Transaktionen
- voidAmount (number) – Betrag der stornierten Transaktionen im Stapel
Beispiel
12DFSFSSF
2
2025-12-18T08:21:39.427Z
2025-12-17T12:22:11.427Z
Wie gefällt Ihnen dieses Lernprogramm?
Wählen Sie die Währung
CZK Tschechische Krone
€ Euro