RetailForce Cloud API

Το RetailForce Cloud API παρέχει όλες τις λειτουργίες του RetailForce Cloud Portal. Μπορεί να χρησιμοποιηθεί για την αυτοματοποίηση διαδικασιών ή για την κλήση λειτουργιών από εξωτερικά συστήματα χωρίς να απαιτείται σύνδεση στο portal και χειροκίνητη εκτέλεση ενεργειών.

Πιστοποίηση

Για να χρησιμοποιήσετε τις λειτουργίες, το σύστημα που υποβάλλει το αίτημα πρέπει να πιστοποιηθεί στο σύστημα Cloud. Παρακάτω περιγράφεται η χειροκίνητη πιστοποίηση, καθώς και παραδείγματα κλήσεων που ενεργοποιούνται από συμβάντα.

Πρόσβαση μέσω του api.RetailForce Cloud

Το Cloud API είναι διαθέσιμο στην ακόλουθη διεύθυνση URL:

• https://api.retailforce.cloud/swagger/index.html

Μη αυτόματη πιστοποίηση

Η πιστοποίηση πραγματοποιείται μέσω των cloudApiKey και cloudApiSecret και της δημιουργίας ενός Bearer Token.

1. Σημείο τερματισμού κλήσης

1. Κάντε κλικ στο endpoint POST /api/v1.0/authenticate/logon για να αναπτύξετε την ενότητα.
2. Εισάγετε τα στοιχεία σας apiKey και apiKeySecret στα αντίστοιχα πεδία.
3. Εκτελέστε το αίτημα για να λάβετε ένα Bearer Token.

2. Χρήση του Bearer Token

1. Αντιγράψτε το Bearer Token από το ResponseBody.
2. Κάντε κλικ στο κουμπί «Authorize» στην επάνω δεξιά γωνία του Swagger UI.
3. Εισάγετε το Bearer Token στο παράθυρο διαλόγου. Μορφή: Bearer <token> (εισάγετε ένα κενό μετά το "Bearer").
4. Κάντε κλικ στο "Authorize"

Αυτόματη πιστοποίηση

Η αυτόματη πιστοποίηση επιτρέπει στα συστήματα να έχουν ασφαλή πρόσβαση στο RetailForce Cloud API χωρίς την παρέμβαση του χρήστη, κάτι που είναι ιδανικό για υπηρεσίες που εκτελούνται στο παρασκήνιο, αυτοματοποιημένες ροές εργασίας ή τακτικές ερωτήσεις δεδομένων.

1. Πιστοποίηση και λήψη του Bearer Token:

Στείλτε ένα αίτημα POST με τα διαπιστευτήριά σας για το api στο τελικό σημείο πιστοποίησης.

curl -X POST "https://api.retailforce.cloud/api/v1.0/authenticate/logon" \
-H "Content-Type: multipart/form-data" \
-F "key=cloudApiKey" \
-F "secret=cloudApiSecret"

Μετά την επιτυχή πιστοποίηση, θα λάβετε ένα Bearer Token στο ResponseBody, το οποίο απαιτείται για την εξουσιοδότηση περαιτέρω αιτημάτων api.

2. Πρόσβαση σε τελικά σημεία:

Χρησιμοποιήστε το Bearer Token που λάβατε για να αποκτήσετε πρόσβαση στα σημεία τερματισμού.

Παράδειγμα:

curl -X 'GET' \
'https://api.retailforce.cloud/api/v1.0/someEndpoint' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer {yourBearerToken}'

Σημαντικό: Διατηρήστε τα διαπιστευτήριά σας για το api και τα token σας ασφαλή, προκειμένου να αποτρέψετε τη μη εξουσιοδοτημένη πρόσβαση.

Cloud Fiscalization

Ο όρος «Cloud Fiscalization» αναφέρεται στην παροχή του RetailForce Middleware φορολογικής καταγραφής ως φιλοξενούμενης υπηρεσίας cloud. Η υπηρεσία λειτουργεί από την RetailForce σε περιβάλλον cloud.

Πρόσβαση μέσω του fiscalisation.RetailForce Cloud

Αποκτήστε πρόσβαση στην υπηρεσία μέσω του ακόλουθου συνδέσμου:

• https://fiscalisation.RetailForceCloud.cloud/swagger/index.html

Χειροκίνητη πιστοποίηση

Υπάρχουν δύο επιλογές για την πιστοποίηση στη RetailForce Cloud Fiscalization μέσω του Swagger UI:

1. Ανοίξτε το Swagger UI και κάντε κλικ στο «Authorize».
2. Μέθοδοι πιστοποίησης
   1. Διαπιστευτήρια πύλης (email & κωδικός πρόσβασης):
      • Επιτρέπει την πρόσβαση σε πολλούς οργανισμούς.
   2. Κλειδί API και μυστικό κλειδί:
      • Συνήθως συνδέονται με έναν συγκεκριμένο distributor ή οργανισμό.
3. Κάντε κλικ στο «Εξουσιοδότηση»

Τώρα έχετε εξουσιοδότηση να δοκιμάσετε και να αρχίσετε να χρησιμοποιείτε τη φορολογική παρακολούθηση μέσω Cloud.

Αυτό το άρθρο μεταφράστηκε αυτόματα.