- 会员信息
- 订单数据(线上请求信息)详情
- 提交订单(线上请求)将线上订单同步至erp
- 查询优惠券是否可用
- 核销优惠券
- 商品同步(从海典接口获取商品)
- 订单接收(接收海典上传订单)
- 积分同步(接收海典积分消息推送)
- 新增会员、修改会员信息
一、会员信息
- /api/user-info
请求方式:
- POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| mobile | 是 | string | 手机号 (与名称二选一) |
| real_name | 否 | string | 会员真实名称 |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"data": {
"uid": "1",
"account": "admin",
"nickname": "Minho",
"group_level": 0 ,
"create_time": "1436864169",
"last_login_time": "0",
}
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| group_level | int | 用户组id,1:超级管理员;2:普通用户 |
二、订单数据
请求URL:
/api/order-list
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| mobile | 是 | string | 手机号 |
| order_sn | 是 | string | 订单号 |
| page | 是 | int | 页码 |
| start_date | 是 | string | 开始时间段(时间段间隔不可超过3月) |
| end_date | 是 | string | 结束时间段(时间段间隔不可超过3月) |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"data": {
"order_id": "订单ID",
"order_sn": "订单号",
"user_id": "用户ID",
"order_type": "1、自提订单2、配送订单",
"order_amount": "订单总金额" ,
"shipping_fee": "运费(快递费)",
"goods_amount": "商品总金额",
"act_price": "优惠金额",
"coupons_id": "优惠券ID",
"pay_name": "支付方式",
"consignee": "收货人",
"address": "收货地址",
"add_time": "下单时间",
"pay_time": "支付时间",
"order_goods":[
{
"goods_no":"商品编号",
"goods_name":"商品名称",
"goods_price":"商品金额",
"goods_number":"购买数量",
"goods_amount":"商品总金额",
}
]
}
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}返回参数说明:
| 参数名 | 类型 | 说明 |
|---|---|---|
| group_level | int | 用户组id,1:超级管理员;2:普通用户 |
三、提交订单至海典系统
请求URL:
/api/order-add
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| order_sn | 是 | string | 订单号 |
| order_amount | 是 | string | 订单总金额 |
| goods_amount | 是 | string | 商品总金额 |
| shipping_fee | 是 | string | 配送费 |
| order_type | 是 | string | 1、自提订单2、配送订单 |
| consignee | 是 | string | 收货人 |
| address | 是 | string | 收货地址 |
| add_time | 是 | string | 下单时间 |
| pay_time | 是 | string | 支付时间 |
| sign | 是 | string | MD5签名 |
| order_goods | 是 | array | 订单商品 |
| –goods_no | 是 | string | –商品编号 |
| –goods_name | 是 | string | –商品名 |
| –goods_price | 是 | string | –商品单价 |
| –goods_number | 是 | string | –商品数量 |
| –goods_amount | 是 | string | –商品总金额 |
返回示例:
正确时返回:
{
"code": 0,
"msg": "成功",
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}四、查询优惠券是否可用
请求URL:
/api/coupons-info
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| coupons_id | 是 | string | 卡券ID |
| coupons_sn | 是 | string | 卡券编号 |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"data": {
"user_id": "用户ID",
"coupons_id": "卡券ID",
"coupons_sn": "卡券编号",
"coupons_name": "卡券名称",
"status": "卡券状态",
"is_enable": "是否可用",
"is_delete": "是否作废",
"ext_info":[
{
"coupons_price":"卡券金额",
"min_goods_amount":"最低使用金额",
"start_time":"有效开始时间",
"end_time":"有效结束时间",
}
]
}
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}五、核销优惠券
请求URL:
/api/coupons-use
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| coupons_id | 是 | string | 卡券ID |
| coupons_sn | 是 | string | 卡券编号 |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"msg": "操作成功"
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}五、订单配送、自提成功
请求URL:
/api/order-send
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| order_sn | 是 | string | 订单号 |
| send_type | 是 | string | 自提、配送 |
| express_no | 否 | string | (自提为空,配送方式必填)配送单号 |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"msg": "操作成功"
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}六、订单配送、自提成功
请求URL:
/api/order-send
POST
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型: application/json |
请求参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 用户ID |
| order_sn | 是 | string | 订单号 |
| send_type | 是 | string | 自提、配送 |
| express_no | 否 | string | (自提为空,配送方式必填)配送单号 |
| sign | 是 | string | MD5签名 |
返回示例:
正确时返回:
{
"code": 0,
"msg": "操作成功"
}错误时返回:
{
"code": -1,
"msg": "参数错误"
}文档更新时间: 2022-07-05 16:49 作者:xieyuhua