Skip to main content

getPurchaseReturnList：获取采购退货单列表

入参

参数名称

是否必须

类型

描述

sKey

Y

String

令牌

page

Y

String

页码：从 1 开始（默认值：1）
page_size

Y

String

每页大小：默认 10 条

kw

N

String

关键字：采购退货单号/备注

return_send_date

N

String

退单配送发货日期开始时间

return_send_date_end

N

String

退单配送发货日期结束时间

stock_id

N

String

仓库 ID

status

N

String

采购退货单状态

supplier_id

N

String

供应商 ID

goods_id

N

String

商品 ID
入参示例
{
    "f": "getPurchaseReturnList",
    "v": {
        "sKey": "60fd01cfbd6e54db71060a1d2637080a",
        "page": 1,
        "page_size": 10,
        "kw": "",
        "status": "",
        "supplier_id": "",
        "return_send_date": "2024-12-15 00:00",
        "return_send_date_end": "2025-06-15 00:00"
    }
}
返参

参数名称

类型

描述、 返回字段

rStatus

Int

100：正常；其他：异常

message

string

信息描述

rData

Object

具体返回信息

rData 结构

字段名称 类型 描述
code int 数据状态码（200 表示成功）
message string 数据返回信息
data object 采购退货单列表的详细信息

data 结构

字段名称 类型 描述
count int 采购退货单总数
list array 采购退货单列表数据

list（采购退货单列表数据）

字段名称 类型 描述
returns_id string 采购退货单 ID
stock_id string 仓库 ID
supplier_id string 供应商 ID
staff_id string 操作员工 ID
staff_name string 操作员工姓名
returns_num string 采购退货单编号
status string 采购退货单状态
returns_total string 采购退货单总金额
discount_total string 折扣总金额
returns_reason string 退货原因
create_date string 创建时间
internal_comtion string 内部沟通信息
remark string 备注
returns_details_count string 退货明细数量
returns_contact string 退货联系人
returns_phone string 退货联系电话
returns_address string 退货地址
returns_cityid string 退货城市 ID
returns_send_date string 退货发货日期
parent_returnsid string 父退货单 ID
parent_companyid string 父公司 ID
is_erp_api string 是否通过 ERP API 操作
status_name string 状态名称
stock_name string 仓库名称
supplier_name string 供应商名称

返参示例
{
    "rStatus": 100,
    "message": "获取采购退货单列表成功",
    "rData": {
        "code": 200,
        "message": "成功",
        "data": {
            "count": 2,
            "list": [
                {
                    "returns_id": "165",
                    "stock_id": "3706",
                    "supplier_id": "51303",
                    "staff_id": "1623",
                    "staff_name": "14711122000",
                    "returns_num": "JHT.20250114.0001",
                    "status": "finished",
                    "returns_total": "0.00",
                    "discount_total": "14.00",
                    "returns_reason": "",
                    "create_date": "2025-01-14",
                    "internal_comtion": "888",
                    "remark": "8989",
                    "returns_details_count": "0",
                    "returns_contact": "uu888",
                    "returns_phone": "uu888",
                    "returns_address": "uuu88",
                    "returns_cityid": "130303",
                    "returns_send_date": "2025-01-14",
                    "parent_returnsid": "0",
                    "parent_companyid": "0",
                    "is_erp_api": "1",
                    "status_name": "已完成",
                    "stock_name": "测试仓库",
                    "supplier_name": "测试供应商"
                }
            ]
        }
    }
}
Back to top