Ενσωμάτωση API Ηλεκτρονικών Δελτίων Αποστολής: Σύνδεση του ERP/DMS σας με την Πύλη
Τεχνικός οδηγός για ενσωμάτωση του ERP ή DMS σας με την πύλη ηλεκτρονικών δελτίων αποστολής μέσω API. Αυθεντικοποίηση, endpoints, μορφές και συνήθη ζητήματα.
Γιατί η Ενσωμάτωση API Είναι Απαραίτητη
Η πύλη διαθέτει διεπαφή web για χειροκίνητη εισαγωγή, αλλά για εταιρείες που αποστέλλουν περισσότερα από 5-10 δελτία αποστολής ημερησίως, η χειροκίνητη εισαγωγή δεν είναι βιώσιμη. Η ενσωμάτωση API επιτρέπει αυτόματη δημιουργία, επιβεβαίωση παραλαβής και συγχρονισμό κατάστασης.
Αρχιτεκτονική Συστήματος
- Πρωτόκολλο: HTTPS (TLS 1.2+)
- Μορφή: JSON
- Αυθεντικοποίηση: Αναγνωρισμένο ηλεκτρονικό πιστοποιητικό (mutual TLS) + κλειδί API
- Τεκμηρίωση: Διαθέσιμη στην πύλη μετά την εγγραφή
Κύρια Endpoints API
| Endpoint | Μέθοδος | Περιγραφή |
|---|---|---|
| /api/v1/delivery-notes | POST | Δημιουργία νέου ηλεκτρονικού δελτίου αποστολής |
| /api/v1/delivery-notes/{id} | GET | Προβολή μεμονωμένου δελτίου αποστολής |
| /api/v1/delivery-notes | GET | Λίστα δελτίων αποστολής (με φίλτρα) |
| /api/v1/receipt-notes | POST | Δημιουργία δελτίου παραλαβής (επιβεβαίωση παραλαβής) |
| /api/v1/delivery-notes/{id}/status | GET | Κατάσταση δελτίου αποστολής |
| /api/v1/delivery-notes/{id}/pdf | GET | Εκδοση PDF για εκτύπωση |
Ενσωμάτωση με Δημοφιλή Συστήματα ERP
SAP
Χρησιμοποιήστε SAP PI/PO ή SAP Integration Suite. Αντιστοίχιση από το module SD (Shipping/Delivery document) στη μορφή API.
Microsoft Dynamics
Χρησιμοποιήστε Power Automate ή προσαρμοσμένους connectors. Αντιστοίχιση από Sales/Transfer Orders.
Τοπικά Συστήματα ERP
Τα περισσότερα τοπικά ERP (Pantheon, Lidder, Bild, 4D) αναπτύσσουν ή διαθέτουν ήδη modules ηλεκτρονικών δελτίων αποστολής.
Συνήθη Ζητήματα Ενσωμάτωσης
- Πιστοποιητικό μη σωστά ρυθμισμένο: πρέπει να είναι στον server, όχι μόνο στον σταθμό εργασίας
- Λάθος μορφή ημερομηνίας: το API αναμένει ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Ελλείπουσα υποχρεωτικά πεδία: το API επιστρέφει 400 με λίστα πεδίων
- Ο παραλήπτης δεν είναι εγγεγραμμένος: ο παραλήπτης πρέπει να υπάρχει στο σύστημα
- Timeout με μεγάλες αποστολές: χωρίστε 100+ αντικείμενα σε πολλαπλά δελτία
Ειδοποιήσεις Webhook
Η πύλη υποστηρίζει webhooks για ενημερώσεις κατάστασης σε πραγματικό χρόνο: επιβεβαίωση παραλαβής, αποδοχή/απόρριψη, προειδοποιήσεις προθεσμίας.
Συμπέρασμα
Η ενσωμάτωση API είναι η μόνη βιώσιμη προσέγγιση για λειτουργίες μεγάλου όγκου.
Το Docavelo διαθέτει έτοιμη ενσωμάτωση πύλης: συνδέστε το ERP σας με το Docavelo και αυτό επικοινωνεί με την πύλη για εσάς.
