HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Amazon Business Orders Use Case Guide

Retrieve and identify Amazon Business orders.

An Amazon Business order is an order where the buyer is a verified business buyer. You can use the isBusinessOrder attribute in the order object to distinguish between business and non-business orders. An Amazon Business order will have the isBusinessOrder attribute set to true.

The Orders API is used to retrieve orders created for the selling partner for whom the calls are being made. You can use the getOrders operation to get all the orders for the selling partner, then get all business orders by filtering with the isBusinessOrder attribute. You can use getOrderAddress to retrieve the shipping address and associated delivery preferences.

Tutorial: Get all Amazon Business orders

Learn how to get all your Amazon Business orders and identify them.

Prerequisites

To successfully complete this tutorial, you need:

Fetch orders for a selling partner and identify Amazon Business orders

Call the getOrders operation, passing the parameters you want to filter the result. The response is paginated. Use the NextToken attribute in subsequent calls to get the next batch of orders.

A successful response includes a payload object, which contains an Orders array of one or more orders, and optionally additional properties. An Amazon Business order will have the isBusinessOrder attribute set to true.

Response example

{
  "payload": {
    "Orders": [
      {
        "BuyerInfo": {},
        "AmazonOrderId": "902-5663548-0163068",
        "EarliestShipDate": "2023-01-02T08:00:00Z",
        "SalesChannel": "Amazon.com",
        "AutomatedShippingSettings": {
          "HasAutomatedShippingSettings": false
        },
        "OrderStatus": "Pending",
        "NumberOfItemsShipped": 0,
        "OrderType": "StandardOrder",
        "IsPremiumOrder": false,
        "IsPrime": false,
        "FulfillmentChannel": "MFN",
        "NumberOfItemsUnshipped": 1,
        "HasRegulatedItems": false,
        "IsReplacementOrder": "false",
        "IsSoldByAB": false,
        "LatestShipDate": "2023-01-03T07:59:59Z",
        "ShipServiceLevel": "Std US D2D Dom",
        "IsISPU": false,
        "MarketplaceId": "ATVPDKIKX0DER",
        "PurchaseDate": "2022-12-30T20:01:07Z",
        "IsAccessPointOrder": false,
        "IsBusinessOrder": true,
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2023-01-04T19:57:49Z",
        "ShipmentServiceLevelCategory": "Standard"
      },
      {
        "BuyerInfo": {},
        "AmazonOrderId": "902-3282686-9052650",
        "EarliestShipDate": "2022-10-14T07:00:00Z",
        "SalesChannel": "Amazon.com",
        "AutomatedShippingSettings": {
          "HasAutomatedShippingSettings": false
        },
        "OrderStatus": "Canceled",
        "NumberOfItemsShipped": 0,
        "OrderType": "StandardOrder",
        "IsPremiumOrder": false,
        "IsPrime": false,
        "FulfillmentChannel": "MFN",
        "NumberOfItemsUnshipped": 0,
        "HasRegulatedItems": false,
        "IsReplacementOrder": "false",
        "IsSoldByAB": false,
        "LatestShipDate": "2022-10-15T06:59:59Z",
        "ShipServiceLevel": "Std US D2D Dom",
        "IsISPU": false,
        "MarketplaceId": "ATVPDKIKX0DER",
        "PurchaseDate": "2022-10-13T08:53:57Z",
        "IsAccessPointOrder": false,
        "IsBusinessOrder": false,
        "OrderTotal": {
          "CurrencyCode": "USD",
          "Amount": "12.13"
        },
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2022-10-25T07:31:21Z",
        "ShipmentServiceLevelCategory": "Standard"
      }
    ],
    "NextToken": "9A+grgyHbZ6aJqJYLDm0ZAmQazDrhw3CjfZLM4uXhchUojdU4H46tsNI3HOI22PIxqXyQLkGMBs8VhF73Xgy+yXWMVizzhiaOZR31XSS2A6ihtsveF3jYQF2C+OrWLWlInTAy+XKVmRZBY+oaVuycxWu4fsY7GTeCx7ShGY9OykghJ+2Ki9vXqfQmOEx4uZaf2GLmUGyr9UGnxD0RJmrryegoU0IPZxXhi1SP6zE/wLAVWPoD6wzg73j3O8ab4IoMBO/reDY2s8hGWNNu3VwFU0hrIUQcumU7YYXwRo+g8JiIXlRXylzxduZ3sLNMwtcdxoH3Y2nWfyVkzb2pTkxaavNDfG6UytaVlcQwn/OKRi5RanugZwxmUYrj/A7uEu6kY1qVoni2ChKw4h6m/JgREdtrcnli9iATruOKKI89oh4YcsIg8cwXw==",
    "CreatedBefore": "2023-01-20T19:47:27Z"
  }
}

In this example, the first order in the Orders array has isBusinessOrder set to true, and the second order in the Orders array has the attribute set to false.

Tutorial: Get order details for an Amazon Business order

Learn how to get order details for a specific order.

Prerequisites

To successfully complete this tutorial, you need:

Get order details for an order ID

Call the getOrder operation with an order ID to get all the order details associated with an order.

A successful response includes the payload object, which contains the information for an order. The payload includes an IsBusinessOrder Boolean property. When true, the order is an Amazon Business order. Otherwise, the attribute is set to false.

Tutorial: Get delivery preferences for an Amazon Business order

Learn how to get delivery preferences for Amazon Business orders.

Step 1. Get the order IDs for Amazon Business orders

In order to get delivery preferences for an order, we need the order ID. Order IDs can be fetched from the GetOrders API as described in the Tutorial: How to get all Amazon Business orders. Any order ID returned with isBusinessOrder equal to true is an Amazon Business order.

Step 2. Get order address details for an Amazon Business order

The delivery preferences are associated with the shipping address. Call the getOrderAddress operation with an order ID to get all delivery preferences specified by the user for the shipping address. If no delivery preferences are specified by the customer for the address, the default business hours for the region are returned. Make sure that:

  • The order ID belongs to an Amazon Business order
  • The order was created after February 8, 2023

Note that the ShippingAddress is not returned for pending and cancelled orders today, and DeliveryPreferences are only available for Amazon Business orders.

Updated about 14 hours ago

OSZAR »