Create a Japan order with scheduled delivery and delivery time windows
Learn how to create orders for Japan with the scheduled delivery shipping option. This ship option is only available for Amazon Japan store orders.
Learn how to create orders for Japan with the scheduled delivery shipping option. This ship option 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.
Step 1. Get the fulfillment preview for scheduled delivery dates
Call getOrderPreview with fulfillmentConfiguration.serviceLevel.serviceTiers set to SCHEDULED.
POST https://sellingpartnerapi-fe.amazon.com/fulfillment/outbound/2026-07-04/previews
{
"fulfillmentConfiguration": {
"serviceLevel": { "serviceTiers": ["SCHEDULED"] }
},
"origin": { "countryCode": "JP" },
"destination": {
"deliveryAddress": {
"name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro",
"addressLine2": "Meguro-ku", "city": "Tokyo",
"countryCode": "JP", "postalCode": "153-0064"
}
},
"lineItems": [
{
"product": { "productIdentifier": { "amazonSku": "SellerSKU12" } },
"amount": { "unit": "EACHES", "value": "2.0" }
}
]
}
Step 2. Create a fulfillment order with the selected delivery window
Call createOrder using the deliveryInterval returned by the preview. Set fulfillmentConfiguration.serviceLevel.serviceTiers to SCHEDULED and pass the chosen fulfillmentConfiguration.serviceLevel.deliveryInterval. Supplying a window not returned by getOrderPreview returns an error. Call getOrderPreview again to get a current window.
POST https://sellingpartnerapi-fe.amazon.com/fulfillment/outbound/2026-07-04/orders
{
"orderId": "JP-SCHEDULED-001",
"fulfillmentConfiguration": {
"serviceLevel": {
"serviceTiers": ["SCHEDULED"],
"deliveryInterval": {
"startTime": "2026-07-20T10:00:00+09:00",
"endTime": "2026-07-20T12:00:00+09:00"
}
},
"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"
}
},
"lineItems": [{
"lineItemId": "item-001",
"product": { "productIdentifier": { "amazonSku": "SellerSKU12" } },
"amount": { "unit": "EACHES", "value": "1.0" }
}]
}
Step 3. Validate the order
Call getOrder and confirm that fulfillmentConfiguration.action is SHIP and status is PROCESSING.
Note
Shipping method service-level agreements vary by store. Refer to Seller Central for shipping method SLAs and MCF fees.
Updated 9 days ago