酷柚易汛ERP开源版对外接口开放文档

于 2023-07-04 09:56:45 发布
阅读量494 收藏
点赞数
文章标签： 开源 php 小程序
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lianglhm36/article/details/131528798
版权

全局公共参数

全局Header参数
参数名示例值参数描述
暂无参数
全局Query参数
参数名示例值参数描述
暂无参数
全局Body参数
参数名示例值参数描述
暂无参数
全局认证方式
noauth
全局预执行脚本
暂无预执行脚本
全局后执行脚本
暂无后执行脚本

/合并对外接口

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/签名

将需要签名的字段名称转换为小写，然后将键按字母顺序排列，将键值对用=拼接后将所有需签名字段用'&'符号拼接为字符串后在最后拼接上key=value，将需签名字符串进行MD5加密即为签名。例如 需签名字段为：account，id，签名为：MD5(account=1111111&id=5&key=2222222);
接口状态

已完成

接口URL

https://ceshi.mxpcsoft.com/api/third/test/getsaleslist

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account18281924211Text是-
sign123Text是-
request_time1659065877Text是-
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
int(1659065888)
string(32) "c269d669339d34eccbd2294aada5cbfd"

/合并对外接口/错误码

1 ： 成功
0 ： 失败
10 ： 请求方式错误
20 ： 接口地址错误
21 ： 账户不存在
22 ： 账户状态异常
23 ： 无效请求
24 ： 签名错误
25 ： 参数错误
26 ： 校验规则错误（接口错误）
27 ： 业务逻辑错误
接口状态

已完成

接口URL

未填写

请求方式

POST

Content-Type

urlencoded

