---
title: "Creates a new production item, including its bills of materials with their components."
method: POST
path: "/v2/production-items/create"
tags: ["CreateCommand"]
---

# Creates a new production item, including its bills of materials with their components.

`POST /v2/production-items/create`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateProductionItemCommandRequest — Creates a new production item, including its bills of materials with their components. - Request
  - `input` JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateProductionItemInput — Represents the input for creating a new production item, including the details of the production item itself and the bills of materials and lot sizes to be created for the production item.
    - `itemId` string, uuid
    - `isCustomized` boolean — Indicates whether this production item is a customized production item (true) or a regular production item (false).
    - `lotLabelTemplateId` string, uuid
    - `singleItemLabelTemplateId` string, uuid
    - `billsOfMaterials` JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateBillOfMaterialsInput[] — The bills of materials to create for this production item. At least one bill of materials is required. Each bill of materials must contain at least one operation, and across all operations, at least one component must be present.
      - `name` string — The name of the bill of materials.
      - `description` string — An optional description of the bill of materials.
      - `componentPostingsShelfLifeEndDateRequirements` 0 | 1 — 0 = None, 1 = Identical
      - `componentPostingsBatchNumberRequirements` 0 | 1 — 0 = None, 1 = Identical
      - `shelfLifeEndDateGenerationMode` 0 | 1 | 2 — 0 = Earliest, 1 = Latest, 2 = ProductionDate
      - `additionalShelfLifeEndDateTime` string, duration — A time span that is added when calculating the shelf life end date of the produced item after completing a lot. Required when ShelfLifeEndDateGenerationMode is ProductionDate; optional when ShelfLifeEndDateGenerationMode is Earliest or Latest; is ignored when ShelfLifeEndDateGenerationMode is not specified.
      - `operations` JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateBillOfMaterialsOperationInput[] — The operations of this bill of materials. At least one operation is required, and across all operations at least one item must be present.
        - `operationId` string, uuid
        - `items` JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateBillOfMaterialsItemInput[] — The bill of materials items assigned to this operation. Optional per individual operation, but at least one component must be present across all operations within the bill of materials.
          - `itemId` string, uuid
          - `quantity` number — The required quantity of this component for the production of the production item. Must be greater than zero.
          - `measurementUnitId` string, uuid
          - `componentPostingsShelfLifeEndDateRequirements` 0 | 1 | 2 — 0 = Inherited, 1 = None, 2 = Identical
          - `componentPostingsBatchNumberRequirements` 0 | 1 | 2 — 0 = Inherited, 1 = None, 2 = Identical
    - `lotSizes` JTLPPSProductionItemsPublicApiDataTransferObjectsV2CreateCreateLotSizeInput[] — The optional lot sizes to create for this production item.
      - `lotSize` integer — The lot size value. Must be greater than zero.

## Response `201`

Successfully created a production item.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)