The following steps describe how to enter your Australia post account details in StarShipIT.
Before starting you need your:
- Australia post eParcel Account number
- Australia post API key
- Australia post API secret
You will need to enter your details, Lookup the MLID and Load you product codes.
1. Enter your API keys details in StarShipIT
- Go to Settings>Carrier>Add New> Australia Post
- Tick Enable Australia Post
- Complete Account Number, Authorisation key, and Password (API Secret)
- Click on Look-up to get you MLID
2. Load you product codes
Click on Load Products Form AusPost to load all your product codes from Australia post, if some of them are missing you need to contact Customer_connectivity@auspost.com.au and ask them to load your product codes.
NOTE: You should have an International and a Domestic default product code. This is the product code that will be automatically selected if your default carrier is Australia Post.
When this is the case the API should return this error message (i.e. key and password are valid, but services not turned on
"message": "Access to the requested resource is controlled by an API key and password. They API key and password supplied in the request does not authenticate or authorise you to use the resource. If you believe you are receiving this message in error, please contact your Account Manager or call Australia Post on 13 21 31."
There are a couple of other situations that also produce a 401 error, which may help you identify /distinguish between the cause of issues:
A request that has invalid key details will provide a different error message (i.e. invalid key and/or password):
"message": "The request failed authentication",
"error_name": "Unauthenticated request"
A key that is valid, but that is being used to access an account that it is not linked to will return this error (i.e. valid key, un-linked or invalid charge account number)
"message": "The API key and password used to authenticate this request cannot be used to transact on the charge account with account number 0001234567. If you believe you are receiving this message in error, please contact your Account Manager or call Australia Post on 13 21 31."