OMS is now able to integrate with Australia Post.

Australia Post (AusPost) is a shipping company specifically for companies with fulfilment centres in Australia. AusPost are able to ship worldwide.

Similiar to the Royal Mail integration, order details will be sent to AusPost and a shipping label returned to the operator when an order has been fully consolidated via the OMS V2 Dispatch Scan Point.

Client Steps

The client must have registered with Australia Post and been provided with both an API key, a password and an account number.

AusPost may require the client to be set up in the testing system first. The client’s account will be upgraded from testing once the client is able to provide AusPost with an example shipping label and manifest document (which are both generated by OMS).

Service Code

AusPost has many different service codes (sometimes referred to by AusPost as product codes).

The correct service code may depend on various factors such as weight, destination or speed of delivery.

It is the client’s responsibility to provide their service code rules. A small amount of development time will be needed to add them to OMS.

For example, the client might decide to use service code ECM8 for international express orders.

Integration Settings

The AusPost integration can be enabled in V2 company settings.

Note that the From fields must be filled in with a valid AU address.

Address Validation

AusPost performs strict validation on domestic addresses (including the From address on the integration settings).

Therefore it is important that the address line rules are followed, i.e. OMS field shipping_address_5 must contain the Australian state and shipping_address_4 must contain a valid suburb of that state.

International orders are not subject to state and suburb checking.

In addition to address validation, AusPost requires a telephone number to be present on each order. Domestic numbers should be prefixed with a 0 and numbers for international orders must have the international calling code present at the start of the number (e.g. +65 for orders being shipped to Singapore).

State Mapping

OMS will attempt to map Australian state names to their short 2 or 3 character code using the below lookup table.

AusPost will reject the order if the state code is not valid.

State Code
New South Wales NSW
Queensland QLD
South Australia SA
Tasmania TAS
Victoria VIC
Western Australia WA
Australian Capital Territory ACT
Northern Territory NT

Parcel Value

For international orders, AusPost requires the value of the parcel to be specified for customs purposes.

OMS will try to calculate the value of an item based on the following rules:

  1. If the unit_sale_price item field is a non zero value, then it will be used. OMS assumes that the currency is AUD.

  2. Otherwise, OMS will try to calculate the value of the item from the corresponding CPP product:

    2a. OMS will first try to find a company specific tier price with currency AUD on the relevant product.

    2b. Otherwise, OMS will try to find a non company specific (“Default”) tier price with currency AUD on the relavent product.

  3. If a price cannot be determined then an error will be displayed.

Parcel Weight

AusPost requires a weight for each parcel and therefore it is required that any relavent CPP products have a weight set in their e-commerce data.

Manifest

The manifest (also know as an order summary) is a document which is required for when AusPost pick up the parcels from the fulfilment centre.

The manifest can be generated manually via Order Manager using the following steps:

  1. Go to https://oms.custom-gateway.net/v2/order-it/order-manager/#/
  2. Select the relevant primary company
  3. Click Advanced
  4. Select Australia Post from the Carrier dropdown
  5. A Manifest Shipments button should now appear.

The manifest is limited to 200 shipments at a time and would usually be generated every day.

It may take several seconds for the manifest to generate.