VAC与SP接口说明1015.doc

VAC与SP接口说明 各位合作伙伴： 由于VAC1212版本已在7月8日上线，此版本对SP订购关系的通知接口进行了完善和功能增强，请新接入的SP遵照VAC1212版本SP通知接口规范执行，做好程序开发调试工作。 需重点注意以下几点： 1、两个版本接口分布情况： 　 SGIP WEBSERVICE 增量文件FTP 月全量文件FTP VAC1212接口 √ √ √ √ 备注:1.VAC1212版本中SP的实时接口方式可设置到业务级，可选取SGIP接口和WEBSERVICE接口中的一个，即同一SP的不同业务可采用不同的实时接口。 2.增量FTP接口均存在,月全量订购关系接口为新增 2、关于FTP方式订购关系通知的说明： VAC将文件放到VAC为SP提供的文件服务器的目录下。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。 VAC文件服务器IP地址： 外网：6 内网：5 VAC为SP分配具有读写文件权限的用户和密码： SP帐号：sp+spid（如：sp30014）； SP帐号密码：sp+spid（如：sp30014），SP可telnet修改密码。 如SP发现使用该帐户密码无法登陆，请联系吴工：020由吴工进行统一登记处理。 FTP文件接口包括增量稽核及全量同步接口。 FTP增量稽核 add/requst目录为订购关系文件准实时接口目录（大约每小时生成一次文件），SP每天要定期清理该目录保证数据入库核对，如没有每日定期清理核对（取完文件后必须进行删除），将对SP进行相关考核。 文件中updatetype为三个类型： Updatetype=4 可视为订购（在文件接口中要注意剔除重复订购关系） Updatetype=1 订购 Updatetype=2 退订 FTP全量稽核 全量文件路径：all/request，VAC每月15日凌晨定时生成sp的全量订购关系，SP每月需要定期清理（5天内，即20日凌晨前）该目录保证数据入库核对，如没有每月定期清理（取完文件后进行删除）核对，将对SP进行相关考核。 FTP接口为实时接口必要的补充和核对机制，SP必须与自己的订购关系数据库进行核对。 如果文件中存在的订购关系，SP订购关系数据库没有的，须加入数据库；文件中已经退订的订购关系，SP订购关系数据库还存在的，须从SP数据库中剔除该订购关系。 通过上述方式保证订购关系与VAC完全一致。如下次SP说因网络等问题没有实时收到订购关系，而文件夹中的订购关系却仍然在文件夹里，SP要自负责任。 3、针对linkid的说明 广东VAC1212版，采用8位随机数来表示，在参看附件文件时注意。 4、针对SGIP接口的说明 在VAC1212版本上线后仍不能提供附件中的改号操作的实时通知，建议SP同时开启增量文件FTP接口来接收这种操作，再对用户的订购关系进行处理。 5、对改号操作的说明 WBSERVICE接口和增量文件FTP、月全量文件FTP接口已经提供改号的操作功能，该点需要SP支持该项功能，以便防止用户因改号后，业务不能正常使用的投诉。具体参看附件说明。 6、关于主动上行及主动下行产品的说明 VAC1212版本升级后，新增了设置产品信任等级功能。对于主动上行、主动下行的产品，在PRM录入时，请设置该产品的信任等级为高，SP，业务信任等级必须为普通。 7、针对彩信SP业务的SPIP填写 对于彩信SP业务业务能力信息中SPIP在PRM的录入，请务必按照如下规范执行： 需至少填写2个IP，1个上行IP，1个下行IP。下行用于与彩信网关建链使用，只填写IP地址；上行IP用于状态报告投递（彩信网关投递给SP），填写IP:PORT。多个IP地址之间用逗号隔开。 如：，：8080 8、针对彩信SP与在信SP接入号有重叠（如10655与106551）情况的说明。此种情况下，如若短信接入号为短号（10655），彩信接入号为长号（106551），此时，SP下发短信时，不能以106551为前缀下发短信，可以10655下发或106552、106553等下发。如以106551下发，业务下发不成功。 9、关于SP订购关系同步消息的content字段填写规则： 1）、如果是订购，且有二次确认，这个字段填写二次确认消息的内容； 2）、如果是订购，没有二次确认，这个字段填写订购消息的内容； 3）、如果是退订，填写退订消息的内容； 4）、如果对应消息的内容为空，这个字段也填写空； 5）、在处理订购关系时，没有必要对这个字段做判断； 10、针对sp订购关系通知采用SPAP接口的情况： 填写SP订购关系通知URL时，需遵从如下规则： SPOrderUrl：填写为SPMS的地址，即5:9090 11、针对订购业务是否需要二次确认的填写规则