发票云(标准版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
  1. 档案
  • 整体介绍
  • 对接约定
  • 授权
    • 获取AccessToken
      POST
  • 开票
    • 产品介绍
    • 开发指南
    • 税控&数电同步开票
      • 业务场景下接口调用顺序
      • 1.01.读取税盘信息(czlx-7)
      • 1.02 .读取票种信息(czlx-30)
      • 1.03.发票开具(czlx-3)
      • 1.04.发票作废(czlx-6)
      • 1.05.发票查询(czlx-5)
      • 1.06.发票打印(czlx-4)
      • 1.07.专用发票申请红字信息表(czlx-20)
      • 1.08.查询专用发票申请红字信息表(czlx-18)
      • 1.09.批量打印(czlx-32)
      • 1.11.机动车销售统一发票开具(czlx-40)
      • 1.12.机动车销售统一发票查询(czlx-41)
      • 1.13.机动车销售统一发票红冲(czlx-42)
      • 1.15.核定票种查询(czlx-51)
      • 1.21.二手车-发票开具(czlx-43)
      • 1.22.二手车-发票查询(czlx-44)
      • 1.23.二手车-发票红冲(czlx-45)
      • 1.30 .查询授信额度接口(czlx-122)
      • 2.01.电子发票开具(czlx-110) ，【注】开数电票请对接：1.03.发票开具(czlx-3)
      • 2.02.电子发票信息查询(czlx-113)
      • 2.03.电子发票红冲 （只支持全额红冲）(czlx-114)
      • 2.04.刷新PDF(czlx-115)
      • 2.05.查询电子发票余量(czlx-116)
      • 3.01.查询税收分类编码信息(czlx-504)
      • 3.03.获取打印机列表(czlx-901)
    • 数电异步开票
      • 异步开票-v4
      • 查询异步开票结果-v4
    • 托管电票(开票)
      • 开发指南
      • 1.01.托管开票接口
      • 1.02.发票红冲接口(通过流水号做全额冲红)
      • 1.03.发票红冲接口(通过发票代码代码、号码做全额冲红)
      • 1.04.电子发票信息查询 （根据流水号）
      • 1.05.电子发票信息查询 （根据代码、号码）
      • 1.06.电子发票信息查询 （根据订单号）
      • 1.07.下载pdf接口（根据流水号）
      • 1.08.下载pdf接口（根据代码、号码）
      • 1.09.销项金蝶云公共pdf地址查询（根据流水号）
      • 1.10.进项发票生成pdf接口
      • 1.11.查询销项发票明细（根据开票时间、销方税号）
      • 1.12.查询普通电子发票余量
      • 1.13版式文件下载及邮件发送接口
      • 1.14.发送邮件和短信接口
    • 扫码开票
      • 上传销售单模式扫码开票
        • 接入指南
        • 1.token获取
        • 2.上传发票销售单接口
        • 3.回推接口地址
      • 自定义扫码开票
        • 接入指南
        • 1.对接方按规则组装二维码链接
        • 2.查询开票明细
        • 3.回推接口地址
    • 企业级-发票云销项查询
      • 根据业务条件查询当前企业的销项发票
  • 收票
    • 开发指南
    • 发票数据规范
    • 发票数据
      • 机动车发票数据
      • 火车票数据
      • 火车票退票凭证数据
      • 财政电子票据数据
      • 客运票/轮船票数据
      • 其他发票数据
      • 完税证明数据
      • 飞机票数据
      • 数电票（铁路电子客票）数据
      • 数电票（航空运输电子客票行程单）数据
      • 数电票（专票/普票)数据
      • 的士票数据
      • 定额发票数据
      • 通用机打(纸质/电子)发票数据
      • 过路过桥费数据
      • 二手车票数据
      • 专票和普票数据
      • 通行费发票数据
      • 海关缴款书数据
      • 发票文件数据
    • 企业级-发票云进项查询
      • 根据业务条件查询当前企业采集的发票
      • 根据代码号码查询当前企业采集的发票
      • 根据开票时间范围和采集时间范围查询当前企业采集的发票
      • 根据发票流水号或者发票代码号码查询当前企业采集的发票
      • 根据业务条件查询指定用户采集的发票
    • 税盘&数电票下载
      • 开发指南
      • 1、获取税款所属期信息
      • 2、进项发票表头采集
      • 3、发票不抵扣勾选
      • 4、海关缴款书抵扣勾选（税盘模式不支持）
      • 5、海关缴款书不抵扣勾选（税盘模式不支持）
      • 6、海关缴款书表头采集（税盘模式不支持）
      • 7、全量发票查询
      • 8、当前统计查询
      • 9、历史统计查询
      • 10、生成统计表
      • 11、撤销统计表
      • 12、确认统计表
      • 13、获取当前已勾选或往期已认证发票（税盘模式不支持）
      • 14、当期已勾选或往期已认证缴款书（税盘模式不支持）
      • 15、发票抵扣勾选
    • 电子凭证解析
      • billTypeCode表
      • 解析 + 验签 指定文件的xbrl信息
      • xbrl字符串转json
      • json转xbrl字符串
    • 发票异步下载
      • 进项全量发票采集-异步申请
      • 进项全量发票采集-异步结果查询
    • 发票数据规范
  • 查验识别
    • 开发指南
    • 发票查验（单张）
    • 发票查验（多张异步）
    • 发票识别+查验（单张）
    • 发票识别（多张）
    • 发票识别+查验（多张）
    • 数电票文件识别+查验
    • 返回状态码
  • 报销
    • 发票助手移动端-h5对接
    • 发票助手移动端-小程序对接
    • 第三方发票报销查询
    • 发票助手PC端对接
      • 对接流程
      • JS建立连接通道
      • 采集发票
      • 后端建立通道
      • 查看发票
      • 编辑单张发票
      • 分录操作
      • 常见问题
      • 获取userKey
      • 获取linkKey
      • 缓存单据
      • 保存单据
      • 更新单据状态
      • 根据发票流水号获取发票详细数据
      • 根据userkey查询单据下所有发票列表
      • 删除单据
      • 再次查验
      • 回写入账信息
      • 删除入账信息
  • 影像
    • 开发指南
    • 对接约定
    • 影像系统对接
    • 授权
      • 获取AccessToken(影像系统)
    • 影像单据
      • 获取影像调阅页面地址
      • 获取影像匹配结果
    • 影像文件
      • 文件上传(文件方式)
      • 文件上传(url方式)
    • 银行回单
      • 获取银行回单助手页面地址接口
      • 银行回单查看详情接口
  • 档案
    • 异构系统接口定义
    • 发票返结构体
  1. 档案

