委外退料单

12 个接口（读 4 / 写 8） · 其中 6 个高危 · 凭证范围：查询需 subcontract:read，写操作需 subcontract:write

	接口	编码	后端签名
POST 高危	仓库确认入库（唯一真正动库存的动作）	subcontract.returns.confirm-inbound	/v1/subcontract/returns/confirm-inbound
POST	创建委外退料单	subcontract.returns.create	/v1/subcontract/returns/create
POST 高危	删除（逻辑删除，仅草稿）	subcontract.returns.delete	/v1/subcontract/returns/delete
POST	委外退料单详情	subcontract.returns.detail	/v1/subcontract/returns/detail
POST	委外退料单列表辅助数据（状态计数/KPI/筛选项）	subcontract.returns.list-aux	/v1/subcontract/returns/list-aux
POST	分页查询委外退料单	subcontract.returns.page	/v1/subcontract/returns/page
POST 高危	可退材料列表（在外余量 > 0 的发料计划行）	subcontract.returns.returnable-materials	/v1/subcontract/returns/returnable-materials
GET	可退料订单下拉（分页）	subcontract.returns.returnable-orders	/v1/subcontract/returns/returnable-orders
POST 高危	反审核（仅待入库；已入库禁止）	subcontract.returns.reverse-approval	/v1/subcontract/returns/reverse-approval
POST 高危	提交（生成待入库单，不动库存）	subcontract.returns.submit	/v1/subcontract/returns/submit
POST	更新委外退料单	subcontract.returns.update	/v1/subcontract/returns/update
POST 高危	作废（草稿/待入库均可）	subcontract.returns.void	/v1/subcontract/returns/void

调用协议（各页通用）

本实体接口统一通过 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 自动对照，个别接口单独标注权限码）。

本页由接口注册表与后端接口规格自动生成。