酷柚易汛进销存开源版对外接口

此接口文档可对接商城系统,CRM系统,OA系统等

/对外接口

暂无描述
公共Header参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Query参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Body参数
参数名示例值参数类型是否必填参数描述

暂无参数

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/对外接口/签名

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

已完成

接口URL

未填写

请求方式

POST

Content-Type

urlencoded

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/对外接口/错误码

21 : 账户不存在
22 : 账户状态异常
23 : 无效请求
24 : 签名错误
25 : 参数错误
26 : 校验规则错误(接口错误)
27 : 业务逻辑错误
接口状态

已完成

接口URL

未填写

请求方式

POST

Content-Type

urlencoded

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/对外接口/商品

暂无描述
公共Header参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Query参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Body参数
参数名示例值参数类型是否必填参数描述

暂无参数

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/goods/goodsTypeList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdacc600875a10174d19dbd49dd6cf24aString签名(签名字段:account)
request_time1647323593Number请求时间戳(小于当前时间5分钟的请求会认为无效)
pid-Number父级ID
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647323345",
	"data": [
		{
			"id": 1,
			"pid": 0,
			"name": "商品默认分类",
			"image": "/assets/img/qrcode.png",
			"updatetime": "2022-02-09"
		}
	]
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647323345Number时间
data-Array返回数据
data.id1Number分类ID
data.pid-Number分类父ID
data.name商品默认分类String分类名称
data.image/assets/img/qrcode.pngString分类图片
data.updatetime2022-02-09String更新时间
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/goods/getGoodsList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdacc600875a10174d19dbd49dd6cf24aString签名(签名字段:account)
request_time1647499719Number请求时间戳(小于当前时间5分钟的请求会认为无效)
page1Number页码
limit1Number每页条数(默认10)
goods_type_id-Number商品分类ID
keyword-String关键词
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647325849",
	"data": {
		"list": [
			{
				"id": 2,
				"goods_code": "SP002",
				"goods_type_id": 1,
				"goods_name": "毛衣",
				"goods_barcode": "10002",
				"note": "",
				"goods_spec": "",
				"unit_id": 2,
				"unit_name": "件",
				"more_unit": "2",
				"purchase": 50,
				"market_sell_price": 100,
				"wholesale_price": 80,
				"vip_price": 70,
				"discount": 80,
				"discount2": 70,
				"goods_image": "http://127.0.0.30/assets/img/qrcode.png",
				"stock": 0,
				"updatetime": "2022-03-15 14:27:39"
			}
		],
		"count": 2
	}
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647325849Number时间
data-Array订单号
data.list-Object返回数据
data.list.id2Number商品ID
data.list.goods_codeSP002String商品编号
data.list.goods_type_id1Number商品分类ID
data.list.goods_name毛衣String商品名称
data.list.goods_barcode10002String商品条码
data.list.note-Object商品备注
data.list.goods_spec-Object规格型号
data.list.unit_id2Number商品单位ID
data.list.unit_nameString商品单位名称
data.list.more_unit2String是否多单位(1:是,2:否)
data.list.purchase50Number预计采购价
data.list.market_sell_price100Number零售价
data.list.wholesale_price80Number批发价
data.list.vip_price70NumberVIP会员价
data.list.discount80Number折扣率1(%)
data.list.discount270Number折扣率2(%)
data.list.goods_imagehttp://127.0.0.30/assets/img/qrcode.pngString商品图片
data.list.stock-Number商品库存
data.list.updatetime2022-03-15 14:27:39String更新时间
data.count2Number总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/goods/getGoodsInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
sign2d5c44487220fc36d89c953f2829e8acString签名(签名字段:account,id)
request_time1647394207Number请求时间戳(小于当前时间5分钟的请求会认为无效)
id1Number页码
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647394262",
	"data": {
		"id": 1,
		"goods_code": "SP001",
		"goods_name": "默认商品",
		"goods_barcode": "10001",
		"goods_spec": "默认",
		"goods_type_id": 1,
		"unit_id": 3,
		"goods_image": "http://127.0.0.30/assets/img/qrcode.png",
		"goods_images": [
			"http://127.0.0.30/uploads/20220315/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg",
			"http://127.0.0.30/uploads/20220315/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg"
		],
		"note": "",
		"more_unit": "1",
		"content": "",
		"unit_data": [
			{
				"unit": 3,
				"purchase": 5,
				"market_sell_price": 20,
				"wholesale_price": 15,
				"vip_price": 12,
				"discount": 80,
				"discount2": 70,
				"is_default": 1,
				"name": "个",
				"stock": 1.3
			},
			{
				"unit": 4,
				"purchase": 50,
				"market_sell_price": 200,
				"wholesale_price": 150,
				"vip_price": 120,
				"discount": 80,
				"discount2": 70,
				"is_default": 0,
				"name": "箱",
				"stock": 0.13
			}
		],
		"attr_data": [
			{
				"id": 5,
				"attr_code": "SP001_1",
				"barcode": "SP001_1",
				"unit": 3,
				"purchase": null,
				"market_sell_price": null,
				"wholesale_price": null,
				"vip_price": null,
				"discount": null,
				"discount2": null,
				"attr_name": "红色/L"
			},
			{
				"id": 6,
				"attr_code": "SP001_2",
				"barcode": "SP001_2",
				"unit": 3,
				"purchase": null,
				"market_sell_price": null,
				"wholesale_price": null,
				"vip_price": null,
				"discount": null,
				"discount2": null,
				"attr_name": "蓝色/L"
			}
		]
	}
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647394262Number时间
data-Array返回数据
data.id1Number商品ID
data.goods_codeSP001String商品编号
data.goods_name默认商品String商品名称
data.goods_barcode10001String商品条码
data.goods_spec默认String规格型号
data.goods_type_id1Number分类ID
data.unit_id3Number单位ID
data.goods_imagehttp://127.0.0.30/assets/img/qrcode.pngString商品主图
data.goods_imageshttp://127.0.0.30/uploads/20220315/b7f15b580afdb771d8c2d72dc4dc3c63.jpegString商品图集
data.note-Object商品备注
data.more_unit1String是否多单位(1:是,2:否)
data.content-Object商品详情
data.unit_data-Object单位价格数组
data.unit_data.unit3Number单位ID
data.unit_data.purchase5Number预计采购价
data.unit_data.market_sell_price20Number零售价
data.unit_data.wholesale_price15Number批发价
data.unit_data.vip_price12NumberVIP会员价
data.unit_data.discount80Number折扣率1
data.unit_data.discount270Number折扣率2
data.unit_data.is_default1Number是否默认单位(0:否,1:是)
data.unit_data.nameString单位名称
data.unit_data.stock1.3Number库存
data.attr_data-Object属性价格数组(商品多单位时价格按单位价格数组为准,单一单位时可使用属性价格)
data.attr_data.id5Number属性组合ID
data.attr_data.attr_codeSP001_1String属性编号
data.attr_data.barcodeSP001_1String属性条码
data.attr_data.unit3Number单位ID
data.attr_data.purchase-Object预计采购价
data.attr_data.market_sell_price-Object零售价
data.attr_data.wholesale_price-Object批发价
data.attr_data.vip_price-ObjectVIP会员价
data.attr_data.discount-Object折扣率1
data.attr_data.discount2-Object折扣率2
data.attr_data.attr_name红色/LString属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

