Skip to content

Instantly share code, notes, and snippets.

@zorem
Last active October 22, 2021 13:02
Show Gist options
  • Save zorem/82a52ab3c2fc02dc2a31e11454e8790b to your computer and use it in GitHub Desktop.
Save zorem/82a52ab3c2fc02dc2a31e11454e8790b to your computer and use it in GitHub Desktop.

Shipment Tracking REST API

The shipment tracking REST API allows you to create, view, and delete individual shipment tracking. The endpoint is /wp-json/wc-ast-pro/v3/.

Shipment Tracking Properties

Attribute Type Description
tracking_id string Unique identifier for shipment tracking read-only
order_id int Unique order id required
tracking_number string Tracking number required
tracking_provider string Tracking provider name
date_shipped date Date when package was shipped
status_shipped int Change order status to “Shipped” (completed) or “Partial Shipped” – (0=no,1=shipped,2=partial shipped(if partial shipped order status is enabled))
sku string Line item (product) SKU
qty int Line item (product) quantity

Create a shipment tracking

POST /wp-json/wc-ast-pro/v3/orders/645/shipment-trackings
curl -X POST https://your-domain.com/wp-json/wc-ast/v3/orders/<order_id>/shipment-trackings 
	-u consumer_key:consumer_secret 
	-H "Content-Type: application/json" 
	-d '{
		"tracking_provider": "Fedex",
		"tracking_number": "12345678",
		"date_shipped": "2019-03-08",//date_shipped is optional parameter
		"status_shipped": 1,//status_shipped is optional parameter
        "sku": "woo-beanie,Woo-beanie-logo",
        "qty": "1,1",
		"replace_tracking": 1,//replace_tracking is optional parameter
	}'
//response example:
"Tracking ID: fb7170d97d0e628bc3b565999d07c6a9"

Retrieve a shipment tracking

GET /wp-json/wc-ast-pro/v3/orders/<order_id>/shipment-trackings/<tracking-id>
curl -X GET https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/aef9edae359ef9d610e8a330879921bc \
    -u consumer_key:consumer_secret \

JSON response example:

{
    "tracking_id": "aef9edae359ef9d610e8a330879921bc",
    "tracking_provider": "USPS",
    "tracking_link": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=9400116901016071541103",
    "tracking_number": "9400116901016071541103",
    "date_shipped": "2021-10-21",
    "products_list": [
        {
            "product": "24",
            "item_id": "170",
            "qty": "5"
        }
    ],
    "_links": {
        "self": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/aef9edae359ef9d610e8a330879921bc"
            }
        ],
        "collection": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings"
            }
        ],
        "up": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552"
            }
        ]
    }
}

List all shipment trackings

GET /wp-json/wc-ast-pro/v3/orders/<order_id>/shipment-trackings/
curl -X GET https://example.com/wp-json/wc-shipment-tracking/v3/orders/16552/shipment-trackings \
    -u consumer_key:consumer_secret \

JSON response example:

[
    {
        "tracking_id": "aef9edae359ef9d610e8a330879921bc",
        "tracking_provider": "USPS",
        "tracking_link": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=9400116901016071541103",
        "tracking_number": "9400116901016071541103",
        "date_shipped": "2021-10-21",
        "products_list": [
            {
                "product": "24",
                "item_id": "170",
                "qty": "5"
            }
        ],
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/aef9edae359ef9d610e8a330879921bc"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings"
                }
            ],
            "up": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552"
                }
            ]
        }
    },
    {
        "tracking_id": "bcd6807ae41efebf629b4fff704331ea",
        "tracking_provider": "USPS",
        "tracking_link": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=9400116901016071541103",
        "tracking_number": "9400116901016071541103",
        "date_shipped": "2021-10-21",
        "products_list": [
            {
                "product": "40",
                "item_id": "169",
                "qty": "2"
            }
        ],
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/bcd6807ae41efebf629b4fff704331ea"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings"
                }
            ],
            "up": [
                {
                    "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552"
                }
            ]
        }
    }
]

Delete a shipment tracking

DELETE /wp-json/wc-ast-pro/v3/orders/<order_id>/shipment-trackings/<tracking-id>
curl -X DELETE https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/aef9edae359ef9d610e8a330879921bc \
    -u consumer_key:consumer_secret \

JSON response example:

{
    "tracking_id": "aef9edae359ef9d610e8a330879921bc",
    "tracking_provider": "USPS",
    "tracking_link": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=9400116901016071541103",
    "tracking_number": "9400116901016071541103",
    "date_shipped": "2021-10-21",
    "products_list": [
        {
            "product": "24",
            "item_id": "170",
            "qty": "5"
        }
    ],
    "_links": {
        "self": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/aef9edae359ef9d610e8a330879921bc"
            }
        ],
        "collection": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings"
            }
        ],
        "up": [
            {
                "href": "https://example.com/wp-json/wc-ast-pro/v3/orders/16552"
            }
        ]
    }
}

List active shipment tracking providers

GET /wp-json/wc-ast-pro/v3/orders/<order_id>/shipment-trackings/providers
curl -X GET https://example.com/wp-json/wc-ast-pro/v3/orders/16552/shipment-trackings/providers \
    -u consumer_key:consumer_secret \

JSON response example:

{
    "Austria": {
        "DPD Austria": "https://tracking.dpd.de/parcelstatus?locale=de_AT&query=%number%"
    },
    "Australia": {
        "Australia Post": "http://auspost.com.au/track/track.html?id=%number%",
        "Fastway AU": "http://www.fastway.com.au/courier-services/track-your-parcel?l=%number%"
    },
    "Germany": {
        "UPS Germany": "http://wwwapps.ups.com/WebTracking/processInputRequest?sort_by=status&tracknums_displayed=1&TypeOfInquiryNumber=T&loc=de_DE&InquiryNumber1=%number%"
    },
    "United Kingdom (UK)": {
        "DHL Express UK": "http://www.dhl.com/content/g0/en/express/tracking.shtml?brand=DHL&AWB=%number%",
        "DPD UK": "http://www.dpd.co.uk/tracking/trackingSearch.do?search.searchType=0&search.parcelNumber=%number%",
        "UPS UK": "https://www.ups.com/track?loc=en_GB&tracknum=%number%"
    },
    "Global": {
        "UPS Global": "http://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=%number%"
    },
    "Sweden": {
        "UPS.se": "http://wwwapps.ups.com/WebTracking/track?track=yes&loc=sv_SE&trackNums=%number%"
    },
    "United States (US)": {
        "DHL US": "https://www.logistics.dhl/us-en/home/tracking/tracking-ecommerce.html?tracking-id=%number%",
        "DHL Parcel": "https://www.logistics.dhl/us-en/home/tracking/tracking-ecommerce.html?tracking-id=%number%",
        "TNT": "https://www.tnt.com/express/en_us/site/tracking.html?searchType=con&cons=%number%",
        "UPS": "http://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=%number%",
        "USPS": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=%number%",
        "UPS i-parcel": "https://tracking.i-parcel.com/?TrackingNumber=%number%"
    }
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment