API开发文档 - 道一云

开发说明

开发说明

功能说明：根据发票id数组，进一步获取发票信息详情
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/reimApiCtl/getInvoiceDetail.do?token=token&corpId=corpId&invoiceIds=id1&invoiceIds=id2

请求参数说明：

参数名	释义	类型	是否必须	描述
token	用于验证	String	是	参考获取token接口
corpId	公司唯一标识	String	是
invoiceIds	发票id数组	String	是	传递多个时，请传递多个参数，invoiceIds=id1&invoiceIds=id2……，一次最多传递500个

SDK调用示例：

		ReimApi api = QwSdkUtil.getInter(ReimApi.class);
		ApiInvoiceDetailResult result = api.getInvoiceDetail(QwSdkUtil.getCacheToken(),
				new String[]{"发票id1","发票id2"});
		System.out.println(JSONUtil.stringify(result));

返回结果：

{
  "code": "0",
  "desc": "成功",
  "data": {
    "invoices": [{
      "agentCode": "",
      "amount": 459,
      "buyer": "",
      "buyerId": "",
      "buyerTaxId": "",
      "caacDevelopmentFund": 0,
      "carCode": "",
      "carEngineCode": "",
      "carModel": "",
      "cardCode": "",
      "cardId": "",
      "category": "",
      "certificateNumber": "",
      "checkCode": "",
      "city": "",
      "code": "",
      "companyName": "",
      "companyTaxId": "",
      "curLog": {
        "id": 0,
        "invoiceId": "",
        "orgId": "",
        "validationCode": "",
        "validationMsg": "",
        "validationTime": ""
      },
      "currencyCode": "",
      "date": "2023年12月18日",
      "entrance": "",
      "exit": "",
      "fare": 0,
      "flights": [],
      "fuelSurCharge": 0,
      "insurance": 0,
      "invoiceCode": "",
      "invoiceId": "60ed4eed179244ed88fb99f13ad49a70",
      "invoiceImageUrl": "/upload/img/....jpeg",
      "invoiceName": "火车票",
      "invoiceNumber": "N043346",
      "invoiceType": 3,
      "invoiceTypeId": "a3791fac0dae4843b4f2e687f0fabb6f",
      "isLock": 0,
      "issueBy": "",
      "items": [],
      "kind": "",
      "licensePlate": "",
      "machineCode": "",
      "machineNumber": "",
      "mileage": "",
      "name": "云办公",
      "noTaxAmount": 421.1,
      "number": "",
      "orderId": "f1e34faca34d4025b9806ccfc98625a1",
      "orgId": "fe63cb089f0646208de2dcde7425aec1",
      "pretaxAmount": 0,
      "province": "",
      "registrationNumber": "",
      "repeat": 0,
      "seat": "二等座",
      "seller": "",
      "sellerTaxId": "",
      "serialNumber": "",
      "sort": 1,
      "stationGetOff": "北京南",
      "stationGetOn": "合肥南",
      "status": 2,
      "tax": 0,
      "taxAmount": 37.9,
      "taxAuthorities": "",
      "taxAuthoritiesCode": "",
      "taxPayerFlag": 0,
      "taxRate": "",
      "time": "07:04",
      "timeGetOff": "",
      "timeGetOn": "",
      "total": 459,
      "trainNumber": "G2552",
      "type": "10503",
      "userId": "4401013333****4444",
      "userName": "",
      "validation": 3,
      "validationLogs": []
    }, ]
  }]
}
}

返回参数说明：

参数名	释义	类型	是否必须	描述
invoices	TbQyReimInvoiceDTO	TbQyReimInvoiceDTO[]	否

TbQyReimInvoiceDTO类型说明：