/对外接口/客户

暂无描述
公共Header参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Query参数
参数名示例值参数类型是否必填参数描述

暂无参数

公共Body参数
参数名示例值参数类型是否必填参数描述

暂无参数

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

/对外接口/客户/职员列表

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/customers/getSalesList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdacc600875a10174d19dbd49dd6cf24aString签名(签名字段:account)
request_time1647394044Number请求时间戳(小于当前时间5分钟的请求会认为无效)
page1Number页码
limit1Number每页条数(默认10)
keyword-String关键词
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647394049",
	"data": {
		"list": [
			{
				"id": 1,
				"men_code": "ZY001",
				"name": "默认职员",
				"phone": "139****9999",
				"updatetime": null
			}
		],
		"count": 1
	}
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647394049Number时间
data-Array返回数据
data.list-Object数据列表
data.list.id1Number职员ID
data.list.men_codeZY001String职员编号
data.list.name默认职员String职员名称
data.list.phone139****9999String电话
data.list.updatetime-String更新时间
data.count1Number总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/customers/getCustomersList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdacc600875a10174d19dbd49dd6cf24aString签名(签名字段:account)
request_time1647401295Number请求时间戳(小于当前时间5分钟的请求会认为无效)
page1Number页码
limit1Number每页条数(默认10)
keyword-String关键词
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647401299",
	"data": {
		"list": [
			{
				"customer_code": "KH003",
				"name": "客户名称",
				"mobile": "13555555555",
				"saler": "ZY001",
				"createtime": 1647398431,
				"status": "1",
				"createtime_text": "2022-03-16 10:40:31"
			}
		],
		"count": 1
	}
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647401299Number时间
data-Array返回数据
data.list-Object数据列表
data.list.customer_codeKH003String客户编号
data.list.name客户名称String客户名称
data.list.mobile13555555555String电话号码
data.list.salerZY001String销售员编号
data.list.createtime1647398431Number添加时间戳
data.list.status1String状态(1:正常,其他:异常)
data.list.createtime_text2022-03-16 10:40:31String添加时间
data.count1Number总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/customers/joinCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
sign9f99c47b9777bd38528b43df709c2d0bString签名(签名字段:account,name,mobile)
request_time1647397216String请求时间戳(小于当前时间5分钟的请求会认为无效)
name客户名称String客户名称
salerZY001String销售员编号
mobile13555555555String客户联系方式
address-String客户收货地址
note-String客户备注
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1647397220",
	"data": {
		"id": "4",
		"customer_code": "KH003"
	}
}
参数名示例值参数类型是否必填参数描述
code1Number状态码
msg添加成功String返回文字描述
time1647397220Number时间
data-Object返回数据
data.id4Number添加的客户ID
data.customer_codeKH003String添加的客户编号
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名示例值参数类型是否必填参数描述
code23Number状态码
msg无效请求String返回文字描述
time1647326548Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/customers/customersInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signec35d52ba94d1e0b9dc11d7ffd778b03String签名(签名字段:account,mobile)
request_time1647399954Number请求时间戳(小于当前时间5分钟的请求会认为无效)
mobile13555555555String电话号码
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1647400106",
	"data": {
		"customer_code": "KH003",
		"name": "客户名称",
		"mobile": "13555555555",
		"address": "",
		"note": "",
		"saler": "ZY001",
		"createtime": 1647398431,
		"status": "1",
		"createtime_text": "2022-03-16 10:40:31"
	}
}
参数名示例值参数类型是否必填参数描述
code1Number状态码
msg查询成功String返回文字描述
time1647400106Number时间
data-Array返回数据
data.customer_codeKH003String客户编号
data.name客户名称String客户名称
data.mobile13555555555String电话号码
data.address-Object收货地址
data.note-Object备注
data.salerZY001String销售员编号
data.createtime1647398431Number添加时间戳
data.status1String状态(1:正常,其他:异常)
data.createtime_text2022-03-16 10:40:31String添加时间
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/customers/editCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
sign632ddc13971fcdb6c85c2cabdca65eecString签名(签名字段:account,code,name,mobile)
request_time1647400760String请求时间戳(小于当前时间5分钟的请求会认为无效)
codeKH003String客户编号
name客户名称String客户名称
salerZY001String销售员编号
mobile13555555555String客户联系方式
address-String客户收货地址
note-String客户备注
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"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

