财政票据电子化系统

第三方接口文档&博思软件ivwivrbosss0ft.com.cn2014年06月编写目的编写过程是一个模拟开发的思考过程，通过这种思考，经验丰富的程序员可以把大部分的问题都能挖掘出来.使开发与测试可以有共同的标准。开发人员可以按着详细设计文档写代码，与此同时，测试人员可以根据详细设计文档写测试用例，从提高项目的质量背景财政实行大集中式电子化票据管理，部分单位已使用第三方业务系统，为了避免用户多次录入，便于统一管理维护，提供接口模式对接第三方业务系统数据.主要业务对接流程3.1电脑开票流程3.2直缴缴款书流程缴款书开票由第三方业务系统发起“直缴缴款书转入开票”请求传入待缴款项目等信息，开具缴款书。银联POS刷卡缴款确认第三方业务系统发起“POS机刷卡缴款确认”请求传入待缴款信息进行缴款确认。缴款确认成功则开具对应的电脑票并返回电脑票相关信息。缴款确认失败则必须发送“POS机缴款确认查询”请求传入待缴款信息对当前缴款书的缴款情况做确认。缴款失败情况简要说明：正常的交易失败POS机设备连接脱落网络连接、电话拨号等信号不正常系统设计4.1接口规范1、 如果是C/S架构，则调用接口DLL：Totallnterface.dll中的接口方法。2、 如果是B/S架构，则调用组件OCX：BillActiveFormProj.ocx中的接口方法。OCX通过安装包自动注册在系统注册表中，键值为[7CDB6D1E-CD4A-47B4-BFD0-310B66089007]通过键值获取OCX对象调用接口方法Totallnterface.dll和BillActiveFormProj.ocx都包含在应用环境包中。4.1.1接口方法详述接口名称：InterfaceMethod描述：所有的接口都是通过该方法进行调用DLL方法声明：FunctionInterfaceMethod(aXml,resXml:PChar):PChar;OCX方法声明：FunctionInterMethod(constXml:WideString):WideString;safecall;参数：参数名类型说明aXmlPChar根据要调用的具体方法，需传入相应的方法参数resXmlPChar根据调用传入方法参数，执行相应的方法，返回与之方法名相应的返回参数（XML格式）参数说明：1•调用DLL传入参数和返回参数的类型是PChar2•通过调用OCX传入的参数和返回的参数类型是string（IE不支持PChar）3•传入参数和返回参数的格式均采用xml的节点格式，但不包含xml头信息4・1・1・1・主要参数格式说明〈webbill〉〈name〉方法名称〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验KEY〈/key〉<version〉接口版本〈/version〉<systype〉系统类型〈/systype〉〈params〉<param1>参数1</param1><param2>参数2</param2>〈/params〉〈/webbill〉节点说明webbill根结点name方法名称（如：InvoiceBill、InvalidBill、GetBillType等），该项是变动的ivcnode开票点编码（根据票据系统）nodeuser单位开票点用户编码（根据票据系统）userpwd单位开票点用户密码（根据票据系统）key单位校验KEY（根据票据系统）version版本号（默认：1.0.0.1）Systype系统类型（默认：1）params方法的参数集合paraml、param2方法的参数是根据节点name的方法名称来决定的，该项是变动的通用参数说明：单位开票点用户编码，用户密码等信息双方保持一致。单位开票点编码默认为001；多开票点情况根据财政票据系统实际使用情况配置。4.1.2接口业务方法详述4・1・2・1・电脑开票说明：根据票据预设的格式，转入开票信息，并可进行打印票据信息电脑开票参数示例传入参数格式〈webbill〉<name>InvoiceBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验KEY〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml>票据信息数据</param1><param2>是否打印〈/param?〉〈param3>票据类型〈/param3>〈param4>备注</param4>〈/params〉〈/webbill〉主要节点说明:节点名类型参数内容namestring方法名（值为InvoiceBill）versionstring该方法（值1.0.0.1）paramlstring票据信息数据“票据信息数据”说明，通用格式如下：<bill>〈head〉〈缴款人〉缴款人〈/缴款人〉〈其它1〉其它1〈/其它1>〈其它2〉其它2</其它2>〈其它3〉其它3</其它3>〈其它x〉其它4</其它x〉</head>〈chargeitems〉〈charge〉〈chargecode〉收费项目编码〈/chargecode〉<cnt〉数量〈/cnt〉〈standard〉单价〈/standard〉〈amt〉金额〈/amt〉〈otherl〉其它1〈/otherl〉〈other2〉其它2〈/other2〉〈other6〉其它6〈/other6〉〈/charge〉〈charge〉<chargecode〉收费项目编码〈/chargecode〉<cnt〉数量〈/cnt〉〈standard〉单价〈/standard〉<amt〉金额〈/amt〉〈other1>其它1〈/other1>〈other2>其它2</other2>〈otherx〉其它x〈/otherx></charge></chargeitems〉〈/bill〉票据信息数据节点说明节点数据类型XML目录位置说明billbill票据信息headbill-〉head票据信息的头信息缴款人stringbill-〉head-〉缴款人票据的缴款人信息，信息节点为固定节点其它1stringbill-〉head-〉其它x节点的“其它1”“其它2”等为可选其它2节点，节点的名称也可以随意命名，节点个数可以在20个以内，具体内容其它x以“5附件”为准chargeitemsbill-〉chargeitems收费项目集合chargestringbill->chargeitems—〉charge收费项目

