eBay Post-Order APIVersion 2

Escalate Inquiry

POST /post-order/v2/inquiry/{inquiryId}/escalate

Escalates the specified Item Not Received inquiry to an eBay customer support INR case on behalf of the buyer or seller. The seller would only escalate an INR inquiry if he/she already shipped the order line item, but the buyer is refusing to close the inquiry.

Note: A successful call will return an HTTP status code of 201, with the following accompanying location code: /post-order/v2/inquiry/{CASEID}, in which CASEID identifies the newly created INR case. This value is required as input for most of the Order Resolution API calls.

Input

See also Samples.

Resource URI (production)

POST https://api.ebay.com/post-order/v2/inquiry/{inquiryId}/escalate

URI parameters

Parameter Type Required? Meaning
inquiryId string Required The unique identifier of the inquiry to be escalated.

Note: This is the value that was returned by the POST /post-order/v2/inquiry/ call in an HTTP location code: /post-order/v2/inquiry/{INQUIRYID}, in which INQUIRYID identifies the newly created inquiry.


HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.



Authorization

This call uses standard authorization tokens. See Making a Call for details.

Payload model

The following lists all fields that could be included in the request.

{ /* EscalateInquiryRequest */
"comments":
    { /* Text */
    "content": string,
    "language": string,
    "translatedFromContent": string,
    "translatedFromLanguage": string
    },
"escalateInquiryReason": token
}

Request field descriptions



Input Container/Field Type Occurrence Meaning
comments Text Optional This optional container allows the buyer or seller to provide more information about why the inquiry is being escalated to a case.
comments.content string Conditional This field displays the actual textual content in the language specified in the language field. This field is always used for containers using the Text type.
comments.language string Conditional This two-letter code indicates the language used to display the content in the content field. The language will default to the language used on the eBay site if a specific language is not specified through the Accept-Language HTTP header. This field is always used for containers using the Text type.

Applicable values are from LanguageEnum:See language.
comments.translatedFromContent string Conditional If language translation/localization is required, this field displays the actual textual content in the language specified in the translatedFromLanguage field. If language translation was not required, this field is not applicable.
comments
  .translatedFromLanguage
string Conditional If language translation/localization is required, this two-letter code indicates the language used to display the content in the translatedFromContent field. If language translation was not required, this field is not applicable.

Applicable values are from LanguageEnum:See translatedFromLanguage.
escalateInquiryReason token Required The reason why the buyer or seller is escalating the specified INR inquiry into a case.

One of the values of InquiryEscalationReasonEnum must be used. Some values are only applicable to the buyer escalating the inquiry, some values are only applicable to the seller escalating the inquiry, and some values are relevant to both parties.

Applicable values: See InquiryEscalationReasonEnum

Output

See also Samples.

Payload model

This call has no response payload.



Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Sample: Escalate an Inquiry

This operation escalates an INR inquiry to an INR case.

Description

This operation escalates the specified inquiry to a case on behalf of the buyer.

Input

Supply the inquiry ID as a path parameter in the call. The value of the optional escalationReason field indicates that the buyer is escalating this inquiry due to a lack of responsiveness on the part of the seller.

URL format. See also the non-wrapped version of this URL.

POST https://api.ebay.com/post-order/v2/inquiry/5003184837/escalate
{
  "escalationReason":"SELLER_NORESPONSE",
  "comments":
  {
    "content": "The seller has not addressed my inquiry."
  }
}

Output

A successful call returns an HTTP code of 200; there is no payload for the response.

JSON format.



Change History

Change Date Description