Εισαγωγή στο ITELINES JSON Template
Κατά τη διαδικασία συγχρονισμού μιας παραγγελίας από το OpenCart στο SoftOne, η γέφυρα δημιουργεί ένα JSON request (αίτημα) για κάθε γραμμή (προϊόν) της παραγγελίας. Αυτό το JSON αποστέλλεται στο SoftOne API για την καταχώρηση των λεπτομερειών του προϊόντος στην παραγγελία εντός του ERP. Η σωστή διαμόρφωση αυτού του JSON είναι κρίσιμη για την αποφυγή λαθών και τη διασφάλιση της συνέπειας των δεδομένων μεταξύ των συστημάτων.
Η γέφυρα σας επιτρέπει να προσαρμόσετε τη δομή αυτού του JSON request μέσω ενός template, χρησιμοποιώντας ειδικές μεταβλητές (placeholders) που αντικαθίστανται δυναμικά με τις πραγματικές τιμές της παραγγελίας.
Το Προεπιλεγμένο (Default) Template
Το προεπιλεγμένο JSON template που παρέχεται με τη γέφυρα είναι σχεδιασμένο για να καλύπτει τις πιο συνηθισμένες ανάγκες:
{
"LINENUM": "%LINENUM=0%",
"MTRL": "%MTRL%",
"qty1": "%QTY%",
"price": "%PRICE%",
"vat": "%VAT%",
"value": "%VALUE%"
}Αυτό το template περιλαμβάνει βασικές πληροφορίες όπως ο κωδικός υλικού, η ποσότητα, η τιμή, ο ΦΠΑ και η αξία γραμμής.
Τι είναι τα Placeholders;
Τα placeholders (π.χ. %MTRL%, %QTY%) είναι ειδικές ετικέτες που περικλείονται σε σύμβολα ποσοστού (%). Η γέφυρα τα αναγνωρίζει και τα αντικαθιστά με τις αντίστοιχες τιμές από τα δεδομένα της παραγγελίας του OpenCart πριν στείλει το αίτημα στο SoftOne.
Για παράδειγμα, για ένα προϊόν με ποσότητα 3 και τιμή 50€, το %QTY% θα αντικατασταθεί με 3 και το %PRICE% με 50.
Διαθέσιμα Placeholders
Ο παρακάτω πίνακας περιγράφει αναλυτικά όλα τα διαθέσιμα placeholders που μπορείτε να χρησιμοποιήσετε στο ITELINES JSON template:
| Placeholder | Περιγραφή | Παράδειγμα Τιμής |
|---|---|---|
| %LINENUM% | Αριθμός γραμμής προϊόντος (αυτόματη αρίθμηση από 1). | 1, 2, 3... |
| %LINENUM=(\d+)% | Επιστρέφει τον αριθμό γραμμής, ξεκινώντας από τον αριθμό που ορίζεται μετά το =. Π.χ., %LINENUM=10% θα ξεκινήσει την αρίθμηση από το 10 (10, 11, 12...). Η προεπιλογή %LINENUM=0% χρησιμοποιείται συχνά όταν το SoftOne αναμένει η αρίθμηση να γίνεται αυτόματα από το ίδιο. | 10, 11, 12... (για %LINENUM=10%) |
| %MTRL% | Επιστρέφει τον κωδικό υλικού (MTRL) του προϊόντος, όπως έχει οριστεί στο αντίστοιχο πεδίο του προϊόντος στο OpenCart. | "SKU12345" |
| %QTY% | Επιστρέφει την ποσότητα του προϊόντος στη συγκεκριμένη γραμμή της παραγγελίας. | 2 |
| %MODEL% | Επιστρέφει το πεδίο "Μοντέλο" (Model) του προϊόντος από το OpenCart. | "OC-MODEL-01" |
| %OPTIONMODEL% | Επιστρέφει το πεδίο "Μοντέλο" (Model) της συγκεκριμένης επιλογής (option) του προϊόντος, αν υπάρχει και έχει οριστεί. Διαφορετικά, επιστρέφει το βασικό μοντέλο του προϊόντος. | "OC-MODEL-01-RED" |
| %PRODUCTTAX% | Επιστρέφει το συνολικό ποσό φόρου για τη συγκεκριμένη γραμμή προϊόντος (ποσότητα * φόρος ανά μονάδα). | 4.80 (αν τιμή=10, ποσότητα=2, ΦΠΑ=24%) |
| %REWARD% | Επιστρέφει τους πόντους ανταμοιβής (reward points) που δίνει το προϊόν. | 10 |
| %NAME% | Επιστρέφει το όνομα του προϊόντος. | "Φορητός Υπολογιστής XPS 15" |
| %PRODUCTID% | Επιστρέφει το μοναδικό ID του προϊόντος στο OpenCart. | 42 |
| %ORDERPRODUCTID% | Επιστρέφει το μοναδικό ID της συγκεκριμένης γραμμής προϊόντος μέσα στην παραγγελία του OpenCart (πίνακας `order_product`). | 512 |
| %ORDERID% | Επιστρέφει το μοναδικό ID της παραγγελίας στο OpenCart. | 1050 |
| %PRICE% | Επιστρέφει την τιμή μονάδας του προϊόντος (χωρίς ΦΠΑ). | 99.99 |
| %VAT% | Επιστρέφει το ποσοστό ΦΠΑ που εφαρμόζεται στο προϊόν (π.χ., 24 για 24%). | 24 |
| %VALUE% | Επιστρέφει τη συνολική αξία της γραμμής προϊόντος (ποσότητα * τιμή μονάδας, χωρίς ΦΠΑ). | 199.98 (για ποσότητα 2 και τιμή 99.99) |
Παραδείγματα Χρήσης
Απλή Χρήση
Μπορείτε να χρησιμοποιήσετε τα placeholders απευθείας στα κλειδιά που αναμένει το SoftOne:
{
"ITEM_CODE": "%MTRL%",
"QUANTITY": "%QTY%",
"UNIT_PRICE": "%PRICE%",
"VAT_CODE": "%VAT%",
"LINE_VALUE": "%VALUE%",
"LINE_COMMENTS": "Product Name: %NAME%"
}Προσθήκη Προσαρμοσμένων Πεδίων
Μπορείτε να προσθέσετε δικά σας κλειδιά με σταθερές ή δυναμικές τιμές:
{
"LINENUM": "%LINENUM=1%",
"MTRL": "%MTRL%",
"qty1": "%QTY%",
"price": "%PRICE%",
"vat": "%VAT%",
"value": "%VALUE%",
"COMMENTS": "From OpenCart Order ID: %ORDERID%",
"WAREHOUSE_CODE": "001",
"CUSTOM_FLAG": true
}Στο παραπάνω παράδειγμα, προσθέσαμε ένα πεδίο COMMENTS που περιλαμβάνει το ID της παραγγελίας από το OpenCart, ένα σταθερό κωδικό αποθήκης WAREHOUSE_CODE, και μια boolean τιμή CUSTOM_FLAG.
Συμβουλές
- Συνεργαστείτε με τον Σύμβουλο SoftOne: Είναι καλή πρακτική να συνεργαστείτε με τον τεχνικό σύμβουλο ή τον υπεύθυνο της εγκατάστασης SoftOne για να καθορίσετε ακριβώς ποια πεδία και με ποια ονόματα κλειδιών απαιτούνται στο JSON request για τις γραμμές παραγγελιών (ITELINES).
- Δοκιμή: Αφού κάνετε αλλαγές στο template, πραγματοποιήστε δοκιμαστικές παραγγελίες και ελέγξτε στο SoftOne ότι τα δεδομένα καταχωρούνται σωστά στα αναμενόμενα πεδία.
- Εφεδρικό Αντίγραφο: Πριν κάνετε σημαντικές αλλαγές, κρατήστε ένα αντίγραφο του προηγούμενου JSON template σας.
Σχετικοί οδηγοί
- EXPANAL JSON για έξοδα παραγγελίας
Πώς να στείλετε αναλυτικά έξοδα, μεταφορικά ή άλλες γραμμές που συνοδεύουν την παραγγελία.
- SET Data JSON για πελάτες OpenCart προς SoftOne
Πώς δημιουργείται ή ενημερώνεται ο πελάτης πριν αποσταλεί η παραγγελία.
- Βήματα διασύνδεσης SoftOne με OpenCart
Οι βασικές προϋποθέσεις για να λειτουργήσει σωστά η αποστολή παραγγελιών.
Χρειάζεστε Περισσότερη Βοήθεια;
Αν αντιμετωπίζετε δυσκολίες ή έχετε εξειδικευμένες ανάγκες για την παραμετροποίηση του ITELINES JSON, η ομάδα υποστήριξης της OpenCart Greece είναι στη διάθεσή σας.
Επικοινωνήστε μαζί μας