# 采购单创建

**Webhook** procurements/create

采购单创建时触发。

需要 `product` [访问权限](/zh-CN/docs/app/building-blocks/authentication/access-scopes)。最低支持版本：`202007`。

## 请求头

- `X-Shoplazza-Topic` string

  触发本次推送的事件，例如 orders/create

  **示例：** `orders/create`
- `X-Shoplazza-Hmac-Sha256` string

  请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza
- `X-Shoplazza-Shop-Domain` string

  产生该事件的店铺域名

  **示例：** `example.myshoplaza.com`
- `X-Shoplazza-Api-Version` string

  序列化 payload 使用的 API 版本

  **示例：** `2025-06`
- `X-Shoplazza-Deduplication-ID` string

  本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

## 请求体

**数据结构 | 示例**

- `procurement` object

  - `created_at` string

    创建时间
  - `location_id` integer

    目标仓库 ID
  - `note` string

    备注
  - `pending_quantity` integer

    在途数
  - `procurement_id` integer

    采购单 ID
  - `procurement_items` object[]

    采购单商品

    *   Array \[

    - `expiration_date` string

      有效期
    - `id` integer

      商品项 ID
    - `lot_number` string

      批次号
    - `pending_quantity` integer

      在途数
    - `purchase_price` string

      采购价
    - `received_quantity` integer

      已收数
    - `rejected_quantity` integer

      拒绝数
    - `shipped_quantity` integer

      发货数量
    - `shipped_received_quantity` integer

      收货数量
    - `transfer_quantity` integer

      购买数 / 转运数
    - `variant_id` string

      小商品 UUID
    - `variant_sku` string

      SKU
    *   \]
  - `procurement_no` string

    采购单编号
  - `received_quantity` integer

    已收数
  - `rejected_quantity` integer

    拒绝数
  - `sn` string

    单号
  - `source_id` integer

    供应商 ID 或仓库 ID
  - `source_type` integer

    来源。1 = 供应商 ID，2 = 仓库 ID
  - `state` integer

    状态。1 = pending，2 = partial，3 = completed，4 = cancelled
  - `supplier_name` string

    供应商名称
  - `transfer_quantity` integer

    购买数 / 转运数
  - `updated_at` string

    更新时间

```json
{
  "procurement": {
    "created_at": "string",
    "location_id": 0,
    "note": "string",
    "pending_quantity": 0,
    "procurement_id": 0,
    "procurement_items": [
      {
        "expiration_date": "string",
        "id": 0,
        "lot_number": "string",
        "pending_quantity": 0,
        "purchase_price": "string",
        "received_quantity": 0,
        "rejected_quantity": 0,
        "shipped_quantity": 0,
        "shipped_received_quantity": 0,
        "transfer_quantity": 0,
        "variant_id": "string",
        "variant_sku": "string"
      }
    ],
    "procurement_no": "string",
    "received_quantity": 0,
    "rejected_quantity": 0,
    "sn": "string",
    "source_id": 0,
    "source_type": 0,
    "state": 0,
    "supplier_name": "string",
    "transfer_quantity": 0,
    "updated_at": "string"
  }
}
```