JTL-Wawi
Ο ελεγκτής τιμών διαβάζει είδη και τιμές από το JTL-Wawi μέσω του επίσημου JTL-Wawi REST API (JTL-Wawi API). Εμφανίζει το όνομα του είδους και τη μικτή τιμή: την καθαρή τιμή πώλησης του είδους συν τον συντελεστή ΦΠΑ που υπολογίζει γι' αυτό το JTL-Wawi.
Σε αντίθεση με το Subiekt ή το Optima, ο ελεγκτής τιμών δεν συνδέεται με τη βάση δεδομένων SQL — επικοινωνεί με τον διακομιστή REST της εγκατάστασης JTL-Wawi και συνδέεται με ένα token που εκδίδει το JTL-Wawi.
Πριν ξεκινήσετε
- JTL-Wawi με JTL-Wawi API. Ο διακομιστής REST είναι μέρος του JTL-Wawi (συνιστάται έκδοση 1.10 ή νεότερη). Μια παρουσία API δημιουργείται στο JTL-Administrator ή με το
JTL.Wawi.Rest.exeκαι μπορεί να εκτελείται ως υπηρεσία Windows. Ανάλογα με τη σύμβασή σας με την JTL, η μονάδα JTL-Wawi API μπορεί να χρειάζεται κράτηση στο κέντρο πελατών της JTL — ελέγξτε τους ισχύοντες όρους με την JTL. - Ο διακομιστής API λειτουργεί και είναι προσβάσιμος από το δίκτυο του καταστήματος. Η προεπιλεγμένη θύρα είναι η 5883. Επιτρέψτε τις εισερχόμενες συνδέσεις σε αυτή τη θύρα στο τείχος προστασίας Windows του διακομιστή (το JTL-Administrator μπορεί να δημιουργήσει τον κανόνα για εσάς).
- Ο ελεγκτής τιμών βρίσκεται στο ίδιο δίκτυο με τον διακομιστή JTL-Wawi API (ή φτάνει σε αυτόν μέσω VPN).
- Ένας διαχειριστής μπορεί να συνδεθεί στο JTL-Wawi — ο ελεγκτής τιμών καταχωρίζεται ως εφαρμογή και η καταχώριση πρέπει να επιβεβαιωθεί στο JTL-Wawi.
Διεύθυνση του JTL-Wawi API
Η διεύθυνση αποτελείται από τη διεύθυνση IP του διακομιστή, τη θύρα του API και τη διαδρομή /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Χρησιμοποιήστε τη διεύθυνση IP του υπολογιστή όπου λειτουργεί το JTL-Wawi API, όχι το όνομά του.
- Χρησιμοποιήστε
http://ήhttps://όπως είναι ρυθμισμένη η παρουσία API. Με HTTPS το API έχει συνήθως αυτο-υπογεγραμμένο πιστοποιητικό — σε αυτή την περίπτωση καταργήστε την επιλογή Check SSL certificate (δείτε παρακάτω). - Το
eazybusinessείναι το όνομα της βάσης δεδομένων του JTL-Wawi. Αν η βάση δεδομένων της εταιρείας σας έχει άλλο όνομα, χρησιμοποιήστε αυτό το όνομα στη διαδρομή.
Μπορείτε να ελέγξετε τη διεύθυνση σε ένα πρόγραμμα περιήγησης σε υπολογιστή του ίδιου δικτύου: το https://<address>:5883/swagger πρέπει να ανοίξει τη σελίδα τεκμηρίωσης του API.
Ρύθμιση βήμα προς βήμα
- Ανοίξτε τις ρυθμίσεις, καρτέλα Source.
- Επιλέξτε JTL-Wawi από τη λίστα.
- Συμπληρώστε τα Address, App ID και App version (δείτε τον πίνακα παρακάτω).
- Πατήστε Generate token. Εμφανίζεται ένα παράθυρο: Confirm app registration in JTL-Wawi (Admin → App registration).
- Στο JTL-Wawi ανοίξτε Admin → App-Registrierung (διαθέσιμο στο νέο περιβάλλον του JTL-Wawi). Εκεί περιμένει το αίτημα από το HDWR Price Checker (πάροχος HDWR Global, δικαίωμα ανάγνωσης ειδών). Επιβεβαιώστε το.
- Ο ελεγκτής τιμών ελέγχει κάθε λίγα δευτερόλεπτα αν η καταχώριση έχει επιβεβαιωθεί. Μετά την επιβεβαίωση συμπληρώνει το πεδίο Token και εμφανίζει Token generated successfully.
- Ελέγξτε τα υπόλοιπα πεδία (εταιρεία, χώρες, διακόπτες αναζήτησης) και πατήστε Connection test.
- Αποθηκεύστε τις ρυθμίσεις και σαρώστε μερικά είδη.
| Πεδίο | Τι να εισαγάγετε | Παράδειγμα |
|---|---|---|
| Address | Η διεύθυνση του JTL-Wawi API, δείτε παραπάνω. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Οποιοδήποτε όνομα που αναγνωρίζει αυτόν τον ελεγκτή τιμών ως εφαρμογή στο JTL-Wawi. Απαιτείται πριν από τη δημιουργία του token. | hdwr-pricechecker |
| App version | Οποιαδήποτε ένδειξη έκδοσης, απαιτείται πριν από τη δημιουργία του token. | 1.0 |
| Token | Συμπληρώνεται με το Generate token. Μπορείτε επίσης να επικολλήσετε ένα κλειδί API που έχει εκδοθεί στο JTL-Wawi για το ίδιο App ID. | συμπληρώνεται αυτόματα |
| Check SSL certificate | Αφήστε το επιλεγμένο για αξιόπιστο πιστοποιητικό· καταργήστε την επιλογή για αυτο-υπογεγραμμένο πιστοποιητικό του API. | ✓ |
| Search by product code (SKU) | Αναζήτηση με τον αριθμό είδους της JTL (Artikelnummer). Ενεργό από προεπιλογή. | ✓ |
| Search by EAN code | Αναζήτηση με το GTIN/EAN του είδους. Ανενεργό από προεπιλογή. | ✓ |
| Company ID | Η εταιρεία (Firma) του JTL-Wawi της οποίας οι ρυθμίσεις ΦΠΑ χρησιμοποιούνται. Συνήθως 1. | 1 |
| Departure country (ISO) | Η χώρα από την οποία πωλούνται τα εμπορεύματα — κωδικός ISO δύο γραμμάτων. | DE |
| Shipment country (ISO) | Η χώρα του πελάτη — για ένα κατάστημα, η ίδια χώρα με το κατάστημα. | DE |
Το token εκδίδεται για το συγκεκριμένο App ID και App version. Αν αλλάξετε οποιοδήποτε από τα δύο, το JTL-Wawi απορρίπτει το token — θα δείτε JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Τότε δημιουργήστε ξανά το token και επιβεβαιώστε τη νέα καταχώριση.
Αν ένα token είναι ήδη συμπληρωμένο, το Generate token ρωτά πρώτα αν θα το αντικαταστήσει. Αν το τρέχον token λειτουργεί, δεν χρειάζεστε νέο.
Τιμή και αναζήτηση
- Η οθόνη εμφανίζει τη μικτή τιμή: την καθαρή τιμή πώλησης του είδους από το JTL-Wawi πολλαπλασιασμένη με τον συντελεστή ΦΠΑ και στρογγυλοποιημένη σε δύο δεκαδικά ψηφία.
- Τον συντελεστή ΦΠΑ τον υπολογίζει το JTL-Wawi για τη συγκεκριμένη εταιρεία, χώρα αποστολής και χώρα παράδοσης — έτσι ένα γερμανικό κατάστημα παίρνει π.χ. 19 % ή 7 %, ανάλογα με τη φορολογική κατηγορία του είδους. Τα είδη με φορολόγηση περιθωρίου (Differenzbesteuerung) έχουν συντελεστή 0 %, οπότε εμφανίζεται η καθαρή τιμή.
- Η τιμή είναι η τυπική τιμή πώλησης του είδους. Τιμές ομάδων πελατών, τιμοκατάλογοι και ειδικές τιμές δεν χρησιμοποιούνται.
- Το Search by product code (SKU) συγκρίνει τον σαρωμένο κωδικό με τον αριθμό είδους· κεφαλαία και πεζά δεν έχουν σημασία.
- Το Search by EAN code συγκρίνει τον σαρωμένο κωδικό ακριβώς με το GTIN του είδους.
- Αν και οι δύο διακόπτες είναι απενεργοποιημένοι, η εφαρμογή αναζητά με τον αριθμό είδους.
Χρόνος απόκρισης
Κάθε σάρωση είναι άμεσο ερώτημα στο JTL-Wawi, οπότε μια αλλαγή τιμής φαίνεται από την επόμενη σάρωση. Το JTL-Wawi API απαντά αισθητά πιο αργά από ένα ερώτημα στη βάση δεδομένων — συνήθως μερικά δευτερόλεπτα ανά σάρωση, επειδή το API επιστρέφει όλα τα είδη που ταιριάζουν με τον κωδικό και η εφαρμογή επιλέγει την ακριβή αντιστοιχία.
Για σύντομους κωδικούς που εμφανίζονται σε πολλά είδη (π.χ. ένας τριψήφιος αριθμός που αποτελεί και μέρος άλλων αριθμών και ονομάτων ειδών), η εφαρμογή σταματά την αναζήτηση μετά από περίπου 40 δευτερόλεπτα ή 500 αποτελέσματα και εμφανίζει Too many results - item not identified. Σαρώστε τον κωδικό EAN ή χρησιμοποιήστε μεγαλύτερους αριθμούς ειδών.
Μηνύματα ειδικά για το JTL-Wawi
| Μήνυμα | Αιτία και λύση |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Το token δεν αντιστοιχεί στο App ID ή στην έκδοση της εφαρμογής, ή η καταχώριση αφαιρέθηκε στο JTL-Wawi. Δημιουργήστε νέο token. |
| The JTL-Wawi server responded with error … | Η διεύθυνση οδηγεί σε διακομιστή, αλλά όχι στο JTL-Wawi API, π.χ. λείπει η διαδρομή /api/eazybusiness/ ή το όνομα της βάσης δεδομένων. |
| The server certificate is not trusted. … | Το API χρησιμοποιεί αυτο-υπογεγραμμένο πιστοποιητικό. Καταργήστε την επιλογή Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Λάθος διεύθυνση IP ή θύρα, η παρουσία API είναι σταματημένη ή το τείχος προστασίας μπλοκάρει τη θύρα 5883. |
| Tax download error | Το είδος βρέθηκε, αλλά το JTL-Wawi δεν επέστρεψε συντελεστή ΦΠΑ — ελέγξτε το ID εταιρείας και τους δύο κωδικούς χωρών. |
| Token generation failed (ή μήνυμα από το JTL-Wawi) | Η καταχώριση απορρίφθηκε ή το JTL-Wawi επέστρεψε σφάλμα. Ελέγξτε τη διεύθυνση και ότι χρησιμοποιείτε το νέο περιβάλλον του JTL-Wawi για το App-Registrierung. |
Τα γενικά μηνύματα περιγράφονται στην Αντιμετώπιση προβλημάτων.
Ενημέρωση από την προηγούμενη έκδοση της εφαρμογής για JTL-Wawi
Ορισμένοι πελάτες έλαβαν μια προηγούμενη έκδοση της εφαρμογής μόνο για JTL. Όταν εγκαθιστάτε την τρέχουσα έκδοση πάνω της, οι ρυθμίσεις JTL-Wawi (διεύθυνση, App ID, token, χώρες) μεταφέρονται αυτόματα και ο ελεγκτής τιμών συνεχίζει να λειτουργεί χωρίς νέα διαμόρφωση. Ο κωδικός EAN κάτω από την τιμή παραμένει κρυφός, όπως στην προηγούμενη έκδοση — μπορείτε να τον ενεργοποιήσετε στην καρτέλα General.