资产单笔发放¶
功能说明¶
企业(或集团,需传enterprise_code)给企业员工发放资产
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/enterprise/assign/single
- 生产环境: https://openapi.guanaitong.com/enterprise/assign/single
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| userid | 是 | string | [1,100] | 员工第三方唯一标识,不会变更 |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,企业不填) |
| account_openid | 是 | string | [32] | 企业账户的openid,详见发放账户查询 |
| sub_limit_id | 否 | int | 仅使用于额度子账户发放 | |
| external_code | 是 | string | [10,30] | 外部发放号,必须以appid开头,支持数字+字母,不支持特殊字符 |
| amount | 是 | decimal(10,2) | [0.01,99999999.99] | 发放积分金额 |
| reason | 是 | string | [1,254] | 发放原因 |
| third_type | 否 | int | [1,5] | 1:企业微信, 2:钉钉,3:飞书,4, 定制, 5:标准对接,非必填默认5 |
| expire_time | 否 | string | [8-14] | 额度过期时间,格式为yyyyMMdd或yyyyMMddHHmmss ,如:20230807,20230807000000(注意积分发放是没有过期时间,只有额度存在过期时间) |
请求示例¶
POST /enterprise/assign/single HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=6007bf4c6efeb798da35b843e4614cff&amount=100&userid=CFX105&&reason=test&amount=100.01&third_type=5&account_openid=e33ee5c4db7c850dd12b9404edf0d0d8&external_code=2500165020220621980323&sign=dc2cb643d101d8ae96e857ff4ca24de23bf4f27f&
timestamp=1495094685
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回external_code代表发放成功 |