BSS积分兑换接口文档

中国联通BSS域服务集规范账务域分册V2.6修改历史目录V2.0 (1)1范围 (1)2缩略语和术语定义 (1)2.1缩略语 (1)2.2术语 (2)3账务域服务目录 (8)4催缴查询服务 (10)4.1服务描述 (10)4.2服务属性 (10)4.3催缴查询（QRY_STOP_INFO） (10)4.3.1操作描述 (10)4.3.2操作属性 (10)4.3.3输入参数 (11)4.3.4输入参数说明 (11)4.3.5输出参数 (11)4.3.6输出参数说明 (13)4.3.7省分功能开发要点 (13)5费用服务 (13)5.1服务描述 (13)5.2服务属性 (13)5.3账户余额查询（QRY_FEE_INFO） (14)5.3.1操作描述 (14)5.3.2操作属性 (14)5.3.3输入参数 (14)5.3.4输入参数说明 (15)5.3.5输出参数 (15)5.3.6输出参数说明 (17)5.3.7省份功能开发要点 (18)5.4查询实时余额（QRY_REAL_FEE_INFO） (18)5.4.1操作描述 (18)5.4.2操作属性 (18)5.4.3输入参数 (18)5.4.4输入参数说明 (19)5.4.5输出参数 (19)5.4.6输出参数说明 (21)5.4.7省份功能开发要点 (21)5.5欠费查询（含呆坏账查询、立即结账查询）（QRY_OWEFEE_INFO） (21)5.5.1操作描述 (21)5.5.2操作属性 (21)5.5.3输入参数 (22)5.5.4输入参数说明 (23)5.5.5输出参数 (23)5.5.6输出参数说明 (28)5.5.7省份功能开发要点 (28)5.6余额转账（TRANS_FEE） (30)5.6.1操作描述 (30)5.6.2操作属性 (31)5.6.3输入参数 (31)5.6.4输入参数说明 (32)5.6.5输出参数 (32)5.6.6输出参数说明 (33)5.6.7省份功能开发要点 (34)5.7综合费用查询 (34)5.7.1服务描述 ....................................................................................... 错误！未定义书签。

1.1.1积分扣减（查询受理分册）1.1.1.1 业务描述该接口用于电子渠道或合作伙伴发起的对用户消费积分的扣减或回退操作。

积分消费方式有兑换、抽奖、互换和消费四种。

积分回退是指当用户取消兑换或投诉时将用户积分返还的一种操作，将已扣减积分返还；积分回退只适用于管理员处理用户投诉的情况。

1.1.1.2 业务流程客户客户登录 进行积分消费电子渠道系统 枢纽系统 用户归属省BSS手机号码校验、积 分查询和消费确认 判断号码归属发送扣减请求地发送扣减请求号码校验积分值验证发送扣减应答进行积分扣减操作发送扣减应答发送扣减应答1) 客户登录电子渠道网站，查看可消费产品列表； 2) 客户进行积分消费；3) 电子渠道系统检验用户手机号码，进行消费确认； 4) 电子渠道系统发送积分扣减请求；5) 枢纽系统根据手机号码路由转发用户归属省 BSS ；6) 用户归属省 BSS 进行号码检验、可用积分值验证和积分扣减操作； 7) 用户归属省 BSS 返回积分扣减应答； 8) 枢纽系统返回积分扣减应答；9)电子渠道给客户返回积分消费结果；在交易过程中，如果归属方 BSS 系统超时无应答，则认为该交易失败。

发起方可以用原交易流水重发请求，归属方应做查重，发现重复流水号的交易请求，直接返回原交易处理结果。

发起方连续重发失败，即认为交易失败，通过对账来调整，见对账接口描述。

1.1.1.3业务属性1.1.1.4交易属性1.1.1.5请求报文可为空；回退交易中，订单号填写原交易流水号。

目前积分扣减接口中产品描述不采用订单方式，产品信息直接填写在报文相应字段；未来对于复杂业务将采用订单方式，即将积分扣减与订单明细分开，本接口只用于积分扣减，订单详细信息通过订单发送。

1.1.1.6应答报文H2接口方式1.1.1包头数据包头格式：内容为一定长ASCII字符串（86102位），具体内容如下：注：除A3标志是响应包必填项外，其它字段都是必填项，是定长1.1.2包体定义一个数据包总长度不可大于4K。

