VendorDirectFulfillmentOrders
- class sp_api.api.VendorDirectFulfillmentOrders(marketplace: 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)
VendorDirectFulfillmentOrders SP-API Client :link:
The Selling Partner API for Direct Fulfillment Orders provides programmatic access to a direct fulfillment vendor’s order data.
- get_orders(self, **kwargs) ApiResponse
Returns a list of purchase orders created during the time frame that you specify. You define the time frame using the createdAfter and createdBefore parameters. You must use both parameters. You can choose to get only the purchase order numbers by setting the includeDetails parameter to false. In that case, the operation returns a list of purchase order numbers. You can then call the getOrder operation to return the details of a specific order.
Usage Plans:
Rate (requests per second)
Burst
10
10
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
shipFromPartyId (key) – string | The vendor warehouse identifier for the fulfillment warehouse. If not specified, the result will contain orders for all warehouses.
status (key) – string | Returns only the purchase orders that match the specified status. If not specified, the result will contain orders that match any status.
limit (key) – integer | The limit to the number of purchase orders returned.
createdAfter (key) – string | * REQUIRED Purchase orders that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.
createdBefore (key) – string | * REQUIRED Purchase orders that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.
sortOrder (key) – string | Sort the list in ascending or descending order by order creation date.
nextToken (key) – string | Used for pagination when there are more orders than the specified result size limit. The token value is returned in the previous API call.
includeDetails (key) – string | When true, returns the complete purchase order details. Otherwise, only purchase order numbers are returned.
- Return type:
- get_order(self, purchaseOrderNumber, **kwargs) ApiResponse
Returns purchase order information for the purchaseOrderNumber that you specify.
Usage Plans:
Rate (requests per second)
Burst
10
10
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
purchaseOrderNumber – string | * REQUIRED The order identifier for the purchase order that you want. Formatting Notes: alpha-numeric code.
- Return type:
- submit_acknowledgement(self, **kwargs) ApiResponse
Submits acknowledgements for one or more purchase orders.
Usage Plans:
Rate (requests per second)
Burst
10
10
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.
- Parameters:
body –
{ “orderAcknowledgements”: [
- {
“purchaseOrderNumber”: “string”, “vendorOrderNumber”: “string”, “acknowledgementDate”: “2019-08-24T14:15:22Z”, “acknowledgementStatus”: {
”code”: “string”, “description”: “string”
}, “sellingParty”: {
”partyId”: “string”, “address”: {
”name”: “string”, “attention”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “county”: “string”, “district”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “taxInfo”: {
”taxRegistrationType”: “VAT”, “taxRegistrationNumber”: “string”, “taxRegistrationAddress”: {
”name”: “string”, “attention”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “county”: “string”, “district”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “taxRegistrationMessages”: “string”
}
}, “shipFromParty”: {
”partyId”: “string”, “address”: {
”name”: “string”, “attention”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “county”: “string”, “district”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “taxInfo”: {
”taxRegistrationType”: “VAT”, “taxRegistrationNumber”: “string”, “taxRegistrationAddress”: {
”name”: “string”, “attention”: “string”, “addressLine1”: “string”, “addressLine2”: “string”, “addressLine3”: “string”, “city”: “string”, “county”: “string”, “district”: “string”, “stateOrRegion”: “string”, “postalCode”: “string”, “countryCode”: “string”, “phone”: “string”
}, “taxRegistrationMessages”: “string”
}
}, “itemAcknowledgements”: [
- {
“itemSequenceNumber”: “string”, “buyerProductIdentifier”: “string”, “vendorProductIdentifier”: “string”, “acknowledgedQuantity”: {
”amount”: 0, “unitOfMeasure”: “Each”
}
}
]
}
]
} –
- Return type: