退件单列表 - OMS开放接口文档

请求参数

Header 参数

Body 参数application/json

示例

{
    "commonParam": {
        "pageParam": {
            "pageNum": 0,
            "pageSize": 0
        }
    },
    "orderNo": "string",
    "referenceNo": "string",
    "signatureNo": "string",
    "trackingNo": "string",
    "pickupType": "1",
    "returnType": "1",
    "status": "1",
    "isSplitAsn": "-1",
    "orderNos": [
        "string"
    ],
    "referenceNos": [
        "string"
    ],
    "warehouseCode": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/open/return-order-data/list' \
--header 'Authorization: {{api_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "commonParam": {
        "pageParam": {
            "pageNum": 0,
            "pageSize": 0
        }
    },
    "orderNo": "string",
    "referenceNo": "string",
    "signatureNo": "string",
    "trackingNo": "string",
    "pickupType": "1",
    "returnType": "1",
    "status": "1",
    "isSplitAsn": "-1",
    "orderNos": [
        "string"
    ],
    "referenceNos": [
        "string"
    ],
    "warehouseCode": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "20000",
    "success": true,
    "data": {
        "pageNum": "1",
        "pageSize": "10",
        "totalCount": "1",
        "totalPage": "1",
        "list": [
            {
                "orderNo": "RO25101199766819",
                "referenceNo": "RO25101199766819",
                "signatureNo": "22222221",
                "outboundOrderNo": "111",
                "trackingNo": "1223",
                "pickupType": 2,
                "pickupDate": "2025-10-16",
                "etaDate": "2025-10-12",
                "companyName": "测试",
                "contactName": "测试",
                "contactMobile": "18888888888",
                "contactCellMobile": "",
                "contactEmail": "test@test.com",
                "province": "测试",
                "city": "测试",
                "district": "测试",
                "doorplate": "测试",
                "address": "测试",
                "postcode": "60000",
                "qty": 2,
                "receiveQty": 0,
                "goodQty": 0,
                "badQty": 0,
                "putawayQty": 0,
                "putawayBadQty": 0,
                "destroyQty": 0,
                "returnType": 1,
                "status": 1,
                "isSyncToSupplier": -1,
                "isSplitAsn": 1,
                "handleAdvice": "测试",
                "remark": "测试备注",
                "cancelType": 1,
                "cancelRemark": "",
                "errorReason": "",
                "errorOperationType": "",
                "openWarehouse": {
                    "warehouseCode": "TEST"
                },
                "openItems": [
                    {
                        "productSku": "SKU112",
                        "qty": 1,
                        "receiveQty": 0,
                        "productQuality": -1,
                        "handleType": -1,
                        "status": 1,
                        "remark": ""
                    }
                ],
                "openAttachments": [
                    {
                        "attachmentType": "物流运单",
                        "fileType": "png",
                        "fileName": "848ad6986d5846048b68b8a86a09c4db_100101.png",
                        "base64": "base64"
                    }
                ],
                "openshippingMethod": {
                    "code": "TEST"
                },
                "openCountry": {
                    "code2": "US"
                }
            }
        ]
    },
    "message": "请求成功",
    "errors": [],
    "timestamp": "1760337265902",
    "duration": 0.844,
    "requestId": "083ba540f01841d48e4cb12abea28e9e"
}