To be able to book return or 3rd party consignments using your DFE account through MachShip, you will need to set up a return or 3rd party DFE carrier account in the system.
To set up the account, you will need the return or 3rd party API keys. You can obtain the API key by applying through the Direct Freight portal under the Developer Centre option:
The key will then be sent through to you within 1-2 business days.
Once the Direct Freight team responds, you will need to fill out the following specific options.
Account Code - The account code would have been
provided to you when your account was set up.
Primary Reference Type:
For certain carriers, MachShip is
configured to utilise the internal reference known as the MachShip number
as reference one. This is done for carriers to ensure
1. Known reference for invoice reconciliation
2. Known reference for tracking
This may affect how you are currently working with a carrier
and as such if you wish to still use your reference please set the primary
reference type as
Customer Reference
Return Pickup Api Key - This will be provided by the direct
Freight IT Team once you apply through the developer centre as per instructions
above.
Authorised Contact Name - authorised contact person in pickup site
Authorised Contact Phone - authorised person's contact number in pickup site
Authorised Contact Email - authorised person's email address in pickup site
Site Indicator - Direct Freight Express will set up accounts against each sending site in one of two ways:
A
series of follower rate accounts off a parent account - If your
account is set up like this then the Site Indicator should
be set as the number assigned to that sending site.
Separate
accounts for each site. If your account is set up like this then the Site
Indicator needs to be set as 0.
Tracking API Key - This will be provided
by the Direct Freight IT team from the email above.
Consignment Prefix - The consignment prefix will
be your Account Code.
Reference Pools - Reference pools are utilised
by
MachShip in order to maintain a count on connote, manifest
and item numbers. The reference pool will ensure that each of those numbers is
unique to what we have sent to the carrier previously. More information can be
obtained on reference pools
here. Direct Freight Express requires the creation of just
1 reference pool, for the
Connote number. To create the reference pool select the Create
Carrier Reference Pool button at the bottom of the page.
If you are creating a new account then the Reference Pools
will be set to the following fields:
Pool Name - Set as DFE Connote Ref Pool
<Account Code>
Minimum Value - 1
Maximum Value - 9999999 (that is seven 9's)
Next Available Reference - 1
Cyclical - No
It will appear as below:

Once created it will appear in the drop-down as below:
Once the carrier account is completed and the ratecard is linked, you will be able to create consignments and generate return or third party jobs.