6.8 创建资金发放计划

接口URL

{开放平台域名地址}/openApi/open/care/createCarePlan

注： 1、相比较6.5资金直接充值到员工账户，客户存在自己的员工福利积分发放系统，需要与东福实现系统对接完成自动发放，且存在福利场景管理、发放数据管理等需求，可以采用该对接方式
2、从企业账户扣钱，通过祝福方式充值到员工账户，企业账户Id由东福方提供，是一个Long类型的数字

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
access_token	String	是	授权访问凭证
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
batchNo	String	是	发放批次号，保证幂等性
noticeWays	List	否	通知方式，1-短信,2-邮件,4-push通知（百福得app）,5-弹窗,6-企微,7-钉钉,8-飞书,9-api对接。不传默认为 不通知
pageNo	Integer	是	当前页码，从1开始
lastPage	boolean	是	是否是最后一页，最后一页传true
sendDetails	CustomerApiCreateCareRequestDetailDTO	是	发放明细。最多500条
CustomerApiCreateCareRequestDetailDTO：

字段	类型	是否必填	中文意描述
sceneName	String	是	场景名称。注：同一批次的数据，需传同一个场景，否则东福会按照场景进行数据拆分合并处理
careName	String	是	祝福名称。注：同一批次的数据，需传同一个祝福名称，否则东福会按照祝福名称进行数据拆分合并处理
account	String	是	用户账号
count	BigDecimal	是	发放数量（发放福豆数量，最多两位小数）
accountType	Integer	是	资金类型：1-福豆；3-激励币。注：资金类型需要和东福提供的账户绑定，不同资金类型只能使用对应的账户去发放
companyAccountId	Long	是	发放账户ID。注：同一批次的数据，需传同一个发放账户，否则东福会按照账户进行数据拆分合并处理

请求示例

POST /openApi/open/care/createCarePlan?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
    "batchNo": "20251223161000020",
    "pageNo": 1,
    "lastPage": true,
    "noticeWays": [],
    "sendDetails": [
        {
            "sceneCode": "FESTVAL",
            "careName": "祝福API测试1223",
            "accountType": 1,
            "companyAccountId": 2509011300005792,
            "account": "xxl02",
            "count": 5
        },
        {
            "sceneCode": "FESTVAL",
            "careName": "祝福API测试1223",
            "accountType": 1,
            "companyAccountId": 2509011300005792,
            "account": "zf002",
            "count": 10.5
        }
    ]
}

返回参数说明

字段	类型	中文意描述
code	String	返回码 注: 0: 处理成功 -1: 处理失败，本批次需从第一页重新开始 10011: 接口超限，请重试此次请求
data	Boolean	相应报文
msg	String	如果错误，返回错误信息

返回示例

success:

{
  "code": "0",
  "data": true,
  "msg": "success"
}

fail:

{
  "code": "10016",
  "data": null,
  "msg": "签名错误"
}