增量請求文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
增量請求正確回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
增量請求文件級錯誤回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
增量請求記錄級錯誤回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
文件名: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
SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.ttt
SPID 八位,不足八位,左補零
文件產生的時間(12位yyyyMMddHHmm精確到年月日時分)
xxx爲省分代碼。
nnnn 是4位序列號,每天從“0001”開始,到達”9999”後又從“0001”開始。
ttt表示文件類型,req表示請求, rsp表示請求結果。每一個req文件都應該有一個rsp文件與其對應。
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字段取值忽略。