企业报销传账

本文档主要针对同时使用美团企业版系统的差旅申请、差旅预订、差旅报销业务的企业客户，包含两个接口：

1. 账务数据推送接口：员工报销单支付完成时，美团企业版主动将报销单账务数据推送给企业系统。
2. 传账结果回调接口：企业异步处理接收到的账务数据，处理完成后，回调美团企业版接口通知入账结果。若入账失败，美团企业版会重算入账数据，再次传账。

1 账务数据推送

1.1 接入说明

流程如下

1. 在美团企业版系统中，完成差旅申请、差旅预订业务。
2. 企业员工，使用美团企业版报销系统进行差旅报销。
3. 报销单到达已完成节点，即支付完成时，

1.2 接口说明

名称	描述
功能	美团企业版主动向企业推送报销单账务数据
HTTP方法	POST
请求方	美团企业版平台
响应方	第三方平台
url	第三方提供
method	expense.account.push

1.3 公共参数

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

1.4 业务请求参数

名称	类型	是否非空	说明
data	Object	是	推送数据实体根据企业需求定制化开发

1.5 业务响应

名称	类型	说明
status	Integer	0: 调用成功 其他值均为: 调用失败。返回失败，会触发推送重试。
msg	String	失败时的错误描述
data	String	额外数据，无具体含义

1.6 示例结果

{
    "status": 0,
    "msg": "success",
    "data": {}
}

{
    "status": 1,
    "msg": "参数校验失败",
    "data": {}
}

2 传账结果回调

2.1 接入说明

流程如下

1. 企业系统，接收到美团企业版推送的账务数据，接收成功即返回成功信息。
2. 企业系统，异步处理成功接收的账务数据，并尝试入账。
3. 入账操作完成后，回调美团企业版接口，返回入账结果。

2.2 接口说明

名称	描述
功能	传账结果回调接口
HTTP方法	POST
请求方	第三方渠道
响应方	美团企业版平台
uri	/expense/accountCallback
method	expense.account.callback

2.3 公共参数

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

2.4 业务请求参数

名称	类型	是否非空	说明
entId	Long	是	外部企业ID
expenseNo	String	是	入账报销单号
entryStatus	Integer	是	入账状态。1：成功，2：失败。
bookkeepingTime	Long	否	记账日期（入账成功日期）, 13位时间戳
proofGenerationTime	Long	否	凭证生成日期, 13位时间戳
failReason	String	否	失败原因，传账状态为失败时必填

2.5 业务响应

名称	类型	是否非空	说明
status	Integer	是	请求响应码
msg	String	是	请求响应信息
data	String	是	请求响应数据，内部是Json格式数据

Json格式数据说明

名称	类型	是否非空	说明
accountNo	String	是	入账报销单号
result	Integer	是	回调处理结果编码
msg	String	是	回调处理结果描述

2.6 示例

业务请求参数
{
  "method":"expense.account.callback",
  "ts":1512963578,
  "entId":100252,
    "expenseNo":"T210510001004",
    "entryStatus":2,
    "bookkeepingTime":null,
    "proofGenerationTime":null,
    "failReason":"基本参数校验失败"
}


业务响应
{
    "msg":"处理成功!",
    "data":{
        "accountNo":"T210510001004",
        "result":200,
        "msg":"处理成功!"
    },
    "status":0
}