REST Resource: orderreturns

Resource: MerchantOrderReturn

Order return. Production access (all methods) requires the order manager role. Sandbox access does not.

JSON representation
{
  "orderReturnId": string,
  "orderId": string,
  "merchantOrderId": string,
  "creationDate": string,
  "returnShipments": [
    {
      object (ReturnShipment)
    }
  ],
  "returnItems": [
    {
      object (MerchantOrderReturnItem)
    }
  ]
}
Fields
orderReturnId

string

Order return ID generated by Google.

orderId

string

Google order ID.

merchantOrderId

string

Merchant defined order ID.

creationDate

string

The date of creation of the return, in ISO 8601 format.

returnShipments[]

object (ReturnShipment)

Shipments of the return.

returnItems[]

object (MerchantOrderReturnItem)

Items of the return.

ReturnShipment

JSON representation
{
  "shipmentId": string,
  "state": string,
  "creationDate": string,
  "shippingDate": string,
  "deliveryDate": string,
  "shipmentTrackingInfos": [
    {
      object (ShipmentTrackingInfo)
    }
  ],
  "returnMethodType": string
}
Fields
shipmentId

string

Shipment ID generated by Google.

state

string

State of the shipment.

Acceptable values are:

  • "completed"
  • "new"
  • "shipped"
  • "undeliverable"

creationDate

string

The date of creation of the shipment, in ISO 8601 format.

shippingDate

string

The date of shipping of the shipment, in ISO 8601 format.

deliveryDate

string

The date of delivery of the shipment, in ISO 8601 format.

shipmentTrackingInfos[]

object (ShipmentTrackingInfo)

Tracking information of the shipment. One return shipment might be handled by several shipping carriers sequentially.

returnMethodType

string

Type of the return method.

Acceptable values are:

  • "byMail"
  • "contactCustomerSupport"
  • "returnless"

ShipmentTrackingInfo

JSON representation
{
  "carrier": string,
  "trackingNumber": string
}
Fields
carrier

string

The shipping carrier that handles the package.

Acceptable values are:

  • "boxtal"
  • "bpost"
  • "chronopost"
  • "colisPrive"
  • "colissimo"
  • "cxt"
  • "deliv"
  • "dhl"
  • "dpd"
  • "dynamex"
  • "eCourier"
  • "easypost"
  • "efw"
  • "fedex"
  • "fedexSmartpost"
  • "geodis"
  • "gls"
  • "googleCourier"
  • "gsx"
  • "jdLogistics"
  • "laPoste"
  • "lasership"
  • "manual"
  • "mpx"
  • "onTrac"
  • "other"
  • "tnt"
  • "uds"
  • "ups"
  • "usps"

trackingNumber

string

The tracking number for the package.

MerchantOrderReturnItem

JSON representation
{
  "itemId": string,
  "returnShipmentIds": [
    string
  ],
  "product": {
    object (OrderLineItemProduct)
  },
  "state": string,
  "customerReturnReason": {
    object (CustomerReturnReason)
  },
  "merchantReturnReason": {
    object (RefundReason)
  }
}
Fields
itemId

string

Product level item ID. If the returned items are of the same product, they will have the same ID.

returnShipmentIds[]

string

IDs of the return shipments that this return item belongs to.

product

object (OrderLineItemProduct)

Product data from the time of the order placement.

state

string

State of the item.

Acceptable values are:

  • "canceled"
  • "new"
  • "received"
  • "refunded"
  • "rejected"

customerReturnReason

object (CustomerReturnReason)

The reason that the customer chooses to return an item.

merchantReturnReason

object (RefundReason)

The reason that merchant chooses to accept a return item.

OrderLineItemProduct

JSON representation
{
  "id": string,
  "offerId": string,
  "targetCountry": string,
  "contentLanguage": string,
  "price": {
    object (Price)
  },
  "title": string,
  "gtin": string,
  "brand": string,
  "mpn": string,
  "condition": string,
  "itemGroupId": string,
  "imageLink": string,
  "shownImage": string,
  "variantAttributes": [
    {
      object (OrderLineItemProductVariantAttribute)
    }
  ],
  "fees": [
    {
      object (OrderLineItemProductFee)
    }
  ]
}
Fields
id

