中国联通A-PaaS能力开放平台API规范-积分商城分册v1

QB/CU * 2016中国联通公司企业标准中国联通公司发布中国联通A-PaaS能力开放平台API标准积分商城分册2017-2实施2017-2发布1 概述1.1 背景随着行业和公司开展，IT和各业务领域更深度融合，IT已不仅是信息化部门的专有任务，越来越多业务单元需要直接参与到IT建立中。传统IT模式正在转变，“平台+应用新格局快速形成，IT部门将逐步更加聚焦于IT整体规划、共享能力提供、数据聚合、根底设施和效劳提供等领域。为构建平台和应用间桥梁，A-PaaS能力体系应运而生，在2015年IT整体规划中，参照IT三层架构总体规划，进一步将各类公共业务能力进展沉淀，形成应用能力层-PaaS，通过A-PaaS实现IT、数据、运营、应用能力的复用和整合，促进集中统一运营红利释放。各类业务单元BU作为A-PaaS能力使用方，获得更加透明、标准化的平台能力支撑，通过平台+业务应用新的IT模式，最大程度发挥自身运营灵活性，并也可实现自身能力复用、沉淀。各类能力单元AU做为A-PaaS能力提供方，视角也在逐步发生变化，由系统建立组织者逐步变为公共能力的生产者或运营者，可以专注能力潜力挖掘，打造更有价值的能力。1.2 围此文档是A-PaaS能力开放平台对外提供的效劳接口规，适用于所有通过API和SDK方式调用开放能力的场景。所有业务应用需要按照此规要求进展效劳调用，并根据返回结果做适当的业务处理。1.3 平台介绍A-PaaS运营支撑平台是面向业务单元的一个能力视图，是具体的效劳、管理、交易平台，包括能力商店、能力开放平台、应用部署环境管理。通过能力商店实现能力提供统一管理，所有开放能力均在能力商店上架，统一管理，统一订购；通过能力开放平台，实现能力开放，对第三方、子公司、省分BU、总部BU提供统一能力调用；通过应用部署环境管理，为创新应用提供自助式分布式部署环境。对于BU来说，A-PaaS运营支撑平台呈现业务标准化能力，屏蔽各能力提供平台差异化效劳；另一方面对于部各类AU提供规效劳接入，A-PaaS运营支撑平台是公司平台化运营的根底业务能力体系。本规主要是针对A-PaaS能力开放平台对外提供的效劳接口规；1.4 参考文献1.5 缩略语与术语1.5.1 缩略语英文缩写英文全称中文解释A-PaaSAbility-Platform as a Service业务能力层I-PaaSIntegration Platform as a Service技术组件层AUAbility Unit能力单元BUBusiness Unit业务单元APP-KEY APP-KEY应用IDAPP_SECRETAPP_SECRET应用密钥1.5.2 术语本文档所涉及的术语定义请参见下表。名词解释能力用于支撑各类业务活动的公共要素或环节，各类业务应用的“公约数、承载一定业务功能，可复用，相对稳定。一个能力可以包括多个效劳效劳效劳是指提供*项业务功能的具体API接口应用接入业务单元使用能力开放平台的能力，完成业务应用建立的过程业务经理业务应用的建立与维护人员，能力经理能力的建立和运营人员，AU的能力提供方平台运营方A-PaaS整体运营根本责任单元，负责A-PaaS体系的运营API调用方式通过接口地址调用效劳的技术实现方式SDK调用方式通过SDK方式调用效劳的技术实现方式2 接入技术2.1 传输协议 采用HTTP传输协议，并采用RESTFUL风格的效劳访问方式。 POST把提交的数据则放置在HTTP包的包体中。 所有参数值需要转换为UTF-8编码。 支持POST请求方式的API接口，所需要拼接的URL格式例如如下：10.124.8.43:8001/api/*(效劳名称)/*(版本号)?2.2 API调用方式本章节主要介绍通过接口地址调用效劳的技术实现方式，简称API调用方式；2.2.1 传输协议 采用HTTP传输协议，并采用RESTFUL风格的效劳访问方式。 POST把提交的数据则放置在HTTP包的包体中。 所有参数值需要转换为UTF-8编码。 支持POST请求方式的API接口，所需要拼接的URL格式例如如下：10.249.214.2:8001/api/*(效劳名称)/*(版本号)?2.2.2 调用方式通过HTTP POST请求方式进展API调用，并根据API规拼接正确的URL，就能够办理相应业务或取得相应数据。2.2.3 调用参数发起API调用的请求有二类参数：系统参数、应用参数，系统参数与应用参数以POST的方式把提交的数据则放置在HTTP包的包体中传输；1) 系统参数名称类型必填?说明备注app_keychar(30)Y接入标识码timestamptimestampY时间戳当前的系统时间戳，单位为毫秒，举例：2016-03-25 12:12:12 187serial_numberchar(23)Y序列号YYYYMMDDHHMMSS+毫秒(3) +6位随机数signvarchar(256)Y签名信息 2应用参数应参参数参照实时接口规2.2.4 签名方式调用api值需要进展签名sign值的校验，效劳器也会对该请求参数进展验证是否合法的。签名值sign是将请求源串以及app_secret根据一定签名方法生成的签名值；方法如下：1. 根据系统参数名称除sign签名将所有请求系统参数按照字母先后顺序排序:key + value . key + value 例如：请求URL为：10.249.214.2:8001/api/cuseser/v1；将系统参数值app_key=abc,timestamp=2016-03-25 12:12:12 187,serial_number=912321eqwrwqq参数名和参数值后，得到拼装字符串：app_keyabcserial_number912321eqwrwqqtimestamp2016-03-25 12:12:12 1872. 拼接app_secretapp_secret为应用申请时分配的App密钥，不在URL中传递，双方配置在自己系统中，用于计算sign值，增强平安性。app_secret值拼接到上面的字串中后面，参加app_secret值为B2732427，最终得到：app_keyabcserial_number912321eqwrwqqtimestamp2016-03-25 12:12:12 187B27324273. 系统支持MD5(64位)加密方式md5：将app_secret拼接到参数字符串尾后进展md5(64位)加密，格式是：md5(key1value1key2value2. app_secret)4. Sign计算：把上面得到的源串进展MD5计算，得到sign值为ewqewq123214tuiiwe392.3 SDK调用方式A-PaaS能力开放平台SDK提供了调用接口API的请求封装、签名、返回解析、消息监听等功能，使用SDK可以轻松完成API的调用，API结果的获取，消息的实时监听。3 实时接口3.1 积分消费记录查询3.1.1 应用场景用于查询客户的积分消费历史；3.1.2 请求说明API名称外网调用入口111.198.162.42:8001/api/integralmall/corebasicquery/scoree*pendrecord/v1网调用入口10.249.214.2:8001/api/integralmall/corebasicquery/scoree*pendrecord/v1HTTP请求方式HTTP-POST格式JSONAPI授权类型需要授权是否收费API否类型根底效劳版本v13.1.3 输入参数3.1.3.1 应用级输入参数名称类型必填?说明备注reqtschar(14)Y请求发起时间戳yyyyMMddHHmmsschannelcodevarchar(50)Y发起方渠道编码bizparamsvarchar(65536)Yjson字符串“param1:value1,param2:value2,.参数列表参数以其参数名的字典序升序进展排序，结果进展aes加密，并且转成base64字符串。加密所用key由积分商城提供同appSecrect所传参数见下表authsignvarchar(256)Y数字签名channelcode+reqts+“param1:value1,param2:value2,.+appSecrect加号不传参数列表参数以其参数名的字典序升序进展排序,按照上面顺序进展排序后MD5加密UTF-8编码，接入渠道编码channelcode，密钥appSecrect由积分商城提供所传参数见下表加密解密方法：测试时，系统参数里面加密使用的是申请应用的时候提供的appkey/appsecret；应用参数里面加密时使用的渠道编码为“AP+两位省份编码，密钥为“RyiQwkaIB2AMvmpJk5RG1g=biz_params入参名称类型必填?说明备注transidvarchar(50)Y发起方流水渠道编码+ yyyymmddhh24miss+6位不重复序列reqservicecodevarchar(9)Y效劳编码积分消费记录查询：11011002provincecodechar(3)Y省份编码citycodechar(3)Y地市编码nettypechar(2)Y网别01 2G02 3G99 4Gpaytypechar(2)Y付费类型1 预付费2 后付费usertypechar(1)Y用户类型0 手机1 宽带2 固话3 上网卡usernumbervarchar(30)Y效劳telareacodevarchar(4)N区号固网必填begindatechar(8)Y开场时间YYYYMMDDenddatechar(8)Y完毕时间YYYYMMDD3.1.4 返回结果名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功9999 系统异常respdescvarchar(500)N应答描述应答描述rsptschar(14)Y响应时间戳yyyyMMddHHmmssrspmsgvarchar(65536)Y业务应答业务参数列表消息应答参数为json格式，同请求参数一样，整体结果进展aes加密，并且转成base64字符串rspmsg参数说明名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功1203 黑用户1204 不存在1420 客户无积分respdescvarchar(500)N应答描述应答描述scoredetailinfoscoredetailinfo_entityN积分消费记录信息实体3.1.5 实体列表3.1.5.1 积分消费记录信息实体3.1.5.1.1 实体说明实体名称scoredetailinfo_entity实体描述3.1.5.1.2 实体数据名称类型必填?说明备注scoree*penddatechar(14)Y积分消费时间YYYYMMDDHH24MISStradeidvarchar(30)Y业务流水payfeemodechar(1)Y支付方式0 积分支付1 积分+现金scorevaluevarchar(50)Y消费积分数chantypechar(1)Y积分消费渠道:0积分商城1网上营业厅2手机营业厅3短信营业厅4 实体营业厅5 自助终端机6 微信厅7 迷你厅8 省分积分平台9 合作伙伴积分平台e*pendliste*pendlist_entityN消费商品列表实体3.1.5.2 消费商品列表实体3.1.5.2.1 实体说明实体名称e*pendlist_entity实体描述3.1.5.2.2 实体数据名称类型必填?说明备注giftkindcodevarchar(20)Y消费商品编码e*pensegoodvarchar(100)Y消费商品名称actioncountvarchar(4)Y消费商品数量e*pensetypechar(1)Y积分用途:0合作方产品1一卡充2 1G流量半年包3 网厅交费4积分活动5积分转赠6 积分销售7 实体营业厅兑换3.1.6 API调用例如3.1.6.1 请求例如app_key:*9lelk*,timestamp: 2014-01-01 10:19:37 212,sign:cOKD31SLKJKLSDAKDJASLDAKJDJKAS, data: reqts:201702141010, channelcode:123456, bizparams:*, authsign: * 3.1.6.2 返回例如正确返回 data:respcode: 0000,respdesc: 成功,rspts: 201702141010,rspmsg: 业务应答消息aes加密base64编码异常返回积分商城返回异常：data:rspcode:9999 , rspdesc:系统异常 异常返回开放平台自身异常：data:status: S-AF-001,message: appkey校验失败 3.1.7 SDK调用例如3.1.7.1 请求例如3.1.7.2 返回例如3.1.8 错误码解释3.1.9 备注说明3.2 积分产生记录查询3.2.1 应用场景查询用户的积分生成详细信息。3.2.2 请求说明API名称外网调用入口111.198.162.42:8001/api/integralmall/corebasicquery/scorerecord/v1网调用入口10.249.214.2:8001/api/integralmall/corebasicquery/scorerecord/v1HTTP请求方式HTTP-POST格式JSONAPI授权类型需要授权是否收费API否类型根底效劳版本v13.2.3 输入参数3.2.3.1 应用级输入参数名称类型必填?说明备注reqtschar(14)Y请求发起时间戳yyyyMMddHHmmsschannelcodevarchar(50)Y发起方渠道编码bizparamsvarchar(65536)Yjson字符串“param1:value1,param2:value2,.参数列表参数以其参数名的字典序升序进展排序，结果进展aes加密，并且转成base64字符串。加密所用key由积分商城提供同appSecrect所传参数见下表authsignvarchar(256)Y数字签名channelcode+reqts+“param1:value1,param2:value2,.+appSecrect加号不传参数列表参数以其参数名的字典序升序进展排序,按照上面顺序进展排序后MD5加密UTF-8编码，接入渠道编码channelcode，密钥appSecrect由积分商城提供所传参数见下表biz_params入参名称类型必填?说明备注transidvarchar(50)Y发起方流水渠道编码+ yyyymmddhh24miss+6位不重复序列reqservicecodevarchar(9)Y效劳编码积分产生记录查询：11011003provincecodechar(3)Y省份编码citycodechar(3)Y地市编码nettypechar(2)Y网别01 2G02 3G99 4Gpaytypechar(2)Y付费类型1 预付费2 后付费usertypechar(1)Y用户类型0 手机1 宽带2 固话3 上网卡usernumbervarchar(30)Y效劳telareacodevarchar(4)N区号固网必填begindatechar(8)Y开场时间YYYYMMDDenddatechar(8)Y完毕时间YYYYMMDD3.2.4 返回结果名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功9999 系统异常respdescvarchar(500)N应答描述应答描述rsptschar(14)Y响应时间戳yyyyMMddHHmmssrspmsgvarchar(65536)Y业务应答业务参数列表消息应答参数为json格式，同请求参数一样，整体结果进展aes加密，并且转成base64字符串rspmsg参数说明名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功1203 黑用户1204 不存在1420 客户无积分respdescvarchar(500)N应答描述应答描述returninforeturninfo_entityN积分产生记录信息实体3.2.5 实体列表3.2.5.1 积分产生记录信息实体3.2.5.1.1 实体说明实体名称returninfo_entity实体描述3.2.5.1.2 实体数据名称类型必填?说明备注scorevarchar(50)N当前积分scoredetailinfoscoredetailinfo_entityY积分生成详细信息实体3.2.5.2 积分生成详细信息实体3.2.5.2.1 实体说明实体名称scoredetailinfo_entity实体描述3.2.5.2.2 实体数据名称类型必填?说明备注scorecreatdatechar(14)Y积分生成时间YYYYMMDDHH24MISSscoreinvaliddatechar(14)Y积分失效时间YYYYMMDDHH24MISSscoretypechar(2)Y积分类型01：通信消费积分02：奖励积分03：营销积分04：维系积分05：转赠积分06：回退积分07:合作伙伴积分scorevaluevarchar(50)Y积分值fusionscorevarchar(50)N融合业务积分3.2.6 API调用例如3.2.6.1 请求例如app_key:*9lelk*,timestamp: 2014-01-01 10:19:37 212,sign:cOKD31SLKJKLSDAKDJASLDAKJDJKAS, data: reqts:201702141010, channelcode:123456, bizparams:*, authsign: * 3.2.6.2 返回例如正确返回 data:respcode: 0000,respdesc: 成功rspts: 201702141010,rspmsg: 业务应答消息aes加密base64编码异常返回积分商城返回异常：data:rspcode:9999 , rspdesc:系统异常 异常返回开放平台自身异常：data:status: S-AF-001,message: appkey校验失败3.2.7 SDK调用例如3.2.7.1 请求例如3.2.7.2 返回例如3.2.8 错误码解释3.2.9 备注说明3.1 综合积分查询3.1.1 应用场景用于查询当前可用积分、积分累计值、已兑换值、即将失效积分等信息。3.1.2 请求说明API名称外网调用入口111.198.162.42:8001/api/integralmall/corebasicquery/scoreinfoquery/v1网调用入口10.249.214.2:8001/api/integralmall/corebasicquery/scoreinfoquery/v1HTTP请求方式HTTP-POST格式JSONAPI授权类型需要授权是否收费API否类型根底效劳版本v13.1.3 输入参数3.1.3.1 应用级输入参数名称类型必填?说明备注reqtschar(14)Y请求发起时间戳yyyyMMddHHmmsschannelcodevarchar(50)Y发起方渠道编码bizparamsvarchar(65536)Yjson字符串“param1:value1,param2:value2,.参数列表参数以其参数名的字典序升序进展排序，结果进展aes加密，并且转成base64字符串。加密所用key由积分商城提供同appSecrect所传参数见下表authsignvarchar(256)Y数字签名channelcode+reqts+“param1:value1,param2:value2,.+appSecrect加号不传参数列表参数以其参数名的字典序升序进展排序,按照上面顺序进展排序后MD5加密UTF-8编码，接入渠道编码channelcode，密钥appSecrect由积分商城提供所传参数见下表biz_params入参名称类型必填?说明备注transidvarchar(50)Y发起方流水渠道编码+ yyyymmddhh24miss+6位不重复序列reqservicecodevarchar(9)Y效劳编码综合积分查询：11011001provincecodechar(3)Y省份编码citycodechar(3)Y地市编码nettypechar(2)Y网别01 2G02 3G99 4Gpaytypechar(2)Y付费类型1 预付费2 后付费usertypechar(1)Y用户类型0 手机1 宽带2 固话3 上网卡usernumbervarchar(30)Y效劳telareacodevarchar(4)N区号固网必填querytypechar(1)Y查询类型0:移网、固网1:有效证件目前支持查询类型为0，按查询certtypechar(2)N证件类型参见附录“证件类型当查询类型为1时必填certnumvarchar(20)N证件当查询类型为1时必填3.1.4 返回结果名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功9999 系统异常rspdescvarchar(500)N应答描述应答描述rsptschar(14)Y响应时间戳yyyyMMddHHmmssrspmsgvarchar(65536)Y业务应答业务参数列表消息应答参数为json格式，同请求参数一样，整体结果进展aes加密，并且转成base64字符串rspmsg参数说明名称类型必填?说明备注respcodechar(4)Y应答码应答编码0000 成功1203 黑用户1204 不存在1420 客户无积分respdescvarchar(500)N应答描述scoreinfoscoreinfo_entityN综合积分信息实体多个用户时返回多条3.1.5 实体列表3.1.5.1 综合积分信息实体3.1.5.1.1 实体说明实体名称scoreinfo_entity实体描述3.1.5.1.2 实体数据名称类型必填?说明备注areacodevarchar(6)N区号serialnumbervarchar(40)N效劳certtypechar(2)N证件类型参见附录“证件类型certnumvarchar(20)Y证件userstatevarchar(2)Y用户状态customerlevelvarchar(3)YVIP客户等级参见附录“客户等级ismergescorechar(1)Y是否进展过积分合并0 否1 是custscorevarchar(50)N客户级积分合并积分主返回此节点isfusionorsharechar(1)Y是否有融合业务或共享套餐0 否1 是isprimerynumberchar(1)Y是否是主0 否1 是netagevarchar(10)Y网龄返回值为用户的实际网龄数totalscorevarchar(50)Y当前总积分availablescorevarchar(50)Y当前可用积分cangivescorevarchar(50)Y当前可转赠积分lastmonthscorevarchar(50)Y本月新增积分invalidscorevarchar(50)Y即将失效积分本月到期的3.1.6 API调用例如3.1.6.1 请求例如 app_key:*9lelk*, timestamp:2014-01-01 10:19:37 212, sign:cOKD31SLKJKLSDAKDJASLDAKJDJKAS,data: reqts:201702141010, channelcode:123456, bizparams:*, authsign: *3.1.6.2 返回例如正确返回： data: rspcode:0000 , rspdesc: 成功,rspts: 201702141010,rspmsg: 业务应答消息aes加密base64编码 异常返回积分商城异常返回：data:rspcode:9999 , rspdesc:系统异常 异常返回开放平台异常时返回：data: status: S-AF-001, message: appkey校验失败 3.1.7 SDK调用例如3.1.7.1 请求例如3.1.7.2 返回例如3.1.8 错误码解释3.1.9 备注说明3.2 综合积分扣减3.2.1 应用场景用于操作移网/宽带的积分扣减、回退或转赠。3.2.2 请求说明API名称外网调用入口111.198.162.42:8001/api/integralmall/corebasictran/scorededuct/v1网调用入口10.249.214.2:8001/api/integralmall/corebasictran/scorededuct/v1HTTP请求方式HTTP-POST格式JSONAPI授权类型需要授权是否收费API否类型根底效劳版本v13.2.3 输入参数3.2.3.1 应用级输入参数名称类型必填?说明备注reqtschar(14)Y请求发起时间戳yyyyMMddHHmmsschannelcodevarchar(50)Y发起方渠道编码bizparamsvarchar(65536)Yjson字符串“param1:value1,param2:value2,.参数列表参数以其参数名的字典序升序进展排序，结果进展aes加密，并且转成base64字符串。加密所用key由积分商城提供同appSecrect所传参数见下表authsignvarchar(256)Y数字签名channelcode+reqts+“param1:value1,param2:value2,.+appSecrect加号不传参数列表参数以其参数名的字典序升序进展排序,按照上面顺序进展排序后MD5加密UTF-8编码，接入渠道编码channelcode，密钥appSecrect由积分商城提供所传参数见下表biz_params入参名称类型必填?说明备注transidvarchar(50)Y发起方流水渠道编码+ yyyymmddhh24miss+6位不重复序列reqservicecodevarchar(9)Y效劳编码综合积分扣减：11021004provincecodechar(3)Y省份编码citycodechar(3)Y地市编码nettypechar(2)Y网别01 2G02 3G99 4Gpaytypechar(2)Y付费类型1 预付费2 后付费usertypechar(1)Y用户类型0 手机1 宽带2 固话3 上网卡servicetypechar(1)Y业务类型1：积分调整2：ECS积分兑换3：积分回退telareacodevarchar(6)N区号usernumbervarchar(40)Y效劳效劳/宽带统一编码paymethodchar(1)Y支付方式0 积分支付1 积分+现金目前仅支持0opertypechar(2)Y操作类型01扣减02回退pointsvarchar(50)Y积分数扣减/回退/转赠/销售的积分数cashvarchar(10)N现金单位：元giftownshipchar(1)N礼品归属围0：全国1：省分goodscodevarchar(30)Y物品编码goodsnamevarchar(200)Y物品名称goodsnumvarchar(30)Y物品数量orderidvarchar(30)Y订单号接入平台的订单号(如果是积分回退或调整传扣减的orderid)chantypechar(1)Y积分消费渠道0积分商城1网上营业厅2手机营业厅3短信营业厅4 实体营业厅5 自助终端机6 微信厅7 迷你厅8 省分积分平台9 合作伙伴积分平台3.2.4 返回结果名称类型必填?说明备注respcodechar(4)Y应答编码应答编码0000 成功9999 系统异常respdescvarchar(500)N应答描述应答描述rsptschar(14)Y响应时间戳yyyyMMddHHmmssrspmsgvarchar(65536)Y业务应答业务参数列表消息应答参数为json格式，同请求参数一样，整体结果进展aes加密，并且转成base64字符串rspmsg参数说明名称类型必填?说明备注respcodechar(4)Y应答码应答编码0000 成功1203 黑用户1204 不存在1420 客户无积分respdescvarchar(500)N应答描述busiordervarchar(30)Y业务订单号每笔业务对应的订单号3.2.5 实体列表3.2.6 API调用例如3.2.6.1 请求例如 app_key:*9lelk*, timestamp:2014-01-01 10:19:37 212, sign:cOKD31SLKJKLSDAKDJASLDAKJDJKAS,data: reqts:201702141010, channelcode:123456, bizparams:*, authsign: *3.2.6.2 返回例如正确返回： data: rspcode:0000 , rspdesc: 成功,rspts: 201702141010,rspmsg: 业务应答消息aes加密base64编码 异常返回积分商城异常返回：data:rspcode:9999 , rspdesc:系统异常 异常返回开放平台异常时返回：data: status: S-AF-001, message: appkey校验失败3.2.7 SDK调用例如3.2.7.1 请求例如3.2.7.2 返回例如3.2.8 错误码解释3.2.9 备注说明4 文件接口4.1 对账4.1.1 描述各省份积分应用每日12点半前将对账文件上传至指定ftp，平帐以接入平台数据为准；文件仅包含办理成功的订单数据。A-PaaS每日将积分商场返回的回执文件分发至各积分应用下载目录下；暂定在积分商城上传文件的1小时流转4.1.2 文件传输效劳器及目录主机IP：联调测试环境地址：10.124.8.41:22生产环境地址：10.249.217.124:22文件路径：文件上传目录：/ining文件下载目录：/outgoingSFTP账号密码将通知各应用平台4.1.3 文件命名请求文件名：yyyyMMdd_JFOP_渠道编码.REQ回执文件名：yyyyMMdd_JFOP_渠道编码.RSPyyyyMMdd为对账日日期，如2017年01月2日平2017年01月1日的帐，则此字段应为：20170101；接入平台每日上传给积分商城的订单数据以该笔订单积分扣减时请求头中“返回响应时间戳为准。举例：如*笔订单发起扣减时，“返回响应时间戳reqts为，则此笔订单应在20170102日对账文件中，该文件文件名为：20170102_JFOP_渠道编码.REQ，该文件由接入平台于2017年01月03日生成并在2017年01月03日1点前上传ftp效劳器。4.1.4 文件容说明文件采用uhf-8编码方式。文件头：文件第一行，每个字段之间用英文逗号分割；文件体：文件第二行到最后一行，每行为一条记录，各条记录之间用换行符作为分隔并在文件中连续书写，每条记录中的每个字段之间用英文逗号分割。在生成记录时假设相应的属性值为空，直接用分隔符隔开，分隔符之间无其他二级分隔符号。4.1.4.1 请求文件文件头序号字段名说明备注1TOTAL_RECORD总记录数2DEDUCT_RECORD扣减交易记录数3FALLBACK_RECORD回退交易记录数4TOTAL_POINTS总交易积分数5DEDUCT_POINTS扣减积分数6FALLBACK_POINTS回退积分数7TOTAL_CASH总交易金额元8DEDUCT_CASH扣减金额元9FALLBACK_CASH回退金额元10换行4.1.4.2 请求文件文文件体序号字段名说明备注1TRANS_ID交易流水，对应请求头公共参数中“发起方流水2USER_NUMBER用户3AREA_CODE区号4POINTS积分5OPER_TYPE操作类型，01-扣减，02-回退6ORDER_ID接入平台订单号，对应“积分扣减业务参数中orderid7换行4.1.4.3 回执文件文件头序号字段名说明备注1TOTAL_RECORD总平帐记录数2SUCCESS_RECORD平帐成功记录数3FAILED_RECORD平帐失败记录数4换行4.1.4.4 回执文件文件体回执文件体填写平帐失败的流水及失败原因。序号字段名说明备注1TRANS_ID交易流水，对应请求头公共参数中“发起方流水2ERROR_MSG平帐失败原因3换行5 附录5.1 省份代码属性编码属性值名称101113*17181922澳门3031343638505159*7071747576798183848586878889*90919799cBss96VOP5.2 地市代码属性编码属性值名称属性值描述101呼和浩特102103乌兰察布盟104伊克昭盟105巴延卓尔盟106107108海拉尔109111锡林浩特112哲里木盟113兴安盟114阿盟115呼盟110130*150151滨州152威海153154日照155潍纺156东营157枣庄158159荷泽160莱芜161166170172173174聊城180181182183184185186187188189720190191晋中192193194195196197198199朔州200220澳门300马301302303304305306307308309311312313314316317池州318亳州310330334常熟340343346348349宿迁350354358430440445450360362363364365367370468469470476380384385386387389390395480501502503510520525526揭阳528530531533535536538540550江门556558560565568570580620670678588贺州589贵港590591592593594595596597598599600崇左601来宾700701702格尔木703德令哈704海西洲705洲706海北洲707黄南州708果洛州709州710711712荆州713仙桃714黄冈715716襄樊717718719721722神农架723随州724725天门726潜江727741742743744745746浏阳747748749791792