华为客服系统与计费、营帐系统接口协议说明书.doc

华为客服系统与计费、营帐系统接口协议说明书 第一章、背景 华为客服系统的话费查询、业务受理、用户资料、欠费催缴等模块需要与局方的计费、营帐系统对接。在实际开局过程中，许多地方都提出采用协议方式对接的要求。华为公司在总结了与对多方计费、营帐系统的实际对接方案后，提出了一整套协议方式对接的解决方案。 第二章、术语简要说明 常连接：客服系统向计费、营帐系统建立TCP连接之后，双方就采用该连接进行数据交换，该连接由客服系统来维护，当发生网络故障造成断连后，客服系统会自动重连。 短连接：当客服系统需要发送请求报文时，就向计费、营帐系统建立一个连接，然后发送请求，请求发送完毕后，客服系统主动切断连接。当计费、营帐系统需要发送应答报文时，向客服系统建立一个连接，发送应答报文，发送完毕后，主动切断连接。（这种方式，会在客服以及计费、营帐系统之间频繁建立、关闭连接，而连接的建立以及拆除是非常耗时的，而且涉及到系统SOCKET资源的频繁申请、释放。在话务量越大的时候，这个问题就越突出，造成不稳定的隐患。强烈建议不要采用这种方式〕。 同步方式： 指客服系统通过某个TCP连接向计费、营帐系统发送请求报文后，阻塞在该TCP连接上等待应答，直到应答结束或者等待应答超时才能再次使用该TCP连接来发送新的请求。这种方式一般要建立一条以上的TCP连接。〔不推荐使用这种方式，这种方式浪费了TCP资源的使用率〕。 异步方式：指客服系统通过某个TCP连接向计费、营帐系统发送请求报文后，只要有新的请求报文，都可以使用该TCP连接发送出去。这种方式可以充分利用TCP连接资源，一般建立一个TCP连接即可。采用异步方式必须有请求ID，这样才能将请求和应答对应起来。请求ID的详细说明见后。 客户进程：指客服通讯接口进程。有两种含义：从业务逻辑上来说，客服系统发送请求，计费、营帐系统应答。从连接方式上来说，客服系统发起连接请求，计费、营帐系统监听连接请求。 服务进程：指计费、营帐通讯接口进程。 请求报文：从客服系统发出的报文都统称为请求报文。 应答报文：从计费、营帐系统发出的报文都统称为应答报文。 请求、应答方式：指客服系统发送请求报文，计费、营帐系统针对该请求报文发送一条或者多条应答报文。这是最常用的方式。 请求、无应答方式：指客服系统发送请求报文，计费、营帐系统针对该请求报文进行处理，但是不需要将结果返回给客服系统。这种方式只适用于某些特定的报文。如催缴结果回写计费、营帐系统，计费，营帐系统对该请求报文进行处理后，不需要再回应答报文给客服系统。 无请求、应答方式。指计费、营帐系统主动发送报文给客服系统。此种方式一般不推荐采用。 变长包：指请求报文或者应答报文的长度是变化的，不是固定包长〔固定包长不灵活且浪费传输带宽，不推荐采用〕。由于TCP协议本身是面向字节流的，和UDP协议不同，所以不能认为一次接收到的就是一条报文。所以在报文中必须有长度字段或者其它标志，接收进程根据该长度从接收到的字节流切割出一个个报文。 命令字：命令字用来区分请求报文，应答报文的命令字必须和请求报文的命令字一致。 请求ID：客服系统发送请求报文时，携带有请求ID，该请求ID由客服系统产生，并且可以在较长一段时间内保证唯一性。计费、营帐系统进行应答时必须将请求ID返回，且不能修改，若有多个应答包，则每个应答包都必须带有该请求ID。 MorePkt字段：当对应一个请求有多个应答报文时，必须通过该字段来说明还有后续包，还是应答结束。 网络字节顺序：由于在数据交换时，会涉及到不同主机硬件，而字节顺序的处理可能不一致。所以对于通讯报文采用统一的字节顺序即网络字节顺序。注意字节顺序只对存储空间超过一个字节的类型有意义，对于字符串以及单字节整型数是无所谓的。 字节对齐方式：由于不同的编译器其默认的字节对齐方式是不同的，为保证统一，要求都按照单字节对齐的方式设定编译开关。 最大包长：客服系统只能支持一个包最大20K的长度，所以所有的协议报文不能超过30K。 第三章、网络通讯协议 客服系统和计费、营帐系统之间交换数据需要通过网络来传输，网络传输协议采用TCP/IP协议，双方的通讯进程在TCP协议之上采用SOCKET方式建立一条或者多条TCP连接。 根据业务逻辑来划分，客服系统的接口进程是客户端，计费、营帐系统的接口进程是服务端。计费、营帐系统的接口进程提供一个或多个监听端口。客服系统主动发起连接请求，并负责断连后的重连。 当计费、营帐系统应答时，必须按照请求报文的路由原路返回。如果没有原始请求报文，则按照预先商定好的路由传输。 客服通讯接口进程可以向计费、营帐接口进程的一个或者多个监听端口建立一条或者多条连接，这些连接可以采用负荷分担的方式，也可以根据不同的业务报