# 企业结算账单
# 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
}
}
← 标准三方对接 飞机票首趟航班报价查询 →