chargecodestringbill->chargeitems—〉charge—〉chrgcode收费项目编码（即医疗票据的大类）entnumberbill—〉chargeitems—〉charge—〉ent数量（最多保留两位小数）standardnumberbill—> chargeitems—〉charge—〉standard收费标准（最多保留六位小数）amtnumberbill—>chargeitems—〉charge—〉amt金额（格式：0.00 保留两位小数位）otherlotherxstringbill—>chargeitems—〉charge—〉otherx节点的otherl”、“other2”等为可选节点，节点的名称也可以随意命名，节点个数可以在20个以内，具体内容以“5附件”为准param2string是否打印（0否，1是）param3string票据类型（根据票据系统）Param4string备注（可为空）返回结果〈result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈billno〉票据号〈/billno〉〈billtype〉票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉〈amt〉金额〈/amt〉<key>数字指纹〈/key〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）数字指纹：用于票据信息真伪的验证。4・1・2・2・作废已开具的票据说明：将原本开过的票据信息，进行作废操作。一次仅只作废一张票据号传入参数格式〈webbill〉<name>InvalidBill</name>〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验KEY〈/key〉<version〉接口版本〈/version〉<systype〉系统类型〈/systype〉〈params〉〈paraml>票据号</param1>〈param2>票据类型〈/param2><param3>票别号</param3><param4>作废权限控制〈/param4>〈/params〉〈/webbill〉说明：〈param4〉作废权限控制〈/param4〉（0为系统默认权限，1为跨单位，2为跨用户）返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉<success><billno>票据号〈/billno〉<billtype〉票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4.1・2・3・取所有机打票据类型说明：用票单位有多种票据类型，通过此函数可以读取出此单位的所有票据类型传入参数格式<webbill><name>GetBillType</name><ivcnode>单位开票点编码〈/ivcnode〉<nodeuser>单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验KEY〈/key〉〈version〉接口版本〈/version〉〈systype〉系统类型〈/systype〉〈params〉〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈bill〉〈billtype〉票据类型〈/billtype>〈billname〉票据名称〈/billname〉〈billregs〉〈billreg〉票别号l〈/billreg〉<billreg〉票别号2〈/billreg〉<billreg〉票别号X〈/billreg〉〈billregs〉</bill></success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）〈billreg〉〈/billreg〉可允许有多个，〈bill〉〈/bill〉可允许有多个4・1・2・4・作废一张空白票据号说明：作废一张当前默认的机打票据类型的票据号传入参数格式<webbill>〈name〉InvalidBillNo〈/name〉<ivcnode>单位开票点编码〈/ivcnode〉<nodeuser>单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉<param1>未使用的票据号</param1><param2>票据类型</param2><param3>票别号</param3></params>〈/webbill〉返回结果<result>〈status〉结果状态〈/status〉<error>失败信息</error><success><billno>票据号</billno><billtype>票据类型〈/billtype>〈billreg>票别号</billreg></success></result>说明：〈status>〈/status>表示返回结果（0为失败，1为成功）4・1・2・5・取发放票据记录说明：提供上级单位向本单位发放票据的详细数据（未被使用过的），使业务系统不必二次录入,接口只提供数据没办法判断是否已经取过了转入参数格式<webbill><name>GetStockOut〈/name><ivcnode>单位开票点编码</ivcnode><nodeuser>单位开票点用户编码</nodeuser><userpwd>用户密码</userpwd><key>单位校验key</key><version>接口版本〈/version><systype>系统类型〈/systype><params></params></webbill>返回结果〈result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈sucesscount〉l〈/sucesscount〉<sucesslst〉〈billstartno〉起始号〈/billstartno〉〈billendno〉终止号〈/billendno〉〈billtype〉票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉<sucesslst〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）<sucesscount〉〈/sucesscount〉表示票段数4・1・2・6・取第一张电脑票票号说明：根据预设的票据类型，读取当前第一张可用的票据号传入参数格式〈webbill〉〈name〉GetCurBillNo〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验key〈/key〉〈version〉接口版本〈/version〉〈systype〉系统类型〈/systype〉〈params〉〈paraml〉票据类型〈/paraml〉〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈sucesscount〉1〈/sucesscount〉<sucesslst〉〈billno〉票据号〈/billno〉<sucesslst〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4.1・2・7・打印一张电脑票据说明：打印一张指定的电脑票据传入参数格式〈webbill〉〈name〉PrintBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验key〈/key〉〈version〉接口版本〈/version〉<systype〉系统类型〈/systype〉〈params〉〈paraml〉票据号〈/paraml〉〈param2〉票据类型〈/param2〉〈param3〉票别号〈/param3〉〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉成功信息〈/success〉</result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4.1・2・8・电脑票POS刷卡缴款确认说明：根据参数中的信息对对应的电脑票据进行pos刷卡缴款确认传入参数格式〈webbill〉〈name〉PosPayComputerInv〈/name〉<ivcnode>单位开票点编码〈/ivcnode〉<nodeuser>单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验KEY〈/key〉〈version〉接口版本〈/version〉〈systype〉系统类型〈/systype〉〈params〉〈paraml>票据号</param1>〈param2>票据类型</param2><param3>票别号</param3><param4>金额〈/param4>〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈billno〉开票票据号〈/billno〉〈billtype〉开票票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉〈transNo〉交易参考号〈/transNo〉〈voucher〉凭证号〈/voucher〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1・2・9・电脑票POS刷卡缴款确认查询说明：根据参数中的信息查询对应的电脑票据pos刷卡的缴款情况传入参数格式<webbill>〈name〉PosQueryComputerInv〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验KEY〈/key〉〈version〉接口版本〈/version〉<systype〉系统类型〈/systype〉〈params〉〈paraml>票据号</param1>〈param2>票据类型〈/param?〉<param3>票别号〈/param3><param4>金额</param4>〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈billno〉开票票据号〈/billno〉〈billtype〉开票票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉〈transNo〉交易参考号〈/transNo〉〈voucher〉凭证号〈/voucher〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1・2・10・ 读取第一张缴款书票据号说明：读取当前第一张可用的缴款书票据号传入参数格式<webbill>〈name〉GetCurPayLetterNo〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml〉票据类型〈/paraml〉〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉<success>〈billno〉票据号〈/billno〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1・2・11・ 直缴缴款书转入说明：根据票据预设的需求格式，转入缴款信息，并可进行打印票据信息直缴缴款书转入参数示例传入参数格式〈webbill〉〈name〉IvcPayLetterBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml>票据信息数据</param1><param2>是否打印</param2>〈param3>票据类型</param3><param4>缴款类型（01:国库02:专户）〈/param4><param5>备注〈/param5>〈/params〉〈/webbill〉节点名类型参数内容paramlstring票据信息数据“票据信息数据”说明，通用格式如下：〈bill〉〈head〉〈payername〉缴款人名称〈/payername〉<payeraccount〉缴款账号〈/payeraccount〉〈payerbank〉缴款银行〈/payerbank〉</head><chargeitems〉〈charge〉<chargecode〉收费项目编码〈/chargecode〉<cnt〉数量〈/cnt〉〈standard〉单价〈/standard〉<amt〉金额〈/amt〉</charge><charge><chargecode〉收费项目编码〈/chargecode〉<cnt〉数量〈/cnt〉〈standard〉单价〈/standard〉<amt〉金额〈/amt〉

