山西代理商门户文档.docx

山西代理商门户文档 一、登陆模块 功能简介：该模块主功能是验证代理商手机号、密码、相关资料，符合条件者可以登录系统否则无法登录 操作流程：1、输入代理商空充号码以及对应密码（非空充密码），验证码。 2、输入手机收到的随短信验证码。 业务逻辑：验证用户输入的验证码调用sGetMaster接口获取号码主体服务类型，接着调用sCheckPaw验证用户密码，然后验证用户输入的短信验证码，最后从数据库查询代理商相关信息，同时调用s8016接口查询代理商余额。 下发短息： 首先向短厅申请配置下发短息的模板，以及参数变量，然后将相关数据写入数据表，详见文档。 接口介绍： sGetMaster【通过服务号码查询主体服务类型】入参只需传入的手机号码。 sCheckPaw【验证用户密码】入参中的主体服务标示（MASTER_SERV_ID）从sGetMaster接口中获取。 3．s8016【空中充值缴费】查询代理商余额时，入参BUSI_TYPE 为“SLYE” LOGIN_NO 为 “air002” LOGIN_PASSWORD 为 “CODCDOJHGECIFONG” SMS_TYPE为 “0” PAY_PATH 为 “19” PAY_METHOD为 “B” 。为用户充值交费时 BUSI_TYPE 为 “SLCZ”其他字段不变，详见接口文档。 二、充值交费 功能简介：该模块主要功能是为用户充值。 操作流程：1、输入需充值的手机号号码。 2、确认用户信息，并选择或输入充值金额。 3、页面显示充值结果，同时用户会受到短信提醒。 业务逻辑：输入充值号码后，调用sRemainFeeQry【实时余额查询】接口查询用户余额，接着调用s8016【空中充值缴费】接口为用户充值。 接口简介： sRemainFeeQry【实时余额查询】入参时只传需要查询的手机号即可。 s8016【空中充值缴费】为用户充值交费时 BUSI_TYPE 为 “SLCZ” LOGIN_NO 为 “air002” LOGIN_PASSWORD 为 “CODCDOJHGECIFONG” SMS_TYPE为 “0” PAY_PATH 为 “19” PAY_METHOD为 “B” ，详见接口文档。 三、增值业务办理（不含农信通，手机报，乡情畅享） =============================================================================== =============================================================================== 功能简介：该模块主要是为用户办理增值业务，包含‘来电显示’、‘双电显示’、‘来电提醒’、‘GPRS功能’、‘GPRS套餐’、‘冲浪助手’、‘短信套餐’，‘彩信套餐’。 操作流程： 选中需要办理的增值业务，在此以冲浪助手为例。 输入需办理业务的手机号码 选择需要的资费，并办理。 业务逻辑：点击导航栏业务办理内对应的增值业务，进入输入手机号页面，输入需办理增值业务的手机号，从数据库查询出该业务对应的产品ID同时调用sGetMaster【通过服务号码查询主体服务类型】接口查询出该号码主体服务标识，然后调用sQUserBase【用户相关信息查询】接口查询用户基本信息，接着调用sPrcInfoButton【查询资费可进行的操作】（注：该接口查询出来的资费有可能是子产品的，其实用户不一定能订购，只能从sProdPrcQry服务中得出的结果中，再将sPrcInfoButton 得出的结果进行一次过滤），接着调用sQUsrPrcInfo【查询订购信息】接口 查询为下一步的接口（sProdPrcQry）提供主资费标识 ，接着调用sProdPrcQry【查询产品资费列表服务】过滤sPrcInfoButton【查询资费可进行的操作】接口中的资费同时为可订购的资费设置生效时间，接着调用sQUsrProdPrc【查询用户产品资费订购情况】为变更资费设置生效时间，至此业务展示页面结束，接着选择某资费（例：手机冲浪助手）当订购或退订该业务时，会调用sNetRelChk_B【业务关系校验】接口校验该用户是否可以办理这个业务，然后调用s4000Cfm_B【用户订购、修改或退订产品受理】办理业务。当选择的资费按钮为“变更资费时”，会调用sRelChk_B【订购、退订产品时，关系校验】验证该业务是否可以变更，然后调用s4000Cfm_B【用户订购、修改或退订产品受理】办理业务。 接口简介： sGetMaster【通过服务号码查询主体服务类型】查询用户主体服务标识 sQUserBase【用户相关信息查询】查询用户基本信息其中 ID_NO以后接口（