How to Integrate your POS/ Order Aggregation Platform with Tookan?

Tookan is a cloud-based Delivery Management Platform designed to revolutionize real-time tracking and delivery management for businesses of all sizes. By leveraging Tookan, Businesses can Increase their operational efficiency, Enhance customer satisfaction, Reduce costs, increase profitability and Gain a competitive edge in their respective markets.

Integrating your platform with Tookan offers a powerful solution for businesses to streamline their delivery operations and enhance customer experience . By embracing automation, real-time visibility, and data-driven insights, businesses can unlock the full potential of their delivery network and deliver exceptional customer experiences.

Here’s a step by step guide: 

1. Create/Login an account on Tookan Dashboard ( https://app.tookanapp.com/#/app/dashboard ).

2. Once logged in, from the left side menu, go to Settings.

3. Now scroll down to the API Keys tab and generate/ copy V2 Api Key.

4. Now, from the Tookan Apiary (Open API documentation, https://tookanapi.docs.apiary.io/#introduction ), you can use the apis required by you and integrate them with your code base. 

5. In the api_key field, add the api key retrieved in Step 3.

GENERAL FLOW: Task Creation > Task Updation > Rider Assignment > Webhook (for status updates/callbacks)

A) API for Task Creation: https://tookanapi.docs.apiary.io/#reference/task

API URL: https://api.tookanapp.com/v2/create_task – create pickup or delivery task

A task is created.

B) API for Task Updation: https://tookanapi.docs.apiary.io/#reference/task/edit-task/edit-task

API URL: https://api.tookanapp.com/v2/edit_task – edit a task

The task address is updated

C) API for Rider Assignment: https://tookanapi.docs.apiary.io/#reference/task/assign-task/assign-task 

API URL: https://api.tookanapp.com/v2/assign_task 

The task is assigned to a rider.

D) Webhook for Order Updates: https://tookanapi.docs.apiary.io/#reference/webhook/tookan-shared-secret/assign-task

API URL: Your API URL where you want to receive updates.

For Webhooks, you need to have a shared secret key. Use this API (https://api.tookanapp.com/v2/set_tookan_shared_secret_key ) to generate it.

Set webhooks on Tookan Dashboard by navigating via Dashboard > Settings > Notifications > Actions > Edit > Webhook.