vp-woo-pont-tracking-automations

Tracking and automation integration

Shipment tracking, carrier-status synchronization, customer tracking pages, tracking emails, and status automations are PRO features. Feature-detect the runtime and settings; do not assume that the presence of the free plugin means tracking is enabled.

Tracking state

Order meta	Meaning
_vp_woo_pont_parcel_number	Tracking/parcel number created with the label.
_vp_woo_pont_parcel_info	Provider-normalized event array, newest-first in the built-in UI.
_vp_woo_pont_parcel_info_time	Last successful synchronization timestamp.
_vp_woo_pont_tracking_link	Random token for the plugin's customer tracking URL. Treat it as a secret.
_vp_woo_pont_tracking_emails_sent	Names of tracking emails already sent.

Read them through WC_Order::get_meta(). A normalized event generally contains event, date, and optional label, but event values remain provider-specific. Do not compare raw GLS, Packeta, MPL, or Foxpost codes across carriers.

Use the public helpers for links:

$order = wc_get_order( $order_id );
if ( $order instanceof WC_Order ) {
	$carrier_link = VP_Woo_Pont()->tracking->get_tracking_link( $order );
	$private_page = VP_Woo_Pont()->tracking->get_internal_tracking_link( $order );
}

The internal URL contains order ID plus _vp_woo_pont_tracking_link. Do not log, index, cache-share, or expose that token to unrelated users.

Scheduler lifecycle

After vp_woo_pont_label_created, supported non-custom carriers schedule a recurring Action Scheduler job:

Contract	Value
Hook	vp_woo_pont_update_tracking_info
Argument	order_id
Group	vp_woo_pont
Default interval	Two hours

vp_woo_pont_tracking_sync_interval( $seconds, $order, $provider ) changes the interval. Keep it large enough for carrier limits.

The updater cancels future work when the order is missing, the parcel number is absent, the sync deadline expires, or the latest normalized state is delivered. The default deadline is two weeks and can be changed through vp_woo_pont_tracking_info_sync_deadline.