发票返结构体

发票返结构体：
增值税专票、普票、卷票返回数据结构：Json
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[
{
"serialNo":"", 发票流水号
"invoiceCode": "", 发票代码
"invoiceNo": "", 发票号码
"invoiceDate": "", 开票日期
"checkCode": "", 校验码
"salerName": "", 销方名称
"salerTaxNo": "", 销方纳税人识别号
"salerAddressPhone": "" 销方地址电话
"salerAccount": "", 销方开户行及账号
"buyerName": "", 购方名称
"buyerTaxNo": "", 购方纳税人识别号
"buyerAddressPhone": "", 购方地址电话
"buyerAccount": "", 购方银行账号
"amount": "", 金额合计(不含税)
"taxAmount": "", 税额合计
"totalAmount": "", 价税合计(小写)
"totalAmountCn": "", 价税合计大写
"remark": "", 备注
"machineNo": "", 机器编号
"cancelMark": "", 作废标识，N：未作废；Y：作废
"proxyMark": "", 代开标识：默认空，1为代开
"snapshotUrl": "", 快照地址
"downloadUrl": "", 原件下载地址
"invoiceType": "", 发票种类: 1.普通电子发票2.电子发票专票3.普通纸质发票4.专用纸质发票5.普通纸质卷票7.通用机打8.的士票9.火车票10.飞机票11.其他12.机动车13.二手车14.定额发票15.通行费16.客运票17.过路过桥发票19.完税证明20.轮船票23.通用机打电子发票
"drawer": "", 开票人
"reviewer": "", 复核人
"payee": "", 收款人
"checkCount": "", 查验次数
"items": [
{
"goodsName": "", 货物名称
"unitPrice": "", 单价(不含税)
"num": "", 数量
"taxRate": "", 税率
"unit": "", 单位
"detailAmount": "", 金额(不含税)
"specModel": "", 规格型号
"taxAmount": "", 税额
"goodsCode": "" 商品编码
}
]
}
]}
}
机动车发票返回结构：Json
{
"errcode": 0,
"description": "查询成功",
"data": {"invoice":[
{
"invoiceCode": "", 发票代码
"invoiceNo": "", 发票号码
"invoiceDate": "", 开票日期
"buyerTaxNo": "", 购方纳税人识别号
"buyerName": "", 购方名称
"buyerIdNo": "", 购方身份证号码/组织机构代码
"salerName": "", 销方单位名称
"salerPhoneNumber": "", 销方电话
"salerTaxNo": "", 销方纳税人识别号
"salerAccount": "", 销方账号
"salerAddress": "", 销方地址
"salerBankName": "", 销方开户银行
"vehicleType": "", 车辆类型
"bandModel": "", 厂牌型号
"produceArea": "", 产地
"qualifiedNo": "", 合格证号
"certificateNo": "", 进口证明书号
"commodityInspectionNo": "", 商检单号
"engineNo": "", 发动机号码
"vehicleIdentificationNo": "", 车辆识别代号/车架号码
"taxRate": "", 增值税税率或征收率
"taxAccount": "", 增值税税额
"totalAmount": "", 价税合计
"taxAuthorityCode": "", 主管税务机关名称
"taxAuthorityName": "", 主管税务机关代码
"amount": "", 不含税价金额
"tonnage": "", 吨位
"limitedCount": "", 限乘人数
"machineNo": "", 机器编号
"taxPaymentCertificateNo": "", 完税凭证号码
"cancelMark": "" 作废标志
}
]}
}
二手车发票返回结构：Json
{
"errorCode": 0,
"description": "查询成功",
"data": {"invoice":[
{
"serialNo": "", 发票流水号
"invoiceCode": "", 发票代码
"invoiceNo": "", 发票号码
"invoiceDate": "", 开票日期
"buyerPhoneNumber": "", 购方电话
"buyerName": "", 购方名称
"buyerIdNo": "", 购方身份证号码/组织机构代码
"buyerAddress": "", 购方地址
"salerName": "", 销方单位名称
"salerPhoneNumber": "", 销方电话
"salerIdNO": "", 销方纳税人识别号
"salerAddress": "", 销方地址
"licensePlateNumber": "", 车牌照号
"registrationNumber": "", 登记证号
"vehicleType": "", 车辆类型
"vehicleIdentificationNo": "", 车辆识别代号/车架号码
"bandModel": "", 厂牌型号
"vehicleManagementName": "", 转入地车辆管理所名称
"totalAmount": "", 车价合计
"totalAmountCn": "", 车价合计大写
"auctionName": "", 拍卖/经营名称
"auctionPhoneNumber": "", 拍卖/经营电话
"auctionAddress": "", 拍卖/经营地址
"auctionTaxpayerId": "", 拍卖/经营税号
"auctionBankAccout": "", 拍卖/经营开户银行帐号
"marketName": "", 二手市场单位
"marketPhoneNumber": "", 二手市场电话
"marketAddress": "", 二手市场地址
"marketTaxpayerId": "", 二手市场税号
"marketBankAccout": "", 二手市场开户银行帐号
"remark": "", 备注
"checkCount": "", 查验次数
"cancelMark": "", 是否作废Y作废，N不作废
"invoiceType": "", 发票类型
}
]}
}
通行费发票返回结构：Json
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[
{
"serialNo":"", 发票流水号
"invoiceCode": "", 发票代码
"invoiceNo": "", 发票号码
"invoiceDate": "", 开票日期
"invoiceMoney": "", 发票金额(不含税
"checkCode": "", 校验码
"salerName": "", 销方名称
"salerTaxNo": "", 销方纳税人识别号
"salerAddressPhone": "" 销方地址电话
"salerAccount": "", 销方开户行及账号
"buyerName": "", 购方名称
"buyerTaxNo": "", 购方纳税人识别号
"buyerAddressPhone": "", 购方地址电话
"buyerAccount": "", 购方银行账号
"amount": "", 金额合计(不含税)
"taxAmount": "", 税额合计
"totalAmount": "", 价税合计(小写)
"totalAmountCn": "", 价税合计大写
"remark": "", 备注
"machineNo": "", 机器编号
"cancelMark": "", 作废标识，N：未作废；Y：作废
"proxyMark": "", 代开标识：默认空，1为代开
"snapshotUrl": "", 快照地址
"downloadUrl": "", 原件下载地址
"invoiceType": "", 发票种类: 1.普通电子发票2.电子发票专票3.普通纸质发票4.专用纸质发票5.普通纸质卷票7.通用机打8.的士票9.火车票10.飞机票11.其他12.机动车13.二手车14.定额发票15.通行费16.客运票17.过路过桥发票19.完税证明20.轮船票23.通用机打电子发票
"drawer": "", 开票人
"reviewer": "", 复核人
"payee": "", 收款人
"checkCount": "", 查验次数
"items": [
{
"specModel": "", 类型
"taxRate": "", 税率
"detailAmount": "", 明细金额(不含税)
"licensePlateNumber": "", 车牌号码
"goodsName": "", 项目名称
"startDate": "", 通行起始日期
"endDate": "", 通行结束日期
"taxAmount": "" 金额
}
]
}
]}
}
//识别的士票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"mileage":"", 里程
"timeGeton":"", 上车时间
"timeGetoff":"", 下车时间
"place":"", 乘车地点
"invoiceType":"" 发票类型
}]}
}
//识别火车票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"printingSequenceNo":"", 印刷序号
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"seat":"", 座位
"stationGeton":"", 上车地点
"stationGetoff":"", 下车地点
"trainTime":"", 开车时间
"trainNum":"", 车次
"passengerName":"", 乘客姓名
"invoiceType":"" 发票类型
}]}
}
//识别飞机票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": "invoice":{[{
"invoiceDate":"", 发票日期
"fightNum":"", 航班号
"destination":"", 目的地
"placeOfDeparture":"", 出发地
"seatGrade":"", 座位等级
"electronicTicketNum":"", 电子客票行程单
"customerIdentityNum":"", 客户身份证
"customerName":"", 客户名
"totalAmount":"", 含税金额
"invoiceAmount":"", 不含税金额
"taxAmount":"", 税额
"fuelSurcharge":"", 燃油附加费
"insurancePremium":"", 保险费
"salesUnitCode":"", 销售单位代号
"fillingUnit":"", 填开单位
"airTime":"", 乘机时间时分秒
"invoiceType":"" 发票类型
}]}
}
//识别通用机打票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"checkCode":"", 校验码
"buyerTaxNo":"", 购方税号
"salerTaxNo":"", 销方税号
"buyerName":"", 购方名称
"salerName":"", 销方名称
"invoiceType":"" 发票类型
}]}
}
//识别定额票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"totalAmount":"", 含税金额
"invoiceType":"" 发票类型
}]}
}
//识别客运票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"stationGeton":"", 上车地点
"stationGetoff":"", 下车地点
"passengerName":"", 乘客姓名
"invoiceType":"" 发票类型
}]}
}
//识别过路过桥票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data": {"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"entrance":"", 入口
"exit":"", 出口
"invoiceType":"" 发票类型
}]}
}
//识别其他票返回结构
{
"errcode": "0000",
"description": "查询成功",
"data":
{"invoice":[{
"invoiceCode":"", 发票代码
"invoiceNo":"", 发票号码
"invoiceDate":"", 发票日期
"totalAmount":"", 含税金额
"invoiceType":"" 发票类型
}]
}
}
//失败返回结构体：
{
"errcode": "0001",
"description": "查询异常"
}
修改于 2024-10-10 07:49:33
上一页
异构系统接口定义
Built with