Managing Your Channels

Order Status & Shipping Notifications

Once your Channel is up and running in KCC, shipping notifications (also known as order status updates) will be uploaded to your Channel roughly every 8/20 minutes providing the Don’t upload order status toggle is disabled on your channel Main / Setup page.

Once an imported order has been issued in KCC from within [Sales Invoice Manager], it will then be added to the next Shipping Notification synchronisation for the Channel in question.

Imported Orders

This tab lists all orders that have been brought down from your Channel. From here you can review and / or investigate any import errors. The orders tab is auto filtered by the channel setup that is loaded, but you can go into the filters and remove this filter to see all order across all channels.

When an order has been imported successfully, it has a SO (Depending on your prefix setup in [System Values]) Code and Customer defined against it.

When an order has failed to import, it will have an error detailing why KCC was unable to import it.

There are three actions available to users in this screen via the orange Grid Actions button:
  1. Ignore / Don’t Import
    1. This will mark any green-selected orders to be ignored by KCC for future imports.
  2. Retry Download
    1. This will force KCC to retry downloading the selected orders from the Channel, this would be required if an order failed to import due to an error on the channel such as an incorrect customer address. Retrying is a two-stage process and takes longer than usual to complete as the channel is asked to download the order details again from scratch.
  3. Retry Import
    1. KCC will try to reimport the selected orders using the existing data. This option should be used if you have corrected KCC to match the details on your channel for the stock items on an order such as an unknown stockcode that has been creacted in KCC. After using this option your order(s) should import within a couple of minutes.

Feedback

Tasks

This tab lists the various synchronisation tasks for the channel, listing the last date and time each of the tasks ran and flagging any communication errors.  If you experience a communication error that is flagged in the Tasks tab, please contact KCC Support for assistance. The orders download task will only show a valid recent date if has been successful in asking for and receiving orders from your channel. Therefore, it is a good indication of the channel’s synchronisation health.

Notifications

This tab highlights any high-level errors and / or notifications with regards to the Channel. The Details column on the grid will provide as much detail as possible with regards to the issue that has been experienced. The notification errors found here are more geared toward any issues communicating with the channel itself or attempting to get data into a compatible format in the first place.

Limitations (Amazon Only)

There are strict limitations on the Amazon MWS API that are beyond our control. Hitting these limits will often be presented as "Error downloading orders: Request is throttled" displayed in the channel feedback / notifications screen. This error should clear automatically given time to do so, however, if you repeatedly encounter this error please contact support@khaoscloud.com who will advise on the options available to you.

Orders

KCC requests 100 orders per page, this is the maximum number that Amazon will allow. This is for orders that have been updated since the last time KCC pulled orders down. Only orders which have a status of Unshipped, Partially Shipped or Shipped, or that are FbA, will be made available to KCC by the API. If KCC needs all 100 of those orders, then these will be downloaded. If there is another page of orders, KCC will then import the next 100 orders and will repeat this operation until it has imported all the orders. 

One page of 100 orders is equal to one request.

Amazon Order Limits

The maximum number of requests is 6 with each representing a 1 minute wait for additional requests, so if there are 6 requests at the same time, it will be 6 minutes before any more requests can be made. This limitation is important to remember if you have a high order volume, or are testing KCC whilst running your existing system in parallel as BOTH will be affected should the API limit be reached.

Order Items

For each order that KCC needs to import, KCC will use the order ref to get the information about the stock items on the order, this is one request. Again, the system can split this into multiple pages if there are a lot of items on the order.

Amazon Order Item Limits

The maximum number of requests is 30 with each request representing a wait of 2 seconds for further requests; so if there were 30 requests at the same time it will be 60 seconds before any more requests can be made. This limitation is important to remember if you have orders with lots of items on or are testing KCC whilst running your existing system in parallel as BOTH will be affected should the API limit be reached.


Did you find this article helpful?