FulfillmentOutbound
- class sp_api.api.FulfillmentOutbound(marketplace: ~sp_api.base.marketplaces.Marketplaces = Marketplaces.US, *, refresh_token=None, account='default', credentials=None, restricted_data_token=None, proxies=None, verify=True, timeout=None, version=None, credential_providers=None, auth_token_client_class=<class 'sp_api.auth.access_token_client.AccessTokenClient'>)
FulfillmentOutbound SP-API Client :link:
The Selling Partner API for Fulfillment Outbound lets you create applications that help a seller fulfill Multi-Channel Fulfillment orders using their inventory in Amazon’s fulfillment network. You can get information on both potential and existing fulfillment orders.
- get_fulfillment_preview(self, **kwargs) ApiResponse
Returns a list of fulfillment order previews based on shipping criteria that you specify.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
Examples
literal blocks:
{ "marketplaceId": "string", "address": { "name": "string", "addressLine1": "string", "addressLine2": "string", "addressLine3": "string", "city": "string", "districtOrCounty": "string", "stateOrRegion": "string", "postalCode": "string", "countryCode": "string", "phone": "string" }, "items": [ { "sellerSku": "string", "quantity": 0, "perUnitDeclaredValue": { "currencyCode": "string", "value": "string" }, "sellerFulfillmentOrderItemId": "string" } ], "shippingSpeedCategories": [ "Standard" ], "includeCODFulfillmentPreview": true, "includeDeliveryWindows": true, "featureConstraints": [ { "featureName": "string", "featureFulfillmentPolicy": "Required" } ] }
- Parameters:
body –
{ “marketplaceId”: “string”, “address”: {
”name”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “districtOrCounty”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “items”: [
- {
“sellerSku”: “string”, “quantity”: 0, “perUnitDeclaredValue”: {
”currencyCode”: “string”, “value”: “string”
}, “sellerFulfillmentOrderItemId”: “string”
}
], “shippingSpeedCategories”: [
”Standard”
], “includeCODFulfillmentPreview”: true, “includeDeliveryWindows”: true, “featureConstraints”: [
- {
“featureName”: “string”, “featureFulfillmentPolicy”: “Required”
}
]
}
- Return type:
- list_all_fulfillment_orders(self, **kwargs) ApiResponse
Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next token parameter.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
queryStartDate (key) – string | A date used to select fulfillment orders that were last updated after (or at) a specified time. An update is defined as any change in fulfillment order status, including the creation of a new fulfillment order.
nextToken (key) – string | A string token returned in the response to your previous request.
- Return type:
- create_fulfillment_order(self, **kwargs) ApiResponse
Requests that Amazon ship items from the seller’s inventory in Amazon’s fulfillment network to a destination address.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
Examples
literal blocks:
{ "marketplaceId": "string", "sellerFulfillmentOrderId": "string", "displayableOrderId": "string", "displayableOrderDate": "2019-08-24T14:15:22Z", "displayableOrderComment": "string", "shippingSpeedCategory": "Standard", "deliveryWindow": { "startDate": "2019-08-24T14:15:22Z", "endDate": "2019-08-24T14:15:22Z" }, "destinationAddress": { "name": "string", "addressLine1": "string", "addressLine2": "string", "addressLine3": "string", "city": "string", "districtOrCounty": "string", "stateOrRegion": "string", "postalCode": "string", "countryCode": "string", "phone": "string" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillOrKill", "codSettings": { "isCodRequired": true, "codCharge": { "currencyCode": "string", "value": "string" }, "codChargeTax": { "currencyCode": "string", "value": "string" }, "shippingCharge": { "currencyCode": "string", "value": "string" }, "shippingChargeTax": { "currencyCode": "string", "value": "string" } }, "shipFromCountryCode": "string", "notificationEmails": [ "string" ], "featureConstraints": [ { "featureName": "string", "featureFulfillmentPolicy": "Required" } ], "items": [ { "sellerSku": "string", "sellerFulfillmentOrderItemId": "string", "quantity": 0, "giftMessage": "string", "displayableComment": "string", "fulfillmentNetworkSku": "string", "perUnitDeclaredValue": { "currencyCode": "string", "value": "string" }, "perUnitPrice": { "currencyCode": "string", "value": "string" }, "perUnitTax": { "currencyCode": "string", "value": "string" } } ] }
- Parameters:
body –
{ “marketplaceId”: “string”, “sellerFulfillmentOrderId”: “string”, “displayableOrderId”: “string”, “displayableOrderDate”: “2019-08-24T14:15:22Z”, “displayableOrderComment”: “string”, “shippingSpeedCategory”: “Standard”, “deliveryWindow”: {
”startDate”: “2019-08-24T14:15:22Z”, “endDate”: “2019-08-24T14:15:22Z”
}, “destinationAddress”: {
”name”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “districtOrCounty”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “fulfillmentAction”: “Ship”, “fulfillmentPolicy”: “FillOrKill”, “codSettings”: {
”isCodRequired”: true, “codCharge”: {
”currencyCode”: “string”, “value”: “string”
}, “codChargeTax”: {
”currencyCode”: “string”, “value”: “string”
}, “shippingCharge”: {
”currencyCode”: “string”, “value”: “string”
}, “shippingChargeTax”: {
”currencyCode”: “string”, “value”: “string”
}
}, “shipFromCountryCode”: “string”, “notificationEmails”: [
”string”
], “featureConstraints”: [
- {
“featureName”: “string”, “featureFulfillmentPolicy”: “Required”
}
], “items”: [
- {
“sellerSku”: “string”, “sellerFulfillmentOrderItemId”: “string”, “quantity”: 0, “giftMessage”: “string”, “displayableComment”: “string”, “fulfillmentNetworkSku”: “string”, “perUnitDeclaredValue”: {
”currencyCode”: “string”, “value”: “string”
}, “perUnitPrice”: {
”currencyCode”: “string”, “value”: “string”
}, “perUnitTax”: {
”currencyCode”: “string”, “value”: “string”
}
}
]
}
- Return type:
- get_package_tracking_details(self, **kwargs) ApiResponse
Returns delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment order.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
packageNumber (key) – integer | * REQUIRED The unencrypted package identifier returned by the getFulfillmentOrder operation.
- Return type:
- list_return_reason_codes(self, **kwargs) ApiResponse
Returns a list of return reason codes for a seller SKU in a given marketplace.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
sellerSku (key) – string | * REQUIRED The seller SKU for which return reason codes are required.
marketplaceId (key) – string | The marketplace for which the seller wants return reason codes.
sellerFulfillmentOrderId (key) – string | The identifier assigned to the item by the seller when the fulfillment order was created. The service uses this value to determine the marketplace for which the seller wants return reason codes.
language (key) – string | * REQUIRED The language that the TranslatedDescription property of the ReasonCodeDetails response object should be translated into.
- Return type:
- create_fulfillment_return(self, sellerFulfillmentOrderId, **kwargs) ApiResponse
Creates a fulfillment return.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
Examples
literal blocks:
{ "items": [ { "sellerReturnItemId": "string", "sellerFulfillmentOrderItemId": "string", "amazonShipmentId": "string", "returnReasonCode": "string", "returnComment": "string" } ] }
- Parameters:
sellerFulfillmentOrderId – string | * REQUIRED An identifier assigned by the seller to the fulfillment order at the time it was created. The seller uses their own records to find the correct SellerFulfillmentOrderId value based on the buyer’s request to return items.
body –
{ “items”: [
- {
“sellerReturnItemId”: “string”, “sellerFulfillmentOrderItemId”: “string”, “amazonShipmentId”: “string”, “returnReasonCode”: “string”, “returnComment”: “string”
}
]
} –
- Returns:
ApiResponse:
- get_fulfillment_order(self, sellerFulfillmentOrderId, **kwargs) ApiResponse
Returns the fulfillment order indicated by the specified order identifier.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
sellerFulfillmentOrderId – string | * REQUIRED The identifier assigned to the item by the seller when the fulfillment order was created.
- Return type:
- update_fulfillment_order(self, sellerFulfillmentOrderId, **kwargs) ApiResponse
Updates and/or requests shipment for a fulfillment order with an order hold on it.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
Examples
literal blocks:
{ "marketplaceId": "string", "displayableOrderId": "string", "displayableOrderDate": "2019-08-24T14:15:22Z", "displayableOrderComment": "string", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "string", "addressLine1": "string", "addressLine2": "string", "addressLine3": "string", "city": "string", "districtOrCounty": "string", "stateOrRegion": "string", "postalCode": "string", "countryCode": "string", "phone": "string" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillOrKill", "shipFromCountryCode": "string", "notificationEmails": [ "string" ], "featureConstraints": [ { "featureName": "string", "featureFulfillmentPolicy": "Required" } ], "items": [ { "sellerSku": "string", "sellerFulfillmentOrderItemId": "string", "quantity": 0, "giftMessage": "string", "displayableComment": "string", "fulfillmentNetworkSku": "string", "orderItemDisposition": "string", "perUnitDeclaredValue": { "currencyCode": "string", "value": "string" }, "perUnitPrice": { "currencyCode": "string", "value": "string" }, "perUnitTax": { "currencyCode": "string", "value": "string" } } ] }
- Parameters:
sellerFulfillmentOrderId – string | * REQUIRED The identifier assigned to the item by the seller when the fulfillment order was created.
body –
{ “marketplaceId”: “string”, “displayableOrderId”: “string”, “displayableOrderDate”: “2019-08-24T14:15:22Z”, “displayableOrderComment”: “string”, “shippingSpeedCategory”: “Standard”, “destinationAddress”: {
”name”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “districtOrCounty”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “fulfillmentAction”: “Ship”, “fulfillmentPolicy”: “FillOrKill”, “shipFromCountryCode”: “string”, “notificationEmails”: [
”string”
], “featureConstraints”: [
- {
“featureName”: “string”, “featureFulfillmentPolicy”: “Required”
}
], “items”: [
- {
“sellerSku”: “string”, “sellerFulfillmentOrderItemId”: “string”, “quantity”: 0, “giftMessage”: “string”, “displayableComment”: “string”, “fulfillmentNetworkSku”: “string”, “orderItemDisposition”: “string”, “perUnitDeclaredValue”: {
”currencyCode”: “string”, “value”: “string”
}, “perUnitPrice”: {
”currencyCode”: “string”, “value”: “string”
}, “perUnitTax”: {
”currencyCode”: “string”, “value”: “string”
}
}
]
}
- Return type:
- cancel_fulfillment_order(self, sellerFulfillmentOrderId, **kwargs) ApiResponse
Requests that Amazon stop attempting to fulfill the fulfillment order indicated by the specified order identifier.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
sellerFulfillmentOrderId – string | * REQUIRED The identifier assigned to the item by the seller when the fulfillment order was created.
- Return type:
- get_features(self, **kwargs) ApiResponse
Returns a list of features available for Multi-Channel Fulfillment orders in the marketplace you specify, and whether the seller for which you made the call is enrolled for each feature.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
marketplaceId (key) – string | * REQUIRED The marketplace for which to return the list of features.
- Return type:
- get_feature_inventory(self, featureName, **kwargs) ApiResponse
Returns a list of inventory items that are eligible for the fulfillment feature you specify.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
marketplaceId (key) – string | * REQUIRED The marketplace for which to return a list of the inventory that is eligible for the specified feature.
featureName – string | * REQUIRED The name of the feature for which to return a list of eligible inventory.
nextToken (key) – string | A string token returned in the response to your previous request that is used to return the next response page. A value of null will return the first page.
- Return type:
- get_feature_s_k_u(self, featureName, **kwargs) ApiResponse
Returns the number of items with the sellerSKU you specify that can have orders fulfilled using the specified feature. Note that if the sellerSKU isn’t eligible, the response will contain an empty skuInfo object.
Usage Plan:
Rate (requests per second)
Burst
2
30
For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
marketplaceId (key) – string | * REQUIRED The marketplace for which to return the count.
featureName – string | * REQUIRED The name of the feature.
sellerSku – string | * REQUIRED Used to identify an item in the given marketplace. SellerSKU is qualified by the seller’s SellerId, which is included with every operation that you submit.
- Return type: