Lingxing
切换旧版

查询采购退货单列表

POST/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderListHTTPSPOST1

请求参数

search_field_timestring
时间搜索维度:
create_time 创建时间【默认值】
last_time 更新时间
start_datestring
开始时间,格式:Y-m-d,双闭区间
当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
end_datestring
结束时间,格式:Y-m-d,双闭区间
当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
statusarray<any>
状态:
121 待审批
122 已驳回
124 已作废(审批作废)
10 已处理
20 已作废(单据作废)
5 待退货
offsetinteger必填
分页偏移量
lengthinteger必填
分页长度,上限500

请求示例

{
    "offset": 0,
    "length": 20,
    "start_date": "2024-08-02",
    "end_date": "2024-08-02",
    "status": [10,20]
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求链路id
示例 929A1D7D-D656-0EA0-C78A-A686790C7090
response_timestring必填
响应时间
示例 2022-05-20 16:57:03
dataobject必填
响应数据
隐藏子属性
totalinteger必填
总数
示例 1000
listarray<object>必填
列表
隐藏子属性
widinteger必填
仓库id
示例 1
order_snstring必填
退货单号
示例 PR220520004
create_uidinteger必填
创建人id
示例 125
create_realnamestring必填
创建人名称
示例 JSTAPI
create_timestring必填
创建时间
示例 2022-05-20 11:48:23
last_timestring必填
更新时间
示例 2022-05-20 11:48:23
buyer_uidinteger必填
采购员id
示例 175
buyer_realnamestring必填
采购员名称
示例 API
purchase_order_snstring必填
采购单号
示例 PO220513032
supplier_idinteger必填
供应商id
示例 12
supplier_namestring必填
供应商名称
示例 供应商3
return_methodinteger必填
退货方式:1 退货扣款,2 退货补货
示例 1
replenish_methodinteger必填
补货方式:1 源单补货
receipt_funds_order_snstring必填
收款单号
statusinteger必填
状态:
121 待审批
122 已驳回
124 已作废(审批作废)
10 已处理
20 已作废(单据作废)
示例 10
purchase_currencystring必填
采购币种
示例 CNY
purchase_currency_iconstring必填
采购币种符号
示例 ¥
fee_part_typeinteger必填
费用分配方式:
0 不分配
1 按金额
2 按数量
shipping_currencystring必填
运费币种
示例 CNY
shipping_pricenumber必填
退货运费
示例 0
other_currencystring必填
其他费用币种
示例 CNY
other_feenumber必填
其他费用
示例 0
return_reasonstring必填
退货原因
示例 单品0001破损
return_amount_totalstring必填
退货总金额
remarkstring必填
单据备注
示例 破损需要退货
item_listarray<object>必填
子项列表
隐藏子属性
item_idinteger必填
子项id
示例 313
spu_namestring必填
款名
示例 SPU NAME
spustring必填
SPU
示例 SPU1
product_namestring必填
品名
示例 单品0001
skustring必填
SKU
示例 DP0001
fnskustring必填
FNSKU
mskuarray<any>必填
MSKU
attributearray<object>必填
属性
隐藏子属性
attr_idstring必填
属性id
示例 1
attr_namestring必填
属性名
示例 颜色
attr_valuestring必填
属性值
示例 白
pricenumber必填
含税单价
示例 1
quantity_realinteger必填
采购数量
示例 20
return_good_numinteger必填
良品退货量
示例 5
return_bad_numinteger必填
次品退货量
replenish_numinteger必填
扣款数量
示例 5
deduction_amountnumber必填
退货金额
示例 5
expect_arrive_timestring必填
预计到货时间
示例 &nbsp;
remarkstring必填
备注
示例 破损

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "0CDB0A84-AE71-A25C-7432-041C78192C34",
    "response_time": "2024-08-02 17:46:27",
    "data": {
        "total": 2,
        "list": [
            {
                "order_sn": "PR240802002",
                "create_realname": "何承伟",
                "create_uid": 10548111,
                "buyer_realname": "甄新晴",
                "buyer_uid": 10401445,
                "create_time": "2024-08-02 10:56:57",
                "last_time": "2024-08-02 10:56:57",
                "purchase_order_sn": "PO240104006",
                "wid": 44,
                "supplier_name": "深圳市健爱户外运动用品有限公司(已删除)",
                "supplier_id": 1583,
                "return_method": 2,
                "replenish_method": 1,
                "receipt_funds_order_sn": "",
                "status": 10,
                "purchase_currency": "CNY",
                "purchase_currency_icon": "¥",
                "fee_part_type": null,
                "shipping_currency": "CNY",
                "shipping_price": "0.00",
                "other_currency": "CNY",
                "other_fee": "0.00",
                "return_amount_total": "0.00",
                "return_reason": "",
                "remark": "",
                "item_list": [
                    {
                        "item_id": 2414,
                        "spu_name": "",
                        "spu": "",
                        "product_name": "服装1111",
                        "sku": "fuzhuang1111",
                        "fnsku": "B0BBB14W7B",
                        "msku": [],
                        "attribute": [],
                        "seller_id": "109",
                        "price": "100.0000",
                        "quantity_real": 80,
                        "return_good_num": 0,
                        "return_bad_num": 5,
                        "replenish_num": 5,
                        "deduction_amount": "0.00",
                        "expect_arrive_time": "",
                        "remark": ""
                    }
                ]
            }
        ]
    },
    "total": 0
}