eBay Post-Order APIVersion 2.7.1

CreateInquiryRequest

Contains the information from which to create an Item Not Received (INR) inquiry on behalf of the buyer.

Call that uses CreateInquiryRequest:

Fields



claimQuantity ( integer ) [0..?]
This integer is the quantity of the line item purchased by the buyer. This value will usually be 1 unless the buyer purchased multiple quantity of a line item in a multiple-quantity, fixed-priced listing. If this field is omitted, its value defaults to 1.
See the Field Index to learn which calls use claimQuantity.

comments ( Text ) [0..?]
This optional container allows the buyer to provide more information about opening up the INR inquiry.
See the Field Index to learn which calls use comments.

desiredOutcome ( token ) [0..?]
This field is used to indicate whether the buyer still wants the item, or whether the buyer is now looking to receive a full refund for the line item. Although this field is optional, it should be specified by the buyer so the seller knows the next action to perform based on what the buyer is looking for. If this field is omitted, the desiredOutcome value defaults to STILL_WANT_ITEM.

Applicable values:
  • FULL_REFUND — This value is used if the buyer wants a full refund of the missing order line item. If this value is specified by the buyer, and the order line item still hasn't been shipped, the seller can use the POST /post-order/v2/inquiry/{inquiryId}/issue_refund call to issue a refund to the buyer instead of fulfilling and shipping the order line item.
  • STILL_WANT_ITEM — This value is used if the buyer still wants the seller to ship the missing order line item. This is the default value if the desiredOutcome field is omitted. If this value is specified by the buyer, the seller should ship the order line item as soon as possible (to avoid the inquiry being escalated to a case), and then use the POST /post-order/v2/inquiry/{inquiryId}/provide_shipment_info call to provide shipment tracking information and inform the buyer that the order line item is on its way.
One of the values of DesiredOutcomeTypeEnum must be used.
See the Field Index to learn which calls use desiredOutcome.

itemId ( string ) [0..?]
The unique identifier for the eBay listing where the item was purchased. This field is used in conjunction with the transactionId field to identify a line item within an order.
See the Field Index to learn which calls use itemId.

transactionId ( string ) [0..?]
The unique identifier for the purchase of a item. This value is created right when the buyer is committed to buying the item, whether that buyer uses a 'Buy it Now' capability, is the winning bidder of an auction, or the buyer's Best Offer is accepted by the seller. This field is used in conjunction with the itemId field to identify a line item within an order.
See the Field Index to learn which calls use transactionId.