格物 开放 API员工福利 · 福豆任务、签到与生日
REST API · 接入指南
员工福利购物
福豆任务、签到与生日
员工福利应用特有的激励玩法，全部可选，不接不影响下单主流程；企业采购不开放这些接口。
- 福豆任务：管理员用
POST /v1/enterprise/org/tasks发布。奖励型（settleMode: "reward"） 员工完成后得额度，发布时从企业额度池冻结预算，结束后未用完的退回；兑换型（consume）员工用额度兑福利，可要求线下核销。 员工侧用/v1/enterprise/tasks报名、提交、兑换，管理员用task-reviews审核、task-redemptions核销。 - 每日签到：企业在
PATCH /v1/enterprise/org/points-settings开启并设奖励规则，员工每个工作日调POST /v1/enterprise/points/checkin领取。 - 生日福利：生日用「修改员工资料」登记，
GET /v1/enterprise/org/birthdays查近期过生日的员工，再用POST /v1/enterprise/org/points发放。
1# 发布前试算：预计最高支出与额度池余额2 GET /v1/enterprise/org/tasks/budget-preview3 x-open-user: u-admin4 5 # 奖励型：员工完成后各得 2000（20 元），限 50 人；同一事务里从额度池冻结预算6 POST /v1/enterprise/org/tasks7 x-open-user: u-admin8 { "title": "安全知识学习", "coverUrl": "https://…/cover.png",9 "settleMode": "reward", "points": 2000, "quota": 50,10 "completeMode": "submit", "submitSchema": [ … ],11 "endAt": "2026-11-30T23:59:59+08:00",12 "idempotencyKey": "task-20261021-01" }