string

The REST ID of the product.

offerId

string

An identifier of the item.

targetCountry

string

The CLDR territory // code of the target country of the product.

contentLanguage

string

The two-letter ISO 639-1 language code for the item.

price

object (Price)

Price of the item.

title

string

The title of the product.

gtin

string

Global Trade Item Number (GTIN) of the item.

brand

string

Brand of the item.

mpn

string

Manufacturer Part Number (MPN) of the item.

condition

string

Condition or state of the item.

Acceptable values are:

  • "new"
  • "refurbished"
  • "used"

itemGroupId

string

Shared identifier for all variants of the same product.

shownImage

string

URL to the cached image shown to the user when order was placed.

variantAttributes[]

object (OrderLineItemProductVariantAttribute)

Variant attributes for the item. These are dimensions of the product, such as color, gender, material, pattern, and size. You can find a comprehensive list of variant attributes here.

fees[]

object (OrderLineItemProductFee)

Associated fees at order creation time.

OrderLineItemProductVariantAttribute

JSON representation
{
  "dimension": string,
  "value": string
}
Fields
dimension

string

The dimension of the variant.

value

string

The value for the dimension.

OrderLineItemProductFee

JSON representation
{
  "name": string,
  "amount": {
    object (Price)
  }
}
Fields
name

string

Name of the fee.

amount

object (Price)

Amount of the fee.

CustomerReturnReason

JSON representation
{
  "reasonCode": string,
  "description": string
}
Fields
reasonCode

string

Code of the return reason.

Acceptable values are:

  • "betterPriceFound"
  • "changedMind"
  • "damagedOrDefectiveItem"
  • "didNotMatchDescription"
  • "doesNotFit"
  • "expiredItem"
  • "incorrectItemReceived"
  • "noLongerNeeded"
  • "notSpecified"
  • "orderedWrongItem"
  • "other"
  • "qualityNotExpected"
  • "receivedTooLate"
  • "undeliverable"

description

string

Description of the reason.

RefundReason

JSON representation
{
  "reasonCode": string,
  "description": string
}
Fields
reasonCode

string

Code of the refund reason.

Acceptable values are:

  • "adjustment"
  • "autoPostInternal"
  • "autoPostInvalidBillingAddress"
  • "autoPostNoInventory"
  • "autoPostPriceError"
  • "autoPostUndeliverableShippingAddress"
  • "couponAbuse"
  • "courtesyAdjustment"
  • "customerCanceled"
  • "customerDiscretionaryReturn"
  • "customerInitiatedMerchantCancel"
  • "customerSupportRequested"
  • "deliveredLateByCarrier"
  • "deliveredTooLate"
  • "expiredItem"
  • "failToPushOrderGoogleError"
  • "failToPushOrderMerchantError"
  • "failToPushOrderMerchantFulfillmentError"
  • "failToPushOrderToMerchant"
  • "failToPushOrderToMerchantOutOfStock"
  • "feeAdjustment"
  • "invalidCoupon"
  • "lateShipmentCredit"
  • "malformedShippingAddress"
  • "merchantDidNotShipOnTime"
  • "noInventory"
  • "orderTimeout"
  • "other"
  • "paymentAbuse"
  • "paymentDeclined"
  • "priceAdjustment"
  • "priceError"
  • "productArrivedDamaged"
  • "productNotAsDescribed"
  • "promoReallocation"
  • "qualityNotAsExpected"
  • "returnRefundAbuse"
  • "shippingCostAdjustment"
  • "shippingPriceError"
  • "taxAdjustment"
  • "taxError"
  • "undeliverableShippingAddress"
  • "unsupportedPoBoxAddress"
  • "wrongProductShipped"

description

string

Description of the reason.

Methods

get

Retrieves an order return from your Merchant Center account.

list

Lists order returns in your Merchant Center account.