ERP, marketplaces & APIs
Όταν το απόθεμα διαφέρει ή μια παραγγελία δεν περνά στο ERP, χρειάζεται να παρακολουθήσουμε τη διαδρομή των δεδομένων. Η σύνδεση είναι διαδικασία, όχι απλώς ένα endpoint.
Παρακολουθούμε τη διαδρομή, όχι μόνο την τελευταία τιμή
Για κάθε ροή καταγράφουμε πηγή, προορισμό, mapping, χρόνο ενημέρωσης και μηχανισμό αποτυχίας. Έτσι μπορούμε να διακρίνουμε αν μια ασυμφωνία προήλθε από λάθος αντιστοίχιση, αποτυχημένη μεταφορά ή νεότερη ενημέρωση άλλου συστήματος.
| Σύμπτωμα / ανάγκη | Τι ελέγχουμε | Χρήσιμο στοιχείο |
|---|---|---|
| Λάθος απόθεμα στο e-shop | Ταυτοποίηση προϊόντος/παραλλαγής και σειράς ενημερώσεων. | Κωδικός ERP, product_id, product_code, ώρα κάθε μεταφοράς. |
| Παραγγελία λείπει από το ERP | Έλεγχος αν εξήχθη, αν παραλήφθηκε και αν απορρίφθηκε. | Ανώνυμο ID αναφοράς και status εργασίας. |
| Διπλή εγγραφή | Χειρισμός retry και αναγνώριση ήδη ολοκληρωμένης μεταφοράς. | Σταθερό ID αντιστοίχισης και ιστορικό επαναλήψεων. |
| Το API επιστρέφει σφάλμα | Διαχωρισμός authentication, permissions, mapping και διαθεσιμότητας. | HTTP status και ανωνυμοποιημένο error body. |
Στο CS-Cart API, 401 αφορά στοιχεία αυθεντικοποίησης και 403 δικαιώματα πρόσβασης. Τα δύο σφάλματα οδηγούν σε διαφορετικούς ελέγχους, όχι σε τυφλές επαναλήψεις.
CS-Cart: API Response Errors ↗Τι εξετάζουμε μαζί
- Ορισμός πηγής αλήθειας για προϊόντα, απόθεμα, τιμές και παραγγελίες.
- Έλεγχος αντιστοιχίσεων, δικαιωμάτων API και χειρισμού αποτυχιών.
- Δοκιμές επανάληψης και συμφωνία διαδικασίας συμφιλίωσης δεδομένων.
Τι θα έχετε από τη συμφωνημένη εργασία
- Χάρτης ροών και πηγή αλήθειας ανά πεδίο.
- Κανόνες αντιστοίχισης και διαχείρισης επαναλήψεων.
- Σενάρια αποτυχίας, συμφιλίωσης και ειδοποίησης υπεύθυνου.
Το τελικό εύρος και τα παραδοτέα επιβεβαιώνονται στην πρόταση της E-GROWTH. Η λίστα είναι πλαίσιο συζήτησης.
Σχηματική ροή connector — δεν είναι ενσωματωμένος μηχανισμός κάθε ERP.
- 01Πηγή
- 02Mapping
- 03API request
- 04Απόκριση
- 05Συμφιλίωση
Παράδειγμα σχεδιασμού: μεταφορά παραγγελίας
Το πρόβλημα
Το αίτημα προς το ERP λήγει χωρίς σαφή απάντηση, ενώ μπορεί να έχει ήδη δημιουργηθεί η εγγραφή.
Η προσέγγιση
Η επανάληψη προηγείται μόνο αφού υπάρχει τρόπος αναγνώρισης της ίδιας παραγγελίας στον προορισμό.
Η επιβεβαίωση
Ένα retry δεν πρέπει να δημιουργεί νέα εμπορική εγγραφή για το ίδιο συμβάν. Η δυνατότητα εξαρτάται από τον connector και το API του ERP.
Τι χρειάζεται να συμφωνηθεί
Η δυνατότητα και το εύρος εξαρτώνται από τα APIs, τις άδειες και τους προμηθευτές. Δεν θεωρούμε δεδομένη τη σύνδεση με κάθε σύστημα.
Πρακτικές ερωτήσεις
Μπορεί μια σύνδεση να λειτουργεί σε πραγματικό χρόνο;
Ο σχεδιασμός εξαρτάται από τα συστήματα: διαθέσιμα events, APIs, όρια αιτημάτων και δυνατότητες connector. Η επιθυμητή καθυστέρηση συμφωνείται ανά ροή.
Τι γίνεται όταν πέσει ένα από τα δύο συστήματα;
Χρειάζεται ορισμένος χειρισμός εκκρεμοτήτων, retries και συμφιλίωσης μετά την επαναφορά. Αυτές οι δυνατότητες πρέπει να τεκμηριώνονται, όχι να θεωρούνται αυτόματες.