Σε αυτό το βήμα πρέπει να εισάγετε το JSON Request (αίτημα) προς την SoftOne, σε μορφή template.
Το default που έχουμε είναι το:
{
"LINENUM": "%LINENUM=0%",
"MTRL": "%MTRL%",
"qty1": "%QTY%",
"price": "%PRICE%",
"vat": "%VAT%",
"value": "%VALUE%"
} Τι είναι τα Placeholders;
Τα placeholders (π.χ. %LINENUM%, %MTRL%, %QTY%, κ.λπ.) είναι ειδικές ετικέτες που αντιστοιχούν σε συγκεκριμένες τιμές που παράγονται αυτόματα από το σύστημα. Για παράδειγμα, το %QTY% θα αντικατασταθεί με την ποσότητα του προϊόντος, ενώ το %PRICE% θα αντικατασταθεί με την τιμή του προϊόντος.
Επιλογές για τον Χρήστη
Μπορείτε να τροποποιήσετε αυτό το JSON όπως επιθυμείτε, αρκεί να παραμένει ένα έγκυρο JSON. Για παράδειγμα, μπορείτε να προσθέσετε νέα κλειδιά, να αφαιρέσετε υπάρχοντα, ή να αλλάξετε τις τιμές των placeholders. Το μόνο που χρειάζεται είναι να διατηρήσετε τη σωστή σύνταξη του JSON.
Εξήγηση των Placeholder Values που υπάρχουν διαθέσιμα
Ο παρακάτω πίνακας εξηγεί τις διαθέσιμες επιλογές για τα placeholders, με βάση τον PHP κώδικα που παρέχεται:
| Placeholder | Περιγραφή | Παράδειγμα Τιμής |
|---|---|---|
%LINENUM% | Επιστρέφει τον αριθμό γραμμής του προϊόντος. | Αυτόματη τιμή |
%LINENUM=(\d+)% | Επιστρέφει τον αριθμό γραμμής του προϊόντος, ξεκινώντας από έναν συγκεκριμένο αριθμό. | Αν %LINENUM=10% θα ξεκινήσει να μετράει από το 10. |
%MTRL% | Επιστρέφει τον κωδικό υλικού (MTRL) του προϊόντος. | Αν το προϊόν έχει κωδικό υλικού “ABC123”, τότε %MTRL% = "ABC123". |
%QTY% | Επιστρέφει την ποσότητα του προϊόντος. | Αν $product['quantity'] = 2, τότε %QTY% = 2. |
%MODEL% | Επιστρέφει το μοντέλο του προϊόντος. | Αν $product['model'] = "X100", τότε %MODEL% = "X100". |
%OPTIONMODEL% | Επιστρέφει το μοντέλο επιλογής του προϊόντος (αν υπάρχει). | Αν $product['optionModel'] = "X100-RED", τότε %OPTIONMODEL% = "X100-RED". |
%PRODUCTTAX% | Επιστρέφει τον φόρο του προϊόντος. | Αν $product['tax'] = 24, τότε %PRODUCTTAX% = 24. |
%REWARD% | Επιστρέφει τα reward points του προϊόντος. | Αν $product['reward'] = 10, τότε %REWARD% = 10. |
%NAME% | Επιστρέφει το όνομα του προϊόντος. | Αν $product['name'] = "Smartphone X", τότε %NAME% = "Smartphone X". |
%PRODUCTID% | Επιστρέφει το ID του προϊόντος. | Αν $product['product_id'] = 123, τότε %PRODUCTID% = 123. |
%ORDERPRODUCTID% | Επιστρέφει το ID του προϊόντος στην παραγγελία. | Αν $product['order_product_id'] = 456, τότε %ORDERPRODUCTID% = 456. |
%ORDERID% | Επιστρέφει το ID της παραγγελίας. | Αν $product['order_id'] = 789, τότε %ORDERID% = 789. |
%PRICE% | Επιστρέφει την τιμή του προϊόντος. | Αν $product_price = 99.99, τότε %PRICE% = 99.99. |
%VAT% | Επιστρέφει το ποσοστό ΦΠΑ του προϊόντος. | Αν $vat = 24, τότε %VAT% = 24. |
%VALUE% | Επιστρέφει την συνολική αξία του προϊόντος (ποσότητα * τιμή). | Αν $product['quantity'] = 2 και $unformatted_product_price = 50, τότε %VALUE% = 100.00. |
Πώς να χρησιμοποιήσετε τα Placeholders
- Απλή Χρήση: Μπορείτε να χρησιμοποιήσετε τα placeholders όπως είναι. Για παράδειγμα:
{ "product_name": "%NAME%", "quantity": "%QTY%" } - Προσαρμογή: Μπορείτε να προσθέσετε δικά σας κλειδιά ή να αλλάξετε τις τιμές των placeholders. Για παράδειγμα:
{ "custom_field": "This is a custom value", "product_price": "%PRICE%" } - Δυναμική Αλλαγή: Μπορείτε να χρησιμοποιήσετε δυναμικές τιμές, όπως το
%LINENUM=(\d+)%, για να δημιουργήσετε αριθμούς γραμμών που ξεκινούν από έναν συγκεκριμένο αριθμό.
Σημαντικές Σημειώσεις
- Έγκυρο JSON: Οποιαδήποτε αλλαγή κάνετε, πρέπει να διασφαλίζετε ότι το JSON παραμένει έγκυρο. Για παράδειγμα, όλες οι τιμές πρέπει να περικλείονται σε διπλά εισαγωγικά (
"). - Placeholders: Αν αλλάξετε τα placeholders, φροντίστε να τα αντιστοιχίσετε σωστά με τις τιμές που παρέχει το σύστημα.