聯通vac增量對賬回執

 原來的增量對賬文件目錄和文件如下:
  增量請求文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
  增量請求正確回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
  增量請求文件級錯誤回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
  增量請求記錄級錯誤回執文件:<根目錄>/VAC/SubscribeInfo/<SPID>/
 
2011-8-15日晚上21點對增量賬文件的目錄和後綴進行調整,調整爲
  文件名: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
 
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
回執文件格式如(SubscribeInfo000416902011081306040170001.rsp
 

SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.ttt

SPID 八位,不足八位,左補零

文件產生的時間(12yyyyMMddHHmm精確到年月日時分)

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字段取值忽略。


 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章