企业发票查询
1 发票列表接口
1.1 接入说明
企业使用美团企业版报销，发票需要从企业侧查询并关联
1.2 接口说明
| 名称 | 描述 |
|---|
| 功能 | 查询企业员工发票列表 |
| HTTP方法 | POST |
| 请求方 | 美团企业版平台 |
| 响应方 | 第三方平台 |
| url | 第三方提供 |
| method | expense.invoice.folder.list.query |
1.3 公共参数
详见：公共参数说明-公共请求参数
1.4 业务请求参数
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| invoiceNo | String | 否 | 发票号码 | 39955919 |
| sellerName | String | 否 | 销方名称，需支持模糊搜索 | 北京喆喆餐饮管理有限公司 |
| staffIdentifier | String | 是 | 员工唯一识别号 | 02781 |
| pageNum | Integer | 是 | 页数 | 1 |
| pageSize | Integer | 是 | 每页数量 | 20 |
1.5 业务响应
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| status | Integer | 是 | 0: 调用成功；其他：失败 |
| msg | String | 是 | 失败原因描述 |
| data | Object | 是 | 发票数据，JSON格式 |
data定义
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| totalCount | Long | 是 | 数据总数 |
| pageNum | Integer | 是 | 当前页码 |
| pageSize | Integer | 是 | 每页数量 |
| totalPage | Integer | 是 | 总页数 |
| list | List<OuterInvoiceFolderInfo定义> | 是 | 发票信息 |
OuterInvoiceFolderInfo
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| cardId | String | 是 | 发票唯一标识 | |
| invoiceCode | String | 否 | 发票代码 | 11002100711 |
| invoiceNo | String | 是 | 发票号码 | 39955919 |
| billingTime | Long | 是 | 开票日期，统一为13位时间戳，毫秒 | 1645372800000 |
| invoiceType | Integer | 是 | 发票类型 | 1 |
| feeWithoutTax | String | 否 | 税前金额，单位元，2位小数 | 33.96 |
| fee | String | 是 | 价税合计金额，单位元，2位小数 | 36 |
| taxFee | String | 否 | 税额，单位元，2位小数 | 2.04 |
| checkCode | String | 否 | 校验码 | 70919230240411737419 |
| buyerName | String | 否 | 购方名称 | 北京三快在线科技有限公司 |
| buyerNumber | String | 否 | 购方税号 | 91110108562144110X |
| sellerNumber | String | 否 | 销方税号 | |
| sellerName | String | 否 | 销方名称 | |
| invoiceUrl | String | 是 | 发票文件地址 | |
| fileName | String | 是 | 发票文件名称，需要包含文件后缀 | 011002100611_21915169_北京三快在线科技有限公司.pdf |
| checkStatus | Integer | 是 | 发票验真状态 | |
| recognizeStatus | Integer | 是 | 发票识别状态 | |
| hasTax | Integer | 是 | 是否有税额，0.无税额，1.有税额 | |
2 发票明细接口
2.1 接入说明
2.2 接口说明
| 名称 | 描述 |
|---|
| 功能 | 查询企业员工发票列表 |
| HTTP方法 | POST |
| 请求方 | 美团企业版平台 |
| 响应方 | 第三方平台 |
| url | 第三方提供 |
| method | expense.invoice.detail.query |
2.3 公共参数
详见：公共参数说明-公共请求参数
2.4 业务请求参数
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| cardIds | String | 是 | 发票唯一标识，多值英文逗号分割 | 100000,100001 |
| staffIdentifier | String | 是 | 员工唯一识别号 | 02781 |
2.5 业务响应
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| status | Integer | 是 | 0: 调用成功；其他：失败 |
| msg | Stringr | 是 | 失败原因描述 |
| data | Object | 是 | 发票数据 |
data定义
OuterInvoiceInfo
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| cardId | String | 是 | 发票唯一标识 | |
| invoiceCode | String | 否 | 发票代码 | 11002100711 |
| invoiceNo | String | 是 | 发票号码 | 39955919 |
| invoiceTitle | String | 否 | 发票的抬头 | 北京增值税电子普通发票 |
| billingTime | Long | 是 | 开票日期，统一为13位时间戳，毫秒 | 1645372800000 |
| invoiceType | Integer | 是 | 发票类型 | |
| feeWithoutTax | String | 否 | 税前金额 | 33.96 |
| fee | String | 是 | 价税合计金额 | 36 |
| taxFee | String | 否 | 税额 | 2.04 |
| checkCode | String | 否 | 校验码 | 70919230240411737419 |
| buyerName | String | 是 | 购方名称 | 北京三快在线科技有限公司 |
| buyerNumber | String | 否 | 购方税号 | 91110108562144110X |
| buyerAddressAndPhone | String | 否 | 购方地址电话 | |
| buyerBankAccount | String | 否 | 购方开户行账号 | |
| sellerNumber | String | 否 | 销方税号 | |
| sellerName | String | 否 | 销方名称 | |
| sellerAddressAndPhone | String | 否 | 销方地址电话 | |
| sellerBankAccount | String | 否 | 销方开户行账号 | |
| invoiceUrl | String | 是 | 发票文件地址 | |
| fileName | String | 是 | 发票文件名称，需要包含文件后缀 | 011002100611_21915169_北京三快在线科技有限公司.pdf |
| agentCode | String | 否 | 销售单位代号 | |
| drawer | String | 否 | 开票人/乘车人/乘机人 | 王淑芬 |
| machineCode | String | 否 | 机器编号 | |
| invoiceCiphertext | String | 否 | 发票密文 | |
| receiver | String | 否 | 收款人 | |
| reviewer | String | 否 | 复核人 | |
| checkStatus | Integer | 是 | 发票验真状态 | |
| recognizeStatus | Integer | 是 | 发票识别状态 | |
| hasTax | Integer | 是 | 是否有税额，0.无税额，1.有税额 | |
| invoiceDetailList | List<OuterInvoiceDetail> | 否 | 发票明细 | |
| fuelSurcharge | String | 否 | （机票）燃油附加费 | 0.0 |
| printNumber | String | 否 | （机票）印刷序号 | 31088796351 |
| civilAviationFund | String | 否 | （机票）民航发展基金 | 100 |
| flightList | List<OuterFlightDetail> | 否 | 航班信息 | |
| trainSeat | String | 否 | （火车票）座位等级 | 二等座 |
| trainNumber | String | 否 | （火车票）车次号 | G1855 |
| serialNum | String | 否 | （火车票）序列号 | 16295300741228A039698 |
| time | String | 否 | （火车票）出发时间 | 16:58 |
| carNo | String | 否 | （出租车）车牌号 | AF07305 |
| leaveTime | String | 否 | （出租车）出发时间 | 18:54 |
| arriveTime | String | 否 | （出租车）到达时间 | 19:23 |
| mileage | String | 否 | （出租车）里程（单位：公里） | 6.69 |
| leaveStation | String | 否 | （客运汽车票、火车票、客运船票）出发城市/发车城市/出发站 | 济宁北站 |
| arriveStation | String | 否 | （客运汽车票、火车票、客运船票）到达城市/到达站 | 曲阜高铁 |
| entrance | String | 否 | （过路费发票）入口 | 滨海新区 |
| roadExit | String | 否 | （过路费发票）出口 | 滨海新区 |
OuterInvoiceDetail
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| name | String | 是 | 商品/货物/服务/项目名称 | 餐饮服务餐饮服务" |
| specificationModel | String | 否 | 规格型号 | 盒 |
| unit | String | 否 | 单位 | 份 |
| quantity | String | 否 | 数量 | 1 |
| unitPrice | String | 否 | 单价，单位：元 | 33.96 |
| fee | String | 是 | 金额，单位：元 | 33.96 |
| taxRate | String | 否 | 税率 | 6% |
| taxFee | String | 否 | 税额，单位：元 | 2.04 |
OuterFlightDetail
| 名称 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| fromStation | String | 是 | 出发站 | 延吉/YNJ |
| toStation | String | 是 | 到达站 | 北京大兴/PKX |
| flightNo | String | 是 | 航班号 | 6151 |
| travelDate | String | 是 | 乘机日期 | 2020-12-31 |
| travelTime | String | 是 | 乘机时间 | 7:50 |
| seatLevel | String | 否 | 座位等级 | S |
| carrier | String | 否 | 承运人 | CZ |
3 数据字典
3.1 发票类型InvoiceTypeEnum
| 发票类型 | 发票类型名称 |
|---|
| 1 | 增值税普通发票 |
| 2 | 增值税电子普通发票 |
| 7 | 增值税普通发票（卷票） |
| 6 | 增值税电子专用发票 |
| 3 | 增值税专用发票 |
| 8 | 火车票 |
| 9 | 机票 |
| 10 | 出租车 |
| 11 | 客运汽车票 |
| 5 | 定额发票 |
| 12 | 机打发票 |
| 13 | 过路费发票 |
| 14 | 客运船票 |
| 4 | 区块链电子发票 |
| 15 | 火车票退票费 |
| 16 | 其他票据（票据缴款书） |
3.2 发票识别状态
| 识别状态 | 识别状态名称 |
|---|
| 0 | 待识别 |
| 1 | 识别成功 |
| 2 | 识别失败 |
3.3 发票验真状态
| 验真状态 | 验真状态名称 |
|---|
| 0 | 无需验真 |
| 1 | 待验真 |
| 2 | 验真成功 |
| 3 | 验真失败 |