365FAX网络传真概述及接口规范.doc

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