认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/商品

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/商品/商品列表

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/goods/getGoodsList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signdacc600875a10174d19dbd49dd6cf24aString是签名（签名字段：account，request_time）
request_time1678843957Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
page1Number否页码
limit1Number否每页条数（默认10）
goods_type_id-Number否商品分类ID
keyword-String否关键词
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1678844158",
	"data": {
		"list": [
			{
				"id": 37,
				"goods_code": "SP011",
				"goods_type_id": 8,
				"goods_name": "商品3",
				"goods_barcode": "",
				"note": "",
				"goods_spec": "11",
				"unit_id": 29,
				"unit_name": "个",
				"more_unit": "2",
				"purchase": 10,
				"market_sell_price": 100.5,
				"wholesale_price": 0,
				"vip_price": 0,
				"discount": 0,
				"discount2": 0,
				"goods_image": "/assets/addons/kuyou/img/noimage.png",
				"stock": 500,
				"updatetime": "2023-03-11 23:23:40"
			}
		],
		"count": 11
	}
}
参数名示例值参数类型参数描述
code200Integer状态码
msg查询成功String返回文字描述
time1678844158String时间
data-Object返回数据
data.list-Array返回数据列表
data.list.id37Integer商品ID
data.list.goods_codeSP011String商品编号
data.list.goods_type_id8Integer商品分类ID
data.list.goods_name商品3String商品名称
data.list.goods_barcode-String商品条码
data.list.note-String商品备注
data.list.goods_spec11String规格型号
data.list.unit_id29Integer商品单位ID
data.list.unit_name个String商品单位名称
data.list.more_unit2String是否多单位（1：是，2：否）
data.list.purchase10Integer预计采购价
data.list.market_sell_price100.5Number零售价
data.list.wholesale_price0Integer批发价
data.list.vip_price0IntegerVIP会员价
data.list.discount0Integer折扣率1
data.list.discount20Integer折扣率2
data.list.goods_image/assets/addons/kuyou/img/noimage.pngString商品图片
data.list.stock500Integer商品库存
data.list.updatetime2023-03-11 23:23:40String更新时间
data.count11Integer总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/商品/商品详情

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/goods/getGoodsInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign2d5c44487220fc36d89c953f2829e8acString是签名（签名字段：account，request_time，id）
request_time1647394207Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
id37Number是ID
info_type2Number否数据类型：1=详细信息，2=基础信息
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1659422387",
	"data": {
		"id": 824,
		"goods_code": "SP003",
		"goods_name": "默认商品",
		"goods_barcode": "10002",
		"goods_spec": "个",
		"goods_type_id": 134,
		"manager_warehouse_id": 0,
		"unit_id": 33,
		"is_offten": "0",
		"status": "1",
		"goods_image": "/uploads/20211118/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg",
		"goods_images": [
			"/uploads/20211118/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg",
			"/uploads/20211118/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg"
		],
		"note": "备注",
		"serial": 0,
		"more_unit": "2",
		"stock_warning": "0",
		"branch": "0",
		"auxiliary": 1,
		"batch": 0,
		"period_status": "0",
		"warehousing": null,
		"warehouse": null,
		"goods_type_name": "水果",
		"manager_warehouse_name": null,
		"warehousing_name": null,
		"warehouse_name": null,
		"unit_name": "个"
	}
}
参数名示例值参数类型参数描述
code1Number状态码
msg查询成功String返回文字描述
time1659422387Number时间
data-Array返回数据
data.id824Number商品ID
data.goods_codeSP003String商品编号
data.goods_name默认商品String商品名称
data.goods_barcode10002String商品条码
data.goods_spec个String商品规格型号
data.goods_type_id134Number分类ID
data.manager_warehouse_id-Number首选仓库ID
data.unit_id33Number单位ID
data.is_offten0String是否常用（0=否,1=是）
data.status1Number状态：0=下架，1=上架
data.goods_image/uploads/20211118/b7f15b580afdb771d8c2d72dc4dc3c63.jpegString商品图片
data.goods_images/uploads/20211118/b7f15b580afdb771d8c2d72dc4dc3c63.jpegString商品图集
data.note备注String备注
data.serial-Number是否开启序列号：0=否，1=是
data.more_unit2String是否多单位：1=是，2=否
data.stock_warning0String是否开启库存预警：0=否，1=是
data.branch0String是否分仓预警：0=否，1=是
data.auxiliary1Number商品是否设置辅助属性（0：否，1=是）
data.batch-Number商品是否启用批次保质期管理（0：否，1=是）
data.period_status0String是否设置期初：0=否，1=是
data.warehousing-Object首选入库单位
data.warehouse-Object首选出库单位
data.goods_type_name水果String分类名称
data.manager_warehouse_name-Object默认仓库名称
data.warehousing_name-Object首选入库单位名称
data.warehouse_name-Object首选出库单位名称
data.unit_name个String单位名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/商品分类

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/商品分类/列表

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/goods/goodsTypeList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signeb7645e9bb7252d58454ff1fcf342838String是签名（签名字段：account，request_time）
request_time1659323476Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
list_type2Number是列表类型：1=组合层级，2=普通列表
page1Number否页码
limit1Number否每页条数（默认10）
keyword-String否关键词
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1678844293",
	"data": [
		{
			"id": 7,
			"pid": 0,
			"name": "默认分类",
			"image": "/assets/addons/kuyou/img/noimage.png",
			"updatetime": "2023-03-03"
		}
	]
}
参数名示例值参数类型参数描述
code200Integer状态码
msg查询成功String返回文字描述
time1678844293String时间
data-Array返回数据
data.id7Integer分类ID
data.pid0Integer父级ID
data.name默认分类String分类名称
data.image/assets/addons/kuyou/img/noimage.pngString图片
data.updatetime2023-03-03String更新时间
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/客户

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/客户/客户列表

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/customers/getCustomersList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signeb7645e9bb7252d58454ff1fcf342838String是签名（签名字段：account，request_time）
request_time1659318549Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
page1Number否页码
limit1Number否每页条数（默认10）
keyword-String否关键词
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1678845629",
	"data": {
		"list": [
			{
				"customer_code": "KH006",
				"name": "客户名称",
				"mobile": "13555555555",
				"saler": null,
				"createtime": 1678845614,
				"status": "1",
				"createtime_text": "2023-03-15 10:00:14"
			}
		],
		"count": 1
	}
}
参数名示例值参数类型参数描述
code200Integer状态码
msg查询成功String返回文字描述
time1678845629String时间
data-Object返回数据
data.list-Array数据列表
data.list.customer_codeKH006String客户编号
data.list.name客户名称String客户名称
data.list.mobile13555555555String手机号
data.list.salernullNull销售员编号
data.list.createtime1678845614Integer添加时间戳
data.list.status1String状态：1=正常，0=禁用
data.list.createtime_text2023-03-15 10:00:14String创建时间
data.count1Integer总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/客户/添加客户

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/customers/joinCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign9f99c47b9777bd38528b43df709c2d0bString是签名（签名字段：account，request_time，name,mobile）
request_time1659318339String是请求时间戳（小于当前时间5分钟的请求会认为无效）
name客户名称String是客户名称
saler-String否销售员编号
mobile13555555555String是客户联系方式
address-String否客户收货地址
note-String否客户备注
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1678845614",
	"data": {
		"id": "40",
		"customer_code": "KH006"
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg添加成功String返回文字描述
time1678845614String时间
data-Object返回数据
data.id40String添加的客户ID
data.customer_codeKH006String添加的客户编号
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名示例值参数类型参数描述
code23Number状态码
msg无效请求String返回文字描述
time1647326548Number时间
data-Object返回数据

/合并对外接口/客户/客户详情

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/customers/customersInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signec35d52ba94d1e0b9dc11d7ffd778b03String是签名（签名字段：account，request_time）
request_time1659319313Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
mobile13555555555String是电话号码
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1678845706",
	"data": {
		"customer_code": "KH006",
		"name": "客户名称",
		"mobile": "13555555555",
		"address": "",
		"note": "",
		"saler": null,
		"createtime": 1678845614,
		"status": "1",
		"createtime_text": "2023-03-15 10:00:14"
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg查询成功String返回文字描述
time1678845706String时间
data-Object返回数据
data.customer_codeKH006String客户编号
data.name客户名称String分类名称
data.mobile13555555555String手机号
data.address-String地址
data.note-String备注
data.salernullNull销售员编号
data.createtime1678845614Integer创建时间
data.status1String状态（1:正常，其他：异常）
data.createtime_text2023-03-15 10:00:14String
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/客户/更新客户

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/customers/editCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign632ddc13971fcdb6c85c2cabdca65eecString是签名（签名字段：account，request_time,code,name,mobile）
request_time1659320315String是请求时间戳（小于当前时间5分钟的请求会认为无效）
codeKH006String是客户编号
name客户名称String是客户名称
saler-String否销售员编号
mobile13555555555String是客户联系方式
address客户收货地址String否客户收货地址
note客户备注String否客户备注
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "编辑成功",
	"time": "1647400886",
	"data": ""
}
参数名示例值参数类型参数描述
code1Number状态码
msg编辑成功String返回文字描述
time1647400886Number时间
data-Object返回数据
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名示例值参数类型参数描述
code23Number状态码
msg无效请求String返回文字描述
time1647326548Number时间
data-Object返回数据

/合并对外接口/客户/注销客户

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/customers/delCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signec35d52ba94d1e0b9dc11d7ffd778b03String是签名（签名字段：account，request_time,mobile）
request_time1659320657Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
mobile13555555555String是电话号码
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "注销成功",
	"time": "1647402085",
	"data": ""
}
参数名示例值参数类型参数描述
code1Number状态码
msg注销成功String返回文字描述
time1647402085Number时间
data-Array返回数据
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/销货单

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/销货单/销货单列表

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/sales/getSalesList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signdacc600875a10174d19dbd49dd6cf24aString是签名（签名字段：account，request_time）
request_time1647487343Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
page1Number否页码
limit1Number否每页条数（默认10）
keyword-String否关键词
order_num-String否外部订单号
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1678846296",
	"data": {
		"list": [
			{
				"purchase_code": "XHD20230315001",
				"purchase_time": 1678809600,
				"customers_id": 40,
				"customer_code": "KH006",
				"customer_name": "客户名称",
				"address": "收货地址",
				"number": 1,
				"all_money": 100,
				"preferential_money": 0,
				"real_money": 100,
				"tax_money": 0,
				"money_tax_price": 100,
				"note": "备注",
				"createtime": 1678846279,
				"purchase_time_text": "2023-03-15",
				"createtime_text": "2023-03-15 10:11:19"
			}
		],
		"count": 1
	}
}
参数名示例值参数类型参数描述
code200Integer状态码
msg查询成功String返回文字描述
time1678846296String时间
data-Object返回数据
data.list-Array数据列表
data.list.purchase_codeXHD20230315001String销货单单号
data.list.purchase_time1678809600Integer单据日期时间戳
data.list.customers_id40Integer客户ID
data.list.customer_codeKH006String客户编号
data.list.customer_name客户名称String客户名称
data.list.address收货地址String收货地址
data.list.number1Integer数量
data.list.all_money100Integer销货金额
data.list.preferential_money0Integer优惠额
data.list.real_money100Integer优惠后金额
data.list.tax_money0Integer税额
data.list.money_tax_price100Integer价税合计
data.list.note备注String备注
data.list.createtime1678846279Integer添加时间戳
data.list.purchase_time_text2023-03-15String单据日期
data.list.createtime_text2023-03-15 10:11:19String添加时间
data.count1Integer总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/销货单/添加销货单

