Endpoint συνεργάτη: PostDOC, πρότυπο JSON και κλήση ελέγχου
Όταν οι παραγγελίες στέλνονται σε υπηρεσία που έγραψε ο συνεργάτης σας SoftOne αντί για το τυπικό setData.
Υπάρχουν δύο τρόποι αποστολής, στις Ρυθμίσεις παραγγελιών, καρτέλα «Για προχωρημένους»:
- Τυπικό SoftOne (setData). Η προεπιλογή. Η υπηρεσία φτιάχνει μόνη της το παραστατικό.
- Endpoint συνεργάτη. Η υπηρεσία καλεί μια υπηρεσία της εγκατάστασής σας, για παράδειγμα
PostDOC_1, και της στέλνει το JSON που ορίζετε εσείς.
Χρησιμοποιήστε τον δεύτερο όταν ο συνεργάτης σας έχει ήδη υπηρεσία που γράφει παραγγελίες με τους κανόνες της επιχείρησής σας. Ο τρόπος αποστολής κλειδώνει μετά την πρώτη παραγγελία.
Διαδρομή endpoint
Ξεκινά με s1services/, για παράδειγμα /s1services/JS/eshop/PostDOC_1.
Σταθερές παράμετροι
Προαιρετικές. Στέλνονται με κάθε αποστολή, δίπλα στο πρότυπο.
Πρότυπο JSON
Το JSON που στέλνεται στο endpoint. Βάζετε τα πεδία της παραγγελίας μέσα σε τιμές κειμένου, με διπλά άγκιστρα:
{
"header": {
"REFERENCE": "{{reference}}",
"CUSTOMER": "{{customer.code}}",
"PAYMENT": "{{payment.code}}",
"REMARKS": "{{note}}"
},
"lines": [
{ "$lines": { "CODE": "{{line.sku}}", "QTY": "{{line.quantity}}", "PRICE": "{{line.unitPrice}}", "DISCOUNT": "{{line.discount}}" } }
]
}
Αυτό είναι το προεπιλεγμένο πρότυπο της εφαρμογής. Τα ονόματα των κλειδιών (REFERENCE, CODE και τα υπόλοιπα) τα ορίζει η υπηρεσία του συνεργάτη σας: αλλάξτε τα ώστε να ταιριάζουν. Το $lines σημειώνει το μπλοκ που επαναλαμβάνεται για κάθε γραμμή της παραγγελίας. Όλα τα διαθέσιμα πεδία φαίνονται στη λίστα «Διαθέσιμα πεδία» της σελίδας.
Κανόνες:
- Το
{{reference}}είναι υποχρεωτικό. Χωρίς αυτό το παραστατικό δεν μπορεί να βρεθεί ξανά στο ERP. - Τα πεδία
line.*δουλεύουν μόνο μέσα στο μπλοκ των γραμμών, που είναι το μοναδικό στοιχείο μιας λίστας. - Το φίλτρο
|number(για παράδειγμα{{line.quantity|number}}) στέλνει την τιμή ως αριθμό αντί για κείμενο, και εφαρμόζεται μόνο σε αριθμητικά πεδία. - Πατώντας ένα πεδίο της λίστας, μπαίνει στη θέση του δρομέα.
Κάτω από το πρότυπο βλέπετε προεπισκόπηση με εικονικά στοιχεία, και τυχόν προβλήματα με γραμμή και στήλη.
Πού βρίσκεται ο αριθμός παραστατικού στην απάντηση
Η διαδρομή μέσα στην απάντηση του endpoint, για παράδειγμα data.FINDOC. Χρειάζονται τουλάχιστον δύο τμήματα: μια απάντηση σφάλματος δεν έχει ούτε αυτή το κλειδί και θα έμοιαζε με «δεν βρέθηκε».
Κλήση ελέγχου
Μια δεύτερη υπηρεσία που ρωτά το ERP αν υπάρχει ήδη παραστατικό με την αναφορά της παραγγελίας. Εκτελείται πριν από κάθε αποστολή. Ορίζετε:
- τη διαδρομή και τις παραμέτρους της κλήσης,
- την παράμετρο αναφοράς, δηλαδή το όνομα της παραμέτρου που παίρνει την αναφορά,
- πού βρίσκεται το αποτέλεσμα: η διαδρομή της απάντησης που έχει τιμή μόνο όταν βρέθηκε παραστατικό,
- προαιρετικά πού βρίσκεται η αναφορά στην απάντηση. Όταν συμπληρωθεί, ένα παραστατικό μετρά μόνο αν η αναφορά του είναι ακριβώς ίδια. Τότε τουλάχιστον μία τιμή του προτύπου πρέπει να είναι σκέτο
{{reference}}, χωρίς άλλο κείμενο.
Πατήστε «Δοκιμή της κλήσης ελέγχου» αφού αποθηκεύσετε.
Χωρίς κλήση ελέγχου
Επιτρέπεται, αλλά έχει συνέπεια: μια αποστολή που δεν πήρε απάντηση δεν μπορεί να ελεγχθεί. Η παραγγελία σταματά ως «Χρειάζεται έλεγχο» και περιμένει εσάς, ώστε να μη σταλεί δύο φορές. Δείτε Άγνωστο αποτέλεσμα και επίλυση.
Ζητήστε από τον συνεργάτη σας μια υπηρεσία αναζήτησης με την αναφορά. Είναι μικρή δουλειά και σας γλιτώνει από χειροκίνητους ελέγχους.