LiveBos客户积分管理系统范例一、积分系统基本功能1.客户帐户信息的管理2.客户积分流水信息管理3.礼品基本信息管理4.客户积分变更二、需要建立的实体对象1.客户信息2.积分流水信息3.礼品信息4.礼品兑付清单三、实现步骤1.建立实体对象：客户信息、积分流水信息、礼品信息、礼品兑付清单2.建立对象方法：在客户信息对象上建立一个“积分变更”的用户方法3.建立业务逻辑方法：在客户信息对象上建立一个“礼品兑换“的业务逻辑方法四、具体实现细节建立客户信息对象1.开始建立对象之前，先建立一个包，输入包名“客户积分管理系统”。

2.建立好包后，要建立第一个实体对象“3.建立对象时可以选择所建立的对象是否要基于模板创建，使该对象具备一些特定的属性、操作和展现。

建立实体对象时，表名对应数据库中的物理表名，可以采用系统默认的命名方式，也可以自定义。

4.创建一个“客户信息”新实体对象，模板为“默认”，表名采用系统默认。

5.双击实体对象“客户信息”，在右边打开一个编辑器来对这个实体对象进行详细的设定。

6.右击“客户信息”，“新建”-“普通字段”来增加对象的字段属性。

7.依次添加“客户信息”实体对象的属性，详细设置“代码”、“名称”、“长度”、“显示控件”、“限制”、“验证模式”、“取值公式”等。

8.设定“性别”字段时，可以通过“选择项”利用系统已经设定好的“性别”数据字典。

9.设定“客户信息”实体对象的“电话号码”和“电子邮箱”属性时，可以利用系统提供的验证模式来保证输入格式的有效性和合法性，还可以自定义出错提示信息。

10.同样可以为“客户信息”实体对象增加操作方法。

11.发布“客户信息”实体对象到LiveBos服务器。

12.测试系统：新增一条记录，输入不合法的手机号码或者电子邮件地址，点击确定提交后系统会提示验证不合法信息。

建立积分流水信息对象1.在“客户积分管理系统”包中新建“积分流水信息”实体对象。

2.给“积分流水”对象新建“对象字段”。