goods参数为转换为json的二维数组，数组中的元素是具体的商品数据；
具体的商品数据包含以下字段，缺一不可，没有相关属性则为空值
goods_code|商品编号
goods_unit|商品单位
goods_attr|商品属性（无属性商品此项传空值）
number|数量
price|商品价格
例如：[{"goods_code":"SP001","goods_unit":"3","goods_attr":"","number":1,"price":20},{"goods_code":"SP002","goods_unit":"2","goods_attr":"1","number":1,"price":100}]
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/sales/sales

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign81dfa0f12c1eeed955e3e6d5ad17404fString是签名（签名字段：account,order_num,mobile,goods）
request_time1648437224String是请求时间戳（小于当前时间5分钟的请求会认为无效）
order_num55465848556455String是外部订单号
mobile13555555555String是客户电话
address收货地址String否收货地址（此项为空时将调用此客户的默认收货地址）
note备注String否备注
goods[{“goods_code”:“SP001”,“goods_unit”:“29”,“goods_attr”:“”,“number”:1,“price”:100}]String是商品详情参数
preferential_money0Number否优惠额
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1678846278",
	"data": {
		"id": "68",
		"purchase_code": "XHD20230315001"
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg添加成功String返回文字描述
time1678846278String时间
data-Object返回数据
data.id68String添加的销货单ID
data.purchase_codeXHD20230315001String添加的销货单编号
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名示例值参数类型参数描述
code23Number状态码
msg无效请求String返回文字描述
time1647326548Number时间
data-Object返回数据

/合并对外接口/销货单/销货单详情

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/sales/salesInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
signdf1c86b8398f048f216e51f7e6f98109String是签名（签名字段：account，request_time，purchase_code）
request_time1647499968Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
purchase_codeXHD20230315001String是销货单单号
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1678846353",
	"data": {
		"purchase_code": "XHD20230315001",
		"purchase_time": 1678809600,
		"customers_id": 40,
		"customer_code": "KH006",
		"customer_name": "客户名称",
		"address": "收货地址",
		"number": 1,
		"all_money": 100,
		"preferential_money": 0,
		"real_money": 100,
		"tax_money": 0,
		"money_tax_price": 100,
		"note": "备注",
		"createtime": 1678846279,
		"purchase_time_text": "2023-03-15",
		"createtime_text": "2023-03-15 10:11:19",
		"info_list": [
			{
				"goods_code": "SP001",
				"goods_note": "",
				"goods_attr": 0,
				"goods_unit": 29,
				"unit_name": "个",
				"number": 1,
				"unit_price": 100,
				"tax_included": 100,
				"all_money": 100,
				"tax_money": 0,
				"money_tax_price": 100,
				"attr_name": ""
			}
		]
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg查询成功String返回文字描述
time1678846353String时间
data-Object返回数据
data.purchase_codeXHD20230315001String销货单单号
data.purchase_time1678809600Integer单据日期
data.customers_id40Integer客户ID
data.customer_codeKH006String客户编号
data.customer_name客户名称String客户名称
data.address收货地址String收货地址
data.number1Integer数量
data.all_money100Integer销货金额
data.preferential_money0Integer优惠额
data.real_money100Integer优惠后金额
data.tax_money0Integer税额
data.money_tax_price100Integer价税合计
data.note备注String商品备注
data.createtime1678846279Integer创建时间戳
data.purchase_time_text2023-03-15String单据日期
data.createtime_text2023-03-15 10:11:19String创建时间
data.info_list-Array商品详情数据
data.info_list.goods_codeSP001String商品编号
data.info_list.goods_note-String商品备注
data.info_list.goods_attr0Integer商品属性
data.info_list.goods_unit29Integer商品单位
data.info_list.unit_name个String商品单位名称
data.info_list.number1Integer数量
data.info_list.unit_price100Integer单价
data.info_list.tax_included100Integer含税价
data.info_list.all_money100Integer销货金额
data.info_list.tax_money0Integer税额
data.info_list.money_tax_price100Integer价税合计
data.info_list.attr_name-String属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/合并对外接口/销货退货单

暂无描述
Header参数
参数名示例值参数描述
暂无参数
Query参数
参数名示例值参数描述
暂无参数
Body参数
参数名示例值参数描述
暂无参数
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/合并对外接口/销货退货单/添加销货退货单

goods参数为转换为json的二维数组，数组中的元素是具体的商品数据；
具体的商品数据包含以下字段，缺一不可，没有相关属性则为空值
goods_code|商品编号
goods_unit|商品单位
goods_attr|商品属性（无属性商品此项传空值）
number|数量
price|商品价格
例如：[{"goods_code":"SP001","goods_unit":"3","goods_attr":"","number":1,"price":20},{"goods_code":"SP002","goods_unit":"2","goods_attr":"1","number":1,"price":100}]
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/sales/returnSales

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign81dfa0f12c1eeed955e3e6d5ad17404fString是签名（签名字段：account,request_time,order_num,mobile,goods）
request_time1648438877String是请求时间戳（小于当前时间5分钟的请求会认为无效）
order_num55465848556455String是外部订单号
mobile13555555555String是客户电话
address收货地址String否收货地址（此项为空时将调用此客户的默认收货地址）
note备注String否备注
goods[{“goods_code”:“SP001”,“goods_unit”:“29”,“goods_attr”:“”,“number”:1,“price”:100}]String是商品详情参数
preferential_money10Number否优惠额
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1678846418",
	"data": {
		"id": "13",
		"purchase_code": "XHTH20230315001"
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg添加成功String返回文字描述
time1678846418String时间
data-Object返回数据
data.id13String添加的销货退货单ID
data.purchase_codeXHTH20230315001String添加的销货退货单编号
错误响应示例
{
	"code": 27,
	"msg": "此销货单未审核，不可退货",
	"time": "1678846396",
	"data": ""
}
参数名示例值参数类型参数描述
code27Integer状态码
msg此销货单未审核，不可退货String返回文字描述
time1678846396String时间
data-String返回数据

/合并对外接口/销货退货单/销货退货单详情

暂无描述
接口状态

已完成

接口URL

https://kuyou.mxpcsoft.com/api/kuyou/third/sales/returnsalesInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account13888888888String是账号
sign558800a25762c734e992c485d5f6d0a9String是签名（签名字段：account,id）
request_time1648433672Number是请求时间戳（小于当前时间5分钟的请求会认为无效）
purchase_codeXHTH20230315001String是销货单单号
认证方式
noauth
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1678846442",
	"data": {
		"purchase_code": "XHTH20230315001",
		"purchase_time": 1678809600,
		"customers_id": 40,
		"customer_code": "KH006",
		"customer_name": "客户名称",
		"address": "收货地址",
		"number": 1,
		"all_money": 100,
		"preferential_money": 10,
		"real_money": 90,
		"tax_money": 0,
		"money_tax_price": 100,
		"note": "备注",
		"createtime": 1678846418,
		"purchase_time_text": "2023-03-15",
		"createtime_text": "2023-03-15 10:13:38",
		"info_list": [
			{
				"goods_code": "SP001",
				"goods_note": "",
				"goods_attr": 0,
				"goods_unit": 29,
				"unit_name": "个",
				"number": 1,
				"unit_price": 100,
				"tax_included": 100,
				"all_money": 100,
				"tax_money": 0,
				"money_tax_price": 100,
				"attr_name": ""
			}
		]
	}
}
参数名示例值参数类型参数描述
code1Integer状态码
msg查询成功String返回文字描述
time1678846442String时间
data-Object返回数据
data.purchase_codeXHTH20230315001String销货退货单单号
data.purchase_time1678809600Integer单据日期
data.customers_id40Integer客户ID
data.customer_codeKH006String客户编号
data.customer_name客户名称String客户名称
data.address收货地址String收货地址
data.number1Integer数量
data.all_money100Integer单据金额
data.preferential_money10Integer优惠额
data.real_money90Integer优惠后金额
data.tax_money0Integer税额
data.money_tax_price100Integer价税合计
data.note备注String商品备注
data.createtime1678846418Integer创建时间戳
data.purchase_time_text2023-03-15String单据日期
data.createtime_text2023-03-15 10:13:38String创建时间
data.info_list-Array商品详情数据
data.info_list.goods_codeSP001String商品编号
data.info_list.goods_note-String商品备注
data.info_list.goods_attr0Integer商品属性
data.info_list.goods_unit29Integer商品单位
data.info_list.unit_name个String商品单位名称
data.info_list.number1Integer数量
data.info_list.unit_price100Integer单价
data.info_list.tax_included100Integer含税价
data.info_list.all_money100Integer单据金额
data.info_list.tax_money0Integer税额
data.info_list.money_tax_price100Integer价税合计
data.info_list.attr_name-String属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

酷柚易汛

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值