《金税防伪开票“升级版”组件接口2.0 软件方案》由会员分享，可在线阅读，更多相关《金税防伪开票“升级版”组件接口2.0 软件方案（10页珍藏版）》请在金锄头文库上搜索。
1、 升级版 组件接口 2 0 软件方案 补充稿 20150331 升级版 组件接口 2 0 软件方案 补充稿 20150331 一 版本说明一 版本说明 该技术方案是 7 23 版组件接口技术方案的补充部分 版本匹配关系 开票版本 V2 0 10 150211 VS 组件接口 V2 0 10 150227 开票版本 V2 0 10 150319 VS 组件接口 V2 0 10 150316 二 接口功能二 接口功能 1 设置数字证书密码 设置数字证书密码 说明 除通过属性方式设置证书密码外 还可以在开票软件 Bin 目录下创建文 件 cert txt 并将证书密码保存在此文件中 组件接口会自动读
2、取文件内容作为 证书密码 2 开启金税盘 开启金税盘 属性名称CertPassWord 说明本项功能在开启金税盘前首先调用 如果未设置默认为 88888888 输入数字证书密码 输出无 方法名称OpenCard 说明本接口开启并占用金税设备 初始化各项参数 分配软件所需各 项资源 如果尚未调用此功能而调用其它功能 则会产生返回码为 1 的尚 未开启金税盘的错误 当数字证书密码错误时 也会导致金税盘开启失败 输入无 输出名称说明 RetCode1011 开启成功 其它为失败 RetMsg错误描述信息 InvLimit单张增专票的价税合计限额 没有增专授权时 返回 0 如果没开卡就调用 返回 0
3、在 150227 版本后增加了开票限额 传入发票 种类 可获取对应的开票限额 3 查询库存发票 查询库存发票 4 发票开具 发票开具 方法 方法 Invoice 功能 功能 传入开票数据 将开票数据记入防伪税控开票数据库 并在金税盘中开 具此发票 输入 输入 5 1 增值税专 普票增值税专 普票 1 发票整体信息 SellerAddress 当 InfoKind 2 普通发票 时 若赋值为 1 表示农产 品销售发票 若赋值为 2 表示农产品收购发票 其它表示增值税普通 发票 2 发票明细信息 注意 注意 支持一票多税率 明细行税率以发票整体信息中的 InfoTaxRate 当前值 为准 5 2
4、 货物运输业发票货物运输业发票 1 发票整体信息 传入发票整体信息前调用 InvInfoInit 方法初始化发票整体信息各项 属性 InvInfoInit 方法名称GetInfo 说明从金税盘读取发票库存数量及其它参数 输入名称说明 InfoKind发票种类 0 增值税专用发票 2 增值税普通发票 11 货物运输业增值税专用发票 12 机动车销售统一发票 输出名称说明 RetCode3011 读取成功 其它为失败 RetMsg错误描述信息 InfoKind 11 如果是负数票给属性 InfoClientAddressPhone 传字符串 1 如 InfoClientAddressPhone W
5、ideString 1 Copy InfoClientName 实际受票方 InfoClientTaxCode 实际受票方纳税人识别号 ConsignerName 收货人 ConsignerTaxCode 收货人纳税人识别号 ShipperName 发货人 ShipperTaxCode 发货人纳税人识别号 OriginViaArrivalPlace 起运地 经由 到达地 InfoListName 运输货物信息 InfoTaxRate 税率 5 传 5 VehicleKindNo 车种车号 VehicleTonnage 车船吨位 InfoNotes 备注 InfoCashier 收款人 Info
6、Checker 复核人 2 费用项目 情况费用项目列表 ClearInvList 循环调用传入费用项目 InvListInit ListGoodsName 费用项目 ListAmount 金额 ListPriceKind 是否含税金额 ListTaxAmount 税额 如果不传 或传零接口自动计算 AddInvList 5 3 机动车销售统一发票机动车销售统一发票 InvInfoInit InfoKind 12 InfoClientAddressPhone 1 旧版 2 新版 InfoClientTaxCode 纳税人识别号 InfoClientName 购货单位 IDCard 身份证号码 组
7、织机构代码 VehicleKind 车辆类型 BrandModel 厂牌型号 OriginPlace 产地 QualityCertificate 合格证号 ImpCertificateNo 进口证明书号 CommInspectionNo 商检单号 EngineNo 发动机号码 VehicleNo 车辆识别代号 车辆号码 ManufacturerName 生产厂家名称 AmountTaxTotal 价税合计 SellerPhone 销货单位电话 SellerAccount 销货单位账号 SellerAddress 地址 SellerBank 开户银行 InfoTaxRate 税率 5 传 5 T
8、onnage 吨位 PeopleNo 限乘人数 InfoNotes 备注 正数票不要传备注 负数票传相应格式的备注 输出 输出 RetCode 4011 开票成功 其它失败 RetMsg 错误描述信息 5 设置发票上传模式 设置发票上传模式 6 发票上传 发票上传 属性名称UploadInvoiceAuto 说明设置已开具发票的上传模式 0 手工上传 1 自动上传 默认 设置为自动上传后 每次开具成功后自动将发票信息上传到局端 数据库 下一张发票开具前自动更新已上传发票的本地状态信 息 设置为手工上传时 需要分别调用上传和下载接口完成发票报 送 输入0 1 输出无 方法名称UploadInvo
9、ice 说明本项功能在发票开具接口 Invoice 调用成功后调用 若不设置输入参数 则手工将刚刚开具的发票信息上传到局端 若设置输入参数 则将指定的发票数据上传到局端 输入名称说明 InfoTypeCode要上传的十位发票代码 InfoNumber要上传的发票号码 7 发票状态更新 发票状态更新 8 发票打印 发票打印 方法 方法 PrintInv 功能 功能 调用防伪开票标准打印程序 打印指定发票 输入 输入 InfoKind 发票种类 0 专用发票2 普通发票11 货物运输业增值 税专用发票12 机动车销售统一发票 InfoTypeCode 要打印发票的十位代码 InfoNumber 要
10、打印发票的号码 9 已开发票作废 已开发票作废 方法 方法 CancelInv 功能 功能 在金税卡及防伪开票数据库中作废已开发票 输入 输入 InfoKind 发票种类 0 专用发票 2 普通发票 11 货物运输业增值 税专用发票 12 机动车销售统一发票 InfoTypeCode 要作废发票的代码 InfoNumber 要作废发票的号码 输出 输出 RetCode 6011 作废成功 其它失败 输出名称说明 RetCode8000 上传成功 其它为失败 RetMsg错误描述信息 方法名称UpdateInvoiceStatus 说明本项功能在发票上传接口 UploadInvoice 调用成功
11、后调用 手工 更新已成功上传到局端的发票本地状态信息 输入无 输出名称说明 RetCode8050 上传成功 其它为失败 RetMsg错误描述信息 RetMsg 错误描述信息 10 关闭金税卡 关闭金税卡 方法 方法 CloseCard 功能 功能 释放对金税卡的设备占用 释放其它占用的资源 输入 输入 无 输出 输出 RetCode 9000 调用成功 其它失败 RetMsg 错误描述信息 11 开启 开启 关闭开票系统手工开票作废功能关闭开票系统手工开票作废功能 方法 方法 EnHand 功能 功能 开启 关闭开票系统手工开票作废功能 下次启动开票软件时生效 需在 金税盘开启后调用 输入
12、输入 HandMade 开启 关闭选项 0 开启 1 关闭 调用方法前设置此属性值 输出 输出 RetCode 9000 调用成功 其它失败 RetMsg 错误描述信息 12 发票查询 发票查询 方法 方法 QryInv 功能 功能 查询发票信息 输入 输入 InfoBillNumber 销售单据编号 或 InfoKind 发票种类 0 专用发票 2 普通发票 11 货物运输业增值税专用 发票 12 机动车销售统一发票 InfoTypeCode 发票代码 InfoNumber 发票的号码 销售单据编号与发票种类 代码 号码只传入一个即可 输出 输出 RetCode 7011 查询成功 其它失败
13、 RetMsg 错误描述信息 InfoKind 发票种类 0 专用发票 2 普通发票 11 货物运输业增值税专用 发票 12 机动车销售统一发票 InfoTypeCode 发票代码 InfoNumber 发票号码 InfoBillNumber 销售单据编号 InfoAmount 合计不含税金额 InfoTaxAmount 合计税额 InfoInvDate 开票日期 PrintFlag 打印标志 0 已打印 1 未打印 UploadFlag 发票报送状态 0 未报送 1 报送成功 2 报送失败 3 报送中 4 验签失败 五 发票填开注意事项五 发票填开注意事项 1 负数发票 负数发票 开具货物运
14、输发票的负数票需将 InfoClientAddressPhone 属性赋值为 1 且备注中注明 开具红字货物运输业增值税专用发票信息表编号 XXXXXXXXXXXXXXX 其中 X 为信息表编号 开具机动车销售统一发票的负数票需在备注中注明 对应正数发票代 码 XXXXXXXXXX 号码 YYYYYYYY 字样 其中 X 为发票左上角 10 位 或 12 位代码数字 Y 为发票右上角 8 位号码数字 六 调用方式举例六 调用方式举例 下面仅以 C Build 语言为例分几种情况作一举例 1 生成发票的情况 生成发票的情况 1 货物运输发票货物运输发票 GoldTax InvInfoInit G
15、oldTax InfoKind 11 if 开具负数发票 GoldTax InfoClientAddressPhone WideString 1 Copy GoldTax InfoClientName WideString sjspf Copy 实际受票方 GoldTax InfoClientTaxCode WideString sjspfnsrsbh Copy 实际受票方纳 税人识别号 GoldTax ConsignerName WideString shr Copy 收货人 GoldTax ConsignerTaxCode WideString shrnsrsbh Copy 收货人纳税人识
16、 别号 GoldTax ShipperName WideString fhr Copy 发货人 GoldTax ShipperTaxCode WideString fhrnsrsbh Copy 发货人纳税人识别 号 GoldTax OriginViaArrivalPlace WideString qydjyddd Copy 起运地 经 由 到达地 GoldTax InfoListName WideString yshwxx Copy 运输货物信息 GoldTax InfoTaxRate StrToFloat slv 100 税率 GoldTax VehicleKindNo WideString czch Copy 车种车号 GoldTax VehicleTonnage WideString ccdw Copy 车船吨位 GoldTax InfoNotes WideString bz Copy 备注 GoldTax InfoCashier WideString skr Copy 收款人 GoldTax InfoChecker WideString fhrr Copy 复核人 GoldTa
