Set up Australia Post On Demand / StarTrack Courier

Australia Post’s integration with Starshipit allows you to use all of Starshipit's features including generation of packing slips and shipping labels, auto-correction of addresses, branded tracking and notifications and many more.

Australia Post and StarTrack Courier (part of AusPost) offer three types of on demand or same/next day courier services:

  • Australia Post On Demand
  • StarTrack Courier 2U2Day
  • StarTrack Courier Ad hoc

To set up any of these services, request your API credentials from the Australia Post developer centre.

Each of the services has different service codes.

1. Request your API key through the developer portal of Australia Post

Follow steps to generate an AusPost/StarTrack API key and secret.

Enter your Australia Post On Demand, StarTrack 2U2Day or StarTrak Ad hoc account number in the Australia Post On Demand field.

2. Enter your API details in Starshipit

  1. Open the Starshipit web portal
  2. Go to Settings > Courier > Add New Courier > AusPost On Demand
  3. Tick Enable AusPost On Demand
  4. Enter the information from the AusPost developer centre in the fields: Account no, API key and Password
  5. Set the pick-up time (this can be set as either a specific time or the time between the label printing and the pick-up, e.g. if I set an offset of 30 minutes and print the label at 14:00, the pick-up will be scheduled for 14:30)
  6. Tick Use API 

Courier Services and Service Codes

The only differences between Australia Post On Demand, StarTrack 2U2Day and StarTrack Ad hoc are the service codes to be set up, and how AusPost/StarTrack actually operate the services.

a. Australia Post On Demand Services

The services are:

  • NOW - Now
  • AFT - Afternoon
  • TON - Tonight
  • SAT - Saturday

Add each service in the courier settings page.

The services have different pick-up windows (when the parcels are picked up) from the printing windows (when the label can be generated in Starshipit).

Printing/booking windows for AusPost On Demand:

  • NOW - Mon-Fri until 14:00
  • AFT - Mon-Fri until 11:00
  • TON - Mon-Fri until 15:00
  • SAT - Sat until 11:00

When printing (which also books) beyond these times, the next possible pick-up date would need to be used.

Pick-up windows for AustPost On Demand:

  • NOW - Mon-Fri 08:00 to 15:00 per scheduled pick-up times or purely ad hoc on the same day
  • AFT - Mon-Fri until 12:00
  • TON - Mon-Fri until 16:00
  • SAT - Fri per nominated time, or Sat until 12:00

b. StarTrack 2U2Day Services

The services are:

  • 2USD - SameDay
  • 2UPM - Afternoon
  • 2UPBM - PM (Afternoon) Brisbane Multi-piece
  • 2UTW - Twilight
  • 2USA - Saturday

Add each service in the courier settings page.

The services have different pick-up windows (when the parcels are picked up) from the printing windows (when the label can be generated in Starshipit).

Printing/booking windows for StarTrack 2U2Day:

  • 2USD - Mon-Fri until 08:00
  • 2UPM - Mon-Fri until 11:00
  • 2UPBM - Identical to 2UPM
  • 2UTW - Mon-Fri until 15:00
  • 2USA - Sat until 11:00

When printing (which also books) beyond these times, the next possible pick-up date would need to be used.

Pick-up windows for StarTrack 2U2Day:

  • 2USD - Mon-Fri 08:00 to 09:00 per scheduled pick-up times
  • 2UPM - Mon-Fri 11:00 to 12:00 per scheduled pick-up times
  • 2UPBM - Identical to 2UPM (usually)
  • 2UTW - Mon-Fri 15:00 to 16:00 per scheduled pick-up times
  • 2USA - Sat 11:00 to 12:00 per scheduled pick-up times

c. StarTrack Ad hoc Services

The services are:

  • STC - Standard Courier (< 25 kg)
  • STW - Standard Wagon (< 125 kg)
  • STH - Standard Half Tonne Van (< 500 kg)
  • STV - Standard Full Tonne Van (< 1 tonne)
  • EXTC - Express Courier (< 25 kg)
  • EXTW - Express Wagon (< 125 kg)
  • EXTH - Express Half Tonne Van (< 500 kg)
  • EXTV - Express Full Tonne Van (< 1 tonne)
  • IMTC - Immediate Priority Courier (< 25 kg)
  • IMTW - Immediate Wagon (< 125 kg)
  • IMTH - Immediate Half Tonne Van (< 500 kg)
  • IMTV - Immediate Full Tonne Van (< 1 tonne)

