Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28 reference

Programmatic access to Vendor or Direct Fulfillment sandbox test data.

Overview

The Selling Partner API for Vendor Direct Fulfillment Sandbox Test Data provides programmatic access to vendor direct fulfillment sandbox test data.

Version information

Version : 2021-10-28

Contact information

Contact : Selling Partner API Developer Support

Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html

License information

License : Apache License 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0

URI scheme

Host : sandbox.sellingpartnerapi-na.amazon.com
Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Operations

generateOrderScenarios
getOrderScenarios

Paths

POST /vendor/directFulfillment/sandbox/2021-10-28/orders

Operation: generateOrderScenarios

Description

Submits a request to generate test order data for Vendor Direct Fulfillment API entities.

Parameters

TypeNameDescriptionSchema
Bodybody
required
The request body for the generateOrderScenarios operation.GenerateOrderScenarioRequest

Responses

HTTP CodeDescriptionSchema
202Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
TransactionReference
415The request payload is in an unsupported format.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList

For additional error status codes, descriptions and schemas, see Error responses and schemas.

GET /vendor/directFulfillment/sandbox/2021-10-28/transactions/{transactionId}

Operation: getOrderScenarios

Description

Returns the status of the transaction indicated by the specified transactionId. If the transaction was successful, also returns the requested test order data.

Parameters

TypeNameDescriptionSchema
PathtransactionId
required
The transaction identifier returned in the response to the generateOrderScenarios operation.string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
TransactionStatus
415The request payload is in an unsupported format.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ErrorList

For additional error status codes, descriptions and schemas, see Error responses and schemas.

Error Responses and Schemas

This table contains HTTP status codes and associated information for error responses.

HTTP CodeDescriptionSchema
400Request has missing or invalid parameters and cannot be parsed.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string):Unique request reference identifier.
ErrorList
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string):Unique request reference identifier.
ErrorList
403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers:
x-amzn-RequestId (string):Unique request reference identifier.
ErrorList
404The resource specified does not exist.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string):Unique request reference identifier.
ErrorList
413The request size exceeded the maximum accepted size.
Headers:
x-amzn-RequestId (string):Unique request reference identifier.
ErrorList

Definitions

GenerateOrderScenarioRequest

The request body for the generateOrderScenarios operation.

NameDescriptionSchema
orders
optional
The list of test orders requested as indicated by party identifiers.< OrderScenarioRequest > array

OrderScenarioRequest

The party identifiers required to generate the test data.

NameDescriptionSchema
sellingParty
required
The identifier of the selling party or vendor.PartyIdentification
shipFromParty
required
The warehouse code of the vendor.PartyIdentification

PartyIdentification

The identification object for the party information. For example, warehouse code or vendor code. Please refer to specific party for more details.

NameDescriptionSchema
partyId
required
Assigned identification for the party. For example, warehouse code or vendor code. Please refer to specific party for more details.string

TransactionReference

A GUID assigned by Amazon to identify this transaction.

NameSchema
transactionId
optional
string

TransactionStatus

The payload for the getOrderScenarios operation.

NameDescriptionSchema
transactionStatus
optional
The transaction details including the status. If the transaction was successful, also includes the requested test order data.Transaction

Transaction

The transaction details including the status. If the transaction was successful, also includes the requested test order data.

NameDescriptionSchema
transactionId
required
The unique identifier returned in the response to the generateOrderScenarios request.string
status
required
The current processing status of the transaction.enum (Status)
testCaseData
optional
Test case data for the transaction. Only available when the transaction status is SUCCESS.TestCaseData

TestCaseData

The set of test case data returned in response to the test data request.

NameDescriptionSchema
scenarios
optional
Set of use cases that describes the possible test scenarios.< Scenario > array

Scenario

A scenario test case response returned when the request is successful.

NameDescriptionSchema
scenarioId
required
An identifier that identifies the type of scenario that user can use for testing.string
orders
required
A list of orders that can be used by the caller to test each life cycle or scenario.< TestOrder > array

TestOrder

Error response returned when the request is unsuccessful.

NameDescriptionSchema
orderId
required
An error code that identifies the type of error that occurred.string

ErrorList

A list of error responses returned when a request is unsuccessful.

NameSchema
errors
required
< Error > array

Error

Error response returned when the request is unsuccessful.

NameDescriptionSchema
code
required
An error code that identifies the type of error that occured.string
message
required
A message that describes the error condition.string
details
optional
Additional details that can help the caller understand or fix the issue.string

Status

The current processing status of the transaction.

Type : enum

ValueDescription
FAILURETransaction has failed.
PROCESSINGTransaction is in process.
SUCCESSTransaction has completed successfully.

Did this page help you?