UpdateItemsInformation
Sets additional information to a collection of Order Items. This call is intended to handle changes in information of the Items which are not necessarily related to a change is its main Status (as UpdateItemsStatus does).
- Status detail (A.K.A. 'location' / 'where is my product'): information intended to clarify the status / location of the item within its main Status. eg: exact location of a returned item.
- SellerCenter will validate that the intended Status Detail is consistent with the current Status or the Order Item in SellerCenter side. The set of acceptable Status Details will be given by OMS through the response to SellerCenter OMS API#getStatusDetailOptionList()
Request example
{
"Request": {
"Items": [
{
"id_sales_order_item":11,
"status_detail": "failed_in_warehouse"
}
]
}
}
Response
SellerCenter will process all the items independently, making possible that either all the items are successfully updated / some are failed / the whole call fails with no item updated.
Success response
{
"SuccessResponse": {
"Head": {
"RequestId": "",
"RequestAction": "UpdateItemsInformation",
"ResponseType": "",
"Timestamp": "2015-07-02T12:26:03+0200"
},
"Body": []
}
Error response some failed Items
Only the failed items are listed inside the Items element, along with an error message and code for each one. The position of the item inside the request collection of items is marked with "Position".
{
"ErrorResponse": {
"Head": {
"RequestAction": "UpdateItemsInformation",
"ErrorType": "Sender",
"ErrorCode": "0",
"ErrorMessage": "Some elements were not processed"
},
"Body": {
"UpdateItemsInformation":
[
{
"ErrorCode": null,
"ErrorMessage": "The Status Detail \"returned_location_1\" does not match with current status (id:1) for Order Item with src_id: 100411",
"Position": 2
}
]
}
}
In previous example, the failing item is the one sent in “position 2”, so the third item of the request.
Error response
{
"ErrorResponse": {
"Head": {
"RequestAction": "UpdateItemsInformation",
"ErrorType": "Sender",
"ErrorCode": "7",
"ErrorMessage": "E007: Login failed. Signature mismatch"
},
"Body": ""
}