1. 会员信息
  2. 订单数据(线上请求信息)详情
  3. 提交订单(线上请求)将线上订单同步至erp
  4. 查询优惠券是否可用
  5. 核销优惠券
  6. 商品同步(从海典接口获取商品)
  7. 订单接收(接收海典上传订单)
  8. 积分同步(接收海典积分消息推送)
  9. 新增会员、修改会员信息

一、会员信息

  • /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