- Upload the plugin folder to the ‘/wp-content/plugins/’ directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- You will be prompted to install the Extensionworks Framework click on the link and install it.
- Activate the Extensionworks Framework
- Thats it – you can now configure the plugin.
ACTIVATE THE EXTENSION WORKS LICENCE KEY
To activate the ExtensionWorks Licence go to: Dashboard > ExtensionWorks Licences
All products require weight and dimensions.
Weight only shipping requires custom boxes( these will be used for the dimensions) and product weight. The custom box must have a maximum weight set up.
WooCommerce Australia Post eparcel requires you to be using Australian dollars (AUD) and Australia as your base country.
Enable/ Disable: Tick to enable to function.
Method Title: This displays the name of the shipping carrier.
Origin Postcode: This is where your shipping will start from. This needs to be the same as the Origin Post set up in your Australia Post eParcel account.
Method Availability: You can select specific Countries, or all Countries.
Debug mode: Used for testing the product.
Order limit: Set up a dollar spend amount. Order limit- 50, 100, this is your choice, once this amount is reached at the cart/ checkout the free shipping option will be available to select.
Free Delivery text: This is the text the Free Shipping option will display on the frontend.
Handling Fee or Discount fee: You can add or subtract an amount form your shipping rate. Enter amount +2.50 or -2.50, you can also add +2% or -2%
Letter Mail Setting
Packing letter Mail together with Parcel- this will allow you to pack the products that have been selected to ship as a letter into the boxes for parcel mail.
Packing letter mail Separately-this will allow the letter to be packed individually and not combined into the parcel mail boxes.
Un-packable Products Setting
Send un-packable products directly: Products that do not fit into any custom boxes, the product dimensions will be sent to the Shipping Carrier (API) to determine a rate.
Remove un-packable products: The products that do not fit into any custom boxes will not have a shipping rate returned from the shipping carrier.
Terminate calculate Process: There are no custom boxes (set up in the admin area) to calculate a shipping rate, the API request will be terminated. No rate will be returned from the Shipping Carrier.
Parcel Packing Method
To use a certain custom box for your shipping you will need to Tick the option: Select Box for the custom box you would like to use.
If your shipping Companies offers Predefined boxes they will already be pre-populated in the custom box area. You will need to Select the predefined boxes you would like to use.
Adding a custom box please enter the following:
- Outer Length, Outer Width, Outer Height
- Inner Length, Inner Width, Inner Height
- Box Weight
- Maximum Weight
- Weight ( tick if only shipping with weight only)
- Letter ( tick if you would like to use as a letter option)
Save you settings. Very Important.
Then go and Select the custom boxes you would like to use. Tick the selected options.
Save your Settings
Tick enable customize shipping methods.
Services: Enable the shipping services you wish to offer your customers.
We have set up some of the shipping services that are offered to Australia Post eParcel account holders.
These services may not be the same for you, please reach out to ExtensionWorks and we can add in your services and service codes applicable to you.
You can find your services listed in your Australia Post eParcel account.
Go here: https://online.auspost.com.au/eParcel/common/auth/login.do
and log in.
Go to Administration > Contract Information > Price Schedule Details
Select shipping rate to display: All, Cheapest Rate, Highest Rate.
Select shipping order to display: None, From low to high or From high to low.
Fallback Name: The Label for the Fallback Price offered.
Fallback: If the shipping method returns no matching rates, offer this amount for the shipping so the customer can still checkout. Leave blank to disable.
Test Mode: Tick this option to enable test mode. Test mode requires eParcel account test credentials.
Test mode requires a Test API Key, Test Password and Test Account number, ( these will be provide to you)
API Key: Add in your API key.
Password: Add in your Australia Post Developer Centre Password.
Account Number: Add in your Australia Post eParcel, Charge Account No, must be 10 digits, you may need to add 000 to the beginning, example: 0001236798
Your Charge Account No can be found here: https://online.auspost.com.au/eParcel/merchant/auth/ViewContract.do
No rates are being calculated
Check that the Origin post code is the same as what is set up in your Australia Post eParcel account.
First, check your products have dimensions and weights set – without this, the calculation cannot be performed. Secondly, check your store’s base country is Australia and that you are using Australia Dollars (AUD) (from WooCommerce > Settings > General).
Test mode uses the Australia Post, Testbed API URL, the Testbed has different 'Service Codes and Names' than what your live account may have, we changed the service codes to reflect a live environment. You may not be able to receive any shipping rates in test mode.
Service Code: E34 - EXPRESS POST
Service Code: T28S - PARCEL POST W/SIGNATURE
Service Code: E34S - EXPRESS POST W/SIGNATURE
The plugin needs to be able to talk to Australia Post’s eParcel API.
For this it uses wp_remote_post which makes use of fsockopen/CURL.
The box packer is volume based. This will in most cases provide good results, but will never be as accurate as a real person packing a box (see BIN Packing Problem) therefore it is important you understand that packing results are as accurate as they can be and any anomalies should be accepted.