格物 开放 API福利 / 采购 · 企业与员工

REST API · 接入指南

员工福利购物 / 企业采购

企业与员工

一期正式接入面向给自己公司搭应用的企业：员工福利（类福利GO）或企业采购。终端用户用你自己的账号体系登录， 平台不替你建号——每个请求把你的用户 ID 放进 x-open-user。

  1. 1
    申请正式接入并录入企业

    在开发者控制台申请正式接入，选择你的用户是谁（员工福利购物 / 企业采购）， 填写企业名称、统一社会信用代码（同时作为开票税号）、营业执照与开票信息。

  2. 2
    平台审核

    审核通过后，平台为你的 appKey 开通接口权限，建好企业并开通企业购交易身份（开通前下单返回 ORG_EGP_NOT_READY）。 签名密钥（app_secret）在控制台自己生成，只显示一次。

  3. 3
    充值与付款方式

    企业与平台确认预充值或授信，额度进入企业额度池；企业承担比例（全额由企业额度支付，或企业承担一部分、员工自付其余）由平台按约定配置。

  4. 4
    绑定员工

    用 GET /v1/partner/orgs 查到你的企业，再调 PUT /v1/partner/orgs/{orgId}/members/{userId} 把你的用户绑成员工，至少绑一个 admin 来发放额度。一个用户同时只能属于一家企业。

角色下单、查自己额度、售后额度池、账单、发放额度
owner✓✓（不能直接停用或离职，需先交接）
admin✓✓
member✓✗

员工离职调 DELETE /v1/partner/orgs/{orgId}/members/{userId}：未用额度退回企业额度池，同时收回采购权限。

1# 审批通过后，平台已为你的 appKey 建好企业：查到 orgId2  GET /v1/partner/orgs3    → { "items": [{ "id": "org_…", "name": "杭州某某科技有限公司", "status": "active" }] }4 5  # 把你的用户绑成员工；路径里的 userId 就是你自己的用户 ID6  PUT /v1/partner/orgs/org_…/members/u-admin   { "name": "王经理", "role": "admin" }7  PUT /v1/partner/orgs/org_…/members/u-001     { "name": "张三", "role": "member" }

本篇用到的接口