Default JSON
Το προεπιλεγμένο JSON template για τα αναλυτικά δεδομένα εξόδων παραγγελιών είναι:
{
"LINENUM": "%LINENUM=0%",
"EXPN": "%EXPN%",
"EXPVAL": "%value%"
} Αυτό το template περιλαμβάνει βασικές πληροφορίες για την ανάλυση εξόδων όπως τον αριθμό γραμμής, τον κωδικό εξόδων/ανάλυσης και τη συνολική αξία.
Τι είναι τα Placeholders;
Οι placeholders (π.χ. %EXPN%, %value%) είναι ειδικές ετικέτες που περικλείονται σε σύμβολα ποσοστού (%). Η γέφυρα τα αναγνωρίζει και τα αντικαθιστά με τις αντίστοιχες τιμές από τα δεδομένα της παραγγελίας του OpenCart πριν στείλει το αίτημα στο SoftOne.
Για παράδειγμα, για μια γραμμή εξόδων με αξία 25€, το %value% θα αντικατασταθεί με 25 και το %EXPN% με τον αντίστοιχο κωδικό ανάλυσης εξόδων.
Επιλογές για τον Χρήστη
Ο χρήστης μπορεί να τροποποιήσει το JSON template σύμφωνα με τις ανάγκες του, προσθέτοντας ή αλλάζοντας πεδία όπως απαιτείται για την ειδική υλοποίηση στο SoftOne ERP.
Εξήγηση των Placeholder Values με βάση τον PHP Κώδικα
Ο παρακάτω πίνακας περιγράφει αναλυτικά όλα τα διαθέσιμα placeholders που μπορείτε να χρησιμοποιήσετε στο EXPANAL JSON template:
| Placeholder | Περιγραφή | Παράδειγμα Τιμής |
|---|---|---|
| %LINENUM% | Επιστρέφει τον αριθμό γραμμής. | 1, 2, 3... |
| %LINENUM=(\d+)% | Επιστρέφει τον αριθμό γραμμής, ξεκινώντας από έναν συγκεκριμένο αριθμό. Π.χ., %LINENUM=10% θα ξεκινήσει την αρίθμηση από το 10 (10, 11, 12...). | 10, 11, 12... (για %LINENUM=10%) |
| %EXPN% | Επιστρέφει την τιμή του EXPN. | "SHIPPING" |
| %value% | Επιστρέφει την συνολική αξία. | 150.50 |
Παραδείγματα Χρήσης
Απλή Χρήση
Μπορείτε να χρησιμοποιήσετε τα placeholders απευθείας στα κλειδιά που αναμένει το SoftOne:
{
"line_number": "%LINENUM%",
"expense_code": "%EXPN%"
} Προσθήκη Προσαρμοσμένων Πεδίων
Μπορείτε να προσθέσετε δικά σας κλειδιά με σταθερές ή δυναμικές τιμές:
{
"custom_field": "This is a custom value",
"expense_value": "%value%"
} Παραδείγματα τιμών
- Αν
$totalLine = 3και%LINENUM=10%, τότε η τιμή θα είναι13(10 + 3). - Αν
$expanValue = "EXP123", τότε%EXPN%="EXP123". - Αν
$totalValue = 150.50, τότε%value%=150.50.
Σημαντικές Σημειώσεις
- Εγκυρότητα JSON: Οποιαδήποτε αλλαγή κάνετε, πρέπει να διασφαλίζετε ότι το JSON παραμένει έγκυρο.
- Αντιστοίχιση Placeholders: Αν αλλάξετε τα placeholders, φροντίστε να τα αντιστοιχίσετε σωστά με τις τιμές που παρέχει το σύστημα.
- Συνεργασία με SoftOne: Είναι καλή πρακτική να συνεργαστείτε με τον τεχνικό σύμβουλο SoftOne για να καθορίσετε τις ακριβείς απαιτήσεις του συστήματός σας.
