【正文】 中國聯(lián)通公司發(fā)布20080XXX實(shí)施20080XXX發(fā)布中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心接口規(guī)范VAC與增值業(yè)務(wù)系統(tǒng)接口分冊(cè)（）China Uni （Version ）QB/CUxxx—2008中國聯(lián)通公司企業(yè)標(biāo)準(zhǔn)36 / 46目 次修改記錄 III前 言 VIII1 范圍 92 規(guī)范性引用文件 93 縮略語和術(shù)語 9 縮略語 9 術(shù)語 24 VAC和增值業(yè)務(wù)系統(tǒng)間的接口 2 實(shí)時(shí)鑒權(quán)計(jì)費(fèi)接口 2 接口描述 2 Command ID （命令字）定義 3 基本數(shù)據(jù)類型 4 PDU 概述 4 連接消息 5 去連接消息 6 鏈路握手消息 6 鑒權(quán)批價(jià) 6 鑒權(quán)批價(jià)確認(rèn) 12 流量計(jì)費(fèi)消息 13 統(tǒng)一配置接口 16 接口描述 16 SP基本信息FTP文件同步接口 16 SP能力信息FTP文件同步接口 16 業(yè)務(wù)信息FTP文件同步接口 16 業(yè)務(wù)能力信息FTP文件同步接口 16 產(chǎn)品信息FTP文件同步接口 16 訂購關(guān)系FTP文件同步接口（WAP門戶） 16 CP基本信息FTP文件同步接口 16 查詢用戶定購關(guān)系接口 16 查詢用戶信息接口 19 接口描述 19 發(fā)起方系統(tǒng) 19 接受方系統(tǒng) 19 接口協(xié)議 19 接口內(nèi)容 19 用戶信息查詢請(qǐng)求（UserIdRequest） 19 用戶信息查詢響應(yīng)（UserInfoResponse） 19 用戶信息結(jié)構(gòu) 20 用戶信息同步接口 20 接口方式 20 文件目錄 20 文件格式 21 用戶號(hào)段同步接口 21 接口描述 21 接口協(xié)議 21 接口內(nèi)容 21 測試用戶同步接口 21 接口描述 21 接口協(xié)議 22 接口內(nèi)容 22附　錄　A （規(guī)范性附錄） 可選參數(shù)標(biāo)識(shí)定義 24附　錄　B （規(guī)范性附錄） 數(shù)據(jù)類型定義 25附　錄　C （規(guī)范性附錄） 鑒權(quán)批價(jià)接口返回錯(cuò)誤結(jié)果碼定義 27附　錄　D （規(guī)范性附錄） 門戶結(jié)果碼定義 30附　錄　E （規(guī)范性附錄） wsdl 31修改記錄文件編號(hào)版本號(hào)擬制人/修改人擬制/修改日期更改理由主要更改內(nèi)容（寫要點(diǎn)即可）2008114如果可信任門戶能知曉用戶使用的是具體的產(chǎn)品構(gòu)成，增加SPID+SPEC_Productid模式20081118新增fee TLV，應(yīng)對(duì)過渡階段部分業(yè)務(wù)系統(tǒng)自己批價(jià)，如炫鈴20081120設(shè)備類型SPMS填SMS Portal附錄B20081123Operation Type 增加了 “定購關(guān)系鑒權(quán)(用于檢查用戶是否訂購了此業(yè)務(wù))”便于SPMS定購和WAP訪問確認(rèn)URL做定購關(guān)系鑒權(quán)20081203增加定購渠道和計(jì)費(fèi)類型2008123增加” 鑒權(quán)批價(jià)接口返回錯(cuò)誤結(jié)果碼定義”附錄C2008125流量計(jì)費(fèi)增加了linkId20081214增加了wap門戶查詢用戶所有定購關(guān)系接口20081215增加用戶信息查詢接口封面20081218版本號(hào)修改20081218修改小節(jié)格式2009115修改ServiceType字段備注2009115Service_updown_Type字段，增加P TO E類型2009120更新成1224日期的wsdl附錄E2009213增加ContentID增加響應(yīng)中CCTime等4字段取值描述　流量計(jì)費(fèi)消息2009213增加用戶服務(wù)類型2009213增加3G業(yè)務(wù)設(shè)備類型附錄B2009214增加發(fā)端設(shè)備類型　用戶信息查詢請(qǐng)求（UserIdRequest）2009214LinkID生成規(guī)則調(diào)整，適應(yīng)現(xiàn)網(wǎng)在信業(yè)務(wù)　鑒權(quán)批價(jià)　流量計(jì)費(fèi)消息2009214WSDL文件更新附錄E20090619中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心接口規(guī)范VAC與增值系統(tǒng)amp。全國VAC接口分冊(cè)”改為“中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心接口規(guī)范VAC與增值系統(tǒng)接口分冊(cè)名稱修改20090619名稱由“WAP門戶查詢用戶所有定購關(guān)系接口”修改為“查詢用戶定購關(guān)系接口”；接口方向：“PortalVAC”改為“增值系統(tǒng)VAC”；刪除觸發(fā)條件、約束；輸入?yún)?shù)中，srcDeviceType字段注釋“02：WAP PORTAL ；”改為“填寫發(fā)端設(shè)備的具體類型，見附錄B”；srcDeviceID字段注釋“02：WAP PORTAL ；”改為“聯(lián)通指定，可配置”各字段長度以WSDL文件為準(zhǔn)expireTime字段備注，刪除“，自動(dòng)續(xù)訂的不填”，改為必填　WAP門戶查詢用戶所有定購關(guān)系接口20090619名稱由“WAP門戶查詢用戶信息接口”修改為“查詢用戶信息接口；發(fā)起方系統(tǒng)“門戶”改為“增值系統(tǒng)”；用戶信息查詢請(qǐng)求（UserIdRequest）中srcDeviceType字段描述“02：WAP PORTAL ；”改為“填寫發(fā)端設(shè)備的具體類型，見附錄B”；srcDeviceID字段 “02：WAP PORTAL ；”改為“聯(lián)通指定，可配置”　WAP門戶查詢用戶信息接口20090619ResentTimes字段，增加“默認(rèn)取值0”fee字段，增加“增值系統(tǒng)不批價(jià)的不帶fee字段，同時(shí)VAC側(cè)支持按照業(yè)務(wù)類型進(jìn)行配置是否批價(jià)處理。對(duì)代收費(fèi)業(yè)務(wù)fee、FeeType必須正確填寫。（FeeType只能填3）。”，刪除“部分業(yè)務(wù)系統(tǒng)在過渡階段可自己批價(jià),如炫鈴等,”ServiceIDType字段，刪除5取值SP_ID/AccessNo字段，名稱改為“SP_ID”，描述改為“填寫企業(yè)代碼”ServiceID/FeatureString字段，刪除2,5取值描述Operation Type，描述中刪除“ServiceIDType=3或4時(shí)，產(chǎn)品類型必須為點(diǎn)播類。生成LinkID，上行計(jì)費(fèi)的產(chǎn)品同時(shí)進(jìn)行計(jì)費(fèi)。同一LinkID只計(jì)費(fèi)一次?！?，是否刪除“ServiceIDType=1時(shí)，”　鑒權(quán)批價(jià)20090619刪除本章，相關(guān)內(nèi)容放在總部VAC接口規(guī)范分冊(cè)中5　VAC和全網(wǎng)VAC系統(tǒng)間的接口20090619設(shè)備類型（SourceDevice_Type）增加：47：中央音樂平臺(tái)48：手機(jī)郵箱增加“對(duì)用戶數(shù)據(jù)，除接口中已經(jīng)明確填寫格式的，VAC作為接受方，支持用戶號(hào)碼前加或不加86；其他接收方在接受VAC數(shù)據(jù)時(shí)，也應(yīng)適應(yīng)用戶號(hào)碼前加或不加86?！备戒汢 20090619（2）OrderMethod字段增加“，在定購時(shí)業(yè)務(wù)系統(tǒng)必須填寫”（3）ServiceType字段，增加“當(dāng)Operation Type=4時(shí)，VAC不對(duì)鑒權(quán)發(fā)起方的業(yè)務(wù)類型與產(chǎn)品的業(yè)務(wù)類型進(jìn)行比較鑒權(quán)”（4）Service_updown_Type字段，增加“vac對(duì)彩信p to e、sp彩信、在信、wap push業(yè)務(wù)需要判斷具體取值，對(duì)其他業(yè)務(wù)不鑒權(quán)本字段”（5）oa、da,刪除“或業(yè)務(wù)平臺(tái)編號(hào)”，刪除“根據(jù)Service_updown_type字段，”（6）CheckPriceResp鑒權(quán)批價(jià)應(yīng)答中feetype字段,增加“對(duì)會(huì)話類計(jì)費(fèi)，5或6必須返回”（7）增加AccessNo字段　鑒權(quán)批價(jià)20090619srcDeviceID改為string類型Userbrand改為STRING 5，增加“，采用編碼方式表示，具體編碼取值對(duì)應(yīng)的品牌由需要本字段的系統(tǒng)保存靜態(tài)表，自行維護(hù)。”　查詢用戶信息接口20090619VolumeQuotaThreshold備注補(bǔ)充ValidityTime增加備注“當(dāng)采用流量計(jì)費(fèi)時(shí)，客戶端在本次分配配額已使用時(shí)長到達(dá)ValidityTime表示值時(shí)，向服務(wù)器端發(fā)起重新授權(quán)申請(qǐng)新的配額。”　流量計(jì)費(fèi)消息200979（1）Operation Type增加“屏蔽業(yè)務(wù)能力 恢復(fù)業(yè)務(wù)能力”（2）Operation Type=3，“退定所有業(yè)務(wù)”改為“退訂ServiceType對(duì)應(yīng)的所有業(yè)務(wù)（終端側(cè)不能單獨(dú)退訂業(yè)務(wù)除外）”，說明放入備注中（3）增加“注……”　鑒權(quán)批價(jià)200979userServiceType說明改為“，”　用戶信息結(jié)構(gòu)200979從3G補(bǔ)充規(guī)范中移入　CP基本信息FTP文件同步接口　用戶信息同步接口　用戶號(hào)段同步接口　測試用戶同步接口2009716增加錯(cuò)誤碼1006 此業(yè)務(wù)能力已被屏蔽1007 用戶無法屏蔽/恢復(fù)業(yè)務(wù)能力附錄C2009716SequencNumber增加說明“和CheckPrice中SequenceNumber編碼方式一致”　流量計(jì)費(fèi)消息2009716增加注：（4）針對(duì)點(diǎn)對(duì)點(diǎn)彩信，業(yè)務(wù)代碼、產(chǎn)品代碼等按照以下方式分配，彩信中心按照以下規(guī)則填寫后發(fā)起到vac的國內(nèi)點(diǎn)對(duì)點(diǎn)彩信業(yè)務(wù)鑒權(quán)，彩信國際互通網(wǎng)關(guān)按照以下規(guī)則填寫后發(fā)起到vac的國際彩信業(yè)務(wù)鑒權(quán)：u CPID：不需要規(guī)定，不使用 u SPID ：99999u 國際彩信業(yè)務(wù)代碼 ： 32000001，其中32 彩信中心編碼，00 全國業(yè)務(wù)，0001 業(yè)務(wù)編號(hào)；國際彩信產(chǎn)品代碼：3200000101u 國內(nèi)點(diǎn)對(duì)點(diǎn)彩信代碼：32xx0002，其中32 彩信中心編碼，xx 分公司業(yè)務(wù)（xx為省分代碼），0002 業(yè)務(wù)編號(hào)；國內(nèi)點(diǎn)對(duì)點(diǎn)彩信產(chǎn)品代碼 32xx000201u 國內(nèi)點(diǎn)到mail彩信代碼：32xx0003，其中32 彩信中心編碼，xx 分公司業(yè)務(wù)（xx為省分代碼），0003 業(yè)務(wù)編號(hào)；國內(nèi)點(diǎn)對(duì)點(diǎn)彩信產(chǎn)品代碼 32xx000301 （5）針對(duì)業(yè)務(wù)代碼等信息，增值系統(tǒng)、vac、業(yè)務(wù)支撐系統(tǒng)必須都是可配、可調(diào)的　鑒權(quán)批價(jià)2009716（1）FeeType字段，增加取值“8：包月計(jì)費(fèi)+單位費(fèi)率（該值不另外增加話單中計(jì)費(fèi)類型字段取值，對(duì)包月計(jì)費(fèi)+單位費(fèi)率資費(fèi)類產(chǎn)品中的包月計(jì)費(fèi)話單類型填3，對(duì)單位計(jì)費(fèi)話單類型填2）”（2）增加SP_ProductID、SPEC_ProductID、ProductID三個(gè)字段（3）增加“注：當(dāng)業(yè)務(wù)系統(tǒng)（目前只針對(duì)WAP系統(tǒng)，可配置）發(fā)起定購關(guān)系鑒權(quán)（Operation Type=6）時(shí)，如果VAC中已經(jīng)有該用戶對(duì)于指定業(yè)務(wù)的定購關(guān)系，響應(yīng)中向業(yè)務(wù)系統(tǒng)返回成功，同時(shí)返回FeeType 、SP_ProductID、SPEC_ProductID、ProductID字段；當(dāng)用戶無定購關(guān)系時(shí)，返回1201錯(cuò)誤，不返回FeeType 、SP_ProductID、SPEC_ProductID、ProductID字段。”（4）附錄A增加0x1510x1510x1514　鑒權(quán)批價(jià)CheckPriceResp鑒權(quán)批價(jià)應(yīng)答2009716增加“2209 產(chǎn)品不能從終端側(cè)訂購、退訂”附錄C20091023增加（2）getSubscriptionNew()具體變化為：(1)增加ServiceType、SPAreaID兩個(gè)字段(2) 刪除IDType、id字段增加VACSub、SPID、SP_ProductID、SPEC_ProductID、ProductID字段　查詢用戶定購關(guān)系接口20091023增加：0x1515 AccessNo TLV String附錄a20091023注（1）增加“；當(dāng)servicetype取00時(shí)，退訂所有業(yè)務(wù)類型下所有訂購關(guān)系”Fee字段“，如本字段為空，返回3002錯(cuò)誤”增加注“（6）增值系統(tǒng)發(fā)起ServiceID計(jì)費(fèi)鑒權(quán)情況下，VAC根據(jù)業(yè)務(wù)找產(chǎn)品，其中有一個(gè)代收費(fèi)產(chǎn)品，即按照代收費(fèi)處理?！薄¤b權(quán)批價(jià)20091111增加“注：當(dāng)CheckPrice請(qǐng)求中Operation Type=1（定購）時(shí)，ReturnMessage 具體格式為：existsub:spid,sp_productid,spec_productid,productid。其中existsub結(jié)構(gòu)體表示該請(qǐng)求對(duì)應(yīng)的已定購產(chǎn)品的信息。當(dāng)用戶要定購產(chǎn)品和前一已定購產(chǎn)品有互斥關(guān)系時(shí)，existsub填寫已定購并生效的互斥產(chǎn)品信息；例如用戶已定購1元手機(jī)郵箱（spid,sp_productid,spec_productid,productid分別為99999,8200000101,123451234501,12345001），再定購2元手機(jī)郵箱（99999,8200000102,123451234502,12345002）時(shí)，vac返回1204錯(cuò)誤，并在ReturnMessage中返回“existsub:99999,8200000101,123451234501,12345001”，表示該已定購產(chǎn)品和要定購產(chǎn)品互斥。”　鑒權(quán)批價(jià)，2）CheckPriceResp鑒權(quán)批價(jià)應(yīng)答20091111（1）增加 預(yù)留9000—99