HayPost Tracking Add-on

PlanetStudio Payment Gateway

HayPost Tracking Add-on

The HayPost Tracking Add-on adds automatic shipment tracking and domestic HayPost delivery rates to WooCommerce.
It synchronizes tracking events, tariffs, and Armenian postal codes, creates WooCommerce delivery zones, and shows customers a clear tracking timeline directly on their order page.

The add-on is designed for WooCommerce stores that:

  • ship orders with HayPost
  • store tracking numbers in WooCommerce fulfillments
  • want automatic shipment status updates
  • want customers to see tracking progress without leaving the order page
  • want weight-based HayPost delivery prices at checkout
  • want to create WooCommerce delivery zones from Armenian postal codes

PlanetStudio Payment Gateway Core, WooCommerce, and an active HayPost add-on token are required.


How It Works

The add-on uses the tracking number saved in a WooCommerce fulfillment and requests shipment data directly from the HayPost tracking service.

Tracking flow:

  1. A WooCommerce order is shipped with HayPost
  2. A fulfillment is created with HayPost as the shipment provider
  3. The HayPost tracking number is saved in the fulfillment
  4. The add-on detects the shipment and schedules synchronization
  5. Tracking events and delivery progress are saved with the fulfillment
  6. The customer sees the latest shipment timeline on the WooCommerce order page
  7. Automatic synchronization stops after the shipment is delivered

Previously synchronized tracking information remains available after delivery.

Domestic delivery flow

  1. The add-on synchronizes Sprint and Parcels tariffs and the Armenian postal code directory from HayPost
  2. The administrator creates or updates the required WooCommerce delivery zones
  3. WooCommerce matches the customer’s four-digit postal code to a shipping zone
  4. The add-on calculates the applicable Standard or YES rate from the package weight
  5. WooCommerce displays the available HayPost methods during checkout

Checkout uses the latest successfully stored tariff and postcode data and does not wait for a live HayPost response.


Requirements

RequirementDescription
WordPressA working WordPress website
WooCommerceRequired for orders, fulfillments, shipping zones, and checkout rates
PlanetStudio Payment Gateway CoreRequired for add-on management and token activation
HayPost Tracking Add-onThe add-on must be installed and activated
Active tokenA valid HayPost add-on token from PlanetStudio
AMD store currencyRequired when using HayPost delivery rates at checkout
Armenian postal codeA valid four-digit postal code is required for zone matching
HayPost tracking numberRequired only for shipment tracking and saved in a WooCommerce fulfillment

Installation and Activation

  1. Install and activate PlanetStudio Payment Gateway Core
  2. Install and activate WooCommerce
  3. Upload and activate the HayPost Tracking Add-on
  4. Go to:
WordPress Admin → PS Gateway → Add-ons
  1. Find the HayPost Tracking Add-on card
  2. Enter your activation token
  3. Activate the token

When the token is active, tracking synchronization, delivery-data synchronization, WooCommerce zone management, checkout rates, and the customer tracking timeline become available.


Adding a HayPost Shipment

  1. Open a WooCommerce order
  2. Create or edit a shipment fulfillment
  3. Select HayPost as the shipment provider
  4. Enter the HayPost tracking number
  5. Save the fulfillment

The add-on automatically detects HayPost fulfillments when they are created or updated.

The add-on does not create shipments or tracking numbers. The shipment must already exist in HayPost, and its tracking number must be added to the WooCommerce order.


Managing Shipments

All detected HayPost shipments are available in:

WordPress Admin → PS Gateway → HayPost → Shipments

The Shipments table shows:

ColumnDescription
OrderLinked WooCommerce order number
Tracking numberHayPost tracking number with a link to the HayPost website
StatusCurrent shipment state and latest event
ProgressCalculated delivery progress
Last syncDate and time of the latest synchronization
ErrorLatest synchronization error, if any
ActionManual refresh for an individual shipment

You can search shipments and filter the table by:

  • All
  • Active
  • Delivered
  • Errors

The number of rows displayed per page can be changed in Screen Options.


Manual Shipment Actions

Scan existing shipments

