Aranova Couriers delivery vehicle

Aranova Couriers WooCommerce Plugin

Aranova Couriers WooCommerce Plugin Installation & Setup Guide

The Aranova Couriers WooCommerce plugin connects your online store to the Aranova Platform for live checkout rates, courier bookings, waybill downloads, customer shipment emails, manual shipping, and public parcel tracking.

Step 1: Install and Activate the Plugin

Install the plugin from your WordPress dashboard.

  1. Download the plugin ZIP file from here.
  2. In WordPress, go to Plugins > Add New.
  3. Click Upload Plugin and choose the downloaded ZIP file.
  4. Click Install Now, then click Activate.
  5. Make sure WooCommerce is installed and active before configuring shipping.

Step 2: Add Your API Key and Shipping Settings

After activation, open the new Aranova Couriers menu in the WordPress dashboard and complete the shipping settings.

  1. Enable Aranova Couriers.
  2. Enter your Aranova Couriers API Key.
  3. Choose whether to allow Auto Shipping at checkout.
  4. Choose whether to allow Manual Shipping from the WooCommerce order screen.
  5. Set your company courier collection address.
  6. Save your settings.

You can also choose a tracking page, add a percentage or fixed markup to courier quotes, and set fallback parcel dimensions for products that do not yet have weight or dimensions saved.

Aranova Couriers settings with API key, shipping modes, fallback parcels, and collection address

Step 3: Configure Fallback Parcels and Product Dimensions

For the most accurate shipping quotes, add weight and dimensions to your WooCommerce products.

  • Weight in kilograms.
  • Length in centimetres.
  • Width in centimetres.
  • Height in centimetres.

If a product is missing shipping data, the plugin uses fallback parcel values from the Aranova Couriers settings. The default fallback values are 40 cm length, 30 cm width, 30 cm height, and 1 kg weight.

Step 4: Show Live Aranova Rates at Checkout

When Auto Shipping is enabled, the plugin sends the customer delivery address and parcel details to the Aranova Platform during checkout. The returned courier services are displayed as WooCommerce shipping methods.

  1. Add Aranova Couriers to the relevant WooCommerce shipping zone if required by your store setup.
  2. Add a product to the cart and go to checkout.
  3. Enter a complete South African delivery address.
  4. Confirm that Aranova Couriers service options and prices appear under shipping.

If rates do not appear, check that the plugin is enabled, the API key is saved, Auto Shipping is enabled, and the checkout address is complete.

Step 5: Book a Courier From a WooCommerce Order

After a customer places an order with an Aranova Couriers shipping option, the WooCommerce order screen can book the courier delivery.

  1. Go to WooCommerce > Orders.
  2. Open the order that used an Aranova Couriers shipping rate.
  3. Click Book Aranova Courier Delivery.
  4. When booking succeeds, the tracking reference is saved on the order.
  5. The customer receives a shipment booking email with the tracking number and tracking page link when a tracking page is selected.

Once a shipment has been booked, the order screen can also show actions to download the Aranova waybill or cancel the courier booking.

WooCommerce order screen with Aranova courier booking, waybill, and cancellation actions

Step 6: Add Customer Tracking to Your Website (Optional)

The plugin includes a public tracking shortcode that can be placed on any WordPress page.

"aranova_tracking"

You can also customise the title and button text:

aranova_tracking title="Track your order" button_text="Track parcel"

  1. Create or edit a WordPress page for parcel tracking.
  2. Add the aranova_tracking shortcode.
  3. Go to Aranova Couriers > Shipping Settings.
  4. Select that page under Tracking Page so customer shipment emails link to it.

The tracking page shows tracking events, current status, waybill number, parcel references, service level, hub information, delivery contact details, and expected delivery details where available.

Public Aranova parcel tracking shortcode with timeline and shipment details

Step 7: Style Tracking and Test the API (Optional)

The Styling tab lets you adjust the public tracking shortcode without editing code.

  • Accent colour.
  • Tracking button text.
  • Tracking card background colour.
  • Tracking card text colour.
  • Tracking card roundness.

The admin page also includes an API test button for rates. Use it to confirm the API key works, inspect the request payload, and view the raw response returned by the Aranova Platform.

Aranova Couriers styling tab and API debug response in WordPress admin

What the Plugin Handles

Support

If you need help with your API key, account setup, or courier services, contact Aranova Couriers support.

Phone: 0861 995 048
Email: support@aranovacouriers.co.za