1、365FAX 网络传真概述及接口规范I目 录1 适用范围 12 引用标准 13 缩略语及名词定义 13.1缩略语 13.2功能定义 14 产品描述 25 产品优势 26 适用群体 37 成本分析 48 接口说明 58.1 字段说明 58.2 协议说明 69 交易说明 69.1 传真请求 SENDFAX69.3.1 交易说明 .69.3.2 请求报文 .79.3.3 应答报文 .89.3.4 报文示例 .99.2 传真结果返回 FAXRESULT 99.3.1 交易说明 .99.3.2 请求报文 .99.3.3 应答报文 .99.3.4 报文示例 109.3 接口辅助工具 .119.3.1 文件
2、工具说明 119.3.2 上传文件实例 119.3.3 下载文件实例 1110 计费 .1111 编制历史 .11II前 言本规范对了 365FAX网络传真产品进行概述、同时定义相关接口规范，是杭州邦信科技有限公司开展 365FAX网络传真运营服务的依据。本规范由杭州邦信科技有限公司提出并归口。本规范起草单位：杭州邦信科技有限公司本规范解释单位：同提出单位。11 适 用 范 围本规范对了 365FAX网络传真产品进行概述、同时定义相关接口规范。本规范适用于商户集成 365FAX网络传真接口的开发、测试。2 引 用 标 准下列标准所包含的条文，通过在规范中引用而构成为本规范的条文。本规范推出时，
3、所示版本均为有效。所有标准都会被修订，使用本规范的各方应探讨使用下列标准最新版本的可能性。3 缩 略 语 及 名 词 定 义3.1缩略语3.2功能定义用户管理：可对资料进行增加、删除、修改及查询等操作。 余额查询：用户可以随时登陆系统查看余额。 传真查询：随时随地登陆网站查询传真记录和传真状况。 清单保存：可根据用户需要查询用户使用清单，可以直接导出，方便保存统计。 功能设定：用户可登陆网站设定传真功能，如传真状态回报、语音提示语言等。 传真群发：用户设定管理地址薄，一次可将文件同时传给多个传真接受设备。 自动重传：系统会将传送时忙线或无人接听的传真自动重传。 定时发送：用户可以指定系统在指定
4、时间将传真文件发送出去。 语音提示：发送传真遇人工接听时，系统有自动语音提示，要求给出传真信号。 修改密码：用户可以通过登陆系统来修改密码。 传真接收：可以随时随地进行传真的接收。24 产 品 描 述365FAX网络传真业务管理系统就是将电脑上已编辑好的文件（如：word、excel、ppt、txt、wps、pdf 等） ，不经过打印，直接通过互联网传送到邦信科技的专业传真服务器上，由服务器转换成传真机接收的格式，并拨通对方的普通传真机将文稿传送过去。这个过程省去了传统发传真先要把文稿打印出来的麻烦，节省了时间和打印的成本。更重要的是我们的系统提供了对传真文稿的有效管理手段，从而使您很轻松地进
5、行归档、查询、统计分析等。您不用再添置任何设备或安装任何软件，只要有一台能上网的电脑就可以随时随地随意收发传真。您只需和以往一样，按照发送的净时间根据信息产业部的 IP电话计费标准付电话费即可。365FAX网络传真业务管理系统功能强大，使用方便。由于结合了电话交换网和互联网的优势，与传统发送传真相比较，极大地降低了用户使用成本，减少了繁琐的环节，提高了方便性和灵活性。堪称是一次革命。系统提供了完善的管理功能和接口，可与企业管理信息系统结合实现无纸化办公。所以可以满足中小企业到大型企业的各类用户的使用要求。5 产 品 优 势365FAX网络传真系统能提高工作效率、提高管理水平、节省您的时间和费用
6、，提升企业形象！365FAX 网络传真系统集成了目前最先进的 CTI（计算机电话集成） 、Internet 、图像处理技术等专业打造。可使您通过普通浏览器来使用系统，再也不用打印，便可通过互联网来收发传真，并且可一次发送上万份传真，每份传真都有一个清晰的结果。使用 365FAX网络传真系统就像收发电子邮件一样方便简单,可在网络能通的任何地方，任何时间收发传真。降低了企业的运营成本，提高了工作效率。 使用365FAX网络传真您不用花钱购买任何设备和软件，有能上网的电脑就能使用，只需按您接通对方传真机的净时间付费即可，再无任何费用。3费用低廉：由于结合了 CTI（计算机电话集成）技术、合理使用了互
7、联网资源，使传真费用只有传统方式的二分之一左右，综合成本下降六成以上；传真群发：用普通传真机将同一份传真文件传给多处时，通常需要逐个拨叫发送。365FAX网络传真业务系统使用电信级专用设备，同时可以发送多份。这对于 产品推广、发送业务、会议通知等非常方便；管理方便：系统对于所有发送的传真文件都进行分类存档，可以按时间、主题、费用等方便的查询统计。提供多种发送方式，发送灵活方便。具有子账户管理。使传统散乱的传真文件管理的有条不紊；发送快速：高容量、多通路电信级专业设备，保证了传真发送的快捷性。内容清晰：电信级的专业设备使得传真质量远远高于普通传真机。自动重发：365FAX 网络传真系统统检测到对
8、方传真机占线或无人应答时，系统可在五分钟内重拨。语音通知：365FAX 网络传真系统统检测到对方传真机是人工接听时，系统自动播放语音通知“您好，您有一份传真，请按传真开始键接收“（可以自定义语音） 。系统监控：通过 365FAX网络传真系统管理程序，可对发送传真的进程进行实时监控，即时查询发送情况。计费管理：365FAX 网络传真系统统计费管理功能可对每个传真自动计费，便于日后统计费用。统计分析：365FAX 网络传真系统可详细记录每个分发事件，包括发送时间、是否成功等等。操作简便：操作简单方便，和使用电子邮件一样简单。无时间限制：不论是出差或旅游，任何时间、任何地点，登录互联网便可使用。传真
9、接收：随时随地可以接收用户的传真件。 6 适 用 群 体* 展览行业 * 咨询行业 * 出版行业 4* 旅游行业 * 广告行业 * 行业协会 * 票务行业 * 快递行业 * 外商代表处 * 物流行业 * 贸易行业* SOHO一簇 * 经常需要商务出行的商务人士 * 其它有传真发送需求的用户7 成 本 分 析【人工成本】成本 普通传真机 365FAX 网络传真 发送一页传真花费时间 10 分钟包括打印、填写封面、从打印机到传真机、排队、拨号、等待发送 1 分钟 平均人工成本 5 元/小时 无 平均每份传真的人工成本 0.4 元 无 平均每天发送的传真数量 100 页 无限制 平均每天的人工成本
10、40 元 无 全年人工成本 14600 元 无 【耗材成本】 成本 普通传真机 365FAX 网络传真 一页传真/打印纸费用 0.05 元 无 平均每天发送的传真数量 100 页 无限制 平均每天传真耗材成本 5 元 无 5全年耗材成本 1825 元 无 【通信成本】 成本 普通传真机 365FAX 网络传真 发送一页传真的时间 60 秒 60 秒 平均每天发送的传真数量 100 页 无限制 平均每天发送的传真成本 30 元 节省 50%费用 全年传真通信成本 10950 元 节省 50%费用【总成本】 成本 普通传真机 365FAX 网络传真 全年的人工成本 14600 元 任何人都可使用
11、全年耗材成本 1825 元 无 全年传真通信成本 10950 元 无须额外通信费用 全年全部传真成本 27375 元 节约 80%费用（纯通信成本）（以上分析不含设备用户设备折旧费、墨盒损耗等，365FAX 网络传真这方面费用为零）8 接 口 说 明8.1 字段说明通讯中所有字段采用以“|”分隔符的方式进行。号码格式：手机号码前面要求增加 0。固话号码为区号加号码，中间无分隔符。如有6分机请加英文横线(-)。8.2 协议说明通讯采用标准 TCP/IP协议进行通讯，通讯报文分为一个 4个字节固定长度的包头和一个以“|”分隔的变化长度包体。服务器采用请求响应模式进行，对于每一个业务的完成有一个请求
12、报文和一个应答报文。支持长连接的异步模式。注：测试服务器 IP地址：221.12.141.190测试服务器端口：5678通讯方式：标准 TCP长连接，BLOCK 模式文件服务端口：56709 交 易 说 明9.1 传真请求 SendFax9.3.1 交易说明1、由商户上传文件（号码文件、 传真附件） ；2、商户发送请求（SendFax）交易；3、FAX 网关处理并返回商户应答；流程图：79.3.2 请求报文字段位置 字段名称 字段类型 字段说明1. 交易代码 string SendFax2. 企业帐号（一级帐户） string3. 密码 string 缺省 0000004. 流水号 strin
13、g 请求流水号5. 交易时间 YYYYMMDDHHMMSS6. 传真主题 string 本次传真的主题，便于WEB界面查询7. 扣费帐号（二级或普通帐户）缺省 0000008. 扣费密码 缺省 0000009. 号源标志 String 1：表示单条号码，直接读取“单条号码字段” ；2：表示群发，从文件中读取。810. 单条号码 string 01380571102311. 传真文件类型 string doc,xls,ppt,txt,wps,pdf9.3.3 应答报文字段位置 字段名称 字段类型 字段说明1. 交易代码 string SendFax2. 流水号 string 请求报文的流水号3.
14、 交易时间 string YYYYMMDDHHMMSS 交易返回时间4. 结果返回码 string 1005. 结果返回说明 string 成功6. 本次作业号 String特别说明：传送文件采用我方提供的文件传送服务工具实现。文件名称说明：号码文件名称：企业帐号_交易时间_流水号.txt 如 s8810_20060101123454_123456.txt传真文件名称：企业帐号_交易时间_流水号.文件类型 如 s8810_20060101123454_123456.doc文件格式说明：一、 号码文件号码文件保存要求发送传真的号码，一行一个号码号码 1号码 29如：013905710001010
15、8674337702188668866-3219.3.4 报文示例请求：SendFax|s8810|000000|123456|20060101123454|测试|000000|000000|2|000000|doc应答：SendFax|123456|20060101123528|100|成功|60816000007499.2 传真结果返回 FaxResult9.3.1 交易说明1), 由 FAX网关生成传真结果文件；2） ，向商户发送传真结果返回（FaxResult）交易，告诉文件已经生成；3） ，商户系统来取处理结果文件，并告诉 OK；9.3.2 请求报文字段位置 字段名称 字段类型 字段
16、说明1. 交易代码 string FaxResult2. 企业帐号 string3. 时间 YYYYMMDDHHMMSS4. 任务作业 ID string 同 SendFax应答报文中的作业号对应109.3.3 应答报文字段位置 字段名称 字段类型 字段说明1. 交易代码 string FaxResult2. 任务作业 ID string 请求过来的作业号3. 交易时间 string YYYYMMDDHHMMSS 交易返回时间4. 结果返回码 string 1005. 结果返回说明 string 成功特别说明：传送文件采用我方提供的文件传送服务工具实现。文件名称说明：结果文件名称：企业帐号_交
17、易时间_任务作业 ID.res如 s8810_20060101123454_6081600000749.res文件格式说明：一、 结果文件结果格式：号码|发送时间|发送次数|发送页数|发送时长|发送费用|发送结果结果文件保存传真发送的结果，一行一个结果，结果各个字段之间采用竖线分隔(|)结果 1结果 2如：013905710001|20060101121234|1|2|87|0.45|成功01086743377|20060101121325|3|0|0|0|呼叫失败02188668866-321|20060101121345|3|1|45|0.24|传真失败119.3.4 报文示例请求：Fax
18、Result|s8810|20060101123454|6081600000749应答：FaxResult|6081600000749|20060101123528|100|成功9.3 接口辅助工具9.3.1 文件工具说明文件传送采用 FileClient程序进行文件传送。命令格式如下：FileClient get|put localfile remotefile ip portget :从服务器获取文件put :上传文件到服务器localfile :本地文件名称remotefile :远程文件名称ip :文件服务器地址port :文件服务器端口9.3.2 上传文件实例FileClient p
19、ut myphone.txt s8810_20060101123454_123456.txt 221.12.141.190 5670FileClient put myfax.doc s8810_20060101123454_123456.doc 221.12.141.190 56709.3.3 下载文件实例FileClient get myresult.txt s8810_20060101123454_6081600000749.res 221.12.141.190 56701210 计 费365FAX网络传真系统采用 6秒 3分的计费机制，从对方传真机摘机开始算起。11 编 制 历 史版本号 更新时间 主要内容变更V1.0.0 2005-8-12 编制规范24小时联系电话：13914831956