Use Scan existing shipments to find HayPost fulfillments that were created before the add-on was installed or activated.

Synchronize all

Use Synchronize all to queue all active HayPost shipments for an update.

Synchronize

Use Synchronize in the Shipments table to immediately update one shipment.


Tracking Settings

Tracking settings are available in:

WordPress Admin → PS Gateway → HayPost → Settings
SettingDescription
Automatic synchronizationPeriodically refresh active HayPost shipments
Update intervalChoose 15 minutes, 30 minutes, 1 hour, 3 hours, or 6 hours
Customer timelineShow HayPost progress and tracking events on the customer order page
Collapse older eventsKeep the newest events visible and place older events in an expandable section
Events shown to customers initiallyNumber of recent events shown before older events are collapsed

Important: WordPress cron runs when the website receives traffic. On low-traffic websites, scheduled updates may run later than the selected interval.


Delivery Tab

Domestic delivery tools are available in:

WordPress Admin → PS Gateway → HayPost → Delivery

The Delivery tab contains:

  • the latest delivery-data synchronization status
  • WooCommerce delivery-zone creation and updating
  • Sprint, Parcels, and Yerevan Express Service tariff tables
  • official and manually overridden tariff values

Tariff and Postal Code Sources

DataSourceUpdate method
Sprint tariffsHayPost APIAutomatic daily synchronization or manual synchronization
Parcels tariffsHayPost APIAutomatic daily synchronization or manual synchronization
Armenian postal codesHayPost APIAutomatic daily synchronization or manual synchronization
Yerevan Express Service (YES)Official HayPost tariff table bundled with the add-onUpdated through add-on releases or overridden manually
Manual tariffStore administratorSaved from the Delivery tab

HayPost does not currently expose YES prices through the delivery API. The add-on therefore includes the official home-delivery tariff table available when that add-on version was prepared. The table displays the date when the bundled data was verified.

Automatic synchronization never overwrites tariff rows that use the Manual source.

Synchronize tariffs and postal codes

Click Synchronize tariffs and postal codes to update Sprint, Parcels, and the Armenian postal code directory immediately. Checkout continues using the previous valid snapshot if HayPost is temporarily unavailable.


WooCommerce Delivery Zones

The add-on can create or update WooCommerce zones for Yerevan, Armenia’s ten regions, and an optional Armenia fallback zone.

  1. Open the Delivery tab
  2. Select the regions that should be created or updated
  3. Optionally select the Armenia fallback zone
  4. Click Create / update delivery zones
  5. Review the resulting order under WooCommerce → Settings → Shipping → Shipping zones

Regional zones use four-digit Armenian postal codes. The optional country-level fallback zone should remain after the regional zones because WooCommerce uses the first matching zone.

Updating a managed zone refreshes its postcode locations but preserves the zone name, zone order, shipping-method titles, enabled states, ordering, and instance settings changed by the store administrator.

If a managed zone is deleted directly in WooCommerce, it is shown as not created in the add-on and can be created again explicitly.


HayPost Shipping Methods

MethodAvailabilityDelivery time
HayPost Standard DeliverySelected Armenian delivery zones; Sprint and/or Parcels must be enabled1–3 days
Yerevan Express Service (YES)Eligible Yerevan postal codes only; packages up to 20 kgSame or next business day

Yerevan zones created by the add-on receive both Standard and YES methods. Other generated regional and fallback zones receive Standard only.

The methods are registered as separate native WooCommerce shipping methods. You can independently enable, disable, rename, and reorder them in each WooCommerce zone.

Plugins that apply conditions through the standard WooCommerce shipping-rate filters can normally target the two HayPost methods separately. This allows rules based on order amount, quantity, products, shipping classes, user roles, coupons, or other supported conditions. Compatibility still depends on the conditional-shipping plugin.


Delivery Pricing Settings

Shared delivery pricing is configured in:

