The AST PRO plugin provides a REST API to manage tracking information for WooCommerce orders. It allows adding, retrieving, and deleting tracking entries, along with listing available shipping carriers.

🔐 How to Get WooCommerce API Keys

To authenticate with the Shipment Tracking API, you’ll need your WooCommerce Consumer Key and Consumer Secret.

🛠️ Steps to Generate API Keys:

• Go to your WordPress dashboard.
• Navigate to WooCommerce > Settings > Advanced > REST API.
• Click Add Key.
• Enter a name (e.g., “AST API Access”).
• Choose a user (with Admin rights recommended).
• Set Permissions to Read/Write.
• Click Generate API Key.

✅ You will now see your Consumer Key and Consumer Secret—copy and store them securely.

---

🧾 Shipment Tracking API Properties

🔄 Add Shipment Tracking to an Order

Endpoint:

POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

Example:

curl -X POST https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings \
-u consumer_key:consumer_secret \
-H "Content-Type: application/json" \
-d '{
  "tracking_provider": "Fedex",
  "tracking_number": "12345678",
  "date_shipped": "08-07-2024",
  "status_shipped": 1,
  "replace_tracking": 1,
  "shipping_note": "Your order has been shipped in two separate packages."
}'

Response:

"Tracking ID: fb7170d97d0e628bc3b565999d07c6a9"

---

📦 Add Tracking Per Order Item

Endpoint:

POST /wp-json/wc-ast-pro/v3/orders/<order_id>/shipment-trackings

Example:

curl -X POST https://your-domain.com/wp-json/wc-ast-pro/v3/orders/340/shipment-trackings \
-u consumer_key:consumer_secret \
-H "Content-Type: application/json" \
-d '{
  "tracking_provider": "USPS",
  "tracking_number": "123456",
  "date_shipped": "2024-07-10",
  "status_shipped": 2,
  "sku": "t-shirt,blue-jeans",
  "qty": "1,1",
  "shipping_note": "Partial shipment – remaining items will ship soon."
}'

Another package:

curl -X POST https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings \
-u consumer_key:consumer_secret \
-H "Content-Type: application/json" \
-d '{
  "tracking_provider": "USPS",
  "tracking_number": "456879",
  "date_shipped": "2024-07-12",
  "status_shipped": 1,
  "sku": "t-shirt,blue-jeans",
  "qty": "1,2"
  "shipping_note": "Final shipment for remaining items."
}'

---

🔍 Get Shipment Tracking Info

Endpoint:

GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

Example:

curl -X GET https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings \
-u consumer_key:consumer_secret

Response:

{
  "tracking_id": "feb9bde4475fda92cc9408607b7ecb66",
  "tracking_provider": "Fedex",
  "tracking_link": "http://www.fedex.com/Tracking?action=track&tracknumbers=12345678",
  "tracking_number": "12345678",
  "date_shipped": "2024-07-10"
}

---

❌ Delete Shipment Tracking

Endpoint:

DELETE /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/<tracking_id>

Example:

curl -X DELETE https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings/fa61d174a05d2f34323b51d92823947d \
-u consumer_key:consumer_secret

Response:

"Tracking ID: fa61d174a05d2f34323b51d92823947d"

---

🧭 Get Shipping Carriers

Endpoint:

GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/providers

Example:

curl -X GET https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings/providers \
-u consumer_key:consumer_secret

Response Sample:

{
  "United States (US)": {
    "USPS": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=%number%",
    "UPS": "http://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=%number%"
  },
  "India": {
    "Delhivery": "https://www.delhivery.com/track/package/%number%"
  }
}

---

❗ API Request Errors

📬 Postman Example

To test using Postman:

1. Method: POST
2. URL:

https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/340/shipment-trackings

3. Authorization:
   • Type: Basic Auth
   • Username: Consumer Key
   • Password: Consumer Secret
4. Headers:

Content-Type: application/json

5. Body → Raw → JSON:

{
  "tracking_provider": "UPS",
  "tracking_number": "1Z9999",
  "date_shipped": "10-07-2024",
  "status_shipped": 1
}

✅ Click Send and confirm the response includes a Tracking ID.

🔄 Bulk Shipment Tracking API

WooCommerce’s REST API supports bulk operations for many resources, but shipment tracking traditionally required updating one order at a time.

To support high-volume fulfillment workflows, AST PRO provides a Bulk Shipment Tracking API, allowing multiple orders and tracking numbers to be added or updated in a single API request.

This feature is designed for merchants, ERPs, OMS systems, shipping platforms, and 3PL providers handling large shipment volumes.

🔗 API Endpoint

Bulk Add Shipment Tracking

POST /wp-json/wc-shipment-tracking/v3/orders/shipment-trackings/bulk

🔐 Authentication and permissions are the same as the single shipment tracking API.

📥 Request Body (Bulk Format)

The bulk endpoint accepts a shipments array, where each object represents one tracking entry for one order.

Each shipment may have different tracking providers, tracking numbers, and shipment dates.

{
  "shipments": [
    {
      "order_id": 677,
      "tracking_provider": "fedex",
      "tracking_number": "FDX-1110",
      "date_shipped": "2024-07-08",
      "status_shipped": 1,
      "shipping_note": "Partial shipment – remaining items will ship soon."
    },
    {
      "order_id": 675,
      "tracking_provider": "ups",
      "tracking_number": "UPS-2220",
      "date_shipped": "2024-07-09",
      "status_shipped": 1,
      "shipping_note": "Final shipment for this order."
    }
  ]
}

ℹ️ The same order_id may appear multiple times to add multiple tracking numbers to a single order.

🧾 Supported Fields

📤 Response Format

The bulk API returns an array of tracking objects, using the same format as the single shipment tracking API.

Each object represents one successfully added tracking entry.

✅ Successful Response Example

[
  {
    "tracking_id": "37fdbfe33f7af11eb6caa04ea0261b0c",
    "tracking_provider": "FedEx",
    "tracking_link": "https://www.fedex.com/fedextrack/?trknbr=FDX-1110",
    "tracking_number": "FDX-1110",
    "date_shipped": "2024-07-08",
    "products_list": ""
  },
  {
    "tracking_id": "c0d318fd8261c2321646d80aeb337614",
    "tracking_provider": "UPS",
    "tracking_link": "https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=UPS-2220",
    "tracking_number": "UPS-2220",
    "date_shipped": "2024-07-09",
    "products_list": ""
  }
]

❌ Failed Shipment Example

If a shipment fails (for example, due to an invalid order ID), the API returns a standard WooCommerce REST API error response:

{
  "code": "woocommerce_rest_order_invalid_id",
  "message": "Invalid order ID.",
  "data": {
    "status": 404
  }
}

⚠️ A failed shipment does not stop the processing of other shipments in the same request.

🧪 cURL Example

curl -X POST https://your-domain.com/wp-json/wc-shipment-tracking/v3/orders/shipment-trackings/bulk \
-u consumer_key:consumer_secret \
-H "Content-Type: application/json" \
-d '{
  "shipments": [
    {
      "order_id": 677,
      "tracking_provider": "fedex",
      "tracking_number": "FDX-1110",
      "date_shipped": "2024-07-08",
      "status_shipped": 1
    },
    {
      "order_id": 675,
      "tracking_provider": "ups",
      "tracking_number": "UPS-2220",
      "date_shipped": "2024-07-09",
      "status_shipped": 1
    }
  ]
}'