美团企业版预算管控(新版)

背景

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

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

预算管控分为两类：

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

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

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

• 员工费用包预算充值
• 员工费用包预算查询

1.员工费用包预算充值

接口说明

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

公共参数

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

业务请求参数

名称	类型	是否必填	示例	说明
rechargeNo	String	是	"131124324"	充值流水号，限制在32个字符以内。根据该字段进行幂等判断，在接口调用超时时可以重试。
staffId	Long	是	12345	美团企业版系统的员工id
expenseNo	String	是	"15061804991676621011"	费用编号，需要先在美团企业版系统内创建对应费用档案获取编码（内测期间先联系对接人）。
rechargeType	String	是	0	0代表新增费用，1代表减少费用
rechargeAmount	String	是	"32"/"32.00"	充值金额，单位元，保留两位小数。当减少费用时，如果遇到余额小于调整金额的情况，员工预算额度会直接调整为0，不会出现负数。

业务响应

名称	类型	是否非空	示例	说明
status	int	是	0	0:接口调用成功,非0为异常代码
msg	String	否	"参数不合法"	status!=0时，为异常信息
data	充值业务响应消息体	否	{"operateId": 48260335,"message": "成功"}	status!=0时，为异常信息

充值业务响应消息体

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

示例

业务请求参数
{
  "method":"staff.budget.package.recharge",
  "ts":1512963578,
  "entId":1,
  "rechargeNo": "131124324",
  "staffId": 7113238,
  "expenseNo": "15061804991676621011",
  "rechargeType": 0,
  "rechargeAmount": "32"
}

业务响应

{
  "status": 0,
  "msg": null,
  "data": {
    "operateId": 48260335,
    "message": "成功"
  }
}

业务错误码

错误码	错误描述	解决方案
10150001	请输入员工ID	请检查staffId和staffIdentifier字段传值，二者必传其一
10150003	请传入合法的费用包ID	请检查expenseNo字段传参是否为空，且与客户经理提供的编码一致。费用ID查看位置：企业管理后台-费控中心-费用管理-详情
10151001	修改金额请输入正数	请检查rechargeAmount字段传参是否正确，只允许输入正数
10151002	未知的费用调整类型	请检查rechargeType字段传参是否正确，只允许传0或1
40151001	当前余额已超过上限，当前额度：XXX	用户当前余额已超过企业充值限额，不予充值。默认用户累计充值上限：100万元
40151002	充值已处理，充值时间：XXX	重复充值，请检查rechargeNo传参
40150004	单笔充值上限100000元，本次已超出	单笔充值上限10万元，请调整充值金额后重试

2.员工费用包预算查询

接口说明

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

公共参数

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

业务请求参数

名称	类型	是否必填	示例	说明
staffId	Long	是	12345	美团企业版系统的员工id
expenseNo	String	是	"15061804991676621011"	费用编号，需要先在美团企业版系统内创建对应费用档案获取编码（内测期间先联系对接人）。

业务响应

名称	类型	是否非空	示例	说明
status	int	是	0	0:接口调用成功,非0为异常代码
msg	String	否	"参数不合法"	status!=0时，为异常信息
data	查询消息体	否	{"balance": "100.00","message": "成功"}	status!=0时，为异常信息

查询消息体

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

示例

业务请求参数
{
  "method":"staff.budget.package.query",
  "ts":1512963578,
  "entId":1,
  "staffId": 7113238,
  "expenseNo": "15061804991676621011"
}

业务响应

{
  "status": 0,
  "msg": null,
  "data": {
    "balance": "100.00",
    "message": "成功"
  }
}