采购退货
21 个接口（读 9 / 写 12） · 其中 6 个高危 · 凭证范围：查询需 srm:read，写操作需 srm:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| GET | 查询可退货的采购订单 | srm.purchase-retreat.available-purchases | /v1/purchase-retreat/available-purchases |
| POST 高危 | 批量删除采购退货单 | srm.purchase-retreat.batch-delete | /v1/purchase-retreat/batch-delete |
| POST | 触发采购退货多维表格全量同步 | srm.purchase-retreat.bitable.sync-all | /v1/purchase-retreat/bitable/sync-all |
| POST | 触发采购退货多维表格筛选同步 | srm.purchase-retreat.bitable.sync-filtered | /v1/purchase-retreat/bitable/sync-filtered |
| POST | 查询采购退货多维表格同步状态 | srm.purchase-retreat.bitable.sync-status | /v1/purchase-retreat/bitable/sync-status |
| POST 高危 | 取消采购退货 | srm.purchase-retreat.cancel | /v1/purchase-retreat/cancel |
| POST | 创建采购退货 | srm.purchase-retreat.create | /v1/purchase-retreat/create |
| POST 高危 | 删除采购退货 | srm.purchase-retreat.delete | /v1/purchase-retreat/delete |
| GET | 采购退货详情 | srm.purchase-retreat.detail | /v1/purchase-retreat/detail |
| POST | 从采购退货来源分批建单出库 | srm.purchase-retreat.outbound.create | /v1/purchase-retreat/outbound/create |
| POST 高危 | 分页查询采购退货待出库来源 | srm.purchase-retreat.outbound.pending-page | /v1/purchase-retreat/outbound/pending-page |
| GET | 查询退货来源出库进度（按商品行） | srm.purchase-retreat.outbound.progress | /v1/purchase-retreat/outbound/progress |
| POST | 采购退货分页查询 | srm.purchase-retreat.page | /v1/purchase-retreat/page |
| POST | 登记供应商补货到货 | srm.purchase-retreat.replacement.arrival.register | /v1/purchase-retreat/replacement/arrival/register |
| GET | 查询换货单到货批次（含明细行） | srm.purchase-retreat.replacement.arrivals | /v1/purchase-retreat/replacement/arrivals |
| GET | 建议换货补货入库默认仓库（取关联采购订单已产生入库单的仓库） | srm.purchase-retreat.replacement.default-store | /v1/purchase-retreat/replacement/default-store |
| POST | 登记换货补货检验入库 | srm.purchase-retreat.replacement.inspection.register | /v1/purchase-retreat/replacement/inspection/register |
| GET | 查询换货单独立剩余额度（按物料行） | srm.purchase-retreat.replacement.quota | /v1/purchase-retreat/replacement/quota |
| POST 高危 | 仓库确认退回实物（换货补货：待仓库确认→待退货出库） | srm.purchase-retreat.replacement.warehouse-confirm | /v1/purchase-retreat/replacement/warehouse-confirm |
| POST 高危 | 提交采购退货审批 | srm.purchase-retreat.submit | /v1/purchase-retreat/submit |
| POST | 更新采购退货 | srm.purchase-retreat.update | /v1/purchase-retreat/update |
调用协议（各页通用）
本实体接口统一通过 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 自动对照，个别接口单独标注权限码）。
本页由接口注册表与后端接口规格自动生成。