# 美团企业版预算中心(老版)

# 背景

美团企业版支持在企业员工因公消费时进行预算管控:

  • 预算充足,则允许使用企业支付
  • 预算不足,则走个人支付或组合支付或不允许支付(取决于企业配置)

预算管控分为两类:

  • 使用美团企业版预算中心进行预算配置
  • 使用企业内部预算系统进行预算配置

如果使用美团企业版预算中心,可以在美团企业版企业端或通过调用接口进行员工预算充值。

美团企业版预算中心对外提供的接口:

  • 员工预算充值
  • 员工预算查询

# 1.员工预算充值

# 接口说明

名称 描述
功能 给员工预算进行充值
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/staffBudgetRecharge
method trade.budget.staff.recharge

# 公共参数

详见:公共参数说明-公共请求参数

# 业务请求参数

名称 类型 是否必填 示例 说明
rechargeNo String "131124324" 充值流水号,限制在32个字符以内。根据该字段进行幂等判断,在接口调用超时时可以重试。
staffId Long 12345 美团企业版系统的员工id
rechargeAmount String "32"/"32.00" 充值金额,单位元,保留两位小数。

# 业务响应

名称 类型 是否非空 示例 说明
operateId Long 554823226873750 充值操作流水号,充值成功时返回。充值幂等时返回相同的充值操作流水号。
message String "成功"/"参数非法" 描述信息

# 示例

业务请求参数
{
  "method":"trade.budget.staff.recharge",
  "ts":1512963578,
  "entId":1,
  "rechargeNo" : "131124324",
	"staffId" : 12345,
	"rechargeAmount" : "32"
}

业务响应

{
	"operateId" : 554823226873750,
	"message" : "成功"
}

# 2.员工预算查询

# 接口说明

名称 描述
功能 查询员工预算余额
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/staffBudgetQuery
method trade.budget.staff.query

# 公共参数

详见:公共参数说明-公共请求参数

# 业务请求参数

名称 类型 是否必填 示例 说明
staffId Long 12345 美团企业版系统的员工id

# 业务响应

名称 类型 是否非空 示例 说明
balance String "32"/"32.00" 员工预算余额,单位元,保留两位小数。
desc String "成功"/"参数非法" 描述信息

# 示例

业务请求参数
{
  "method":"trade.budget.staff.query",
  "ts":1512963578,
  "entId":1,
  "staffId" : 12345
}

业务响应

{
	"balance" : "32",
	"message" : "成功"
}

上次更新: 4/22/2024, 4:15:08 PM