How it works

This integration lets third-party systems (POS / order-taking / ERP) create delivery requests in CoDeliver so the last-mile delivery can be executed by drivers.

1) Onboarding

1. Submit the partner registration form.
2. We receive a Slack notification and follow up to align on requirements.
3. We provide credentials (shared secret) and store mapping (group, store_id).
4. Credentials are shared privately through a secure onboarding channel.

2) Typical integration flow

1. (Optional) Use the API reference to call the Precalculate endpoint and estimate price/ETA.
2. Call Create request to create a delivery request.
3. When the order is ready, call Pickup ready.
4. If you need to cancel before pickup, call Cancel.

3) Identifiers / idempotency

• request_id: must be stable for the same order (enables safe retries without duplicates).
• vendor_reference_id: your system reference (e.g. POS order id).
• group / store_id: provided during onboarding and required for routing.

4) Security

• All calls are HTTPS.
• Store and use the shared secret securely (server-side).
• For production integrations we can add additional restrictions per partner (e.g. allowlisted origins/IPs).

5) Support

If you need help with the integration, start from partner registration.