Εισαγωγή στο SET Data JSON Template
Κατά τη δημιουργία ή ενημέρωση πελάτη από το OpenCart στο SoftOne, η γέφυρα δημιουργεί ένα JSON request (SET Data) με όλα τα απαραίτητα στοιχεία του πελάτη. Το JSON αυτό αποστέλλεται στο SoftOne API για την καταχώρηση ή ενημέρωση του πελάτη στο ERP. Η σωστή διαμόρφωση του JSON διασφαλίζει την ορθή αντιστοίχιση και ενημέρωση των στοιχείων πελατών.
Η γέφυρα σας επιτρέπει να προσαρμόσετε το JSON template χρησιμοποιώντας placeholders που αντικαθίστανται δυναμικά με τα πραγματικά δεδομένα πελάτη από το OpenCart.
Το Προεπιλεγμένο (Default) Template
Το προεπιλεγμένο JSON template για πελάτες είναι το παρακάτω:
{
"service": "setData",
"clientID": "%clientid%",
"appId": "%appid%",
"OBJECT": "CUSTOMER",
"KEY": "",
"data": {
"CUSTOMER": {
"CODE": "*",
"NAME": "%NAME%",
"ADDRESS": "%ADDRESS%",
"COUNTRY": "%COUNTRY%",
"ZIP": "%ZIP%",
"PHONE01": "%TELEPHONE%",
"FAX": "",
"EMAIL": "%EMAIL%",
"BUSUNITS": "101",
"SALESMAN": "279",
"TRDCATEGORY": "3099",
"AFM": "000000000"
}
}
}Το παραπάνω template περιλαμβάνει όλα τα βασικά στοιχεία πελάτη που απαιτούνται για την καταχώρηση στο SoftOne.
Ο διαχειριστής του OpenCart μπορεί να αλλάξει το JSON template απευθείας από το διαχειριστικό περιβάλλον:
OpenCart Admin → CSL SoftOne → Ρυθμίσεις → Προχωρημένες Επιλογές → Tab Πελάτες και μετά επεξεργασία στο Βήμα 3 | Customers - setData.
Ενεργοποιώντας την επιλογή και αποθηκεύοντας, οι αλλαγές εφαρμόζονται άμεσα (live).
Τι είναι τα Placeholders;
Τα placeholders (π.χ. %NAME%, %ADDRESS%) είναι ειδικές ετικέτες που περικλείονται σε σύμβολα ποσοστού (%). Η γέφυρα τα αντικαθιστά με τις πραγματικές τιμές του πελάτη από το OpenCart πριν σταλεί το αίτημα στο SoftOne.
Για παράδειγμα, αν το όνομα πελάτη είναι "Γιάννης Παπαδόπουλος", το %NAME% θα αντικατασταθεί με Γιάννης Παπαδόπουλος.
Διαθέσιμα Placeholders
Ο παρακάτω πίνακας περιγράφει τα βασικά placeholders που μπορείτε να χρησιμοποιήσετε στο SET Data JSON template για πελάτες:
| Placeholder | Περιγραφή | Παράδειγμα Τιμής |
|---|---|---|
| %clientid% | Το Client ID που έχει δοθεί από το SoftOne. | "9J8pJIKtHNHZ.....FM4LcL4D1" |
| %appid% | Το App ID που έχει δοθεί από το SoftOne. | "1234" |
| %NAME% | Το πλήρες όνομα του πελάτη. | "Γιάννης Παπαδόπουλος" |
| %ADDRESS% | Η διεύθυνση του πελάτη. | "Ερμού 10, Αθήνα" |
| %COUNTRY% | Η χώρα του πελάτη. | 1000 εάν η χώρα υπάρχει στη βάση της SoftOne με το ίδιο όνομα, ή αλλιώς το όνομα της χώρας εάν δεν υπάρχει πχ "Ελλάδα" |
| %ZIP% | Ο ταχυδρομικός κώδικας. | "10563" |
| %TELEPHONE% | Το τηλέφωνο του πελάτη. | "2101234567" |
| %EMAIL% | Το email του πελάτη. | "[email protected]" |
Παραδείγματα Χρήσης
Απλή Χρήση
Χρησιμοποιήστε τα placeholders απευθείας στα πεδία που απαιτεί το SoftOne:
{
"service": "setData",
"clientID": "%clientid%",
"appId": "%appid%",
"OBJECT": "CUSTOMER",
"KEY": "",
"data": {
"CUSTOMER": {
"CODE": "*",
"NAME": "%NAME%",
"ADDRESS": "%ADDRESS%",
"COUNTRY": "%COUNTRY%",
"ZIP": "%ZIP%",
"PHONE01": "%TELEPHONE%",
"EMAIL": "%EMAIL%"
}
}
}Προσθήκη Προσαρμοσμένων Πεδίων
Μπορείτε να προσθέσετε δικά σας κλειδιά ή σταθερές τιμές, ανάλογα με τις ανάγκες σας:
{
"service": "setData",
"clientID": "%clientid%",
"appId": "%appid%",
"OBJECT": "CUSTOMER",
"KEY": "",
"data": {
"CUSTOMER": {
"CODE": "*",
"NAME": "%NAME%",
"ADDRESS": "%ADDRESS%",
"COUNTRY": "%COUNTRY%",
"ZIP": "%ZIP%",
"PHONE01": "%TELEPHONE%",
"EMAIL": "%EMAIL%",
"SALESMAN": "279",
"TRDCATEGORY": "3099"
}
}
}Στο παραπάνω παράδειγμα, προστέθηκαν τα πεδία SALESMAN και TRDCATEGORY με σταθερές τιμές.
Συμβουλές
- Συνεργαστείτε με τον Σύμβουλο SoftOne: Συζητήστε με τον τεχνικό σύμβουλο SoftOne για να καθορίσετε τα απαραίτητα πεδία και τις τιμές τους.
- Δοκιμή: Πραγματοποιήστε δοκιμαστικές εγγραφές πελατών και ελέγξτε στο SoftOne ότι τα δεδομένα καταχωρούνται σωστά.
- Εφεδρικό Αντίγραφο: Κρατήστε backup του template πριν από σημαντικές αλλαγές.
Σχετικοί οδηγοί
- Συγχρονισμός πελατών από SoftOne σε OpenCart
Η αντίστροφη ροή όταν τα κεντρικά στοιχεία πελατών διατηρούνται στο SoftOne ERP.
- Βασικά βήματα διασύνδεσης SoftOne με OpenCart
Τι χρειάζεται πριν στείλετε πελάτες από το OpenCart στο SoftOne.
- Παραγγελίες OpenCart προς SoftOne με ITELINES JSON
Πώς συνεχίζεται η ροή μετά τη δημιουργία πελάτη στο SoftOne.
Χρειάζεστε Περισσότερη Βοήθεια;
Αν χρειάζεστε βοήθεια ή έχετε εξειδικευμένες ανάγκες για το SET Data JSON, η ομάδα υποστήριξης της OpenCart Greece είναι στη διάθεσή σας.
Επικοινωνήστε μαζί μας