1. Return 2.0 退货订单开放接口
Open-API
  • eBay fulfillment openAPI
  • OAuth
    • URL(getAuthorizationCode)
      GET
    • AccessToken
      POST
    • Refresh AccessToken
      POST
  • SKU
    • SKUCreation v3
      POST
    • SKUQuery v3
      POST
    • SKU Label
      POST
    • SKUSetupEFService
      POST
    • QuerySKUEFService
      POST
  • Stock
    • GetStockMovement
      POST
    • StockSnapshot v2
      POST
    • GetStockAge
      POST
  • Inbound
    • PlaceInboundOrder
      POST
    • Inbound Order List Query
      POST
    • Inbound Order Detail Query
      POST
    • Inbound Label Query
      POST
    • Upload TrackingNo
      POST
    • Upload Clearance Doc
      POST
  • Outbound
    • Place Outbound Order
    • Outbound Order Query v2
    • Outbound Order Cancellation
    • placeThirdPartyLabelOrder
    • 同步运费试算接口
  • Warehouse
    • GetServiceList
  • Pricing
    • Cost Estimation Request
    • Cost Estimation Response
  • VAS
    • placeVasOrder
    • queryVasOrderDetail
    • cancelVasOrder
  • Webhook
    • Outbound Callback Webhook Reception
  • return
    • Return 2.0 退货订单开放接口
      • 查询退货订单
        GET
      • 获取面单
        GET
      • 取消 RMA 订单或同步更新退货跟踪信息
        POST
      • 查询退货库存快照
        POST
      • 关联退件库存商品
        POST
      • Erp提交订单
        POST
    • Auth
      • 获取AccessToken
    • 财务明细接口
      • 费用明细查询
  1. Return 2.0 退货订单开放接口

关联退件库存商品

Sandbox
https://openapi-stage-hk.orangeconnex.com/openapi
Sandbox
https://openapi-stage-hk.orangeconnex.com/openapi
POST
/3pp/returns/v1/inventory/associate

Request

Header Params

Body Params application/json

Example
{
  "messageId": "{{messageId}}",
  "data": {
    "returnAssociateList": [
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0001",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0001"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0002",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0002"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0003",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0003"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0004",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0004"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0005",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0005"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0006",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0006"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0007",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0007"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0008",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0008"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0009",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0009"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0010",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0010"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0011",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0011"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0012",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0012"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0013",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0013"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0014",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0014"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0015",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0015"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0016",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0016"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0017",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0017"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0018",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0018"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0019",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0019"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0020",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0020"
      },
      {
        "uniqueId": "DE01UC202606051611",
        "ocSkuId": "OC0000256232022"
      },
      {
        "uniqueId": "RETURN_UNIQUE_ID_001",
        "ocSkuId": "OC_SKU_ID_001"
      },
      {
        "uniqueId": "DE01UC202606051609",
        "ocSkuId": "OC0000256238011"
      },
      {
        "uniqueId": "DE01UC09201147",
        "ocSkuId": "OC0000256238020"
      },
      {
        "uniqueId": "TEST_SKU_001",
        "ocSkuId": "OC0000256234073"
      },
      {
        "uniqueId": "DE01UC202604211908",
        "ocSkuId": "OC0000256234073"
      },
      {
        "uniqueId": "DE01UC202606051608",
        "ocSkuId": "OC0000256240052"
      }
    ]
  }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://openapi-stage-hk.orangeconnex.com/openapi/3pp/returns/v1/inventory/associate' \
--header 'Access-Token: ' \
--header 'Content-Type: application/json' \
--data '{
  "messageId": "{{messageId}}",
  "data": {
    "returnAssociateList": [
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0001",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0001"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0002",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0002"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0003",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0003"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0004",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0004"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0005",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0005"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0006",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0006"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0007",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0007"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0008",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0008"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0009",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0009"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0010",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0010"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0011",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0011"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0012",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0012"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0013",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0013"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0014",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0014"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0015",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0015"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0016",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0016"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0017",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0017"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0018",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0018"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0019",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0019"
      },
      {
        "uniqueId": "STG-RIA-20260617-T20-RET-0020",
        "ocSkuId": "STG-RIA-20260617-T20-OC-0020"
      },
      {
        "uniqueId": "DE01UC202606051611",
        "ocSkuId": "OC0000256232022"
      },
      {
        "uniqueId": "RETURN_UNIQUE_ID_001",
        "ocSkuId": "OC_SKU_ID_001"
      },
      {
        "uniqueId": "DE01UC202606051609",
        "ocSkuId": "OC0000256238011"
      },
      {
        "uniqueId": "DE01UC09201147",
        "ocSkuId": "OC0000256238020"
      },
      {
        "uniqueId": "TEST_SKU_001",
        "ocSkuId": "OC0000256234073"
      },
      {
        "uniqueId": "DE01UC202604211908",
        "ocSkuId": "OC0000256234073"
      },
      {
        "uniqueId": "DE01UC202606051608",
        "ocSkuId": "OC0000256240052"
      }
    ]
  }
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
    "requestId": "string",
    "success": true,
    "hasBusinessException": true,
    "errorCode": "string",
    "errorMsg": "string",
    "message": "string",
    "result": {
        "successCount": 0,
        "failedCount": 0,
        "successList": [
            {
                "uniqueId": "string",
                "ocSkuId": "string"
            }
        ],
        "failedList": [
            {
                "uniqueId": "string",
                "ocSkuId": "string",
                "errorCode": "string",
                "errorMessage": "string"
            }
        ]
    },
    "isFallback": true
}
Modified at 2026-06-17 10:03:06
Previous
查询退货库存快照
Next
Erp提交订单
Built with