Die Übertragung von digitalen Belegen kann über die Methoden des Fiskalservices, oder direkt in der Kommunikation mit der Cloud erfolgen.
Voraussetzungen
Sie benötigen die folgenden Voraussetzungen und folgenden Kenntnisse um die direkte Kommunikation in der Retailforce Cloud zu benutzen:
- Sie müssen einen Distributor Account und einen dazugehörigen Distributor api Schlüssel und api secret verfügen
- Sie müssen Kenntnisse über JSON/Rest Webservice calls (HTTP) haben
- Sie müssen Kenntnisse über JWT Bearer authentication (wird eingesetzt) haben
- Sie müssen einen Terminal in der Retailforce Cloud erstellen und die entsprechenden Lizenzen einstellen. (DigitalReceipt/DigitalReceiptLight)
Sie finden weitere Informationen zur JWT Bearer Authentication:
Übertragung von digitalen Belegen
Um einen digitalen Beleg zu übertragen, müssen Sie die folgenden Methoden in den folgenden Reihenfolge aufrufen:
Methoden:
- https://api.retailforce.cloud/api/v1.0/authenticate/logon (POST)
key: FORM Parameter
secret: FORM Parameter - https://api.retailforce.cloud/api/v1.0/licensing/token (GET)
uniqueClientId: QUERY Parameter
accessLicenseId: QUERY Parameter - https://functions.retailforce.cloud/api/digitalReceipt (POST)
uniqueClientId: QUERY/FORM Parameter (both possible)
licenseToken: QUERY/FORM Parameter (both possible)
file: FORM Parameter (Content)
Hinweis: Sie können den gleichen Dateinamen öfter als einmal für das gleiche POS System schicken. (uniqueClientId).
Nähere Informationen zu den Funktionen finden Sie unter https://api.retailforce.cloud . Benutzen Sie folgenden Link:https://api.retailforce.cloud/swagger.
Wichtig: Sie müssen nicht den gesamten Vorgang die ganze Zeit wiederholen. Der Lizenz Token, den sie vom Lizenz/token (GET) bekommen, ist 30 Tage gültig. Sie können jwt/decode auf der client Seite nutzen, um zu sehen, ob der Lizenztoken gültig ist.
Hinweis: Wenn Sie die Funktion licensing/token zu oft aufrufen, wird diese geblockt. Verwenden Sie es daher nur in der richtigen Weise, wie oben beschrieben.
Hinweis: Wenn Sie die Funktion licensing/token zu oft aufrufen, wird diese geblockt. Verwenden Sie es daher nur in der richtigen Weise, wie oben beschrieben.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.