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

此接口文档可对接商城系统,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参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign dacc600875a10174d19dbd49dd6cf24a String 签名(签名字段:account)
request_time 1647323593 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
pid - Number 父级ID
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 200,
	"msg": "查询成功",
	"time": "1647323345",
	"data": [
		{
			"id": 1,
			"pid": 0,
			"name": "商品默认分类",
			"image": "/assets/img/qrcode.png",
			"updatetime": "2022-02-09"
		}
	]
}
参数名 示例值 参数类型 是否必填 参数描述
code 200 Number 状态码
msg 查询成功 String 返回文字描述
time 1647323345 Number 时间
data - Array 返回数据
data.id 1 Number 分类ID
data.pid - Number 分类父ID
data.name 商品默认分类 String 分类名称
data.image /assets/img/qrcode.png String 分类图片
data.updatetime 2022-02-09 String 更新时间
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign dacc600875a10174d19dbd49dd6cf24a String 签名(签名字段:account)
request_time 1647499719 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
page 1 Number 页码
limit 1 Number 每页条数(默认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
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 200 Number 状态码
msg 查询成功 String 返回文字描述
time 1647325849 Number 时间
data - Array 订单号
data.list - Object 返回数据
data.list.id 2 Number 商品ID
data.list.goods_code SP002 String 商品编号
data.list.goods_type_id 1 Number 商品分类ID
data.list.goods_name 毛衣 String 商品名称
data.list.goods_barcode 10002 String 商品条码
data.list.note - Object 商品备注
data.list.goods_spec - Object 规格型号
data.list.unit_id 2 Number 商品单位ID
data.list.unit_name String 商品单位名称
data.list.more_unit 2 String 是否多单位(1:是,2:否)
data.list.purchase 50 Number 预计采购价
data.list.market_sell_price 100 Number 零售价
data.list.wholesale_price 80 Number 批发价
data.list.vip_price 70 Number VIP会员价
data.list.discount 80 Number 折扣率1(%)
data.list.discount2 70 Number 折扣率2(%)
data.list.goods_image http://127.0.0.30/assets/img/qrcode.png String 商品图片
data.list.stock - Number 商品库存
data.list.updatetime 2022-03-15 14:27:39 String 更新时间
data.count 2 Number 总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign 2d5c44487220fc36d89c953f2829e8ac String 签名(签名字段:account,id)
request_time 1647394207 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
id 1 Number 页码
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"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"
			}
		]
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 200 Number 状态码
msg 查询成功 String 返回文字描述
time 1647394262 Number 时间
data - Array 返回数据
data.id 1 Number 商品ID
data.goods_code SP001 String 商品编号
data.goods_name 默认商品 String 商品名称
data.goods_barcode 10001 String 商品条码
data.goods_spec 默认 String 规格型号
data.goods_type_id 1 Number 分类ID
data.unit_id 3 Number 单位ID
data.goods_image http://127.0.0.30/assets/img/qrcode.png String 商品主图
data.goods_images http://127.0.0.30/uploads/20220315/b7f15b580afdb771d8c2d72dc4dc3c63.jpeg String 商品图集
data.note - Object 商品备注
data.more_unit 1 String 是否多单位(1:是,2:否)
data.content - Object 商品详情
data.unit_data - Object 单位价格数组
data.unit_data.unit 3 Number 单位ID
data.unit_data.purchase 5 Number 预计采购价
data.unit_data.market_sell_price 20 Number 零售价
data.unit_data.wholesale_price 15 Number 批发价
data.unit_data.vip_price 12 Number VIP会员价
data.unit_data.discount 80 Number 折扣率1
data.unit_data.discount2 70 Number 折扣率2
data.unit_data.is_default 1 Number 是否默认单位(0:否,1:是)
data.unit_data.name String 单位名称
data.unit_data.stock 1.3 Number 库存
data.attr_data - Object 属性价格数组(商品多单位时价格按单位价格数组为准,单一单位时可使用属性价格)
data.attr_data.id 5 Number 属性组合ID
data.attr_data.attr_code SP001_1 String 属性编号
data.attr_data.barcode SP001_1 String 属性条码
data.attr_data.unit 3 Number 单位ID
data.attr_data.purchase - Object 预计采购价
data.attr_data.market_sell_price - Object 零售价
data.attr_data.wholesale_price - Object 批发价
data.attr_data.vip_price - Object VIP会员价
data.attr_data.discount - Object 折扣率1
data.attr_data.discount2 - Object 折扣率2
data.attr_data.attr_name 红色/L String 属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

/对外接口/客户

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

暂无参数

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

暂无参数

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

