获取退换单状态

1、功能名称：获取退换单状态

2、功能描述：获取退换单状态

3、请求地址：https://ssl.glitzcloud.com/agent/v1/orders/return/getstatus

      测试地址：http://gztest.glitzcloud.com/agent/v1/orders/return/getstatus

4、请求方式：POST

5、请求参数

名称 必填 类型 示例值 描述
store_name 是 String The Warehouse USA 仓库名称
change_sn 是 String GCR16092656522,GCR16092656523 退货单号

6、请求示例

           array(
                    'format'=>'json',
                    'apikey'=>'85082f5f62a811e684f500163e06045f',
                    'randoms'=>1234,
                    'sign'=>'656d6fbe6b7dec6c2e77ffe27f04bd6d',
                    'store_name' => 'The Warehouse USA',
                    'change_sn'=> 'GCR16092656522',
             );

7、返回格式：JSON

8、返回示例：

正确时的返回JSON数据包如下：

            {
                "status": 200,
                "reqMsg": "ok",
                "result": [
                    {
                        "change_sn": "GCR25030480833",
                        "status": "Completed",
                        "receive_time": "1741077432",
                        "product_info": [
                            {
                                "product_sn": "sasha070566",
                                "exp_piece_qty": "1",
                                "act_piece_qty": "1"
                            }
                        ],
                        "charge": [
                            {
                                "charge_name": "B2C Return - TWUSA",
                                "charge_price": "7.20",
                                "charge_amount": "1.00",
                                "charge_discount": "0.40",
                                "charge_total": "2.88",
                                "charge_currency": "usd",
                                "pay_status": "1",
                                "create_time": "2025-03-04 16:37:12"
                            }
                        ]
                    },
                    {
                        "change_sn": "GCR25093054095",
                        "status": "Completed",
                        "receive_time": "1759199129",
                        "product_info": [
                            {
                                "product_sn": "lydia2023102301",
                                "exp_piece_qty": "1",
                                "act_piece_qty": "1"
                            }
                        ],
                        "charge": [
                            {
                                "charge_name": "B2C Return - TWUSA",
                                "charge_price": "7.20",
                                "charge_amount": "1.00",
                                "charge_discount": "0.40",
                                "charge_total": "2.88",
                                "charge_currency": "usd",
                                "pay_status": "1",
                                "create_time": "2025-09-30 10:25:29"
                            }
                        ]
                    }
                ]
            }

错误时的返回JSON数据包如下：

            {
                "status": 6003,
                "reqMsg": "Return Order doesn't exist",
                "result": []
            }

9、返回参数说明：

参数 类型 示例值 描述
change_sn String GCR16092776172 退换货单号
status String Received 退货单状态
Pending:未收货
Receiving:待收货
Received:已收货
Confirmed:已确认
Pending Response:等待回复
Completed:已完成
Cancelled:已取消
receive_time String 2017-07-01 12:10:11 收货时间
sku String 1111000115 产品编号SKU
exp_piece_qty Integer 300 预报数量
act_piece_qty Integer 200 实收数量
good_qty Integer 180 合格数量
bad_qty Integer 20 不合格数量

全局返回码说明