**Version: 202601**

# Batch create procurement items

**POST** `/openapi/2026-01/procurements/:procurement_id/items`

Allows the bulk addition of procurement items to a procurement record.

## Request

**Path Parameters**

- `procurement_id` string (required)

  The unique identifier of the procurement record

**application/json**

**Body | Example**

**Body (required)**

- `items` object[] (required)

  The array of items to be added to the procurement record

  *   Array \[

  - `product_id` string (required)

    The unique identifier of the product
  - `variant_id` string (required)

    The unique identifier of the product variant
  - `transfer_quantity` int32 (required)

    The quantity of the item to be transferred
  *   \]

```json
{
  "items": [
    {
      "product_id": "string",
      "variant_id": "string",
      "transfer_quantity": 0
    }
  ]
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `fail_items` object[]

    An array of items that failed to be added, with details of each failure

    *   Array \[

    - `product_id` string

      Product ID
    - `variant_id` string

      Variant ID
    - `transfer_quantity` int32

      Transfer quantity
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "fail_items": [
      {
        "product_id": "string",
        "variant_id": "string",
        "transfer_quantity": 0
      }
    ]
  }
}
```