Koombiyo Delivery

Koombiyo Delivery connects your WooCommerce store to the Koombiyo Delivery courier network (Sri Lanka): assign waybills and dispatch orders in bulk, track shipment status and Proof of Delivery, and request courier pickups — all from your WordPress admin.

The plugin works as a standalone WooCommerce extension (one site-level Koombiyo account), or in multi-vendor mode with WCFM or Dokan, where each vendor connects and uses their own independent Koombiyo merchant account.

Requires

• WooCommerce (required)
• WCFM Marketplace or Dokan (optional — enables multi-vendor mode; neither is required for standalone use)
• A Koombiyo Delivery merchant account (contact Koombiyo Delivery to obtain API credentials)

External services

This plugin connects to the Koombiyo Delivery courier service, provided by Koombiyo Delivery (Pvt) Ltd in Sri Lanka. A Koombiyo Delivery account is required. Nothing is sent until a store owner or vendor connects their account.

Koombiyo Delivery API (https://client.koombiyodelivery.lk) is used to dispatch and track orders.

• Your API key and password are sent when you connect an account, and when the plugin has to sign in again.
• Customer name, phone numbers, delivery address, city and postal code, order number, order description, cash on delivery amount, product value and your notes are sent when you dispatch an order.
• A waybill number is sent when you open shipment details, a timeline or a Proof of Delivery, print waybills or delete a shipment.
• Pickup address, phone number, map location, quantity, remark and vehicle type are sent when you request a pickup.
• Your account login token is sent with these requests and when the plugin loads the Dashboard, the notices banner, active waybills or the order and pickup lists.
• A waybill or pickup is looked up when Koombiyo sends this site a status update, so the plugin can confirm the update before changing anything. If delivery updates are off on a single-vendor account, no lookup is made.

Koombiyo notice images: a notice from Koombiyo may include an image, which your browser then loads from the address Koombiyo gave, on the plugin’s admin pages.

Koombiyo tracking page (https://koombiyodelivery.lk): the “Order dispatched” customer email links to Koombiyo’s tracking page. When a customer opens the link, the waybill number and phone number in it are sent to Koombiyo.

Status updates from Koombiyo: Koombiyo sends status updates to this site’s REST API addresses shown under API Settings, once you save them in the Koombiyo portal. They contain a waybill or pickup ID and its status.

Koombiyo Delivery terms of service: https://koombiyodelivery.lk/about (select “Terms & Conditions” at the bottom of the page)
Koombiyo Delivery privacy policy: https://koombiyodelivery.lk/privacy_policy

OpenStreetMap is used for the map where you choose a pickup location on the Pickup Requests screen. While that map is showing, your browser loads map images from OpenStreetMap’s servers (https://tile.openstreetmap.org), which receive your IP address and the map area being viewed. No order or customer details are sent. The service is provided by the OpenStreetMap Foundation.

OpenStreetMap terms of use: https://osmfoundation.org/wiki/Terms_of_Use
OpenStreetMap tile usage policy: https://operations.osmfoundation.org/policies/tiles/
OpenStreetMap privacy policy: https://osmfoundation.org/wiki/Privacy_Policy

Source code

The human-readable source of the compiled JavaScript and CSS in build/ is included in this plugin, in the src/ folder, with package.json and webpack.config.js.

To rebuild it, run npm install and then npm run build in the plugin folder. This needs Node.js and uses @wordpress/scripts.

The Pickup Requests map uses Leaflet 1.9.4 (BSD-2-Clause license), which is bundled into build/, along with its marker images. Its source is at https://github.com/Leaflet/Leaflet.