WordPress Admin → PS Gateway → HayPost → Settings
SettingDescription
Automatic synchronizationSynchronize delivery tariffs and postal codes once per day through WordPress cron
Packaging weightAdded to the total product weight before tariff selection
Fixed markupAdded once to every HayPost delivery rate
Percentage markupCalculated from the base HayPost tariff
Price roundingRound to the nearest value, up, down, or do not round
Rounding stepUse an AMD increment of 10, 50, 100, or 500
Fallback costOptional Standard rate used only when synchronized tariffs cannot price the package

Final cost: HayPost tariff + fixed markup + percentage of the HayPost tariff. Rounding is applied last.

The fallback cost does not remove the YES postcode or 20 kg restrictions.


Customer Tracking Timeline

When the Customer timeline setting is enabled, synchronized HayPost information is displayed on the customer’s WooCommerce order page.

The timeline includes:

  • tracking number
  • link to the shipment on the HayPost website
  • visual delivery progress
  • latest tracking event
  • event location and country
  • event date and time
  • expandable earlier events

The timeline uses tracking data stored with the WooCommerce fulfillment. If HayPost is temporarily unavailable, the latest successfully synchronized information remains available.


WordPress Dashboard Widget

The add-on adds a compact HayPost Tracking widget to the WordPress Dashboard.

The widget shows:

  • license status
  • number of active shipments
  • number of synchronization errors
  • next automatic synchronization time

Use the Shipments and Settings links at the bottom of the widget to open the corresponding HayPost administration tab.


Shipment Status and Progress

HayPost tracking events are converted into a clear delivery progress indicator.

Depending on the available HayPost events, the shipment can progress through stages such as:

  1. Shipment accepted
  2. Processing or sorting
  3. In transit
  4. Arrived in Armenia or customs processing
  5. Sent to the delivery location
  6. Delivered

The exact event names and locations are provided by HayPost and may vary between shipments.


Token and License Protection

The HayPost Tracking Add-on requires an active token issued through PlanetStudio.

If the token is inactive or expired:

  • HayPost API requests are disabled
  • automatic synchronization is stopped
  • manual synchronization actions are disabled
  • the customer tracking timeline is not displayed
  • delivery-data synchronization and zone-management actions are disabled
  • HayPost checkout rates are unavailable

Cached shipment, tariff, postcode, and manual pricing information is preserved. Synchronization and checkout rates can continue after the token is activated again.


Troubleshooting

Shipment does not appear in the table

Check that:

  • the add-on token is active
  • the WooCommerce order has a fulfillment
  • the shipment provider is set to HayPost
  • a tracking number is saved in the fulfillment

Then open the Shipments tab and click Scan existing shipments.

Shipment is not updating automatically

Check that:

  • Automatic synchronization is enabled
  • the add-on token is active
  • WordPress cron is working
  • the website receives enough traffic to trigger scheduled tasks
  • the HayPost tracking service is available

You can also click Synchronize to test one shipment manually.

Customer timeline is not visible

Check that:

  • Customer timeline is enabled in the HayPost settings
  • the add-on token is active
  • the shipment has been synchronized at least once
  • HayPost returned tracking events for the tracking number

Synchronization error

The latest error is displayed in the Error column of the Shipments table.

Common reasons include:

  • invalid tracking number
  • shipment not found by HayPost
  • temporary HayPost service error
  • network connection problem
  • inactive or expired add-on token

HayPost delivery is not displayed at checkout

Check that:

  • the add-on token is active
  • the WooCommerce store currency is AMD
  • the destination country is Armenia
  • the customer entered a valid four-digit postal code
  • the matching WooCommerce zone contains an enabled HayPost method
  • Sprint or Parcels is enabled for Standard delivery
  • the stored tariff table can price the package weight or a fallback cost is configured

YES is not displayed

Check that YES is enabled in the Delivery tariff table, the destination postal code belongs to Yerevan, the Yerevan zone contains the YES method, and the package weight including packaging does not exceed 20 kg.

Tariffs or postal codes are not updating

Confirm that the token is active, WordPress cron is working, and the HayPost delivery service is available. Use Synchronize tariffs and postal codes for a manual test. The previous valid data remains active when a synchronization attempt fails.


Need Help?

If you need assistance please contact support:

Support
https://planetstudio.am/support/

Screenshots