Πώς λειτουργεί

Η διασύνδεση επιτρέπει σε τρίτες υπηρεσίες (POS / order-taking / ERP) να δημιουργούν delivery requests στο CoDeliver, ώστε να εκτελεστεί η διανομή από τους οδηγούς.

1) Onboarding

1. Κάνεις εγγραφή partner.
2. Λαμβάνουμε Slack notification και επικοινωνούμε για requirements.
3. Σου δίνουμε credentials (shared secret) και store mapping (group, store_id).
4. Τα credentials κοινοποιούνται ιδιωτικά με ασφαλές onboarding channel.

2) Integration flow (τυπικό)

1. (Optional) Καλείς από το API reference το endpoint Precalculate για να δείξεις εκτίμηση κόστους/ETA στον πελάτη.
2. Καλείς Create request για να δημιουργήσεις delivery request.
3. Όταν η παραγγελία είναι έτοιμη, καλείς Pickup ready.
4. Αν ακυρωθεί πριν το pickup, καλείς Cancel.

3) IDs / idempotency

• request_id: πρέπει να είναι σταθερό για το ίδιο order (χρήσιμο για retries χωρίς duplicates).
• vendor_reference_id: το reference του δικού σου συστήματος (π.χ. order id).
• group / store_id: δίνονται στο onboarding και είναι υποχρεωτικά για routing.

4) Security

• Όλες οι κλήσεις γίνονται μέσω HTTPS.
• Το shared secret πρέπει να αποθηκεύεται και να χρησιμοποιείται με ασφάλεια (server-side).
• Σε παραγωγικές διασυνδέσεις μπορούμε να προσθέσουμε επιπλέον περιορισμούς (π.χ. allowlist origins/IPs) ανά partner.

5) Support

Αν χρειάζεσαι βοήθεια στο integration, ξεκίνα από την εγγραφή partner.