中国联通业务支持系统（BSS）运行维护管理平台业务技术规范（讨论稿）中国联通2004年6月目录1.总体概述 (1)1.1 行业背景 (1)1.2 系统现状分析 (1)1.3 编制目的 (2)1.4 适用范围 (2)1.5 起草单位 (2)1.6 解释权 (2)1.7 参考文献 (2)2.建设目标及原则 (3)2.1 建设目标 (3)2.1.1 近期目标 (3)2.1.2 远期目标 (3)2.1.3 建设规划 (4)2.2 建设原则 (4)3.系统总体结构 (5)3.1 系统定位以及与现有网管系统之间的关系 (5)3.1.1 系统定位 (5)3.1.2 与现有网管系统之间的关系 (5)3.2 系统组织结构 (6)3.3 系统体系结构 (7)3.3.1 数据层 (8)3.3.1.1 监控数据 (8)3.3.1.2 管理数据 (9)3.3.1.3 系统数据 (9)3.3.1.4 文档数据 (9)3.3.2 功能层 (9)3.3.3 接入展现层 (12)3.4 与外部系统之间的关系 (12)4.业务功能与流程 (14)4.1 各模块之间的关系 (14)4.2 岗位与角色描述 (14)4.2.1 岗位描述 (14)4.2.2 角色描述 (15)4.3 业务功能描述 (17)4.3.1 服务支持 (17)4.3.1.1 服务台 (17)4.3.1.2 事件管理 (19)4.3.1.3 问题管理 (22)4.3.1.4 变更管理 (25)4.3.1.5 配置管理 (28)4.3.1.6 日常运维管理 (31)4.3.1.7 供应商管理 (32)4.3.1.8 知识库管理 (33)4.3.2 系统监控 (36)4.3.2.1 监控台 (36)4.3.2.2 性能管理 (36)4.3.2.3 告警管理 (38)4.3.2.4 配置处理 (45)4.3.3 系统管理 (47)5.系统技术要求 (49)5.1 总体技术要求 (49)5.1.1 应用软件 (49)5.1.2 数据要求 (50)5.1.3 性能要求 (50)5.1.4 开发工具 (50)5.2 统计报表 (51)5.3 拓扑展现 (51)5.3.1 拓扑的生成方式 (51)5.3.2 技术要求 (52)5.4 工作流 (52)5.5 安全管理 (56)5.5.1 对安全管理的统一维护 (56)5.5.2 运维管理平台的安全性 (56)5.6 数据采集 (57)5.6.1 数据源类型 (57)5.6.2 数据采集要求 (57)5.6.3 数据预处理 (57)6.系统接口 (59)6.1 接口原则 (59)6.2 服务支持与系统监控的接口 (60)6.2.1 接口定义 (60)6.2.2 接口方式 (60)6.2.3 接口要求 (60)6.2.4 接口内容 (60)6.3 与业务应用系统的接口 (62)6.3.1 接口定义 (62)6.3.2 接口方式 (62)6.3.3 接口策略 (62)6.3.4 接口要求 (63)6.3.5 接口内容 (63)6.4 与系统平台的接口 (63)6.4.1 接口定义 (63)6.4.2 接口方式 (63)6.4.3 接口要求 (64)6.4.4 接口内容 (64)6.5 两级运维系统间的接口 (64)6.5.1 接口定义 (64)6.5.2 两级接口文件命名规则及相关约束 (65)6.5.2.1 文件命名规则 (65)6.5.2.2 回执文件格式约定 (66)6.5.2.3 错误信息说明 (66)6.5.3 上传关键业务指标 (68)6.5.3.1 接口定义 (68)6.5.3.2 接口实现 (68)6.5.4 工单信息的传递 (70)6.5.4.1 接口定义 (70)6.5.4.2 接口实现 (71)6.5.5 知识库信息传递 (72)6.5.5.1 接口定义 (72)6.5.5.2 接口实现 (73)6.5.6 上传统计报表 (73)6.5.6.1 接口定义 (73)6.5.6.2 接口实现 (74)6.6 与其他系统的接口 (74)6.6.1 接口定义 (74)6.6.2 接口实现 (74)1.总体概述1.1行业背景当今通信市场正由传统的以通信网为中心的服务质量的竞争转变成以客户为中心的服务质量的竞争，中国联通为了适应市场竞争的变化，必须建立以客户服务为中心的服务机制。

