Επισκόπηση των βημάτων που απαιτούνται για τη θέση σε λειτουργία ενός client:

1. Δημιουργία οργανωτικής δομής
2. Διαμόρφωση
3. Δημιουργία σύνδεσης με το Cloud
4. Αρχικοποίηση πελάτη

1. Δημιουργία οργανωτικής δομής

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

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

2. Διαμόρφωση

Η διαμόρφωση ενός clients του middleware μπορεί βασικά να γίνει με δύο διαφορετικούς τρόπους (ανάλογα με τις ρυθμίσεις και τις συμφωνίες που έχουν γίνει μεταξύ του κατασκευαστή του λογισμικού ταμειακής μηχανής και της εταιρείας που διαχειρίζεται τα ταμεία):

1. Διαμόρφωση μέσω του RetailForce Cloud, ή εναλλακτικά
2. Διαμόρφωση μέσω λογισμικού POS (σύστημα ταμειακής μηχανής, σύστημα ηλεκτρονικής καταγραφής)

1. Διαμόρφωση μέσω του RetailForce Cloud

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

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

Οι παράμετροι για την κλήση είναι:

• Αναγνωριστικό εταιρείας (companyIdentification), συνήθως ο αριθμός ΦΠΑ (VatNumber). Ανάλογα με τη χώρα φορολογίας, ενδέχεται να είναι απαραίτητο να εισαχθούν εναλλακτικά ή επιπλέον άλλα χαρακτηριστικά αναγνώρισης (!). Ωστόσο, για την έναρξη λειτουργίας συνιστάται ο αριθμός ΦΠΑ.
• Αριθμός καταστήματος / υποκαταστήματος
• Αριθμός ταμειακής μηχανής
• cloudApiKey
• cloudApiSecret

Εάν η λειτουργία PUT api/v1/management/clients/byCloud ολοκληρωθεί χωρίς σφάλμα, η διαμόρφωση του φορολογικού πελάτη έχει ολοκληρωθεί. Το Guid της φορολογικής ενότητας (=clientId) μεταδίδεται ως τιμή επιστροφής.

2. Διαμόρφωση μέσω λογισμικού POS

Ως εναλλακτική λύση της αυτόματης διαμόρφωσης πελάτη μέσω του RetailForce Cloud system, το αντικείμενο διαμόρφωσης μπορεί επίσης να προετοιμαστεί από το λογισμικό POS. Αυτός ο τύπος διαμόρφωσης χρησιμοποιείται για συστήματα που δεν διαθέτουν σύνδεση με το RetailForce Cloud. Για το σκοπό αυτό χρησιμοποιείται το endpoint PUT /api/v1/management/clients.

Κατά τη διαμόρφωση του λογισμικού ταμειακής μηχανής, υπάρχουν 2 τρόποι για τη σωστή εκκίνηση της ενότητας:

1. Ενότητα χωρίς σύνδεση με το Cloud με τοπική αποθήκευση και εξαγωγή δεδομένων
2. Ενότητα με σύνδεση στο Cloud με τοπική και αποθήκευση δεδομένων στο Cloud και εξαγωγή

Σε κάθε περίπτωση, είναι απαραίτητο οι απαιτούμενες παράμετροι διαμόρφωσης να έχουν οριστεί σωστά σύμφωνα με την τεκμηρίωση.

Η παραλλαγή 2 (με σύνδεση στο Cloud) μπορεί επίσης να ενεργοποιηθεί αργότερα, δηλαδή είναι δυνατό να δημιουργηθεί μια φορολογική διαμόρφωση χωρίς σύνδεση στο Cloud και στη συνέχεια να συγχρονιστεί με το Cloud.

Πρέπει να σημειωθεί ότι η δημιουργία ενός clients στο cloud πρέπει να ενεργοποιηθεί από τον κατασκευαστή του λογισμικού POS και/ή τον οργανισμό στις ρυθμίσεις του cloud. Ο συνήθης τρόπος είναι να δημιουργηθεί πρώτα ένα αντικείμενο διαμόρφωσης στο cloud.

3. Εγκατάσταση σύνδεσης με το Cloud

Το επόμενο βήμα είναι η σύνδεση του πελάτη με το RetailForce Cloud (για συστήματα εκτός σύνδεσης, χωρίς σύνδεση με το cloud, αυτό το βήμα μπορεί να παραλειφθεί). Αυτό γίνεται μέσω της συνάρτησης:

• POST /api/v1/management/cloud/connect .

Παράμετροι για την κλήση:

• clientId - το μοναδικό αναγνωριστικό πελάτη (Guid) που επιστράφηκε στο ταμείο κατά τη διαμόρφωση μέσω του RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Αρχικοποίηση πελάτη

Με την κλήση της συνάρτησης InitializeClient (POST /api/v1/management/clients/initialize), με την παράμετρο (start document), καλείται η ρουτίνα αρχικοποίησης της αντίστοιχης χώρας, ενώ σε αυτή τη διαδικασία αρχικοποιούνται επίσης τυχόν στοιχεία ασφαλείας (εάν απαιτείται).
Για θέματα που αφορούν συγκεκριμένες χώρες ή συγκεκριμένο υλικό, ανατρέξτε στη σχετική τεκμηρίωση.

Το αρχικό έγγραφο μπορεί να ζητηθεί από την υπηρεσία εκτελώντας τη συνάρτηση:

• GET /api/v1/transactions/document/{clientId}/start
  (parameter: clientId, optional: BookDate).

Εάν το FiscalClient χρησιμοποιείται χωρίς φορολογική καταγραφή (NoFiscalisation), για παράδειγμα εάν μεταδίδονται στον client μόνο ψηφιακές αποδείξεις ή δεδομένα αρχείου, η αρχικοποίηση δεν είναι απαραίτητη.

• Κλήση της συνάρτησης αρχικοποίησης (InitializeClient - POST /api/v1/management/clients/initialize)

Η αρχικοποίηση της φορολογικής μονάδας πραγματοποιείται στη συνέχεια μέσω της κλήσης InitializeClient.

Ένα NullReceipt μεταβιβάζεται στη συνάρτηση InitializeClient, ένα παράδειγμα μπορεί να βρεθεί παρακάτω:

{
    "modelVersion": "1.5.2",
    "uniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
    "additionalFields": {},
    "documentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
    "documentId": "1",
    "createDate": "2025-05-02T07:08:17.8334419+02:00",
    "bookDate": "2025-05-02T07:08:17.8335535+02:00",
    "documentNumber": "1",
    "documentType": 1000,
    "documentTypeCaption": "Startbeleg",
    "user": {
        "id": "1",
        "caption": "User 1",
        "firstName": "1",
        "lastName": "User",
        "dateOfEntry": "2025-05-02T07:08:17.833596+02:00"
    },
    "allocationGroups": [],
    "positionCount": 0,
    "fiscalDocumentNumber": 1,            
    "fiscalDocumentRevision": 1,          
    "positions": [],
    "Payments": [],
    "additionalHeader": [],
    "additionalFooter": [],
    "fiscalAdditionalFields": {}
}

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

Η θέση σε λειτουργία με μια ματιά

Για την ενεργοποίηση ενός πελάτη καλούνται οι ακόλουθες συναρτήσεις με την παρακάτω σειρά:

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

Αρχικοποίηση Γερμανία

Διαχείριση σφαλμάτων

Σφάλμα: Δεν βρέθηκε η GetConfiguration για τον πελάτη <CLIENTID>

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