Upgrade to Amazon SP API for Despatch Cloud v3.5

← Back

Introduction

Amazon has created a new Web Services API titled ‘Selling Partner API’ (SP) which will be superseding the previous Merchant Web Services (MWS) API. As the year has gone on, certain MWS services have been deprecated. The Orders endpoints of their API (or Order Info, Buy Shipping Labels and Order Fulfilment) are to be deprecated at the end of July 2022, meaning our previous Amazon integration(s) will no longer work. All MWS endpoints will be deprecated by the end of the year in favour of the new SP API.

Prerequisites

This is incredibly important!

The prerequisite below cannot and should not be skipped. Please read through thoroughly and ensure that no step has been missed before proceeding with Upgrading your Amazon Sales Channel(s) and/or your Amazon courier(s).

You must “disable” the current Amazon sales channel(s) before installing the new modal to prevent any more orders coming in via the old integration

You can disable Sales channels by going to Settings > Sales Channels > Amazon and then clicking Edit on the Amazon instance.

Once you have changed the active button please make sure that you Submit the changes in the bottom right hand corner of the modal.

Upgrading the Sales Channel

If you have an Amazon sales channel(s), then follow this step to upgrading the Amazon module(s) on your account. You will have to do this for each Amazon sales channel you have on your account.

First, click the Sales Channels title within Settings:

Within here, click on the Amazon SP tile (within time, “Amazon SP” will replace the “Amazon” tile).

To ensure only orders which need to be despatched by yourselves and are not Fulfilled by Amazon, we recommend setting Fulfilment Channels to just MFN. To ensure that no old orders are brought through and that the orders have in fact been paid for, we recommend that you set Order Statuses to only show Unshipped. There are other options such as Push Stock Levels, Download Product Images, however, these settings are entirely up to you and your own requirements.

Once you have completed the Credentials tab, please make sure that you set up standard Brand and Commercial Invoice details. Then Submit the changes in the bottom right hand corner of the modal.

Once created, you will be redirected to your newly created Amazon integration. We now need to connect the Amazon account to Despatch Cloud. Simply click the Connect icon to begin:

This will redirect you to an Amazon login page. If you don’t have a logged in Amazon session, you will be greeted with a login form. Once you login, you may be asked to select a marketplace. This is normally if you’re managing multiple Amazon Seller Central accounts with a single set of login credentials. Once you’ve selected your marketplace, you’ll be asked to grant Despatch Cloud access to your Amazon account:

* If the Amazon login state's CourierAPI instead of Despatch Cloud, please be assured that CourierAPI is a service built and supported by Despatch Cloud.

To allow Despatch Cloud access, click the checkbox highlighted in red above and click the confirm button in the bottom-right corner. Once confirmed, you’ll be redirected to another page confirming that your Amazon account has been linked successfully.

If you see this, your Amazon integration is complete and you can close the page. You now need to delete your old Amazon integration. Go back in Sales Channels and click ‘Amazon:

Once here, click the Trash Bin icon to remove the old Amazon integration from your account:

Everything is now done for your Amazon Sales Channels! If you require further assistance, please contact us by creating a support ticket.

Upgrading your Amazon Couriers

If you have Amazon Shipping or Amazon Buy Shipping then you must also upgrade the module(s) for those to the new Selling Partner API too. First, navigate to Settings > Courier Integrations

Within Courier Integrations, you’ll see a new courier titled ‘Amazon’.

Click the Amazon tile and a modal will appear asking you to authorise access. Click the blue Login with Courier button.

You’ll be redirected to another page. Click the Login with Amazon button to continue.

You will be redirected to an Amazon login page. Once you login, you’ll be asked to grant Despatch Cloud access to your Amazon account:

If the Amazon login state's CourierAPI instead of Despatch Cloud, please be assured that CourierAPI is a service built and supported by Despatch Cloud.

To allow Despatch Cloud access, click the checkbox highlighted in red above and click the confirm button in the bottom-right corner. Once confirmed, you’ll be redirected back to the previous page with the following modal:

If you’re integrating multiple new Amazon integrations to replace your previous Amazon Shipping or Amazon Buy Shipping, it is recommended that you specify an auth company. Remember this value (copy it to your clipboard). For example, in the supplied screenshot, we have specified Amazon UK as our auth company.

Click the Save button once done. A notification will appear highlighting that your authorisation request has been completed and that you can now close this window (tab).

When you return to the previous tab (your DC v3.5 account), you’ll notice that the contents on the modal have changed and now show different input fields. Here we can enter our Auth Company from the previous tab (if applicable). Once done, click the blue Save Changes button.

Once completed, click the Amazon tile again and click the Edit button.

This will take you to the Basic Settings of the courier module. First, set Active to Enabled and then press the Save Changes button.

Once Save Changes has been pressed, a few more tabs will appear in the top right of Despatch Cloud.

Under Add Services, create a Manual service titled Get Services and click the Add Service button. This will create the same service as the quote services for Amazon Buy Shipping and Amazon Shipping.

And your new Amazon courier integration is all set up. If you require further assistance, please contact us by creating a support ticket.