新版商城接口文档（在原有的基础上修改的李祥）新版商城接口文档一、首页商品信息（getHomeGoodsInfo） (1)二、首页地域选择（getHomeCityList） (7)三、收货地址列表（addressList） (8)四、添加收货地址（confirmAddress） (9)五、修改收获地址（updateAddress） (10)六、设置默认收获地址（setAddressDefault） (11)七、删除收货地址（deleteAddress） (11)八、添加收货地址获取省市县列表（getAddressCityList） (12) 测试接口地址：所有接口返回，result字段需加密所有接口请求返回成功status = 200失败status != 200 失败时json结构如下{"status": 500,"result": {"message": "请求出错了"}}一、首页商品信息（getHomeGoodsInfo）请求地址121.40.189.127/buyer/mainPage.htm (post 方式)请求参数buyerId 用户Id（可为空）cityId 城市Id（Id=213）响应结果result list列表type类型content内容列表type=picture_scroll时, 图片轮播（type=1）type=one_column时, 一行一列banner （type=2）type=two_column时, 一行两列banner （type=3）type= group_scroll_view时, 可左右滑动商品（type=4）type= group_one_column时, 组名称+一行一列banner （type=5）type= group_two_column时, 组名称+一行两列banner （type=6）content为type 类型类型1为商品2链接……img轮播图(图片路径)price 价格（当params是商品的时候，价格有值（Integer类型））params类型1为商品id2链接地址……title 标题示例{"status":" 200" ,"result": {" message"=" "," data ": [{"content": [{"title": "羊前腿","img":"/doc/2c8725520.html,/uploads/2016 08231000089166631924.jpg","params": "2875","type": "1"},{"title": "处暑","img":"/doc/2c8725520.html,/uploads/2016 08221632362523132124.jpg","params":"/doc/2c8725520.html,/usc-wechat/zhuanti/app/845","type": "2"},{"title": "大闸蟹","img":"/doc/2c8725520.html,/uploads/2016 08221014042408210740.jpg","params": "2925","type": "1"},],"type": "1"},{"content": [{"title": "生鲜好货","img":"/doc/2c8725520.html,/uploads/2016 07271406218475 009815.jpg","params":"/doc/2c8725520.html,/usc-wechat/zhuanti/app/406","type": "4"},{"title": "营养早餐","img":"/doc/2c8725520.html,/uploads/2016 08221145385015 647883.jpg","params":"/doc/2c8725520.html,/usc-wechat/zhuanti/app/795","type": "4"}],"type": "3"},{"content": [{"title": "时令推荐","img":"/doc/2c8725520.html,/uploads/2016 08221405303142 072687.jpg","params": "","type": "4"}],"type": "2"},{"content": [{"title": "大闸蟹1","price": 60,"img":"/doc/2c8725520.html,/uploads/2016 08221425583217 528190.jpg","params": "2925","type": "3"},{"title": "大闸蟹2","price": 60,"img":"/doc/2c8725520.html,/uploads/2016 08221429142711 182812.jpg","params": "2925","type": "3"}],"title": "新鲜水果""type": "4"},{"content": [{"title": "羊前腿","img":"/doc/2c8725520.html,/uploads/2016 08231000089166 631924.jpg","params": "2875","type": "1"},{"title": "处暑","img":"/doc/2c8725520.html,/uploads/2016 08221632362523 132124.jpg","params":"/doc/2c8725520.html,/usc-wechat/zhuanti/app/845","type": "2"},{"title": "大闸蟹","img":"/doc/2c8725520.html,/uploads/2016 08221014042408210740.jpg","params": "2925","type": "1"},],"type": "1"},{"content": [{"title": "凯特","img":"/doc/2c8725520.html,/uploads/2016 08221433162986 145057.jpg","params": "2923","type": "3"},{"title": "红阳","img":"/doc/2c8725520.html,/uploads/2016 08221436099555 260459.jpg","params": "2924","type": "3"},{"title": "凯特","img":"/doc/2c8725520.html,/uploads/2016 08221433162986 145057.jpg","params": "2923","type": "3"},{"title": "红阳","img":"/doc/2c8725520.html,/uploads/2016 08221436099555 260459.jpg","params": "2924","type": "3"}],"title": "营养母婴""type": "6"},{"content": [{"title": "羊前腿","img":"/doc/2c8725520.html,/uploads/2016 08231000089166 631924.jpg","params": "2875","type": "1"},{"title": "处暑","img":"/doc/2c8725520.html,/uploads/2016 08221632362523 132124.jpg","params":"/doc/2c8725520.html,/usc-wechat/zhuanti/app/845","type": "2"},{"title": "大闸蟹","img":08221014042408 210740.jpg","params": "2925","type": "1"},],"type": "1"},{"content": [{"title": "无添加","img":"/doc/2c8725520.html,/uploads/2016 08221441240678 593483.jpg","params": "","type": "16"},{"title": "无添加","img":"/doc/2c8725520.html,/uploads/2016 08221441240678593483.jpg","params": "","type": "16"},{"title": "无添加","img":08221441240678593483.jpg","params": "","type": "16"}],"title": "厨房好物""type": "5"}]}}二、首页地域选择（getHomeCityList）请求地址121.40.189.127/buyer/mainArea.htm (post 方式) 请求参数响应结果result city_list列表cityId城市idcityName城市名称示例{"status": "200","result": {" message"=""," data": [{"cityId": 3360,"cityName": "北京"},{"cityId": 3361,"cityName": "天津"},{"cityId": 3362,"cityName": "上海"},{"cityId": 213,"cityName": "杭州"},{"cityId": 326,"cityName": "广州"},{"cityId": 328,"cityName": "深圳"},{"cityId": 1,"cityName": "其它"}]}}三、收货地址列表（addressList）请求地址121.40.189.127/buyer/addressList.htm (post 方式)请求参数buyerId用户Id响应结果result address_list收货地址列表receiverId地址idreceiverName收货人receiverMobile收货人手机province省city 市district区address 详细地址isDefault是否默认示例{"status": "200 ","result": {" message"=" "," data": [{" address ": "北京阿尔萨办公楼入口229", " district": "朝阳区", "receiverId": 73529, "receiverName": "李孟泽", "isDefault":0," city ": "北京市", "receiverMobile": "186********"," province": "北京市"},{" address ": "国贸大厦226", "district": "东城区","receiverId": 70174,"receiverName": "科技","isDefault": 0," city ": "北京市","receiverMobile": "186********"," province": "北京市"}]}}四、添加收货地址（confirmAddress）请求地址121.40.189.127/buyer/addAddress.htm (post 方式) 请求参数buyerId 用户idreceiverName收件人receiverMobile 手机号province省city城市district区域address详细地址isDefault是否默认(0是不默认，1是默认)响应结果result {"result": {"data": {"receiverId": "100043" //收货地址id},"message": "添加成功"},"status": "200"}五、修改收获地址（updateAddress）请求地址121.40.189.127/buyer/editAddress.htm (post 方式)请求参数receiverId 收货地址idbuyerId用户idreceiverName收件人receiverMobile 手机号province省city城市district区域address详细地址isDefault是否默认（0是不默认，1是默认）响应结果result {"result": {"data": {"receiverId": "100043" //收货地址id},"message": "修改成功"},"status": "200"}六、设置默认收获地址（setAddressDefault）请求地址121.40.189.127/buyer/addressDefault.htm (post 方式) 请求参数receiverId 收货地址idbuyerId用户idisDefault 是否默认（0是不默认，1是默认）响应结果result {"result": {"data": { },"message": "修改默认状态成功"},"status": "200"}七、删除收货地址（deleteAddress）请求地址121.40.189.127/buyer/delAddress.htm (post 方式)请求参数receiverId 收货地址idbuyerId用户id响应结果result {"result": {"data": { },"message": "删除成功"},"status": "200"}八、添加收货地址获取省市县列表（getAddressCityList）请求地址121.40.189.127/buyer/addressAreaList.htm (post 方式) 请求参数parentId 父级id 。

1、对接流程1.1术语定义•开发者：使用兑吧积分商城服务的开发者简称。

•积分：开发者与兑吧商城对接使用的“虚拟货币单位”，开发者可以自己更改“货币名称”和“货币汇率”。

•汇率：开发者自己平台上的虚拟货币与现实中人民币的大致比率。

如：100积分= 1元意味着100积分可以兑换1元面值的商品。

•服务端：指开发者的服务器，用于接口对接。

•客户端：又称用户端，目前支持Android（安卓）、IOS、微信、纯H5方式接入。

•自动登录url：又称免登录url，在用户进入兑吧积分商城的时候由服务端实时生成，提供用户的登录信息，包含用户id和积分值。

•扣积分接口：用户发起兑换请求后，兑吧会向开发者发一个扣积分的http请求，开发者接收到请求后，需创建订单、扣除用户相应的积分，并响应相应的信息。

•通知接口：用户在兑吧兑换成功/失败后，兑吧会向开发者发通知请求，告知订单最终结果，开发者需根据通知结果修改本地订单状态，如果结果为失败，还需要退还用户之前扣除的积分。

•开发者账号：开发者在兑吧注册的账号•应用（app）：开发者账号下可以创建多个应用，便于统一账号下管理。

•appKey：每个应用都有一个唯一的标识码。

•签名：遍历请求参数的值进行MD5编码，比对sign值，确保请求不可伪造。

自有虚拟商品：由开发者自己平台向用户提供充值的商品，如：会员等级，礼品卡，月卡，游戏点数，虚拟货币等。

1.2积分兑换原理说明用户在使用积分进行兑换时，兑吧如何与开发者共同来实现这一功能呢？整体原理图如下：当用户发起一个兑换请求时，兑吧服务器会先收到这个请求。

然后会依次执行下面的步骤：Step1.向开发者服务器发起扣除用户积分的请求。

兑吧开始启动兑换流程，向服务器发送扣除用户积分的请求。

比如用户兑换话费需要消耗100积分，这个请求中就会带上用户id，以及需要扣除的积分数：100。

开发者需要对这个请求进行响应，比如扣除成功，或者扣除失败，原因是什么。

中国联通BSS域服务集规范cBSS系统文件分册V1.2目录1. 范围 (21)2. 缩略语和术语定义 (22)2.1.缩略语222.2.术语243. 银行代收代扣文件接口 (35)3.1银行代收对帐353.1.1业务描述353.1.2平账处理说明363.1.3异常记录处理363.1.4文件说明363.2银行托收申请403.2.1业务描述403.2.2平账处理说明403.2.3异常记录处理403.2.4文件说明403.3银行托收回盘453.3.1业务描述453.3.2平账处理说明463.3.3异常记录处理463.3.4文件说明464. 营业受理文件接口 (51)4.1帐前信息同步514.1.1业务描述524.1.2文件说明534.2销账后余额同步614.2.1业务描述614.2.2文件说明624.3销账后欠费信息同步664.3.1业务描述664.3.2文件说明674.4代为收费账单缴费通知724.4.1业务描述724.4.2文件说明724.5用户积分同步774.5.1业务描述774.5.2文件说明774.6用户评级上传81814.6.2文件说明824.7省份黑名单同步错误!未定义书签。

4.7.1业务描述错误!未定义书签。

4.7.2文件说明错误!未定义书签。

4.8代理商资金账户实时交易日对账874.8.1业务描述874.8.2文件说明905. 路由数据文件 (117)5.1路由数据日增量更新同步文件1171175.1.2文件说明1185.2路由数据全量更新文件1215.2.1业务描述1215.2.2文件说明1226. VAC文件接口 (130)6.1.产品信息文件同步接口1306.1.1服务描述1306.1.2文件描述1306.2.用户开户请求文件接口错误!未定义书签。

6.2.1.服务描述错误!未定义书签。

6.2.2.文件描述错误!未定义书签。

6.3.用户信息文件同步接口1456.3.1 服务描述 (145)6.3.2 文件描述 (145)6.4.正向产品订购关系文件接口1526.4.1 服务描述 (152)6.4.2 文件描述 (152)6.5.资费模型文件同步接口1676.5.1 服务描述 (167)6.5.2 文件描述 (168)6.6.优惠规则模型文件同步接口错误!未定义书签。

✓省分上传用户资料采用定时增量的方式，将规定时间段的所有变更的用户资料上传至总部✓此流程只针对集团客户在省分BSS系统订购的普通基础业务，对于非集团客户订购的普通基础业务，保持省分现有模式（即：通过个人客户受理时选择集团客户、账户完成集客标识的设置）附加情况【流程说明】1.2G/3G成员用户的计费账务缴费等处理都在省份BSS中进行。

2.集客BBSS月底根据成员归属关系，下发成员列表文件。

【流程说明】1.数据专线业务由集客系统进行批价计费账务处理，月底出账。

2.集客系统每月向省分BSS进行月租下发3.集客系统月底向省分BSS进行出账账单下发。

【流程说明】1.宝视通业务在集客系统进行批价计费帐务处理,月底出帐.2.省份BSS月底接受集客系统出帐后账单,进行销账.3.省份上传销账文件给集客系统.4.集客系统将结算数据提供给固网结算进行结算处理.【补充说明】✓集客系统提供自服务功能，供用户详单查询.【流程说明】1.省份聚类IVPN业务在省份BSS中进行批价,月租计费扣取出帐等操作.2.集客系统根据集团成员关系,下发成员用户列表.3.省份BSS根据成员用户列表,进行出帐后账单的上传.集客系统接受数据4.省份BSS进行销账操作,上传销账文件到集客系统.集客系统接受数据, 同时月底上传全量销账信息给集客系统5.集客系统出具应收,实收等收入统计报表.【流程说明】1.组合业务在省份BSS中进行批价,月租计费扣取出帐等操作.2.集客系统根据集团成员关系,下发成员用户列表.3.省份BSS根据成员用户列表,进行出帐后账单的上传.集客系统接受数据4.省份BSS进行销账操作,上传销账文件到集客系统.集客系统接受数据,同时月底上传全量销账信息给集客系统4.8集客系统出具应收,实收等收入统计报表客户合户【流程说明】1.如果目标客户不存在，则创建目标集团客户；2.创建的新客户通过全业务平台下发到省分BSS和ERP系统；3.选择源客户；4.进行在省分受理的用户能否进行合户的判断，若未通过校验则退出流程（省分业务规则校验接口）；5.进行客户合并，将所有源客户下所有的账户、用户、合同、项目、商机信息迁移到目标客户下；。