Skip to main content

getPurchaseReturnContent：获取采购退货单详情

入参

参数名称

是否必须

类型

描述

sKey

Y

String

令牌
purchase_num

Y

String

采购退库单编号
入参示例
{
    "f": "getPurchaseReturnContent",
    "v": {
        "sKey": "60fd01cfbd6e54db71060a1d2637080a",
        "purchase_num": "JHT.20250114.0001"
    }
}
返回参数

参数名称

类型

描述、 返回字段

rStatus

String

100：正常 其他：异常

message

String

信息描述

rData

String

具体信息

rData 结构

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

data 结构

main（采购退货单主信息）

字段名称 类型 描述
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 array 退货城市 ID（省、市、区）
returns_city_name array 退货城市 名字（省、市、区）
returns_send_date string 退单配送发货日期
source_device string 来源设备
is_erp_api string 是否通过 ERP 获取
status_name string 采购退货单状态名称
stock_name string 采购退货仓库名称
supplier_name string 供应商名称
supplier_num string 供应商编号
contact_name string 联系人名称
list array 采购退货单中的商品明细
log array 采购退货单的操作日志

 list（商品明细）

字段名称 类型 描述
returns_list_id string 采购退货明细 ID
goods_id string 商品 ID
options_id string 规格 ID
returns_number string 退货数量
returns_price string 退货价格
category_id string 商品分类 ID
brand_id string 商品品牌 ID
confirm_price string 确认退货价格
remark string 备注
confirm_number string 确认退货数量
goods_name string 商品名称
base_units string 基本单位
goods_picture string 商品图片 URL
container_units string 大单位
conversion_number string 大单位换算关系

goods_num

 string 商品编码
options_goods_num string 商品多规格编号
purchase_list_id string 采购单明细 ID
purchase_num string 采购单编号
options_name string 多规格名称
amount string 采购退货金额
category_name string 商品分类名称
brand_name string 商品品牌名称
cost_price string 库存成本价
purchase_number string 采购数量
already_returns_number string 已退货数量

log（操作日志）

字段名称 类型 描述
track_id string 日志 ID
accounts_id string 账户 ID
operation string 操作名称
operation_name string 操作名称（英文）
set_audit_id string 主数据 ID
remark string 备注
create_date string 创建时间
operation_name_cn string 操作名称（中文）
account_name string 账户名称


返参示例
{
    "rStatus": 100,
    "message": "获取采购退货单详情成功",
    "rData": {
        "code": 200,
        "message": "成功",
        "data": {
            "list": [
                {
                    "returns_list_id": "136",
                    "goods_id": "268903",
                    "options_id": "0",
                    "returns_number": "2.00",
                    "returns_price": "0.00",
                    "category_id": "15191",
                    "brand_id": "0",
                    "confirm_price": "1.00",
                    "remark": "",
                    "confirm_number": "1.00",
                    "goods_name": "测试物料A",
                    "base_units": "只he",
                    "goods_picture": "http://admin.dhb168.vip/Public/static//images/default.jpg",
                    "container_units": "",
                    "conversion_number": "1.0000",
                    "options_goods_num": "MAT00002",
                    "goods_num": "100011",
                    "purchase_list_id": "1899",
                    "purchase_num": "JH.20250114.0001",
                    "options_name": "",
                    "amount": "1.00",
                    "category_name": "默认分类",
                    "brand_name": "",
                    "max_returns_number": "2.00",
                    "cost_price": "0.00",
                    "purchase_number": "3333.00",
                    "already_returns_number": "1.00"
                }
            ],
            "log": [
                {
                    "track_id": "415",
                    "accounts_id": "9049",
                    "operation": "保存采购退货",
                    "operation_name": "created",
                    "set_audit_id": "165",
                    "remark": "保存采购退货单成功",
                    "create_date": "2025-01-14 15:33",
                    "operation_name_cn": "保存采购退货",
                    "account_name": "14711122000"
                }
            ],
            "main": {
              "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 07:33",
              "internal_comtion": "888",
              "remark": "8989",
              "returns_details_count": "0",
              "returns_contact": "uu888",
              "returns_phone": "uu888",
              "returns_address": "uuu88",
              "returns_cityid": [
                  130000,
                  130300,
                  130303
              ],
              "returns_city_name": [
                  "河北省",
                  "秦皇岛市",
                  "山海关区"
              ],
              "returns_send_date": "2025-01-14 00:00",
              "source_device": "compute",
              "parent_returnsid": "0",
              "parent_companyid": "0",
              "is_erp_api": "1",
              "status_name": "已完成",
              "stock_name": "测试仓库",
              "supplier_name": "测试供应商",
              "supplier_num": "supplier123",
              "contact_name": "uu888"
            }
        }
    }
}
Back to top