=== Yalhem Shipping for WooCommerce ===
Contributors: tonyhelmy
Tags: shipping, courier, cash on delivery, saudi arabia, egypt
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send your WooCommerce orders to your courier on Yalhem Shipping System: shipments, labels, live delivery status and shipping prices at checkout.

== Description ==

This plugin connects a WooCommerce store to its courier (delivery company) when that courier runs on [Yalhem Shipping System](https://shipping.yalhem.com/) (سيستم شحن يلهم), in Saudi Arabia and Egypt. Orders become shipments without copying addresses by hand, and the delivery status comes back into WooCommerce.

= What is Yalhem Shipping System? =

[Yalhem Shipping System](https://shipping.yalhem.com/) is an Arabic-first platform that local courier and last-mile delivery companies use to run their whole operation. It is made by [Yalhem (يلهم)](https://yalhem.com/).

* **For the courier:** shipments, hubs, assigning orders to drivers, a driver app, cash-on-delivery collection and merchant payouts.
* **For merchants (stores):** a store portal to create shipments, print labels and see money collected, plus WooCommerce and Shopify connections.
* **For customers:** a live tracking page where they can follow the driver, reschedule, or send their location.

Each courier has its own account. A store using this plugin gets its API key from its courier, not from Yalhem.

**Run a courier company?** Your merchants can install this free plugin and send you their orders automatically. Contact [Yalhem](https://yalhem.com/) to get your own Yalhem Shipping System account, and see the [API documentation](https://shipping.yalhem.com/developers) for other integrations.

= What the plugin does =

* **Shipments from orders:** automatically when an order reaches a status you choose (Processing by default), or with a button / bulk action.
* **Cash on delivery:** orders paid with your COD methods go out with the order total for the driver to collect.
* **Labels:** print the courier's label from the order screen or the orders list.
* **Live status:** out for delivery, delivered, failed attempt… appear as order notes; delivered orders can be completed automatically.
* **Tracking for customers:** a tracking link in the order page and emails.
* **Shipping price at checkout:** a shipping method that shows the courier's price for the customer's city and the cart weight.
* City names are matched for you: "Riyadh", "al-Khobar", "Nasr City" and Arabic spellings all work. For cities split into districts (like Riyadh), the district is found in the address.

Works with HPOS (custom order tables) and the block checkout.

== Installation ==

1. Install and activate the plugin.
2. Ask your courier for an API key for your store (they create it in Settings → Integrations (API)).
3. WooCommerce → Settings → Shipping → Yalhem Shipping: paste the key and save. You'll see "Connected to …".
4. Optional: add the "Yalhem Shipping (live price)" method to a shipping zone.

Your site must be reachable over HTTPS for delivery updates to arrive.

== Frequently Asked Questions ==

= Where do I get the API key? =

From your courier. They create it for your store in their Yalhem Shipping System account, under Settings → Integrations (API).

= My courier doesn't use Yalhem Shipping System. Can I still use the plugin? =

No. The plugin only talks to couriers on Yalhem Shipping System. You can point your courier to [shipping.yalhem.com](https://shipping.yalhem.com/) or [yalhem.com](https://yalhem.com/).

= Which countries are supported? =

Saudi Arabia and Egypt, with Arabic and English city names.

= Does it work with Shopify? =

This plugin is for WooCommerce. Yalhem Shipping System connects to Shopify stores separately.

= Is there an API for other platforms? =

Yes. See the [Yalhem Shipping API documentation](https://shipping.yalhem.com/developers).

== Screenshots ==

1. Settings: paste the key from your courier and you're connected. Choose when shipments are created and which payment methods are cash on delivery.
2. The order screen: the shipment number, its delivery status and buttons to print the label, track it or refresh the status.
3. The orders list: every order shows its shipment and status.

== External services ==

This plugin sends order shipping data (customer name, phone, address, city, items, order total for cash on delivery) to the Yalhem Shipping System API of your courier
(default https://shipping.yalhem.com) when a shipment is created or a shipping price is requested, and receives delivery updates from it.
Terms: https://yalhem.com/terms/ · Privacy: https://yalhem.com/privacy-policy/

== Changelog ==

= 0.1.0 =
* First version.
