How To: Configure Amazon Logistics

Page approved.




WARNING icon
Configuring Amazon Logistics is an Advanced User feature.
Training must be completed before using Channel Listings.

Amazon Logistics enables UK local and regional delivery companies to deliver Amazon and non-Amazon parcels to customers seven days a week. Khaos Control has been modified to include an integration with Amazon Logistics, which can be used in order to acquire and set Delivery information against Sales Orders, such as Courier Services and Shipping Rates.

Overview

In Khaos Control, for any Courier Services mapped to a type of 'Amazon Logistics', the system will contact the Amazon Logistics API in order to acquire Shipping service and rate information. It will use this information to update the invoice associated with the Sales Order with the appropriate shipping service and shipping rate.

Once a Shipping Service and Rate has been obtained from Amazon using the Logistics API, the invoice associated with the Sales Order will be updated with the Courier Service information which has been retrieved. Khaos Control will match against the 'Courier Code' when updating invoices with Courier Service information retrieved from the Amazon Logistics API. Any Courier Services for which details will be returned by the API will need to be created as separate services within [ System Data | Couriers ] .

The system uses the existing [ System Data | Couriers ] and [ System Data | Channel Courier Mapping ] functionality to achieve this,

Notes:

  1. When requesting a list of available services for a Sales Order from Amazon Logistics, if there are multiple services available for a Sales Order, Khaos Control will choose the service with the lowest Rate.
  2. Where a Courier Code cannot be matched using the response information from the Amazon Logistics API, the Courier Service against the invoice for the Sales Order will not be populated.

KSS Options

KSS options must be configured for Amazon Logistics to work.

  1. Click on [ System Operations ] on the file menu at the top of the screen.
  2. In the Option File Tree select the File in bold.
  3. In the Sections pane, select the section [ CourierExport ].
  4. In the Values panel on the right:
    • AmzLog_DatePathFormat=YYYYMM (this is date format for file name tag $DATE)
    • AmzLog_LabelDir=$APP\CourierExport\AmzLog\Labels\$DATE (Where the label files should be saved to)
    • AmzLog_LabelPrintDirect=-1 (0 is default, should the label be printed directly to the printer or just saved)
    • AmzLog_LabelPrinterName= (which printer should be used for direct printing - for png files only!)
  5. Click OK to close the dialog.

System Data - Couriers

  1. Open a System Data screen (show me how).
  2. Open the [ System Data | Couriers ] screen.
  3. Press Alt+E or click the green triangle icon is the buttonbar's EDIT button to enter edit mode.
  4. Press F3 or click the NEW ITEM button has an icon that shows two sheets of paper (identified by having the top right corner folded down), arranged diagonally on the icon from top left to bottom right   to add a new item.
  5. Add a new courier service:
    1. ExportType: Amazon Logistics.
    2. Add an appropriate Code and ‘Service / Courier Name’.
    3. Right click on this courier and select ‘Configure …’.
      Note:
      • It is VERY important the courier is fully set up, Amazon rejects requests which it considers to be incomplete.
      • Dimensions MUST be set here, for example if Amazon allow you to ship up to 42 x 36 x 34 you would enter the values as 41.99 x 35.99 x 33.99 because this has to be a decimal value.
      • Amazon is very data sensitive. Valid Sender Address details should be specified.
      • The fields which can be left empty are:
        • Sender Address 2.
        • PDF Print Command (for printing PDFs if label is returned as PDF).

Courier Mapping

  1. Open a System Data screen (show me how).
  2. Open the [ System Data | Channel Courier Mapping ] screen.
  3. Press Alt+E or click the green triangle icon is the buttonbar's EDIT button to enter edit mode.
  4. Press F3 or click the NEW ITEM button has an icon that shows two sheets of paper (identified by having the top right corner folded down), arranged diagonally on the icon from top left to bottom right   to add a new item.
  5. Set up mappings for couriers chosen by Amazon, they will send you a pdf of the details. These are setup in the Channel Courier column and are one of the following:
    • Standard
    • Expedited
    • NextDay
    • SecondDay
      Note: these values can be found by opening the .cmp file sent from Amazon containing the Sales Order. This will have a <COURIER_DESC>. This value can be mapped to a Channel and Courier (set above) such that orders imported from Amazon, matching this Channel and Courier_Desc will have the Courier assigned to the Sales Order.
  6. Set 'Is Prime' as appropriate.
  7. Press Ctrl+S or click the disk icon is the button bar's SAVE button    to save.

MustArriveByDate

  1. Open a System Data screen (show me how).
  2. Open the [ System Data | Couriers ] screen.
  3. Press Alt+E or click the green triangle icon is the buttonbar's EDIT button to enter edit mode.
  4. Setup the couriers as per the instructions above.
  5. Right click on the courier and select Configure.
  6. Update the Send MustArriveByDate as appropriate.
    Courier MustArriveByDate option
  7. Press Ctrl+S or click the disk icon is the button bar's SAVE button    to save.

Note: to have more available services returned when using the Amazon Logistics courier, in particular for shipping to Wales, Scotland and Ireland, Amazon Technical Onboarding Support have advised not specifying the MustArriveByDate when calling GetEligibleShippingServices, therefore this option should be turned off.

See Also

Visit KhaosWikiX at https://support.khaoscontrol.com/wiki_kcx/ to see the following:

Contact the Khaos Team