Create a Japan order providing neighbor details in delivery preferences

Learn how to create an order for Japan where the delivery preference is set to a designated neighbor if the recipient is not available at the destination address. This feature is only available for Amazon Japan store orders.

Prerequisites

To complete this tutorial, you need:

Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
The Amazon Fulfillment role assigned to your developer profile.
The Amazon Fulfillment role selected in the App registration page for your application.

Create a fulfillment order with neighbor delivery preferences

Call createOrder using the Far East endpoint. Set destination.dropOffLocation.type to FALLBACK_NEIGHBOR_DELIVERY and provide the neighbor's neighborName and houseNumber in the attributes object.

POST https://sellingpartnerapi-fe.amazon.com/fulfillment/outbound/2026-07-04/orders

{
  "orderId": "JP-NEIGHBOR-ORDER-001",
  "fulfillmentConfiguration": {
    "serviceLevel": { "serviceTiers": ["STANDARD"] },
    "action": "SHIP"
  },
  "origin": { "countryCode": "JP" },
  "destination": {
    "deliveryAddress": {
      "name": "Mary Major",
      "addressLine1": "1-8-1 Shimomeguro",
      "addressLine2": "Meguro-ku",
      "city": "Tokyo",
      "countryCode": "JP",
      "postalCode": "153-0064"
    },
    "dropOffLocation": {
      "type": "FALLBACK_NEIGHBOR_DELIVERY",
      "attributes": {
        "neighborName": "Frank Doe",
        "houseNumber": "142"
      }
    }
  },
  "lineItems": [{
    "lineItemId": "item-001",
    "product": { "productIdentifier": { "amazonSku": "SellerSKU12" } },
    "amount": { "unit": "EACHES", "value": "1.0" }
  }]
}