〈/charge〉〈/chargeitems〉〈/bill〉票据信息数据节点说明节点数据类型XML目录位置说明billbill票据信息headbill-〉head票据信息的头信息payernamestringbill—〉head-〉payername票据的付款人信息，信息节点为固定节点payeraccountstringbill->head-〉payeraccount票据的付款人账号信息，信息节点为固定节点payerbankstringbill->head-〉payerbank票据的付款人银行信息，信息节点为固定节点chargeitemsbill->chargeitems收费项目集合chargestringbill->chargeitems—〉charge收费项目chargecodestringbill->chargeitems—〉charge—〉chrgcode收费项目编码（即医疗票据的大类）entnumberbill—>chargeitems—〉charge—〉cnt数量（最多保留两位小数）standardnumberbill—> chargeitems—〉charge—〉standard收费标准（最多保留六位小数）amtnumberbill—>chargeitems—〉charge—〉amt金额（格式：0.00保留两位小数位）返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉<success>〈billno〉票据号〈/billno〉〈billtype〉票据类型〈/billtype〉〈billreg〉注册号〈/billreg〉〈amt〉金额〈amt〉〈/success〉〈/result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1.2・12・ 作废一张缴款书票据说明：作废一张开过的缴款书票据传入参数格式〈webbill〉〈name〉InvalidPayLetterBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml〉缴款书票据号〈/paraml〉〈param2〉缴款书票据类型〈/param2〉〈param3〉缴款书票别号〈/param3〉〈/params〉〈/webbill〉返回结果<result〉〈status〉结果状态</status〉〈error〉失败信息〈/error〉〈success〉〈billno〉缴款书票据号〈/billno〉〈billtype〉缴款书票据类型〈/billtype>〈billreg〉缴款书票别号〈/billreg〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1.2・13・ 打印一张缴款书票据说明：打印一张开过的缴款书票据传入参数格式〈webbill〉〈name〉PrintPayLetterBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml〉缴款书票据号〈/paraml〉〈param2〉缴款书票据类型〈/param2〉〈param3〉缴款书票别号〈/param3〉〈/params〉〈/webbill〉返回结果〈result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉成功信息〈/success〉</result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1・2・14・ 缴款书POS机刷卡缴款确认说明：根据参数中的信息对对应的缴款书进行pos刷卡缴款并开具电脑票据传入参数格式〈webbill〉〈name〉PosPayLetterBill〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉<key>单位校验key〈/key〉<version〉接口版本〈/version><systype〉系统类型〈/systype〉〈params〉〈paraml〉缴款书票据类型〈/paraml〉〈param2〉缴款书票别号〈/param2〉〈param3〉缴款书票据号〈/param3〉〈param4〉金额〈/param4〉<param5>是否打印电脑票〈/param5〉〈/params〉〈/webbill〉说明：〈param4〉是否打印（0否，1是）返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈billno〉开票票据号〈/billno〉〈billtype〉开票票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉〈amt〉金额〈/amt〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4・1・2・15・缴款书POS机缴款确认查询说明：根据参数中的信息查询对应的缴款书pos刷卡的缴款情况，成功则缴款确认并开具电脑票据传入参数格式<webbill>〈name〉PosQueryPayLetter〈/name〉〈ivcnode〉单位开票点编码〈/ivcnode〉〈nodeuser〉单位开票点用户编码〈/nodeuser〉〈userpwd〉用户密码〈/userpwd〉〈key〉单位校验key〈/key〉〈version〉接口版本〈/version〉〈systype〉系统类型〈/systype〉〈params〉〈paraml〉缴款书票据类型〈/paraml〉〈param2〉缴款书票别号〈/param2〉〈param3〉缴款书票据号〈/param3〉〈param4〉金额〈/param4〉〈param5〉是否打印电脑票〈/param5〉〈/params〉〈/webbill〉说明：〈param4〉是否打印（0否，1是）返回结果<result〉〈status〉结果状态〈/status〉〈error〉失败信息〈/error〉〈success〉〈billno〉开票票据号〈/billno〉〈billtype〉开票票据类型〈/billtype〉〈billreg〉票别号〈/billreg〉<amt〉金额〈/amt〉</success></result〉说明：〈status〉〈/status〉表示返回结果（0为失败，1为成功）4.2与第三方业务系统对接的数据项说明由于双方系统的数据不一致，因此在对接时需要规范数据格式、统一数据来源1•单位开票点用户编码，用户密码等信息双方保持一致。单位开票点编码默认为001；多开票点情况根据财政票据系统实际使用情况配置。单位校验KEY,由财政票据系统提供4•票据、票别号等根据财政票据系统实际情况而变化5.收费项目需要在财政票据系统中做数据对照设置5.附件5.1电脑开票参数示例〈webbill〉〈name〉InvoiceBill〈/name〉〈ivcn