Εισαγωγή στον Συγχρονισμό Πελατών
Ο συγχρονισμός πελατών από το SoftOne ERP στο OpenCart σας επιτρέπει να διατηρείτε τα δεδομένα πελατών σας ενημερωμένα και συνεπή και στις δύο πλατφόρμες. Αυτή η διαδικασία είναι ιδανική για επιχειρήσεις που διαχειρίζονται τα κεντρικά δεδομένα πελατών τους στο SoftOne και θέλουν να τα αντικατοπτρίζουν αυτόματα στο e-shop τους.
Η γέφυρα SoftOne - OpenCart προσφέρει μια ευέλικτη λύση δύο βημάτων που επιτρέπει τον συγχρονισμό δεδομένων πελατών μέσω ειδικών JSON requests (Browser Info και Browser Data), με δυνατότητα προσαρμογής και αντιστοίχισης πεδίων σύμφωνα με τις ανάγκες σας.
Σημαντική Σημείωση: Ρυθμίσεις Συγχρονισμού Πελατών
Για να λειτουργήσει ο συγχρονισμός των πελατών, πρέπει πρώτα να ενεργοποιήσετε τις αντίστοιχες ρυθμίσεις στο διαχειριστικό περιβάλλον του OpenCart:
- Πλοηγηθείτε στο Ρυθμίσεις Πελατών → Συγχρονισμός Πελατών από SoftOne → OpenCart
- Ενεργοποιήστε τις επιλογές που χρειάζεστε:
- Εισαγωγή Νέων Πελατών
- Ενημέρωση Υπάρχοντων Πελατών
- Επιλέξτε το Πεδίο Συγχρονισμού Πελάτη που θέλετε να χρησιμοποιήσετε για τον συγχρονισμό
Χωρίς αυτές τις ρυθμίσεις, η προσαρμογή του JSON template από μόνο της δεν θα πραγματοποιήσει συγχρονισμό δεδομένων.
Σημαντικές Σημειώσεις για τον Συγχρονισμό:
Το Πεδίο Συγχρονισμού Πελάτη που επιλέγετε πρέπει:
- Να υπάρχει σε όλους τους πελάτες που επιστρέφονται από το SoftOne
- Να έχει τιμή (δηλαδή να μην είναι κενό) για κάθε πελάτη
- Αν το πεδίο λείπει ή είναι κενό, η εγγραφή του πελάτη θα παρακαμφθεί από τον συγχρονισμό
Επιπλέον, οι εγγραφές πελατών θα παρακαμφθούν επίσης αν:
- Λείπουν απαιτούμενα δεδομένα πελάτη από το OpenCart (π.χ. email)
- Τα δεδομένα είναι μη έγκυρα ή ακατάλληλα για τη δημιουργία/ενημέρωση
Browser Info JSON Template
Το Browser Info template χρησιμοποιείται για τη λήψη πληροφοριών για τα πεδία και τη δομή των δεδομένων πελατών που διαθέτει το SoftOne.
Το προεπιλεγμένο JSON template για το Browser Info είναι:
{
"service": "getBrowserInfo",
"clientID": "%clientid%",
"appId": "%appid%",
"object": "Customer",
"list": "",
"filters": ""
} Επεξήγηση Παραμέτρων:
| Παράμετρος | Περιγραφή | Τιμή |
|---|---|---|
| service | Ο τύπος υπηρεσίας SoftOne | "getBrowserInfo" |
| clientID | Το Client ID από το SoftOne | "%clientid%" |
| appId | Το App ID από το SoftOne | "%appid%" |
| object | Το αντικείμενο SoftOne | "Customer" |
| list | Λίστα πεδίων | "" |
| filters | Φίλτρα δεδομένων | "" |
Browser Data JSON Template
Το Browser Data template χρησιμοποιείται για την πραγματική λήψη των δεδομένων πελατών από το SoftOne μετά τη διαμόρφωση των πεδίων.
Το JSON template για το Browser Data είναι:
{
"service": "getBrowserData",
"clientID": "%clientid%",
"appId": "%appid%",
"reqID": "%reqid%"
} Επεξήγηση Παραμέτρων:
| Παράμετρος | Περιγραφή | Τιμή |
|---|---|---|
| service | Ο τύπος υπηρεσίας SoftOne | "getBrowserData" |
| clientID | Το Client ID από το SoftOne | "%clientid%" |
| appId | Το App ID από το SoftOne | "%appid%" |
| reqID | Δυναμικό Request ID | "%reqid%" |
Ρύθμιση και Διαμόρφωση
- Ενεργοποίηση Βημάτων: Στο διαχειριστικό περιβάλλον του OpenCart, πλοηγηθείτε στο CSL SoftOne → Ρυθμίσεις → Προχωρημένες Επιλογές και ενεργοποιήστε τόσο το Βήμα 1 όσο και το Βήμα 2 για τον συγχρονισμό πελατών.
- Επαλήθευση Templates: Βεβαιωθείτε ότι τα JSON templates για Browser Info και Browser Data είναι σωστά διαμορφωμένα και έγκυρα.
- Test Connection: Εκτελέστε μια δοκιμαστική σύνδεση για να επιβεβαιώσετε ότι η επικοινωνία με το SoftOne API λειτουργεί σωστά.
Μόλις ενεργοποιηθεί το Βήμα 1, χρησιμοποιήστε το Browser Info template για να λάβετε τις διαθέσιμες δομές δεδομένων πελατών από το SoftOne.
Αντιστοίχιση Πεδίων (Field Mapping)
Η αντιστοίχιση πεδίων είναι ένα κρίσιμο βήμα που διασφαλίζει την σωστή μεταφορά δεδομένων μεταξύ SoftOne και OpenCart:
- Connect Customer Fields: Χρησιμοποιήστε το κουμπί "Connect Customer Fields" για να ανοίξετε το interface αντιστοίχισης πεδίων.
- Map SoftOne to OpenCart: Αντιστοιχίστε τα πεδία του SoftOne στα αντίστοιχα πεδία του OpenCart.
- Common Mappings:
- SoftOne NAME → OpenCart First Name + Last Name
- SoftOne EMAIL → OpenCart Email
- SoftOne PHONE01 → OpenCart Telephone
- SoftOne ADDRESS → OpenCart Address
- SoftOne ZIP → OpenCart Post Code
- Save Mapping: Αποθηκεύστε τη διαμόρφωση αντιστοίχισης πεδίων.
Εκτέλεση Συγχρονισμού
Χειροκίνητος Συγχρονισμός
Για άμεσο συγχρονισμό:
- Εκτελέστε το Cron Job για τον συγχρονισμό πελατών από το διαχειριστικό περιβάλλον
- Παρακολουθήστε τα logs για πιθανά σφάλματα ή προειδοποιήσεις
- Επαληθεύστε τα αποτελέσματα στο OpenCart
Αυτόματος Συγχρονισμός
Για συνεχή συγχρονισμό, μπορείτε να ρυθμίσετε ένα CLI Cron Job για αυτοματοποιημένη εκτέλεση:
CLI Cron Job Εντολή
Χρησιμοποιήστε την παρακάτω εντολή για τον αυτόματο συγχρονισμό πελατών:
0 3 * * * /usr/bin/php /path_to_opencart_install/csl_softone_cron.php syncCustomers store=(store_id) Χρονικός Προγραμματισμός
Το παραπάνω παράδειγμα εκτελείται στις 3:00 π.μ. κάθε μέρα
Store ID Παράμετρος
Χρησιμοποιήστε store=0 για το default store, ή αντικαταστήστε το με το συγκεκριμένο store ID
Συνιστώμενη Συχνότητα
Προτείνουμε εκτέλεση μία φορά την ημέρα αλλά εσείς μπορείτε να το τρέχετε κάθε όποτε επιθυμείτε.
Σημαντικές Σημειώσεις:
- Βεβαιωθείτε ότι η διαδρομή
/path_to_opencart_install/είναι σωστή για την εγκατάστασή σας - Ο χρήστης που εκτελεί το cron job πρέπει να έχει τα απαραίτητα δικαιώματα πρόσβασης στα αρχεία
- Ελέγξτε τα logs του OpenCart για την παρακολούθηση των αποτελεσμάτων του συγχρονισμού
Συμβουλές & Βέλτιστες Πρακτικές
- JSON Validation: Πάντα να επικυρώνετε τα JSON templates χρησιμοποιώντας εργαλεία όπως το
jsonlint.com. - Δεν Χρησιμοποιείτε Hardcoded Values: Αποφύγετε τη χρήση σταθερών τιμών για παραμέτρους όπως
objectήlistαν πρόκειται να αλλάξουν. - Testing: Εκτελέστε δοκιμές με μικρό αριθμό πελατών πριν από τον πλήρη συγχρονισμό.
- Backup: Κάντε backup των δεδομένων πελατών του OpenCart πριν από τον πρώτο συγχρονισμό.
- Consult SoftOne Technician: Για προσαρμοσμένες απαιτήσεις, συμβουλευτείτε τον τεχνικό σύμβουλο SoftOne.
- Regular Monitoring: Ελέγχετε τακτικά τα αποτελέσματα του συγχρονισμού και διορθώστε τυχόν αναντιστοιχίες.
Σχετικοί οδηγοί
- Πελάτες OpenCart σε SoftOne με SET Data JSON
Η αντίστροφη ροή για δημιουργία ή ενημέρωση πελατών στο SoftOne ERP.
- Custom κλήσεις SoftOne API
Πώς λειτουργούν οι προσαρμοσμένες κλήσεις API και το field mapping.
- Βήματα διασύνδεσης SoftOne με OpenCart
Τα Cloud Services και API credentials που πρέπει να υπάρχουν πρώτα.
Υποστήριξη
Αν χρειάζεστε βοήθεια με τον συγχρονισμό πελατών από το SoftOne στο OpenCart, η ομάδα υποστήριξης της OpenCart Greece είναι στη διάθεσή σας.
Επικοινωνήστε μαζί μας