联通SP增量对账回执文件说明

根据联通<中国联通增值业务鉴权中心接口规范-VAC与SP接口规范-1212.doc>接口要求，SP务必部署订购关系对账程序，对账文件取走后删除VAC服务器上的文件，我们将每天核查对账文件的处理情况，对不按时取走对账文件的SP进行结算考核。

回执文件格式如（SubscribeInfo000416902011081306040170001.rsp）

 

SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.ttt

SPID 八位，不足八位，左补零

文件产生的时间（12位yyyyMMddHHmm精确到年月日时分）

xxx为省分代码。

nnnn 是4位序列号，每天从“0001”开始，到达”9999”后又从“0001”开始。

ttt表示文件类型，req表示请求, rsp表示请求结果。每一个req文件都应该有一个rsp文件与其对应。

 

举例如下： 

对账请求文件名：SubscribeInfo000416902011081306040170001.req

对账回执文件名：SubscribeInfo000416902011081306040170001.rsp

 

 --------------------------------------------------------------------------------------------------------------------------------- 

增量账文件的目录和后缀：
  文件名：SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.req
  增量请求文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/request
  增量请求正确回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/right
  增量请求文件级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/bad
  增量请求记录级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/semiwrong

 

------------------------------------------------------------------------------------------------------------------------------------------------------------------接口规范

 

1.1　定购关系同步接口

1.1.1　接口描述

采用文件方式。

文件采用GBK编码格式,

文件体不定长，文件体各属性间使用‘\t’分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。

文件体中一行作为一条记录，各条记录之间用换行符‘\n’作为分隔并在文件中连续书写。

文件头定长，各属性间无分隔符。

文件的维护由VAC负责。

 

包括增量稽核接口、全量同步。对CRM增量、全量文件形式的订购、退订数据，VAC仅以文件方式通知SP，不以实时方式通知。

（1）增量稽核接口

该接口用于VAC与SP每天稽核增量订购关系。包括批量定购和退订。

VAC将每天增量文件放到VAC为SP提供的文件服务器的目录下。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC为SP分配具有读写文件权限的用户和密码。

VAC每个小时（可配置）生成1个文件，10万条以内只能是1个文件，超过10万条另起1个文件，不能出现跨天的情况。SP于每天凌晨1：00进行稽核文件资料同步。资料同步周期应具有根据最新规定进行可调的能力。

VAC在某时刻生成的实时数据包含在当天增量数据中及当月全量数据中。对增量文件稽核接口，VAC只把对定购关系的最后一次操作记录传递给SP，不传递中间过程，例如当用户某天定购某产品、接着又退订该产品后，增量同步时VAC只把最后一次退订操作记录传递给SP，不传递前一次的定购操作。

（2）全量同步接口

该接口用于VAC与SP同步全量订购关系。其中10万条以内只能是1个文件，超过10万条另起1个文件，不能出现跨天的情况。

VAC将全量文件放到VAC为SP提供的文件服务器的目录下。系统于每月1日凌晨2：00进行全量文件资料同步。资料同步周期应具有根据最新规定进行可调的能力。

1.1.2　发起方系统

VAC。

 

1.1.3　接受方系统

SP。

1.1.4　接口协议

FTP 文件。

1.1.5　接口内容

文件目录

增量请求文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/request

增量请求正确回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/right

增量请求文件级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/bad，文件级错误代码参见附录

增量请求记录级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/add/response/semiwrong，记录级错误代码参见附录。

 

全量请求文件：<根目录>/VAC/SubscribeInfo/<SPID>/all/request

全量请求正确回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/all/response/right

全量请求文件级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/all/response/bad，文件级错误代码参见附录

全量请求记录级错误回执文件：<根目录>/VAC/SubscribeInfo/<SPID>/all/response/semiwrong，记录级错误代码参见附录。

 

存放SP与VAC全量同步数据稽核后、SP中多余数据的文件：<根目录>/VAC/SubscribeInfo/<SPID>/all/response/redundant

 

文件命名: SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.ttt

