采购退货单列表
GET
/erp-purchase-return-order
接口描述
用于获取采购退货单列表。
请求头
参数名
类型
描述
必填
Device-Type
string
设备类型，示例：web
必填
Authorization
string
Token，示例：fafaf139-37b8-4d1e-abc3-65d9901697c5
必填
请求参数
参数名
类型
描述
必填
page
int
分页页码，示例：1，默认：1
可选
limit
int
分页数量，示例：10，默认：10
可选
sort
string
排序字段，示例：id，可选值：{"id":"ID"}，默认：id
可选
order
string
排序规则，示例：desc，可选值：{"asc":"升序","desc":"降序"}，默认：desc
可选
id
int
采购退货单ID，示例：1，搜索方式：等于
可选
purchase_return_order_no
string(25)
采购退货单编号，示例：CGTHDD-20210825-3，搜索方式：%模糊%
可选
money_unit
string(10)
退货金额单位，示例：USD，搜索方式：等于
可选
money[0]
float
最低退货金额，示例：1.00，搜索方式：大于等于
可选
money[1]
float
最高退货金额，示例：100.00，搜索方式：小于等于
可选
return_time[0]
string
开始退货日期，示例：2021-08-01，搜索方式：大于等于
可选
return_time[0]
string
结束退货日期，示例：2021-08-31，搜索方式：小于等于
可选
remark
string(255)
备注，示例：货物与描述不符，搜索方式：%模糊%
可选
audit_status
int
审核状态，示例：1，可选值：{"0":"待审核","1":"已通过","2":"已拒绝","3":"审核中","-1":"未提交","-2":"已撤回","-3":"已作废"}，搜索方式：等于
可选
purchase_order_no
string(50)
采购单编号，示例：ALA1-QL001-1，搜索方式：%模糊%
可选
contract_no
string(25)
合同号，示例：ALA1-QL001，搜索方式：%模糊%
可选
customer_no
string(20)
客户编码，示例：QL01，搜索方式：%模糊%
可选
customer_name
string(25)
客户名称，示例：全联集采水产品（广东）股份有限公司，搜索方式：%模糊%
可选
customer_name_en
string(255)
客户名称 (英文)，示例：Quanlian Aquatic Products Collection (Guangdong) Co., Ltd.，搜索方式：%模糊%
可选
customer_name_keyword
string(255)
客户名称关键字，示例：全联集采水产品（广东）股份有限公司，搜索方式：%模糊%，搜索字段：{"customer_name":"客户名称","customer_name_en":"客户名称 (英文)"}
可选
keyword
string(255)
关键字，示例：CGTHDD-20210825-3，搜索方式：%模糊%，搜索字段：{"purchase_return_order_no":"采购退货单编号","supplier_name":"供应商名称","customer_name":"客户名称","customer_name_en":"客户名称 (英文)"}
可选
响应参数
application/json参数名
类型
描述
必填
total
int
数据总数，示例：12
必填
per_page
int
每页数量，示例：10
必填
current_page
int
当前一页页码，示例：1
必填
last_page
int
最后一页页码，示例：2
必填
id
int
采购退货单ID，示例：14
必填
purchase_return_order_no
string
采购退货单编号，示例：CGTHDD-20210825-3
必填
type
int
退货类型，示例：0，值：{"0":"退运","1":"退货"}
必填
money_unit
string
退货金额单位，示例：USD
必填
money
int
退货金额，示例：100
必填
return_time
string
退货日期，示例：2021-08-23
必填
remark
string
退货原因 / 备注，示例：货物与描述不符
必填
audit_status
int
审核状态，示例：2，值：{"0":"待审核","1":"已通过","2":"已拒绝","3":"审核中","-1":"未提交","-2":"已撤回","-3":"已作废"}
必填
order_id
int
采购单ID，示例：1
必填
contract_id
int
采购合同ID，示例：1
必填
seller_id
int
卖家ID，示例：1
必填
customer_id
int
客户ID，示例：2
必填
id
int
关联附件ID，示例：97
必填
attachment_id
int
附件ID，示例：4
必填
name
string
附件名称，示例：采购退货PDF-1
必填
url
string
Url链接，示例：http://api.crm.qljc.com/uploads/20210804/1cbbf00549f577901571feb79eadc7cb.pdf
必填
size
int
附件大小 (b)，示例：255946
必填
type
string
附件类型，示例：pdf
必填
mime
string
附件Mime，示例：application/pdf
必填
size_text
string
附件大小文本，示例：0.24MB
必填
id
int
卖家ID，示例：1
必填
name
string
卖家名称，示例：SAHITHI SEA FOODS & MARINE EXPORTS PVT.LTD.,
必填
id
int
客户ID，示例：2
必填
customer_no
string
客户编码，示例：QL01
必填
name
string
客户名称，示例：全联集采水产品（广东）股份有限公司
必填
name_en
string
客户名称 (英文)，示例：Quanlian Aquatic Products Collection (Guangdong) Co., Ltd.
必填
audit_status_text
string
审核状态文本，示例：已拒绝
必填
factory_id
int
工厂ID，示例：1
必填