Add each service in the courier settings page.

Printing/booking windows for StarTrack Ad hoc:

  • STC / STW / STH / STV - Mon-Fri until 16:00
  • EXTC / EXTW / EXTH / EXTV - Mon-Fri until 17:00
  • IMTC / IMTW / IMTH / IMTV - Mon-Fri until 18:00

Pick-up windows for StarTrack Ad hoc:

  • STC / STW / STH / STV - Mon-Fri: 08:00 to 16:00
  • EXTC / EXTW / EXTH / EXTV - Mon-Fri: 08:00 to 17:00
  • IMTC / IMTW / IMTH / IMTV - Mon-Fri: 08:00 to 18:00

 

Setting the pick-up date/time values

The following services REQUIRE a PICK-UP DATE (BUT NOT pick-up time):

  • AusPost On Demand AFT, TON, SAT
  • StarTrack non-Ad hoc

When printing with these services, if the stored pick-up date is in the past now, it is not used - in this case, TODAY is AUTOMATICALLY used (or the next possible Saturday, for Saturday services).

As long as the service's PRINTING/BOOKING WINDOW has NOT ended for the day (e.g. up to 11:00 for AFT), the print will succeed.

However, if the service's PRINTING/BOOKING WINDOW has passed for the day, an error is shown that you are outside the day's PRINTING/BOOKING window.

In this case, to be able to print, you must change the pick-up date to the NEXT VALID day. (The next VALID day might not be the next ACTUAL day, e.g. in the case of Sunday being the next day).

You can make this pick-up date change via the New Order page (in the options alongside the service, when you select it), or in Settings > Couriers > AusPost On Demand. Either way, the pick-up date is stored to the same setting field.


The following services REQUIRE a PICK-UP DATE and PICK-UP TIME:

  • AusPost On Demand NOW
  • StarTrak Ad hoc – any
  • [Zoom2u – any - see separate setup page about this]

There are two ways to set this:

  • As a fixed pick-up date/time
  • As an offset number of minutes from the time of printing/booking

 

IF the FIXED option is used:
When printing with these services, we default the pick-up date/time EXACTLY as per the stored setting.

As long as the pick-up date/time is NOT in the past AND the service's PRINTING/BOOKING WINDOW has NOT ended for the day (e.g. up to 14:00 for NOW), the print will succeed.

However, if the pick-up date/time is in the past OR the service's PRINTING/BOOKING WINDOW has passed for the day, an error is shown.

In this case, to be able to print, you must change the pick-up date/time to the NEXT VALID day. (The next VALID day might not be the next ACTUAL day, e.g. in the case of Sunday being the next day).

You can make this pick-up date/time change via the New Order page (in the options alongside the service, when you select it), or in Settings > Couriers > AusPost On Demand. Either way, the pick-up date/time is stored to the same setting fields.

In effect, you must set a current/future pick-up date/time at least once per day.


IF the OFFSET option is used:
When printing with these services, if the current time is MORE than offset minutes BEFORE the PICK-UP SERVICE WINDOW START TIME of the day, then that PICK-UP SERVICE WINDOW START TIME is used (e.g. if you have the offset as 10 minutes and print at 07:50 or EARLIER, then the pick-up time will be set to the PICK-UP SERVICE WINDOW START TIME of 08:00 for the NOW service).

Otherwise the current time PLUS the offset minutes is used as the pick-up time.

If the current time plus offset minutes is AFTER the PICK-UP SERVICE WINDOW END TIME (15:00 for the NOW service), an error is shown.

In this case, to be able to print, you must change the pick-up date/time to the NEXT VALID day.

 

Other relevant information for you:

To know more about Startrack Courier services by Australia Post, click here

For more information on APIs and their importance, click here

 

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.