SPID 八位，不足八位，左补零

文件产生的时间（12位yyyyMMddHHmm精确到年月日时分）

xxx为省分代码。

nnnn 是4位序列号，每天从“0001”开始，到达”9999”后又从“0001”开始。

ttt表示文件类型，req表示请求, rsp表示请求结果。每一个req文件都应该有一个rsp文件与其对应。

 

1.1.5.1　请求文件头（定长）

 

序号	属性名	长度	备注
1	文件序列号(流水号)	CHAR(4)	0001开始，排满9999后重新循环
2	版本信息	CHAR(5)	缺省：00000
3	文件产生时间	CHAR(14)	yyyymmddhhmmss
4	文件生成方系统代码	CHAR(3)	902
5	记录开始日期时间	CHAR(14)	yyyymmddhhmmss
6	记录结束日期时间	CHAR(14)	yyyymmddhhmmss
7	总记录数	CHAR(10)
8	备用	CHAR(40)
9	换行	CHAR(1)

 

 

 

1.1.5.2　请求文件体

 

参数名	类型	大小	描述
RecordSequenceID	String	18	流水号,
UserIdType	Integer	4	用户ID类型 1: MSISDN 2: PsedoCode
UserId	String	36	用户手机号码或伪码 UserIdType填1 为手机号码 UserIdType填2 为伪码
ServiceType	String	2	业务类型,见附录A7
SpId	String	21	SP标识
SP_ProductId	String	21	产品标识（此为SP在PRM侧申请的SP_Productid）
UpdateType	Integer	4	对全量同步文件，忽略本字段取值 更新操作的类型包括： 1：订购 2：退定 4：定购关系变更(一般是修改有效期) 5：改号
UpdateTime	String	14	更新时间
UpdateDesc	String	100	更新操作的详细描述 联通在信、彩信等定购、点播接入号，和CheckPrice请求中AccessNo字段一致； 对crm侧订购、退订由vac根据产品填写；对其他业务填空
LinkID	String	20	事务关联ID，用于点播业务的临时定购关系关联，由平台产生。格式如下： 8位随机序列号； 为空表示无效。 用户点播时使用。
Content	String	140	内容
EffectiveDate	String	14	订购关系生效时间, 格式：yyyyMMddhhmmss
ExpireDate	String	14	订购关系失效时间, 格式：yyyyMMddhhmmss
Time_Stamp	String	10	时间戳由VAC生成,格式是: MMDDHHMMSS，月日时分秒。
EncodeStr	String	32	采用32位的MD5加密串,以便SP鉴权定购关系来源的合法性, MD5 加密算法如下: EncodeStr=UserId+共享密钥+ ProductId+ Time_Stamp 共享密钥由SP分配,时间戳由VAC设备生成，格式是：MMDDHHMMSS，月日时分秒。共享密钥的定义见BSS与VAC接口规范SP属性接口OrderKey 如果SP的OrderKey为空,VAC不加密

 

 

1.1.5.3　回执文件头（定长）

 

序号	属性名	长度	备注
1	文件序列号(流水号)	CHAR(4)	从0001开始，排满9999后重新循环。
2	版本信息	CHAR(5)	缺省：00000
3	文件产生时间	CHAR (14)	Yyyymmddhhmmss
4	文件生成方系统代码	CHAR(3)	缺省：000
5	总记录数	CHAR(10)	同请求文件
6	正确处理记录数	CHAR(10)
7	备用	CHAR(40)	文件级错误代码
8	换行	CHAR(1)

 

 

1.1.5.4　回执文件体（变长）

对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执文件，在文件体中列出错误的结果代码。

 

序号	参数名	说明	参数类型	最大长度	是否必填
1	RecordSequenceID	流水号	String	18	M
2	ResultCode	结果标识 0：正确 1：错误	integer	4	M

 

 

1.1.5.5　SP全量稽核后多余的数据文件格式

同4.2.5.2节，其中RecordSequenceID字段由SP生成，UPDATEType字段取值忽略。