Αυτό το σημείο τερματισμού επιτρέπει την ανάκτηση ενός πελάτη στο RetailForce Middleware, με δεδομένα (συμπεριλαμβανομένων πληροφοριών διαμόρφωσης) από το RetailForce Cloud.
Η ανάκτηση ενός πελάτη μπορεί να είναι απαραίτητη σε περίπτωση αλλαγής του υλικού του ταμειακού μηχανήματος ή ελαττωμάτων του υλικού.
Η λειτουργία POST /api/v1/management/clients/recovery/restoreByCloud/ID είναι ουσιαστικά πανομοιότυπη με την PUT /api/v1/management/clients/byCloud, ωστόσο η τελευταία μπορεί να εκτελεστεί μόνο μία φορά κατά την αρχική θέση σε λειτουργία ενός πελάτη.
Αποτέλεσμα
Επιτυχής κλήση στο τελικό σημείο (200):
- Επανακατεβάζει το αντικείμενο διαμόρφωσης για τον σχετικό πελάτη από το σύστημα Cloud και διαμορφώνει τον πελάτη αναλόγως.
- Επαναφέρει έναν πελάτη που έχει ήδη τεθεί σε λειτουργία στο middleware και του εκχωρεί το αντίστοιχο uniqueClientId του terminals από το RetailForce Cloud.
Χρήση
Αυτό το τελικό σημείο χρησιμοποιείται όταν ένας πελάτης, ο οποίος έχει ήδη δημιουργηθεί μία φορά και του οποίου το clientId είναι γνωστό, πρέπει να ανακτηθεί (όπως στην περίπτωση αλλαγής υλικού).
Προϋποθέσεις
- Ο πελάτης πρέπει να έχει δημιουργηθεί μία φορά και το clientId πρέπει να είναι γνωστό.
- Η οργανωτική δομή και το αντικείμενο διαμόρφωσης έχουν δημιουργηθεί στο RetailForce Cloud και έχουν εκχωρηθεί αναλόγως.
- Έχει εγκατασταθεί το Fiscal Middleware.
- Το restoreByCloud μπορεί να χρησιμοποιηθεί μόνο εάν:
- χρησιμοποιείται η αντίστοιχη άδεια χρήσης (πακέτο αδειών που περιλαμβάνει το «Cloud Archive Access»),
- η checkbox «Cloud Archive» είναι ενεργοποιημένη στη διαμόρφωση (Cloud),
- ο πελάτης έχει ήδη μεταφέρει δεδομένα στο αρχείο Cloud (ΠΡΙΝ από την επαναφορά).
- Στη Γερμανία, πρέπει να έχει καταγραφεί στον client και να έχει μεταφερθεί στο αρχείο Cloud τουλάχιστον ένα ημερήσιο κλείσιμο (σε οποιοδήποτε σημείο στο παρελθόν).
Σημείωση: Το restoreByCloud θα λειτουργήσει σωστά μόνο εάν
- το middleware έχει εγκατασταθεί πρόσφατα στο σύστημα ΠΡΙΝ από την εκτέλεση του restoreByCloud,
- ή (χωρίς επανεγκατάσταση) η υπηρεσία φορολογικής καταγραφής (υπηρεσία RetailForce) έχει επανεκκινηθεί πριν από την εκτέλεση του restoreByCloud.
Πεδία φόρμας
Πρέπει να μεταδοθούν οι ακόλουθες πληροφορίες:
| Όνομα | Περιγραφή | Παραδείγματα |
| Τύπος |
Τύπος αναγνώρισης της εταιρείας. Ο τύπος πρέπει επίσης να καταχωρηθεί και να υπάρχει στο RetailForce Cloud. Διατίθενται οι ακόλουθοι τύποι: [0] = VatNumber, Δείτε επίσης: Αναγνωριστικό εταιρείας Συνιστούμε τη χρήση του τύπου [0] = VatNumber ως κύριου ID σε όλες τις χώρες (ΕΕ), ακόμη και αν δεν χρησιμοποιείται ως υποχρεωτικό ID εταιρείας στην εκάστοτε χώρα. |
[0] = VatNumber |
| Ταυτοποίηση | Το ίδιο το αναγνωριστικό της εταιρείας. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud. | ATU57780814 |
| storeNumber |
Ο αριθμός του καταστήματος στο οποίο βρίσκεται το ταμείο. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud.
ΣΗΜΕΙΩΣΗ:
στη Γαλλία, εδώ πρέπει να αναγράφεται ο αριθμός SIRET (επέκταση του SIREN με τον αριθμό καταστήματος).
|
|
| 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 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.