# 企业结算账单
# 1.账单汇总查询
# 接口说明
| 名称 | 描述 |
|---|---|
| 功能 | 按交易时间查询企业账单汇总数据 |
| HTTP方法 | POST |
| 请求方 | 第三方平台 |
| 响应方 | 美团企业版平台 |
| uri | $API_HOST/entBill/querySum |
| method | ent.bill.sum.query |
# 公共参数
# 业务参数
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| startDate | String | 是 | 2021-01-01 | 开始日期, yyyy-MM-dd, 不支持查询当天数据 |
| endDate | String | 是 | 2021-01-01 | 结束日期, yyyy-MM-dd, 不支持查询当天数据 |
# 业务响应
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| entId | Long | 是 | 617 | 企业ID |
| payAmount | String | 是 | 0.00 | 支付总金额 |
| refundAmount | String | 是 | 0.00 | 退款总金额 |
| totalRealAmount | String | 是 | 0.00 | 实付总金额 |
| entPayAmount | String | 是 | 0.00 | 企业支付总金额 |
| entRefundAmount | String | 是 | 0.00 | 企业退款总金额 |
| staffPayAmount | String | 是 | 0.00 | 员工支付总金额 |
| staffRefundAmount | String | 是 | 0.00 | 员工退款总金额 |
# 示例结果
{
"status": 0,
"msg": null,
"data": {
"entId": 617,
"payAmount": 12345678.00,
"refundAmount": 78.00,
"totalRealAmount": 12345600.00,
"entPayAmount": 12345000.00,
"entRefundAmount": 78.00,
"staffPayAmount": 678.00,
"staffRefundAmount": 0.00
}
}
# 2.账单列表查询
# 接口说明
| 名称 | 描述 |
|---|---|
| 功能 | 按交易时间查询企业账单 |
| HTTP方法 | POST |
| 请求方 | 第三方平台 |
| 响应方 | 美团企业版平台 |
| uri | $API_HOST/entBill/queryList |
| method | ent.bill.list.query |
# 公共参数
# 业务参数
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| sqtTypes | List<Integer> | 否 | [1,2,3] | 美团企业版业务类型, 为空则查询全部。枚举见订单详情查询查询返回结果中OrderBaseInfo.sqtType |
| startDate | String | 是 | 2021-01-01 | 开始日期, yyyy-MM-dd, 不支持查询当天数据 |
| endDate | String | 是 | 2021-01-01 | 结束日期, yyyy-MM-dd, 不支持查询当天数据 |
| transactionTypes | List<Integer> | 否 | [1,2] | 交易类型, 1支付, 2退款 |
| sqtBizOrderId | String | 否 | 4320998765891001 | 美团企业版订单ID, 不为空则只查询该订单 |
| sqtOrderId | String | 否 | 719861351477424 | 美团企业版交易单号, 不为空则只查询该交易单 |
| invoiceTaxNum | String | 否 | 91310000785639590B | 发票税号（仅支持特定企业使用。如需接入，请先与对接接口人联系） |
| pageNo | int | 否 | 1 | 分页查询页码, 默认为1 |
| pageSize | int | 否 | 100 | 分页查询页大小, 最大为100（默认20） |
# 业务响应
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| pageNo | Integer | 是 | 1 | 页码 |
| pageSize | Integer | 是 | 20 | 页大小 |
| totalCount | Long | 是 | 1 | 查询结果总数量 |
| result | List<BillDetail> | 是 | 流水明细 |
BillDetail字段说明
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| entId | Long | 是 | 617 | 企业ID |
| staffId | Long | 是 | 157880 | 美团企业版员工ID |
| staffEntNum | String | 否 | 35520 | 员工工号(需要返回该字段值, 请先与对接接口人联系) |
| staffName | String | 是 | 李美团 | 美团企业版员工姓名 |
| billPeriod | String | 是 | 20210101-20210131 | 账期 |
| traceId | Long | 是 | 1399285103018323969 | 流水ID |
| traceTime | Long | 是 | 1609430400000 | 流水发生时间 |
| sqtBizOrderId | String | 是 | 1192105311642101 | 美团企业版订单ID |
| sqtOrderId | String | 是 | 719861351477424 | 美团企业版交易单号 |
| sqtType | Integer | 是 | 1 | 美团企业版业务类型 |
| transactionType | Integer | 是 | 1 | 交易类型： 1 支付 2 退款 16 随单收服务费支付 17 随单收服务费退款 |
| payType | Integer | 是 | 10 | 支付类型： 10 企业支付 20 员工支付 |
| transactionAmount | String | 是 | 0.00 | 交易金额 当transactionType=16时，该值对应随单收服务费支付金额; 当transactionType=17时，该值对应随单收服务费退款金额; |
| invoiceTaxNum | String | 否 | 91310000785639590B | 发票税号(需要返回该字段值, 请先与对接接口人联系) |
| invoiceTitle | String | 否 | 美团 | 发票抬头(需要返回该字段值, 请先与对接接口人联系) |
| realtimeServicePayAmount | String | 否 | 1.00 | 随单收服务费支付金额(需要返回该字段值, 请先与对接接口人联系) |
| realtimeServiceRefundAmount | String | 否 | 1.00 | 随单收服务费退款金额(需要返回该字段值, 请先与对接接口人联系) |
# 示例结果
{
"status": 0,
"msg": null,
"data": {
"pageNo": 1,
"pageSize": 20,
"totalCount": 1,
"result": [
{
"billPeriod": "20210101-20210131",
"traceId": 1399285103018323969,
"traceTime": 1609430400000,
"sqtBizOrderId": "1192105311642101",
"sqtOrderId": "719861351477424",
"sqtType": 12,
"transactionType": 1,
"transactionAmount": "750.0",
"payType": 10,
"entId": 617,
"staffId": 157800,
"staffName": "李美团",
"staffEntNum": 35520,
"invoiceTaxNum": "91310000785639590B",
"invoiceTitle": "美团"
}
]
}
}
# 3.偿还流水查询
# 接口说明
| 名称 | 描述 |
|---|---|
| 功能 | 按交易时间查询企业的个人偿还流水明细 |
| HTTP方法 | POST |
| 请求方 | 第三方平台 |
| 响应方 | 美团企业版平台 |
| uri | $API_HOST/entBill/query/repayFlow |
| method | ent.bill.repay.flow.query |
# 公共参数
# 业务参数
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| sqtTypes | List<Integer> | 否 | [1,2,3] | 美团企业版业务类型, 为空则查询全部。枚举见订单详情查询查询返回结果中OrderBaseInfo.sqtType |
| startDate | String | 是 | 2021-01-01 | 开始日期, yyyy-MM-dd, 不支持查询当天数据 |
| endDate | String | 是 | 2021-01-01 | 结束日期, yyyy-MM-dd, 不支持查询当天数据 |
| sqtBizOrderId | String | 否 | 4320998765891001 | 美团企业版订单ID, 不为空则只查询该订单 |
| pageNo | int | 否 | 1 | 分页查询页码, 默认为1 |
| pageSize | int | 否 | 100 | 分页查询页大小, 最大为100（默认20） |
# 业务响应
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| pageNo | Integer | 是 | 1 | 页码 |
| pageSize | Integer | 是 | 20 | 页大小 |
| totalCount | Long | 是 | 1 | 查询结果总数量 |
| result | List<RepayFlow> | 是 | 流水明细 |
RepayFlow字段说明
| 名称 | 类型 | 是否非空 | 示例 | 说明 |
|---|---|---|---|---|
| entId | Long | 是 | 617 | 企业ID |
| staffId | Long | 是 | 157880 | 美团企业版员工ID |
| staffEntNum | String | 是 | 35520 | 员工工号 |
| staffName | String | 是 | 李美团 | 美团企业版员工姓名 |
| billPeriod | String | 是 | 20210101-20210131 | 账期 |
| flowId | Long | 是 | 1399285103018323969 | 流水ID |
| flowTime | Long | 是 | 1609430400000 | 流水发生时间 |
| repayOrderTime | Long | 是 | 1609430400000 | 偿还时间 |
| sqtBizOrderId | String | 是 | 1192105311642101 | 美团企业版订单ID |
| sqtType | Integer | 是 | 1 | 美团企业版业务类型 |
| transactionType | Integer | 是 | 1 | 交易类型： 3 支付 4 退款 |
| transactionAmount | String | 是 | 0.00 | 交易金额, 退款则为负数 |
| invoiceTaxNum | String | 是 | 91310000785639590B | 发票税号 |
| invoiceTitle | String | 是 | 美团 | 发票抬头 |
# 示例结果
{
"status": 0,
"message": null,
"data": {
"pageNum": 1,
"pageSize": 20,
"totalCount": 1,
"result": [
{
"entId": 12345,
"staffId": 5678901234,
"staffEntNum": "MEITUANLI",
"staffName": "李美团",
"billPeriod": "20220401-20220430",
"flowId": "6518433666135964666",
"flowTime": 1651225982000,
"repayOrderTime": 1646882196000,
"sqtBizOrderId": "1133624262300811265",
"sqtType": 3,
"transactionType": 4,
"transactionAmount": "-0.20",
"invoiceTaxNum": "6",
"invoiceTitle": "抬头666"
}
],
"totalPages": 1,
"pageNo": 1
}
}
← 标准三方对接 飞机票首趟航班报价查询 →