Γενικές πληροφορίες σχετικά με τη διαμόρφωση – RetailForce

Αυτό το άρθρο περιέχει γενικές πληροφορίες σχετικά με τον τρόπο δημιουργίας ενός αντικειμένου διαμόρφωσης για το RetailForce Fiscal Middleware στο cloud. Οι διαμορφώσεις κατεβάζονται και εφαρμόζονται από τους φορολογικούς πελάτες κατά την αρχικοποίηση, μέσω του ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Για περισσότερες πληροφορίες, ανατρέξτε στο άρθρο σχετικά με την αρχικοποίηση.

Στην RetailForce portal, η διαμόρφωση μπορεί να κληρονομηθεί προς τα κάτω εντός της οργανωτικής δομής. Αυτό σημαίνει ότι μια διαμόρφωση μπορεί να χρησιμοποιηθεί για διάφορα τερματικά ταυτόχρονα και δεν είναι απαραίτητο να δημιουργηθεί ξεχωριστά για κάθε τερματικό. Είναι επίσης δυνατό να αντικατασταθούν ορισμένες διαμορφώσεις στο κληρονομημένο αντικείμενο.

Παράδειγμα:

Στο παρακάτω παράδειγμα, το αντικείμενο διαμόρφωσης Α έχει αντιστοιχιστεί στον οργανισμό «XYZ Holding GmbH». Η διαμόρφωση κληρονομείται από όλες τις υποκείμενες μονάδες στην οργανωτική δομή. Στο ταμείο «099» (terminal) έχει αντιστοιχιστεί το αντικείμενο διαμόρφωσης Β, το οποίο, ως εκ τούτου, αντικαθιστά το κληρονομημένο αντικείμενο διαμόρφωσης Α.

Το αντικείμενο διαμόρφωσης είναι πάντα ανεξάρτητο από το αντικείμενο κύριων δεδομένων, όπως ο οργανισμός κ.λπ.

Είναι δυνατή η μεταφορά ενός αντικειμένου διαμόρφωσης σε οποιοδήποτε επίπεδο κληρονομικότητας. Ένα αντικείμενο διαμόρφωσης μπορεί να μεταφερθεί σε κάθε επίπεδο (οργανισμός, εταιρεία, καταστήματα και terminals).

Σημαντικό: Δεν είναι δυνατή η κοινή χρήση ενός αντικειμένου διαμόρφωσης μεταξύ διαφορετικών οργανισμών. Πρέπει να δημιουργηθεί ξεχωριστό αντικείμενο διαμόρφωσης για κάθε οργανισμό. Εξαίρεση: Κύριος Οργανισμός

Δομή κληρονομικότητας δεδομένων στο Cloud:

Οργανισμός
- Εταιρεία - προαιρετικό
  - Κατάστημα
    - Terminal

Παράδειγμα:

Ο οργανισμός σας αποτελείται από 13 καταστήματα στη Γερμανία και τώρα σχεδιάζει να ανοίξει ένα νέο υποκατάστημα στην Αυστρία. Το υλικό του συστήματος POS που χρησιμοποιείται είναι το ίδιο στη Γερμανία και στην Αυστρία.

Θα χρειαστείτε:

Μια εταιρεία με έδρα στη Γερμανία (fiscalCountry = Germany)
Μια επιπλέον προαιρετική εταιρεία με έδρα στην Αυστρία (fiscalCountry = Austria)
13 καταστήματα/υποκαταστήματα συνδεδεμένα με τον οργανισμό
1 υποκατάστημα που συνδέεται με τον οργανισμό ΚΑΙ με την εταιρεία στην Αυστρία

Πρέπει να ορίσετε 2 αντικείμενα διαμόρφωσης:

ένα αντικείμενο διαμόρφωσης με όλες τις διαμορφώσεις που απαιτούνται για τη Γερμανία
- μπορείτε να ορίσετε ολόκληρη τη διαμόρφωση υλικού στο αντικείμενο διαμόρφωσης για τη Γερμανία
ένα αντικείμενο διαμόρφωσης με όλες τις διαμορφώσεις που απαιτούνται για την Αυστρία
- δεν χρειάζεται να ορίσετε τη διαμόρφωση υλικού στη διαμόρφωση για την Αυστρία
- αντικαταστήστε το fiscalCountry και τη διαμόρφωση που αφορά συγκεκριμένα τη χώρα στη διαμόρφωση για την Αυστρία

Αντιστοίχιση διαμορφώσεων

Η ανάθεση ενός αντικειμένου διαμόρφωσης πραγματοποιείται στο RetailForce portal, μέσω των λεπτομερειών των αντίστοιχων οντοτήτων (αντικείμενα οργάνωσης: Οργάνωση, Εταιρεία, Κατάστημα, Terminal).

Για να το κάνετε αυτό, επιλέξτε τη σχετική διαμόρφωση στην περιοχή «Διαμόρφωση» μέσω του αναπτυσσόμενου μενού και κάντε κλικ στο «Αποθήκευση».

Σημείωση: Εάν δεν εμφανίζεται κανένα αντικείμενο διαμόρφωσης στην επιλογή, είτε δεν έχει δημιουργηθεί ακόμη καμία διαμόρφωση είτε η διαμόρφωση που έχει δημιουργηθεί δεν αντιστοιχεί στη φορολογική χώρα που έχει οριστεί για την οντότητα. Οι διαμορφώσεις μπορούν να αντιστοιχιστούν μόνο εάν η φορολογική χώρα της οντότητας (π.χ. της εταιρείας) αντιστοιχεί σε εκείνη της διαμόρφωσης.

Μέσω της επιλογής μενού «Νέα διαμόρφωση» μπορείτε να ορίσετε ότι μια νέα διαμόρφωση ισχύει από μια συγκεκριμένη ημερομηνία («Νέα ισχύει από»).

Ενημέρωση διαμόρφωσης

Προσοχή: Εάν ένα αντικείμενο διαμόρφωσης τροποποιηθεί στο Cloud, η αλλαγή αυτή ΔΕΝ διανέμεται αυτόματα στους σχετικούς clients (εντολές middleware)!

Οι διαμορφώσεις των επιμέρους πελατών πρέπει να μεταδοθούν μέσω:

PUT /api/v1/management/clients/byCloud/{clientId}

πρέπει να ενημερωθούν.

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

Σφάλμα: Άδεια χρήσης

Εάν λάβετε το ακόλουθο σφάλμα κατά την κλήση του τελικού σημείου GetConfiguration:

[error] (exception): License 'GetConfiguration' for client '<ClientID>' not found.

Λείπει η επιλογή άδειας χρήσης που επιτρέπει στον client να ανακτήσει δεδομένα διαμόρφωσης από το cloud. Ελέγξτε στο RetailForce Cloud Portal εάν η εκχωρημένη άδεια χρήσης περιέχει την επιλογή «Πρόσβαση στη λήψη διαμόρφωσης».