委外发料单
17 个接口(读 8 / 写 9) · 其中 8 个高危 · 凭证范围:查询需 subcontract:read,写操作需 subcontract:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| POST | 新建发料单(draft=true 保存草稿) | subcontract.issues.create | /v1/subcontract/issues/create |
| POST 高危 | 删除(逻辑删除,仅草稿/已驳回) | subcontract.issues.delete | /v1/subcontract/issues/delete |
| GET | 委外发料单详情 | subcontract.issues.detail | /v1/subcontract/issues/detail |
| POST 高危 | 补建委外出库单(幂等) | subcontract.issues.ensure-outbound | /v1/subcontract/issues/ensure-outbound |
| GET | 可发料订单下拉(分页) | subcontract.issues.issuable-orders | /v1/subcontract/issues/issuable-orders |
| POST | 委外发料单列表辅助数据(状态计数/KPI/筛选项) | subcontract.issues.list-aux | /v1/subcontract/issues/list-aux |
| GET | 按订单带出可发料明细(含剩余可发量) | subcontract.issues.order-materials | /v1/subcontract/issues/order-materials |
| POST | 分页查询委外发料单 | subcontract.issues.page | /v1/subcontract/issues/page |
| POST 高危 | 反审核(仅待发料,释放锁仓并回退草稿) | subcontract.issues.reverse-approval | /v1/subcontract/issues/reverse-approval |
| POST 高危 | 审核通过/驳回(通过时自动锁仓) | subcontract.issues.review | /v1/subcontract/issues/review |
| POST 高危 | 查发料单当前锁仓记录 | subcontract.issues.stock-lock | /v1/subcontract/issues/stock-lock |
| POST | 批量查物料可发仓库与可用量(新建发料单选仓用) | subcontract.issues.stock-options | /v1/subcontract/issues/stock-options |
| POST 高危 | 提交审核 | subcontract.issues.submit | /v1/subcontract/issues/submit |
| GET | 可作超耗补料来源的回厂单(已入库且有超耗) | subcontract.issues.supplement-sources | /v1/subcontract/issues/supplement-sources |
| POST | 更新发料单(仅草稿/已驳回) | subcontract.issues.update | /v1/subcontract/issues/update |
| POST 高危 | 作废(释放锁仓) | subcontract.issues.void | /v1/subcontract/issues/void |
| POST 高危 | 撤回审批(待审核 → 草稿,仅流程发起人;reason 选填) | subcontract.issues.withdraw | /v1/subcontract/issues/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 自动对照,个别接口单独标注权限码)。
本页由接口注册表与后端接口规格自动生成。