委外订单
14 个接口(读 4 / 写 10) · 其中 8 个高危 · 凭证范围:查询需 subcontract:read,写操作需 subcontract:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| POST | 新建委外订单(draft=true 保存草稿,宽松校验) | subcontract.orders.create | /v1/subcontract/orders/create |
| POST 高危 | 删除(逻辑删除,仅草稿/已驳回) | subcontract.orders.delete | /v1/subcontract/orders/delete |
| GET | 委外订单详情 | subcontract.orders.detail | /v1/subcontract/orders/detail |
| POST 高危 | BOM 展开发料计划(不落库) | subcontract.orders.expand-bom | /v1/subcontract/orders/expand-bom |
| POST | 分页查询委外订单 | subcontract.orders.page | /v1/subcontract/orders/page |
| POST 高危 | 反审核(必填 reason) | subcontract.orders.reverse-approval | /v1/subcontract/orders/reverse-approval |
| GET | 反审核预检(只读,返回阻断项与副作用) | subcontract.orders.reverse-precheck | /v1/subcontract/orders/reverse-precheck |
| POST 高危 | 审核通过/驳回(驳回必填 comment) | subcontract.orders.review | /v1/subcontract/orders/review |
| POST | 委外订单 KPI 统计 | subcontract.orders.stats | /v1/subcontract/orders/stats |
| POST 高危 | 提交审核,发起审批流 | subcontract.orders.submit | /v1/subcontract/orders/submit |
| POST 高危 | 状态推进:START_PROCESS 开始加工 / FINISH 确认完工 | subcontract.orders.transition | /v1/subcontract/orders/transition |
| POST | 更新委外订单(仅草稿/已驳回可编辑) | subcontract.orders.update | /v1/subcontract/orders/update |
| POST 高危 | 作废(必填 reason,数据仍可见可查) | subcontract.orders.void | /v1/subcontract/orders/void |
| POST 高危 | 撤回审批(待审核 → 草稿,仅流程发起人;reason 选填) | subcontract.orders.withdraw | /v1/subcontract/orders/withdraw |
调用协议(各页通用)
本实体接口统一通过 POST https://open.risemap.cn/v1/api/invoke 调用,用 apiCode 指定接口。
JSON 响应为统一信封 { code, message, data },文件接口成功时直接返回文件;
错误码见错误码说明;凭证获取与调用协议见开放接口清单。
示例中的鉴权头为 OAuth 访问令牌形态;AppKey 集成商换成 -H "X-App-Key: <appKey>" -H "X-App-Secret: <appSecret>" 即可,其余不变。
所有调用以绑定员工身份执行,员工须具备对应主站功能权限(默认按后端接口 URL 自动对照,个别接口单独标注权限码)。
本页由接口注册表与后端接口规格自动生成。