http://127.0.0.30/api/kuerp/third/customers/delCustomers

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signec35d52ba94d1e0b9dc11d7ffd778b03String签名(签名字段:account,mobile)
request_time1647402076Number请求时间戳(小于当前时间5分钟的请求会认为无效)
mobile13555555555String电话号码
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"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参数
参数名示例值参数类型是否必填参数描述

暂无参数

预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/sales/getSalesList

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdacc600875a10174d19dbd49dd6cf24aString签名(签名字段:account)
request_time1647487343Number请求时间戳(小于当前时间5分钟的请求会认为无效)
page1Number页码
limit1Number每页条数(默认10)
keyword-String关键词
order_num-String外部订单号
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647487404",
	"data": {
		"list": [
			{
				"purchase_code": "XHD20220316002",
				"purchase_time": 1647360000,
				"customers_id": 6,
				"customer_code": "KH003",
				"customer_name": "客户名称",
				"address": "收货地址",
				"number": 2,
				"all_money": 120,
				"preferential_money": 10,
				"real_money": 125.6,
				"tax_money": 15.6,
				"money_tax_price": 135.6,
				"note": "备注",
				"createtime": 1647424041,
				"purchase_time_text": "2022-03-16",
				"createtime_text": "2022-03-16 17:47:21"
			}
		],
		"count": 1
	}
}
参数名示例值参数类型是否必填参数描述
code200Number状态码
msg查询成功String返回文字描述
time1647487404Number时间
data-Array返回数据
data.list-Object数据列表
data.list.purchase_codeXHD20220316002String销货单单号
data.list.purchase_time1647360000Number单据日期时间戳
data.list.customers_id6Number客户ID
data.list.customer_codeKH003String客户编号
data.list.customer_name客户名称String客户名称
data.list.address收货地址String收货地址
data.list.number2Number数量
data.list.all_money120Number销货金额
data.list.preferential_money10Number优惠额
data.list.real_money125.6Number优惠后金额
data.list.tax_money15.6Number税额
data.list.money_tax_price135.6Number价税合计
data.list.note备注String备注
data.list.createtime1647424041Number添加时间戳
data.list.purchase_time_text2022-03-16String单据日期
data.list.createtime_text2022-03-16 17:47:21String添加时间
data.count1Number总条数
错误响应示例
{
	"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

http://127.0.0.30/api/kuerp/third/sales/sales

请求方式

POST

Content-Type

urlencoded

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

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/sales/salesInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
signdf1c86b8398f048f216e51f7e6f98109String签名(签名字段:account,id)
request_time1647499968Number请求时间戳(小于当前时间5分钟的请求会认为无效)
purchase_codeXHD20220317002String销货单单号
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1647500059",
	"data": {
		"purchase_code": "XHD20220317002",
		"purchase_time": 1647446400,
		"customers_id": 6,
		"customer_code": "KH003",
		"customer_name": "客户名称",
		"address": "收货地址",
		"number": 2,
		"all_money": 106.1947,
		"preferential_money": 10,
		"real_money": 110,
		"tax_money": 13.8053,
		"money_tax_price": 120,
		"note": "备注",
		"createtime": 1647499957,
		"purchase_time_text": "2022-03-17",
		"createtime_text": "2022-03-17 14:52:37",
		"info_list": [
			{
				"goods_code": "SP001",
				"goods_note": "",
				"goods_attr": 7,
				"goods_unit": 3,
				"unit_name": "个",
				"number": 1,
				"unit_price": 17.6991,
				"tax_included": 20,
				"all_money": 17.6991,
				"tax_money": 2.3009,
				"money_tax_price": 20,
				"attr_name": "红色/L"
			},
			{
				"goods_code": "SP002",
				"goods_note": "",
				"goods_attr": 1,
				"goods_unit": 2,
				"unit_name": "件",
				"number": 1,
				"unit_price": 88.4956,
				"tax_included": 100,
				"all_money": 88.4956,
				"tax_money": 11.5044,
				"money_tax_price": 100,
				"attr_name": "红色/L"
			}
		]
	}
}
参数名示例值参数类型是否必填参数描述
code1Number状态码
msg查询成功String返回文字描述
time1647500059Number时间
data-Array返回数据
data.purchase_codeXHD20220317002String销货单单号
data.purchase_time1647446400Number单据日期
data.customers_id6Number客户ID
data.customer_codeKH003String客户编号
data.customer_name客户名称String客户名称
data.address收货地址String收货地址
data.number2Number数量
data.all_money106.1947Number销货金额
data.preferential_money10Number优惠额
data.real_money110Number优惠后金额
data.tax_money13.8053Number税额
data.money_tax_price120Number价税合计
data.note备注Object商品备注
data.createtime1647499957Number创建时间戳
data.purchase_time_text2022-03-17String单据日期
data.createtime_text2022-03-17 14:52:37String创建时间
data.info_list-Object商品详情数据
data.info_list.goods_codeSP001String商品编号
data.info_list.goods_note-Object商品备注
data.info_list.goods_attr7Number商品属性
data.info_list.goods_unit3Number商品单位
data.info_list.unit_nameString商品单位名称
data.info_list.number1Number数量
data.info_list.unit_price17.6991Number单价
data.info_list.tax_included20Number含税价
data.info_list.all_money17.6991Number销货金额
data.info_list.tax_money2.3009Number税额
data.info_list.money_tax_price20Number价税合计
data.info_list.attr_name红色/LString属性名称
错误响应示例
{
	"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

http://127.0.0.30/api/kuerp/third/sales/returnSales

请求方式

POST

Content-Type

urlencoded

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

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

暂无描述
接口状态

已完成

接口URL

http://127.0.0.30/api/kuerp/third/sales/returnsalesInfo

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名示例值参数类型是否必填参数描述
account165945954465String账号
sign558800a25762c734e992c485d5f6d0a9String签名(签名字段:account,id)
request_time1648433672Number请求时间戳(小于当前时间5分钟的请求会认为无效)
purchase_codeXHTH20220328001String销货单单号
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "查询成功",
	"time": "1648433928",
	"data": {
		"purchase_code": "XHTH20220328001",
		"purchase_time": 1648396800,
		"customers_id": 2,
		"customer_code": "KH002",
		"customer_name": "客户名称",
		"address": "收货地址",
		"number": 1,
		"all_money": 100,
		"preferential_money": 10,
		"real_money": 90,
		"tax_money": 0,
		"money_tax_price": 100,
		"note": "备注",
		"createtime": 1648433907,
		"purchase_time_text": "2022-03-28",
		"createtime_text": "2022-03-28 10:18:27",
		"info_list": [
			{
				"goods_code": "SP001",
				"goods_note": "",
				"goods_attr": 0,
				"goods_unit": 1,
				"unit_name": "个",
				"number": 1,
				"unit_price": 100,
				"tax_included": 100,
				"all_money": 100,
				"tax_money": 0,
				"money_tax_price": 100,
				"attr_name": ""
			}
		]
	}
}
参数名示例值参数类型是否必填参数描述
code1Number状态码
msg查询成功String返回文字描述
time1648433928Number时间
data-Array返回数据
data.purchase_codeXHTH20220328001String销货退货单单号
data.purchase_time1648396800Number单据日期
data.customers_id2Number客户ID
data.customer_codeKH002String客户编号
data.customer_name客户名称String客户名称
data.address收货地址String收货地址
data.number1Number数量
data.all_money100Number销货金额
data.preferential_money10Number优惠额
data.real_money90Number优惠后金额
data.tax_money-Number税额
data.money_tax_price100Number价税合计
data.note备注Object商品备注
data.createtime1648433907Number创建时间戳
data.purchase_time_text2022-03-28String单据日期
data.createtime_text2022-03-28 10:18:27String创建时间
data.info_list-Object商品详情数据
data.info_list.goods_codeSP001String商品编号
data.info_list.goods_note-Object商品备注
data.info_list.goods_attr-Number商品属性
data.info_list.goods_unit1Number商品单位
data.info_list.unit_nameString商品单位名称
data.info_list.number1Number数量
data.info_list.unit_price100Number单价
data.info_list.tax_included100Number含税价
data.info_list.all_money100Number销货金额
data.info_list.tax_money-Number税额
data.info_list.money_tax_price100Number价税合计
data.info_list.attr_name-String属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名示例值参数类型是否必填参数描述
code24Number状态码
msg签名错误String返回文字描述
time1637200680Number时间
data-Object返回数据
  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

酷柚易汛

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

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

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

打赏作者

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

抵扣说明:

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

余额充值