Αυτό το σημείο τερματισμού επιτρέπει την ανάκτηση ενός πελάτη στο RetailForce Middleware, με δεδομένα (συμπεριλαμβανομένων πληροφοριών διαμόρφωσης) από το RetailForce Cloud.
Η ανάκτηση ενός πελάτη μπορεί να είναι απαραίτητη σε περίπτωση αλλαγής του υλικού του ταμείου ή ελαττωμάτων του υλικού.
Η λειτουργία POST /api/v1/management/clients/recovery/restoreByCloud είναι ουσιαστικά πανομοιότυπη με την PUT /api/v1/management/clients/byCloud, αλλά η τελευταία μπορεί να εκτελεστεί μόνο μία φορά κατά την αρχική θέση σε λειτουργία ενός πελάτη.
Αποτέλεσμα
Επιτυχής κλήση στο τελικό σημείο (200):
- Επανακατεβάζει το αντικείμενο διαμόρφωσης για τον σχετικό client από το σύστημα Cloud και διαμορφώνει τον client αναλόγως.
- Επαναφέρει έναν πελάτη που έχει ήδη τεθεί σε λειτουργία στο middleware και του αποδίδει το αντίστοιχο uniqueClientId του τερματικού από το RetailForce Cloud.
Χρήση
Αυτό το τελικό σημείο χρησιμοποιείται όταν ένας πελάτης, ο οποίος έχει ήδη δημιουργηθεί μία φορά και του οποίου το clientId είναι γνωστό, πρέπει να αποκατασταθεί (για παράδειγμα, σε περίπτωση αλλαγής υλικού).
Προϋποθέσεις
- Ο πελάτης πρέπει να έχει δημιουργηθεί μία φορά και το clientId πρέπει να είναι γνωστό.
- Η οργανωτική δομή και το αντικείμενο διαμόρφωσης έχουν δημιουργηθεί στο RetailForce Cloud και έχουν εκχωρηθεί αναλόγως.
- Τα «storeNumber» και «terminalNumber» είναι γνωστά.
- Το «LicenseConsumerId» είναι γνωστό.
- Έχει εγκατασταθεί το Fiscal Middleware.
- Το restoreByCloud μπορεί να χρησιμοποιηθεί μόνο εάν:
- χρησιμοποιείται η αντίστοιχη άδεια χρήσης (πακέτο αδειών που περιλαμβάνει το «Cloud Archive Access»),
- η checkbox «Cloud Archive» είναι ενεργοποιημένη στη διαμόρφωση (Cloud),
- ο πελάτης έχει ήδη μεταφέρει δεδομένα στο αρχείο Cloud (ΠΡΙΝ από την επαναφορά).
- Στη Γερμανία, πρέπει να έχει καταχωρηθεί στον client και να έχει μεταφερθεί στο αρχείο Cloud τουλάχιστον ένα ημερήσιο κλείσιμο (σε οποιοδήποτε σημείο στο παρελθόν).
Σημείωση: Το restoreByCloud θα λειτουργήσει σωστά μόνο εάν
- το middleware έχει εγκατασταθεί πρόσφατα στο σύστημα ΠΡΙΝ από την εκτέλεση του restoreByCloud,
- ή (χωρίς επανεγκατάσταση) η υπηρεσία φορολογικής καταγραφής (υπηρεσία RetailForce) έχει επανεκκινηθεί πριν από την εκτέλεση του restoreByCloud.
Πεδία φόρμας
Πρέπει να υποβληθούν οι ακόλουθες πληροφορίες:
| Όνομα | Περιγραφή | Παραδείγματα |
| LicenseConsumerId | Το ID του οργανισμού. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Ο αριθμός του καταστήματος όπου βρίσκεται το ταμείο. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud. Στοιχεία χώρας:
|
|
| terminalNumber | Αριθμός ταμειακής μηχανής. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud. | 0010 |
| cloudApiKey | Κλειδί API για την πιστοποίηση της επικοινωνίας με το Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret for authenticating Cloud communication | ypts7u5OU... |
Απάντηση
Πιθανές απαντήσεις:
| Κωδικός | Περιγραφή | Παράδειγμα |
| 200 | Ο πελάτης αποκαταστάθηκε και διαμορφώθηκε με επιτυχία. Το αντικείμενο απόκρισης επιστρέφει το uniqueClientId του αποκατεστημένου πελάτη. Το uniqueClientId πρέπει να αποθηκευτεί από το σύστημα ταμειακής μηχανής και να χρησιμοποιηθεί για ολόκληρη την περαιτέρω διαδικασία επικοινωνίας που αφορά τον πελάτη. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Ο τύπος του παρεχόμενου αναγνωριστικού εταιρείας δεν είναι μοναδικός. Διαχείριση σφαλμάτων: Χρησιμοποιήστε έναν από τους ακόλουθους αναγνωριστικούς κωδικούς εταιρείας: [0] = VatNumber, |
- |
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.