Μετάβαση στο κύριο περιεχόμενο

PUT /api/v1/management/clients/ byCloud

Harald Krondorfer
  • Ενημέρωση

Αυτό το σημείο τερματισμού δημιουργεί έναν νέο client στο Fiscal Middleware και τον συνδέει με ένα terminal στο RetailForce Cloud. Αποτελεί το πρώτο βήμα για τη θέση σε λειτουργία ενός νέου ταμείου.

Αποτελέσματα

Μια επιτυχής κλήση του τελικού σημείου (200)

  • δημιουργεί έναν νέο πελάτη στο middleware, του αποδίδει το uniqueClientId του τερματικού (Cloud) και
  • κατεβάζει το αντικείμενο διαμόρφωσης από το σύστημα Cloud και διαμορφώνει τον client αναλόγως.

Χρήση

  • Μία φορά, όταν τίθεται σε λειτουργία ένα νέο ταμείο. Η εκ νέου κλήση του τελικού σημείου για τον ίδιο πελάτη (clientId) θα οδηγήσει σε σφάλμα!
ΠΡΟΣΟΧΗ : εάν ένας συγκεκριμένος πελάτης έχει ήδη συνδεθεί μία φορά με το terminal που δημιουργήθηκε στο cloud (εκχώρηση uniqueClientId), η εκ νέου κλήση του τελικού σημείου θα οδηγήσει σε μήνυμα σφάλματος: «409 - Ο πελάτης υπάρχει ήδη». Εάν ένας πελάτης πρέπει να δημιουργηθεί εκ νέου (π.χ. βλάβη σκληρού δίσκου κ.λπ.), πρέπει να χρησιμοποιηθεί το τελικό σημείο /api/v1/management/clients/recovery/restoreByCloud.

Προαπαιτούμενα

Πεδία φόρμας

Πρέπει να υποβληθούν οι ακόλουθες πληροφορίες:

Ονομασία Περιγραφή Παράδειγμα
Τύπος

Τύπος αναγνώρισης εταιρείας. Ο τύπος πρέπει επίσης να έχει καταχωρηθεί και να υπάρχει στο RetailForce Cloud.

Διατίθενται οι ακόλουθοι τύποι:

[0] = VatNumber,
[1] = taxNumber,
[2] = GLN,
[3] = BusinessIdentificationNumber,
[4] = Στατιστική ταξινόμηση,
[5] = Αριθμός εμπορικού μητρώου,
[6] = Αριθμός εμπορικού μητρώου,
[7] = Αριθμός εμπορικού μητρώου

Δείτε επίσης: Ταυτοποίηση εταιρείας 

Συνιστούμε τη χρήση του τύπου [0] = VatNumber ως κύριου ID σε όλες τις χώρες (ΕΕ), ακόμη και αν δεν χρησιμοποιείται ως υποχρεωτικό ID εταιρείας στην εκάστοτε χώρα.
 [0] = VatNumber
Ταυτοποίηση

Το ίδιο το αναγνωριστικό της εταιρείας. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud.

 ATU57780814
storeNumber

Ο αριθμός του υποκαταστήματος / καταστήματος όπου βρίσκεται το ταμείο. Πρέπει να ταιριάζει με τις πληροφορίες που έχουν εισαχθεί στο RetailForce Cloud.

ΠΡΟΣΟΧΗ: στη Γαλλία, πρέπει να αναγράφεται εδώ ο αριθμός SIRET (επέκταση του αριθμού SIREN με τον αριθμό υποκαταστήματος).
  • S001,
  • 12345
  • κ.λπ.
terminalNumber

Αριθμός ταμειακής μηχανής. Πρέπει να ταιριάζει με τα στοιχεία που έχουν καταχωρηθεί στο RetailForce Cloud.

 0010
cloudApiKey

Κλειδί API για την πιστοποίηση της επικοινωνίας με το cloud

 RFC_4a2abc...
cloudApiSecret

API Secret για την πιστοποίηση της επικοινωνίας με το cloud

 ypts7u5OU...

Απάντηση

Πιθανές απαντήσεις:

Κωδικός Περιγραφή Παράδειγμα
200

The client was created and configured with success.

Το uniqueClientId επιστρέφεται ως αντικείμενο απόκρισης.

Το uniqueClientId πρέπει να αποθηκευτεί από το σύστημα POS και να χρησιμοποιηθεί από αυτό για όλη την περαιτέρω διαδικασία επικοινωνίας (όσον αφορά τον πελάτη).
 3fa85f64-5717-4562-b3fc-2c963f66afa6
404

Δεν βρέθηκε οργανισμός στο RetailForce Cloud για το συγκεκριμένο ID εταιρείας.

Αντιμετώπιση προβλημάτων:

  • Ελέγξτε το ID της εταιρείας στο RetailForce Cloud και στο ταμείο.
  • Δημιουργήστε εταιρεία (οργανισμό ή εταιρεία) στο RetailForce Cloud
 -
406

Λόγω του καθορισμένου τύπου (κωδικός εταιρείας), δεν είναι δυνατή η σαφής αντιστοίχιση (π.χ. όταν χρησιμοποιείται [6] = CommercialRegisterNumberOffice).

Αντιμετώπιση προβλημάτων:

  • Χρησιμοποιήστε διαφορετικό τύπο ID (π.χ. [0] = VatNumber)
 -
409

Υπάρχει ήδη πελάτης με το σχετικό uniqueClientId στη Φορολογική Υπηρεσία (Fiscal Middleware).

Αντιμετώπιση προβλημάτων:

  • Χρησιμοποιήστε τον υπάρχοντα client
 -

 

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

Σχετικά άρθρα

Σχόλια

0 σχόλια

Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.

Παρέχεται από τη Zendesk