暂无参数

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

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

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

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign dacc600875a10174d19dbd49dd6cf24a String 签名(签名字段:account)
request_time 1647401295 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
page 1 Number 页码
limit 1 Number 每页条数(默认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
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 200 Number 状态码
msg 查询成功 String 返回文字描述
time 1647401299 Number 时间
data - Array 返回数据
data.list - Object 数据列表
data.list.customer_code KH003 String 客户编号
data.list.name 客户名称 String 客户名称
data.list.mobile 13555555555 String 电话号码
data.list.saler ZY001 String 销售员编号
data.list.createtime 1647398431 Number 添加时间戳
data.list.status 1 String 状态(1:正常,其他:异常)
data.list.createtime_text 2022-03-16 10:40:31 String 添加时间
data.count 1 Number 总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

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

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

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

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign 632ddc13971fcdb6c85c2cabdca65eec String 签名(签名字段:account,code,name,mobile)
request_time 1647400760 String 请求时间戳(小于当前时间5分钟的请求会认为无效)
code KH003 String 客户编号
name 客户名称 String 客户名称
saler ZY001 String 销售员编号
mobile 13555555555 String 客户联系方式
address - String 客户收货地址
note - String 客户备注
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "编辑成功",
	"time": "1647400886",
	"data": ""
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 编辑成功 String 返回文字描述
time 1647400886 Number 时间
data - Object 返回数据
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名 示例值 参数类型 是否必填 参数描述
code 23 Number 状态码
msg 无效请求 String 返回文字描述
time 1647326548 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign ec35d52ba94d1e0b9dc11d7ffd778b03 String 签名(签名字段:account,mobile)
request_time 1647402076 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
mobile 13555555555 String 电话号码
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "注销成功",
	"time": "1647402085",
	"data": ""
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 注销成功 String 返回文字描述
time 1647402085 Number 时间
data - Array 返回数据
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

/对外接口/销货单

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

暂无参数

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

暂无参数

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

暂无参数

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

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign dacc600875a10174d19dbd49dd6cf24a String 签名(签名字段:account)
request_time 1647487343 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
page 1 Number 页码
limit 1 Number 每页条数(默认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
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 200 Number 状态码
msg 查询成功 String 返回文字描述
time 1647487404 Number 时间
data - Array 返回数据
data.list - Object 数据列表
data.list.purchase_code XHD20220316002 String 销货单单号
data.list.purchase_time 1647360000 Number 单据日期时间戳
data.list.customers_id 6 Number 客户ID
data.list.customer_code KH003 String 客户编号
data.list.customer_name 客户名称 String 客户名称
data.list.address 收货地址 String 收货地址
data.list.number 2 Number 数量
data.list.all_money 120 Number 销货金额
data.list.preferential_money 10 Number 优惠额
data.list.real_money 125.6 Number 优惠后金额
data.list.tax_money 15.6 Number 税额
data.list.money_tax_price 135.6 Number 价税合计
data.list.note 备注 String 备注
data.list.createtime 1647424041 Number 添加时间戳
data.list.purchase_time_text 2022-03-16 String 单据日期
data.list.createtime_text 2022-03-16 17:47:21 String 添加时间
data.count 1 Number 总条数
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
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参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign 81dfa0f12c1eeed955e3e6d5ad17404f String 签名(签名字段:account,order_num,mobile,goods)
request_time 1648437224 String 请求时间戳(小于当前时间5分钟的请求会认为无效)
order_num 55465848556455 String 外部订单号
mobile 13555555555 String 客户电话
address 收货地址 String 收货地址(此项为空时将调用此客户的默认收货地址)
note 备注 String 备注
goods [{“goods_code”:“SP001”,“goods_unit”:“1”,“goods_attr”:"",“number”:1,“price”:100}] String 商品详情参数
preferential_money 10 Number 优惠额
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1647423485",
	"data": {
		"id": "3",
		"purchase_code": "XHD20220316002"
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 添加成功 String 返回文字描述
time 1647423485 Number 时间
data - Object 返回数据
data.id 3 Number 添加的销货单ID
data.purchase_code XHD20220316002 String 添加的销货单编号
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名 示例值 参数类型 是否必填 参数描述
code 23 Number 状态码
msg 无效请求 String 返回文字描述
time 1647326548 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign df1c86b8398f048f216e51f7e6f98109 String 签名(签名字段:account,id)
request_time 1647499968 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
purchase_code XHD20220317002 String 销货单单号
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"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"
			}
		]
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 查询成功 String 返回文字描述
time 1647500059 Number 时间
data - Array 返回数据
data.purchase_code XHD20220317002 String 销货单单号
data.purchase_time 1647446400 Number 单据日期
data.customers_id 6 Number 客户ID
data.customer_code KH003 String 客户编号
data.customer_name 客户名称 String 客户名称
data.address 收货地址 String 收货地址
data.number 2 Number 数量
data.all_money 106.1947 Number 销货金额
data.preferential_money 10 Number 优惠额
data.real_money 110 Number 优惠后金额
data.tax_money 13.8053 Number 税额
data.money_tax_price 120 Number 价税合计
data.note 备注 Object 商品备注
data.createtime 1647499957 Number 创建时间戳
data.purchase_time_text 2022-03-17 String 单据日期
data.createtime_text 2022-03-17 14:52:37 String 创建时间
data.info_list - Object 商品详情数据
data.info_list.goods_code SP001 String 商品编号
data.info_list.goods_note - Object 商品备注
data.info_list.goods_attr 7 Number 商品属性
data.info_list.goods_unit 3 Number 商品单位
data.info_list.unit_name String 商品单位名称
data.info_list.number 1 Number 数量
data.info_list.unit_price 17.6991 Number 单价
data.info_list.tax_included 20 Number 含税价
data.info_list.all_money 17.6991 Number 销货金额
data.info_list.tax_money 2.3009 Number 税额
data.info_list.money_tax_price 20 Number 价税合计
data.info_list.attr_name 红色/L String 属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
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参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign 81dfa0f12c1eeed955e3e6d5ad17404f String 签名(签名字段:account,order_num,mobile,goods)
request_time 1648438877 String 请求时间戳(小于当前时间5分钟的请求会认为无效)
order_num 55465848556455 String 外部订单号
mobile 13555555555 String 客户电话
address 收货地址 String 收货地址(此项为空时将调用此客户的默认收货地址)
note 备注 String 备注
goods [{“goods_code”:“SP001”,“goods_unit”:“1”,“goods_attr”:"",“number”:1,“price”:100}] String 商品详情参数
preferential_money 10 Number 优惠额
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"code": 1,
	"msg": "添加成功",
	"time": "1647509976",
	"data": {
		"id": "4",
		"purchase_code": "XHTH20220317001"
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 添加成功 String 返回文字描述
time 1647509976 Number 时间
data - Object 返回数据
data.id 4 Number 添加的销货退货单ID
data.purchase_code XHTH20220317001 String 添加的销货退货单编号
错误响应示例
{
	"code": 23,
	"msg": "无效请求",
	"time": "1647326548",
	"data": ""
}
参数名 示例值 参数类型 是否必填 参数描述
code 23 Number 状态码
msg 无效请求 String 返回文字描述
time 1647326548 Number 时间
data - Object 返回数据

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

暂无描述
接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

urlencoded

请求Body参数
参数名 示例值 参数类型 是否必填 参数描述
account 165945954465 String 账号
sign 558800a25762c734e992c485d5f6d0a9 String 签名(签名字段:account,id)
request_time 1648433672 Number 请求时间戳(小于当前时间5分钟的请求会认为无效)
purchase_code XHTH20220328001 String 销货单单号
预执行脚本
暂无预执行脚本
后执行脚本
暂无后执行脚本
成功响应示例
{
	"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": ""
			}
		]
	}
}
参数名 示例值 参数类型 是否必填 参数描述
code 1 Number 状态码
msg 查询成功 String 返回文字描述
time 1648433928 Number 时间
data - Array 返回数据
data.purchase_code XHTH20220328001 String 销货退货单单号
data.purchase_time 1648396800 Number 单据日期
data.customers_id 2 Number 客户ID
data.customer_code KH002 String 客户编号
data.customer_name 客户名称 String 客户名称
data.address 收货地址 String 收货地址
data.number 1 Number 数量
data.all_money 100 Number 销货金额
data.preferential_money 10 Number 优惠额
data.real_money 90 Number 优惠后金额
data.tax_money - Number 税额
data.money_tax_price 100 Number 价税合计
data.note 备注 Object 商品备注
data.createtime 1648433907 Number 创建时间戳
data.purchase_time_text 2022-03-28 String 单据日期
data.createtime_text 2022-03-28 10:18:27 String 创建时间
data.info_list - Object 商品详情数据
data.info_list.goods_code SP001 String 商品编号
data.info_list.goods_note - Object 商品备注
data.info_list.goods_attr - Number 商品属性
data.info_list.goods_unit 1 Number 商品单位
data.info_list.unit_name String 商品单位名称
data.info_list.number 1 Number 数量
data.info_list.unit_price 100 Number 单价
data.info_list.tax_included 100 Number 含税价
data.info_list.all_money 100 Number 销货金额
data.info_list.tax_money - Number 税额
data.info_list.money_tax_price 100 Number 价税合计
data.info_list.attr_name - String 属性名称
错误响应示例
{
	"code": 24,
	"msg": "签名错误",
	"time": "1637200680",
	"data": null
}
参数名 示例值 参数类型 是否必填 参数描述
code 24 Number 状态码
msg 签名错误 String 返回文字描述
time 1637200680 Number 时间
data - Object 返回数据

你可能感兴趣的:(php)