Amazon Shipping

ShipEngine now supports Amazon Shipping for the UK! This carrier integration works mostly the same as any other carrier in ShipEngine.

Amazon Shipping offers domestic shipping solutions for shipments originating in the UK. Amazon Shipping offers fast ground shipping, on time, seven days a week.

This guide provides developers an overview of shipping services that Amazon Shipping offers and the service codes that you will use to create Amazon Shipping shipments.

Connect Your Amazon Shipping Account

Our integration with Amazon Shipping must be configured in your ShipEngine Dashboard and cannot be configured programmatically.

For instructions on connecting Amazon Shipping via the ShipEngine dashboard, go to our Amazon Shipping help article.

By connecting a Amazon Shipping account, you and your users agree to the Amazon Shipping TOS.

Amazon Shipping UK Service Details

Service	Transit Time	Carrier Code	Service API Codes
ON Amazon Shipping Standard Tracked	5 - 8 days	econ-uk-mfn	`amazon_uk_econ`
ON Amazon Shipping One-Day Tracked	1 Business Day	prime-premium-uk-mfn	`amazon_uk_prime_prem`
OFF Amazon Shipping One Day	1 Business Day	SWA-UK-PREM	`amazon_uk_prem`
OFF Amazon Shipping Two Day	2 Business Days	SWA-UK-2D	`amazon_uk_2_day_off`
ON Amazon Shipping Two-Day Tracked	2 Business Days	std-uk-mfn	`amazon_uk_2_day_on`

Return Services

Return labels are supported for all of the available Amazon Shipping UK services.

Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Adding Shipment Insurance

Amazon Shipping supports adding insurance to your shipments. Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

Create an Amazon Shipping Label

When fulfilling a non-Amazon order, you can use Amazon Shipping to create a label in the same way as any other ShipEngine carrier. No additional fields are required.

When fulfilling an Amazon order, however, you will need to provide some additional data. Namely, you'll need to specify order_source_code: "amazon", as well as set the external_order_id and the asin of each item in the shipment.

Example Label Request & Response

Here's an example of how to create an Amazon Shipping label for an Amazon order.

POST /v1/labels

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
POST /v1/labels HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "shipment": {
    "carrier_id": "se-123456",
    "service_code": "amazon_shipping_standard",
    "order_source_code": "amazon",
    "external_order_id": "103-4795772-1364518",
    "items": [
      {
        "quantity": 1,
        "name": "Monopoly",
        "asin": "B00005N5PF",
        "external_order_id" : "114-2825781-8037847",
        "external_order_item_id" : "16902221730370"
      },
      {
        "quantity": 1,
        "name": "Chromecast",
        "asin": "B015UKRNGS",
        "external_order_id" : "114-2825781-8037847",
        "external_order_item_id" : "16902221730370"
      }
    ],
    "ship_date": "2019-04-04T05:00:00.000Z",
    "ship_from": {
      "name": "Stamps.com",
      "address_line1": "1990 E. Grand Ave.",
      "city_locality": "El Segundo",
      "state_province": "CA",
      "postal_code": "90245-5013",
      "country_code": "US",
      "phone": "1-800-608-2677"
    },
    "ship_to": {
      "name": "Jeff Bezos",
      "address_line1": "701 5th Ave",
      "city_locality": "Seattle",
      "state_province": "WA",
      "postal_code": "98104",
      "country_code": "US",
      "phone": "206-266-1000"
    },
    "packages": [
      {
        "weight": {
          "value": 2.5,
          "unit": "pound"
        },
        "dimensions": {
          "length": 24,
          "width": 10,
          "height": 3,
          "unit": "inch"
        }
      }
    ]
  }
}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
{
  "label_id": "se-123456",
  "status": "completed",
  "shipment_id": "se-202887313",
  "ship_date": "2019-04-04T05:00:00.000Z",
  "created_at": "2019-04-04T20:20:01.979Z",
  "shipment_cost": {
    "currency": "USD",
    "amount": 6.86
  },
  "insurance_cost": {
    "currency": "USD",
    "amount": 0.0
  },
  "tracking_number": "9405511899560441854156",
  "is_return_label": false,
  "is_international": false,
  "batch_id": "",
  "carrier_id": "se-123456",
  "service_code": "amazon_shipping_ground",
  "package_code": "package",
  "voided": false,
  "label_format": "pdf",
  "label_layout": "4x6",
  "trackable": false,
  "carrier_code": "amazon_shipping_us",
  "tracking_status": "unknown",
  "label_download": {
    "href": "https://api.shipengine.com/v1/downloads/aFbxNUVCZ0SDHHp-BmcKjA/testlabel-202887313.pdf"
  },
  "form_download": null,
  "insurance_claim": null,
  "packages": [
    {
      "package_code": "package",
      "weight": {
        "value": 2.5,
        "unit": "pound"
      },
      "dimensions": {
        "unit": "inch",
        "length": 24,
        "width": 10,
        "height": 3
      },
      "insured_value": {
        "currency": "usd",
        "amount": 0.00
      },
      "tracking_number": null,
      "label_messages": {
        "reference1": null,
        "reference2": null,
        "reference3": null
      }
    }
  ],
  "items": [
    {
      "quantity": 1,
      "name": "Monopoly",
      "asin": "B00005N5PF",
      "order_source_code": "amazon",
      "external_order_id": "103-4795772-1364518"
    },
    {
      "quantity": 1,
      "name": "Chromecast",
      "asin": "B015UKRNGS",
      "order_source_code": "amazon",
      "external_order_id": "103-4795772-1364518"
    }
  ]
}

Additional Notes about Amazon Shipping

Amazon Shipping UK does not currently support shipping to Northern Ireland.

You are now ready to create shipments using Amazon Shipping via ShipEngine!