=== Australia Couriers for WooCommerce ===
Contributors: catcodestudio
Tags: australia post, startrack, shipping, eparcel, shipping labels
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 11.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Australia Post and StarTrack for WooCommerce: live prices at checkout, shipments, labels, the daily manifest and tracking for the buyer.

== Description ==

Ship with Australia Post and StarTrack from the WooCommerce order screen. Retail prices come from the free Australia Post postage calculator. With an Australia Post eParcel or StarTrack contract, the plugin uses your own Shipping and Tracking API key for contract prices, shipments, labels, the order summary (manifest) and tracking.

Australia Post and StarTrack are third-party services. This is an independent integration, not affiliated with or endorsed by them.

**Free**

* Two delivery methods for your shipping zones: Australia Post and StarTrack.
* Australia Post: Parcel Post and Express Post inside Australia, International Standard, Express, Economy Air and Courier abroad. Each service the carrier offers for the parcel becomes a choice at checkout, on the classic and the block checkout.
* Retail prices with a free postage calculator key, or your eParcel contract prices for Parcel Post and Express Post. Delivery estimate in business days, signature on delivery priced in.
* StarTrack Road Express, Premium and Fixed Price Premium at your contract prices.
* A parcel the carrier refuses (too heavy, too long, unknown postcode) shows no price. When the API does not answer, the fixed price takes over, so the checkout keeps working.
* Free from an order amount or with a free-shipping coupon, weight limit.
* Shipment from the order screen: service, weight, box size and authority to leave can be changed for each order. PDF label (A4 or label printer), deleting a shipment before it is lodged.
* Despatch page: put the day's shipments into one carrier order and print the order summary (manifest) for the driver or the post office.
* Tracking status on the order, and the tracking link for the buyer in the order, on the account page and in the emails.
* A tracking number added by hand, for parcels sent from MyPost Business or the post office.

**Pro** (7-day free trial from the settings page)

* Bulk actions in the orders list: shipments, one PDF with all labels, lodging the carrier order.
* Shipments created automatically when an order reaches the status you choose.
* Hourly tracking sync with order notes and automatic completion on delivery.
* Price rules at checkout: markup, rounding, only the cheapest service.
* Extra cover (transit cover on contracts) for the cart value, at checkout and on shipments.
* StarTrack pickup booking from the despatch page.

== Installation ==

1. Install and activate WooCommerce and this plugin.
2. Open WooCommerce → Australia Couriers. Enter the postage calculator key and the sender address; with a contract, also the Shipping and Tracking API key, password and account numbers. Save and check the connection.
3. Add the Australia Post and StarTrack methods to your shipping zones in WooCommerce → Settings → Shipping and choose the services.
4. Open an order and create the shipment in the Australia Couriers box. Lodge the day's shipments in WooCommerce → AU despatch.

== Frequently Asked Questions ==

= Do I need a contract with Australia Post? =

Not for prices: retail prices need only the free postage calculator key from the Australia Post Developer Centre. Shipments, labels, the order summary and tracking go through the Shipping and Tracking API, which Australia Post gives to eParcel and StarTrack contract customers.

= How do I get the Shipping and Tracking API key? =

In the Australia Post Developer Centre, as the account holder. Australia Post sends the test bed details first; the production key follows after Australia Post checks your integration. Choose the test bed in the settings and enter the URL from your welcome pack while you test.

= Where do the contract product ids come from? =

The account check in the settings reads your contract and fills in the Parcel Post and Express Post product ids when they are empty. You can also type them in.

= Can I ship international parcels from the plugin? =

The checkout shows international retail prices. Send international parcels from your Australia Post account and add the tracking number to the order by hand: the buyer gets the tracking link.

= When does the carrier bill a shipment? =

When it is lodged in a carrier order. Until then a shipment can be deleted from the order screen.

= Which currency? =

Australian dollars. In a shop with another currency the methods use their fixed price.

== External services ==

The plugin connects only to the services the shop owner sets up, and only for the actions below.

**Australia Post Postage Assessment Calculator** (digitalapi.auspost.com.au/postage).

* At checkout: the sender and receiver postcodes (or the destination country), the weight and box size of the cart, and with extra cover the cart value, are sent to get prices.

**Australia Post Shipping and Tracking API**, for Australia Post and StarTrack accounts (digitalapi.auspost.com.au/shipping, or the test bed address the shop owner enters).

* In the settings: the account number is sent to read the account and the products on the contract.
* At checkout, with contract prices: the sender and receiver suburb, state and postcode, the weight and box size of the cart are sent to get prices.
* When the shop creates a shipment: the buyer's name, company, address, phone number and email address, the order number, product SKUs, the parcel weight and size, and the sender address are sent to create the shipment.
* For labels, the carrier order, tracking and deleting a shipment: the shipment ids, the tracking numbers or the carrier order id are sent.
* Pro, StarTrack pickup: the sender address and contact, the date, time and parcel count are sent to book the pickup.

The tracking link for the buyer opens auspost.com.au.

Terms: https://auspost.com.au/terms-conditions StarTrack terms: https://auspost.com.au/terms-conditions/startrack-terms-and-conditions Privacy: https://auspost.com.au/privacy

The Pro license check connects to catcode.com.ua and sends the license key and the site address.

== Changelog ==

= 1.0.0 =
* First version: Australia Post and StarTrack, retail and contract prices on the classic and the block checkout, shipments, labels, carrier order and summary, tracking; Pro bulk actions, automatic shipments, hourly tracking, price rules, extra cover, StarTrack pickups.
