下载中心/接口清单

接口清单

下载原文件

订单履约与交付看板 · 接口清单

约定:统一走站点数据访问层;错误返回 { code, message };所有写接口需带身份标识。

1. 订单

创建订单

POST /order

{
  "source": "rfq|sample|quote|material",
  "rfqId": "string|null",
  "sampleId": "string|null",
  "quoteId": "string|null",
  "supplierId": "string",
  "orderType": "pcb|sample|material|test",
  "totalAmount": 12800,
  "currency": "CNY",
  "promiseLeadDays": 7,
  "remark": "string"
}

返回 { id, orderSn, status: "submitted" }

列表

GET /order?role=buyer|supplier&status=&keyword=&page=1&pageSize=20 → { list, total }

详情

GET /order/{id} → { order, lots, processes, ships, checkbill, sla }

状态流转

POST /order/{id}/status

{ "to": "scheduled|in_production|testing|ready_to_ship|shipped|received|reconciling|completed|on_hold|rework|cancelled", "note": "string" }

约束:首件未通过时 first_article → in_production 返回 ORDER_FIRST_ARTICLE_PENDING。

导出

GET /order/{id}/export → 订单明细(含工艺要求、批次、交期)。

2. 批次 Lot

POST /order/{id}/lot → { lotNo, qtyTotal } GET /order/{id}/lot → Lot[] POST /order/lot/{lotId}/close → { qtyGood, qtyDefect, note }

3. 排产

GET /order/schedule/calendar?supplierId=&from=&to= → 设备/班组占用 POST /order/schedule/{lotId} → { equipment, team, startDate, endDate, priority }

4. 工序报工

POST /order/lot/{lotId}/process

{
  "processCode": "inner_layer|lamination|outer_layer|solder_mask|surface_finish|drilling|profile|flying_probe|aoi|final_check|packing|engineering",
  "operator": "string",
  "startAt": "2026-11-15 08:00",
  "finishAt": "2026-11-15 12:00",
  "qtyIn": 500,
  "qtyDefect": 3,
  "inspection": "pass|fail|conditional",
  "note": "string",
  "picUrls": ["string"]
}

错误码:ORDER_PROCESS_ORDER_INVALID、ORDER_QTY_INVALID、ORDER_LOT_LOCKED。

GET /order/lot/{lotId}/process → 工序时间线

5. 首件

POST /order/lot/{lotId}/first-article → { images: [], dimReport: "string", impedanceReport: "string" } POST /order/lot/{lotId}/first-article/confirm → { result: "pass|reject", reason: "string" } 错误码:ORDER_FA_REASON_REQUIRED

6. 发货与物流

POST /order/{id}/ship → { lotId, carrier, trackingNo, qty, shipAt } POST /order/ship/{shipId}/receive → { receiveAt, inspection: "pass|fail", note }

7. 对账

POST /order/{id}/checkbill → { items: [{ lotNo, qty, unitPrice, deduction, reason }], total } GET /order/{id}/checkbill → 对账明细与扣款依据

8. 预警

GET /order/warn?supplierId=&level= → [{ orderId, lotNo, slaExpireAt, hoursLeft, reason }]

9. 边界

  • 不含支付、退款、分账接口;结算状态仅记录。
  • 不含承运商轨迹订阅接口;物流轨迹以人工录入节点呈现。
  • 附件走对象存储,未开通时仅保存文件名。