ABS Courier

By abscourier

0+ active installationsVersion 1.0.0

Ship WooCommerce orders with ABS Courier in Egypt: create shipments, print waybills, request pickups and track delivery status.

Description

ABS Courier connects your WooCommerce store to your ABS Courier account, so you can ship orders across Egypt without leaving WordPress.

Send orders to ABS

  • Automatically when an order reaches the status you choose (Processing by default). It happens in the background, so checkout is never slowed down.
  • From the order screen with one click, or in bulk from the orders list.
  • The recipient’s phone number, address, delivery district, weight and cash-on-delivery amount are filled in for you. Cash on delivery is collected only for orders paid with a cash-on-delivery method; other orders are sent as already paid.
  • The delivery district is matched from the address in English or Arabic. When it can’t be matched you choose: send it as “Not Clear” for ABS to confirm, or hold the order until you pick the district.

Follow every shipment

  • The ABS status appears on your orders list and on each order, with an order note on every change.
  • Live updates from ABS for stores on HTTPS, plus an automatic check every 30 minutes and a “Refresh status” button.
  • Optionally mark orders Completed when ABS delivers them. Payment status is never changed by the plugin.
  • Cancelling an order cancels its ABS shipment while it hasn’t been picked up yet.

Everything in one place

  • Shipments: search by AWB, order number, phone or name; filter by status; see each shipment’s delivery history.
  • Waybills: print A4 waybills (two per page, with barcode and QR code) for one order, a selection, or a whole batch.
  • Pickups: see upcoming and past pickups and request a new one.
  • Transactions: every batch of shipments you created.

Requirements

  • WooCommerce 10.0 or later.
  • An ABS Courier account and an API key bound to your sub-account (see Installation).
  • Orders in EGP for delivery within Egypt.

External services

This plugin connects to the ABS Courier API (https://core.absegy.com), operated by ABS Courier, to create, track, print and cancel shipments and to request pickups. It is required for the plugin to work.

  • When: only after you connect your ABS Courier account in the plugin settings. When an order is sent to ABS (automatically or by you), and when you open the plugin’s Shipments, Pickups or Transactions pages.
  • What is sent: the recipient’s name, phone number, email address and delivery address; the order number, item names, quantities, weight and order total; and the cash-on-delivery amount. Your API key authenticates each request.
  • What is received: shipment numbers (AWB), statuses, waybill data, pickups and batches. For stores on HTTPS, ABS also sends status updates to this site’s address /wp-json/abs-courier/v1/webhook, signed with a secret only your store and ABS know.

ABS Courier terms of service: https://www.absegy.com/en/terms
ABS Courier privacy policy: https://www.absegy.com/en/privacy

Privacy

The plugin stores, in your WordPress database: your ABS API key and webhook secret (encrypted), your settings, and on each order its ABS shipment number, status and district. It sends customer details to ABS Courier only to deliver the order (see External services). Suggested text for your privacy policy is added under Settings → Privacy → Policy Guide. Deleting the plugin removes its settings and keys; shipment details on orders are kept as part of your order history.

Installation

  1. In WordPress, go to Plugins → Add New, search for ABS Courier, then install and activate it. (Or upload the ZIP under Plugins → Add New → Upload Plugin.)
  2. In your ABS Courier portal, create an API key bound to your sub-account with these permissions: shipments (create, read, update), pickups (create, read), tracking (read) and webhooks (read, write, delete).
  3. In WordPress, go to WooCommerce → ABS Courier → Settings, paste the key and click Connect. The key is checked with ABS before it is saved.
  4. Review the shipment settings (trigger status, cash-on-delivery payment methods, product, package type, default weight) and click Save settings.

FAQ

Do I need an ABS Courier account?

Yes. The plugin uses your ABS Courier account to create and track shipments. Contact ABS Courier at https://absegy.com to open one.

Why does Connect say my key “is not linked to a sub-account”?

The plugin needs an API key that is bound to a sub-account in the ABS portal. Create a new key, choose your sub-account, and grant the permissions listed under Installation.

Will it slow down my checkout?

No. Orders are sent to ABS by background jobs after checkout; the customer never waits for ABS.

What happens if ABS is unavailable?

The plugin retries automatically (after 1, 5 and 15 minutes, then 1 and 4 hours). If a request timed out, it first checks with ABS whether the shipment was created before sending again, so you don’t get duplicates.

What does “District not matched” mean?

The delivery district couldn’t be identified from the customer’s address with confidence. Depending on your setting, the order is sent as “Not Clear” (ABS confirms the address with the customer) or held until you pick the district in the ABS Courier box on the order screen.

Why are live status updates “Off”?

Live updates need your store to use HTTPS, because ABS only sends updates to secure addresses. Statuses are still checked every 30 minutes, and you can click “Refresh status” on any order.

Can I cancel a shipment?

Yes, while ABS hasn’t picked it up yet: cancel the order, or click “Cancel shipment” in the ABS Courier box. After pickup, contact ABS Courier support.

Can I keep the API key out of the database?

Yes. Add define( 'ABS_COURIER_API_KEY', 'your-key' ); to wp-config.php. The settings page then uses that key and can’t change it.

Does it work with High-Performance Order Storage and the block checkout?

Yes, both are supported.

Screenshots

Changelog

1.0.0

  • Initial release: send orders to ABS Courier (manually, in bulk or automatically), track shipment status, print waybills, request pickups, and view shipments and batches in WooCommerce.

Full history: see changelog.txt.