接口文档 / 商品接口

创建采购单

POST/api/v2/open-agency/products/purchase-orders在线调试

请求参数

名称	说明	类型
Body 参数
`orderType`可选	采购单类型 0:普通采购单 1:诊所收货采购单，默认1 示例：`1`	`integer`
`supplierId`必填	供应商ID 示例：`ffffffff0000000013186d180b520000`	`string`
`purchaseOrganId`可选	采购机构ID，未填时使用当前门店示例：`ffffffff0000000013186d180b520000`	`string`
`applicantId`可选	采购员工ID，可以不传，不传没有采购人示例：`ffffffff0000000013186d180b520000`	`string`
`comment`可选	单据备注，不能超过200个字符示例：`备注`	`string`
`purchaseOrderDate`可选	采购日期 yyyy-MM-dd 示例：`2026-12-01` 格式：date	`string`
`purchaseOrderItemList`必填	采购单明细	`array<object>`

请求示例

json

{
  "orderType": 1,
  "supplierId": "ffffffff0000000013186d180b520000",
  "purchaseOrganId": "ffffffff0000000013186d180b520000",
  "applicantId": "ffffffff0000000013186d180b520000",
  "comment": "备注",
  "purchaseOrderDate": "2026-12-01",
  "purchaseOrderItemList": [
    {
      "productId": "0021650c11444ed9ad05e07f3ccc5c1f",
      "shortId": 2481526,
      "unit": "盒[药品的单位10片/盒的片或盒]",
      "purchaseCount": 10,
      "totalCost": 50
    }
  ]
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`comment`可选	备注	`object`
`id`可选	采购单ID	`integer`
`orderNo`可选	采购单号示例：`CG2024110600001`	`string`
`purchaseOrderItemList`可选	采购单条目列表	`array<object>`
`status`可选	采购单状态,0:待审核 1:审核通过 9:审核驳回 31:撤回药店特有，60:待收货 62:待验收 64:待入库 66:已入库示例：`0`	`integer`
`supplierId`可选	供应商id 示例：`ffffffff0000000034af4ae82d69c000`	`string`
`orderType`可选	采购类型，0：线下集采，10：ABC商城采购示例：`0`	`integer`
`supplier`可选	供应商示例：`测试供应商`	`string`
`purchaseOrganName`可选	采购门店名称	`string`
`receiveOrganId`可选	收货机构id 示例：`ffffffff0000000034d6d4adbec04000`	`string`
`purchaseOrganId`可选	采购门店ID	`string`
`receiveOrganName`可选	收货机构示例：`abc`	`string`
`applyEmployeeId`可选	申请人ID	`string`
`applyEmployeeName`可选	申请人	`string`
`purchaseOrderDate`可选	采购日期示例：`2024-11-06 16:51:03` 格式：date-time	`string`
`created`可选	创建时间示例：`2024-11-06 16:51:03` 格式：date-time	`string`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "comment": {
      "time": "2026-01-01T00:00:00Z",
      "content": "string",
      "employeeId": "string",
      "employeeName": "string"
    },
    "id": 0,
    "orderNo": "CG2024110600001",
    "purchaseOrderItemList": [
      {
        "id": 123123,
        "productId": "ffffffff000000003473c049d7ab4000",
        "productShortId": "000251",
        "productName": "阿莫西林胶囊",
        "pieceCount": 0,
        "packageCount": "盒"
      }
    ],
    "status": 0,
    "supplierId": "ffffffff0000000034af4ae82d69c000",
    "orderType": 0,
    "supplier": "测试供应商",
    "purchaseOrganName": "string",
    "receiveOrganId": "ffffffff0000000034d6d4adbec04000",
    "purchaseOrganId": "string",
    "receiveOrganName": "abc",
    "applyEmployeeId": "string",
    "applyEmployeeName": "string",
    "purchaseOrderDate": "2024-11-06 16:51:03",
    "created": "2024-11-06 16:51:03"
  },
  "error": null
}

业务失败包装示意

json

{
  "data": null,
  "error": {
    "code": 11003,
    "message": "不支持的授权类型{grantType}"
  }
}

查看 HTTP 状态与业务码排查