参数名	释义	类型	是否必须	描述
invoiceId	发票ID	String	否
orderId	单据id	String	否	如：表单的workId，报销单的reimId
sort	排序号	Integer	否
invoiceTypeId	发票类型ID	String	否
invoiceType	发票类型	Integer	否	0:增值税普通发票 1:增值税专用发票 2:出租车发票 3:火车票 4:长途汽车票 5:飞机票 6:网约车发票 7:其他 99:自定义发票
invoiceName	发票类型名称	String	否
cardId	卡劵 id	String	否
cardCode	卡劵 code	String	否
type	识别的发票类型	String	否	10100:增值税专用发票 10101:增值税普通发票 10102:增值税电子普通发票 10103:增值税普通发票(卷票) 10104:机动车销售统一发票 10105:二手车销售统一发票 10505a:船票 10200:定额发票 10400:机打发票 10500:出租车发票 10503:火车票 10505:客运汽车票 10506:航空运输电子客票行程单 10107:数电票(增值税专用发票) 10507:过路费发票 10900:可报销其他发票 0000:其他 20100:小票 20105:出行行程单 10902:完税证明 10108:数电票(普通发票)
amount	价税合计（元）	BigDecimal	否
taxAmount	税额（元）	BigDecimal	否
noTaxAmount	不含税金额（元）	BigDecimal	否
invoiceCode	发票代码	String	否
invoiceNumber	发票号码	String	否
total	发票-总金额（元）	BigDecimal	否
tax	发票-税额（元）	BigDecimal	否
pretaxAmount	发票-税前金额（元）	BigDecimal	否
date	发票日期	String	否
checkCode	校验码	String	否
buyer	购买方名称	String	否
buyerTaxId	购买方纳税人识别号	String	否
seller	销售方名称	String	否
sellerTaxId	销售方纳税人识别号	String	否
validation	验真标识	Integer	否
invoiceImageUrl	发票图片地址	String	否
timeGetOn	上车时间	String	否
timeGetOff	下车时间	String	否
mileage	里程	String	否
province	省	String	否
city	市	String	否
time	乘车时间	String	否
name	乘车人姓名	String	否
stationGetOn	上车车站	String	否
stationGetOff	下车车站	String	否
trainNumber	车次	String	否
seat	座位	String	否
userName	乘机人姓名	String	否
userId	身份证号	String	否
number	电子客票号码	String	否
agentCode	销售单位代号	String	否
issueBy	填开单位	String	否
fare	票价（元）	BigDecimal	否
fuelSurCharge	燃油附加费（元）	BigDecimal	否
caacDevelopmentFund	民航发展基金（元）	BigDecimal	否
insurance	保险费（元）	BigDecimal	否
currencyCode	币种	String	否
taxRate	税率	String	否
buyerId	买方单位代码/个人身份证号	String	否
entrance	入口	String	否
exit	出口	String	否
serialNumber	序列号	String	否
kind	发票消费类型	String	否
category	种类	String	否
companyName	二手车市场	String	否
companyTaxId	二手车市场纳税人识别号	String	否
licensePlate	车牌号	String	否
registrationNumber	登记证号	String	否
carCode	车架号/车辆识别代码	String	否
carModel	厂牌型号	String	否
machineCode	机打代号	String	否
machineNumber	机打号码	String	否
taxAuthorities	主管税务机关	String	否
taxAuthoritiesCode	主管税务代码	String	否
carEngineCode	发动机号码	String	否
certificateNumber	合格证号	String	否
status	状态	Integer	否	0:草稿;1:发布
repeat	发票是否重复	Integer	否	0:不重复;1:重复;
taxPayerFlag	纳税人校验标识	Integer	否
items	增值税项目	TbQyReimInvoiceItemDTO[]	否
curLog	当前此次验真	TbQyReimInvoiceValidationLogDTO	否
validationLogs	增值税验真日志记录	TbQyReimInvoiceValidationLogDTO[]	否
code	验真状态码	String	否
flights	航班信息	TbQyReimInvoiceFlightDTO	否
isLock	是否需要锁定电子发票	Integer	否

TbQyReimInvoiceItemDTO类型说明：

参数名	释义	类型	是否必须
name	项目名称	String	否
amount	金额	BigDecimal	否
tax	税额	BigDecimal	否
taxRate	税率	String	否

TbQyReimInvoiceValidationLogDTO类型说明：

参数名	释义	类型	是否必须
validationCode	验真结果代码	String	否
validationMsg	验真信息	String	否
validationTime	验真时间	String	否

TbQyReimInvoiceFlightDTO类型说明：

参数名	释义	类型	是否必须
flightFrom	出发站	String	否
flightTo	到达站	String	否
flightNumber	航班号	String	否
date	乘机日期	String	否
time	乘机时间	String	否
seat	座位等级	String	否
carrier	承运人	String	否

企业微信

获取发票信息详情

开发说明