接口文档 / 商品接口

创建收货单

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

请求参数

名称	说明	类型
Body 参数
`erpOrderNo`可选	erp订单编号示例：`XHCX00000182466`	`string`
`erpOrderId`可选	erp订单id 示例：`CX00000182466`	`string`
`purchaseOrderId`可选	abc采购单id 示例：`100001697`	`string`
`claimOrderId`可选	abc要货单id 示例：`100001697`	`string`
`supplierId`必填	abc供应商id 示例：`ffffffff00000000349179dde6fd0000`	`string`
`receiveOrganId`必填	收货机构示例：`ffffffff0000000013186d180b520000`	`string`
`list`可选	收货单明细	`array<object>`
`sourceType`可选	收货单来源 100=采购收货单 120=配货收货单示例：`100`	`integer`

请求示例

json

{
  "erpOrderNo": "XHCX00000182466",
  "erpOrderId": "CX00000182466",
  "purchaseOrderId": 100001697,
  "claimOrderId": 100001697,
  "supplierId": "ffffffff00000000349179dde6fd0000",
  "receiveOrganId": "ffffffff0000000013186d180b520000",
  "list": [
    {
      "purchaseOrderItemId": 100002498,
      "claimOrderItemId": 100002498,
      "productId": "0021650c11444ed9ad05e07f3ccc5c1f",
      "shortId": 2481526,
      "batchNo": 202311008,
      "expiryDate": "2025-12-10",
      "productionDate": "2021-01-20",
      "totalPrice": 10,
      "packageCostPrice": 5,
      "receiveCount": 2,
      "unit": "盒",
      "erpProductData": {
        "erpProductId": "SPZ00015757",
        "name": "盐酸贝尼地平片",
        "manufacturer": "四川中庸药业有限公司",
        "medicineNmpn": "国药准字Z20043621",
        "displaySpec": "2ml*10支/盒"
      }
    }
  ],
  "sourceType": 100
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`可选	收货单id 示例：`3796368496350265300`	`integer`
`receiveOrderItemList`可选	收货单明细列表	`array<object>`
`orderNo`可选	收货单单号示例：`SH2024013000001`	`string`
`status`可选	收货单状态 10:待收货 20:已收货示例：`10`	`integer`
`kindCount`可选	收货品种数量示例：`5`	`integer`
`sum`可选	收货金额示例：`100`	`number`
`outOrderNo`可选	外部单号示例：`035040`	`string`
`receiveDate`可选	收货时间格式：date-time	`string`
`receiveOrganId`可选	收货机构id 示例：`ffffffff0000000034d6d4adbec04000`	`string`
`receiveOrganName`可选	收货机构示例：`abc`	`string`
`receiveEmployeeId`可选	收货人id 示例：`6e45706922a74966ab51e4ed1e604641`	`string`
`receiveEmployeeName`可选	收货人示例：`张三`	`string`
`supplier`可选	供应商示例：`测试供应商`	`string`
`supplierId`可选	供应商ID 示例：`ffffffff0000000034af4ae82d69c000`	`string`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": 3796368496350265300,
    "receiveOrderItemList": [
      {
        "id": 123456,
        "productId": "ffffffff0000000034966c3a883ec000",
        "productShortId": 1000001,
        "productName": "阿莫西林",
        "expiryDate": "2022-05-10",
        "productionDate": "2024-05-10",
        "batchNo": 20220526000001,
        "totalPrice": 10,
        "packageCostPrice": 5,
        "receiveCount": 2,
        "unit": "盒"
      }
    ],
    "orderNo": "SH2024013000001",
    "status": 10,
    "kindCount": 5,
    "sum": 100,
    "outOrderNo": "035040",
    "receiveDate": "2026-01-01T00:00:00Z",
    "receiveOrganId": "ffffffff0000000034d6d4adbec04000",
    "receiveOrganName": "abc",
    "receiveEmployeeId": "6e45706922a74966ab51e4ed1e604641",
    "receiveEmployeeName": "张三",
    "supplier": "测试供应商",
    "supplierId": "ffffffff0000000034af4ae82d69c000"
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查