---
title: "Create an Inventory Item"
slug: "create-an-inventory-item"
updated: 2026-05-26T12:48:31Z
published: 2026-05-26T12:48:45Z
canonical: "developers.cmicglobal.com/create-an-inventory-item"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an Inventory Item

Post/ci-rest-api/rest/1/ciitem

## Create Inventory Items

UI Location: ASSET MANAGEMENT - Inventory - Setup - Item Master

### 

SecurityHTTPType basic

Basic authentication

Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceItem+json

Body parameters<select class='api-response-data' aria-label='Media type'><option value='0b11acc7-cc54-446b-b00f-41cb929a7133'>application/json</option>
</select>object  Example{
  "CiitemCompCode": "ZZ",
  "CiitemItemCode": "BD538",
  "CiitemBbPriceOrPctCode": "C",
  "CiitemWriAccCode": "1700.200",
  "CiitemRevAccCode": "4000.700",
  "CiitemInvAccCode": "1700.100",
  "CiitemSuspAccCode": "1700.400",
  "CiitemVarAccCode": "1700.500",
  "CiitemItemClassCode": "TOOL",
  "CiitemCostUpdateLevelCode": "I",
  "CiitemCostMethCode": "AVG",
  "CiitemSellPriceOrPctCode": "C",
  "CiitemAdjAccCode": "1700.300",
  "CiitemWmCode": "EA",
  "CiitemSerialFlag": "N",
  "CiitemMsAvailableFlag": "N",
  "CiitemAltWmAllowFlag": "N",
  "CiitemLotCtrlFlag": "N",
  "CiitemAutoBuildCmpFlag": "N",
  "CiitemUsageCode": "N"
}CiitemWriAccCodestring    Required

Write-off account. Reference to the ACCOUNT table.

Max length16
CiitemAltWmAllowFlagstring    Required

‘Y’ if alternate unit conversions are enabled. ‘N’ if not.

💻 UI Fieldname: Alternate WM Allowed

Max length1
CiitemCompCodestring    Required

Company Code

Max length8
CiitemRevAccCodestring    Required

Revenue account. Reference to the ACCOUNT table.

Max length16
CiitemWmCodestring    Required

Reference to a weight/measure code defined in WGTMES_TABLE

Max length2
CiitemItemCodestring    Required

Key value 2; Inventory item code or number. If the fixed length flag is set in the control file, this code must be of the length specified in the control file.

💻 UI Fieldname: *Item Code

Max length16
CiitemInvAccCodestring    Required

Inventory account. Reference to the ACCOUNT table.

Max length16
CiitemCostMethCodestring    Required

One of AVG (average cost), SF (standard FIFO), F (modified FIFO) and STD (standard cost). The validation program does not check but this should be the same value as in the item’s class.

Max length3
CiitemBbPriceOrPctCodestring    Required

‘P’ if the buyback price is entered explicitly. ‘C’ if it calculated as a percentage of the cost price.

💻 UI Fieldname: *Buy Back

Max length1
CiitemSellPriceOrPctCodestring    Required

‘P’ if the selling price is entered explicitly, ‘C’ if it calculated as a percentage of the cost price.

💻 UI Fieldname: *Issue At

Max length1
CiitemAdjAccCodestring    Required

Adjustment account. Reference to the ACCOUNT table.

Max length16
CiitemSuspAccCodestring    Required

Suspense account. Reference to the ACCOUNT table.

Max length16
CiitemCostUpdateLevelCodestring    Required

If using the Average Cost method of inventory valuation, specify whether to update the average cost of this inventory item by the total inventory (‘I’), or by the inventory within a specified location (‘L’).

💻 UI Fieldname: Average Cost Update Level

Max length1
CiitemMsAvailableFlagstring    Required

Is the Item available for MS system Y/N

💻 UI Fieldname: Available For MS System

Max length1
CiitemVarAccCodestring    Required

Variance account. Reference to the ACCOUNT table.

Max length16
CiitemSerialFlagstring    Required

‘Y’ if the item is serialized, ‘N’ if not.

💻 UI Fieldname: Serialized

Max length1
CiitemVUuidstring    Required

Unique Row ID

Max length64
CiitemItemClassCodestring    Required

Key value 3; Reference (with CIITEM_COMP_CODE) to a class defined in the CICLASS table.

💻 UI Fieldname: *Class Code

Max length4
CiitemTax2Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11
CiitemSalesTax3Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11
CiitemDefaultLocCodestring    

Used in ADF to create default Item Detail right with the insert of Item Master

Max length7
CiitemAllowNegQtyFlagstring    

Allow negative balances

💻 UI Fieldname: Negative Balances

Max length1
CiitemSalesProductFlagstring    

Item setup for Sales Product Code Y = Yes N = No

💻 UI Fieldname: Sales Code

Max length1
CiitemIuUpdateDatestring    
CiitemStdOnhandQtynumber    

Standard on-hand quantity

💻 UI Fieldname: Standard On Hand

Max length16
CiitemMaxOnhandQtynumber    

Maximum on-hand quantity

💻 UI Fieldname: Maximum On Hand

Max length16
CiitemEmCostComponCodestring    

Default EM component code for costing Equipment

💻 UI Fieldname: Equipment Category

Max length8
CiitemCustRevAccCodestring    

Customer sales revenue account. Reference to the ACCOUNT table.

Max length16
CiitemProdFlagstring    

Default value for Production flag on the item/type level

💻 UI Fieldname: Production

Max length1
CiitemRestockPriceAmtnumber    

Dollar amount that will be added to each unit of this inventory item, when all or a portion of the item is returned.

💻 UI Fieldname: Re-Stock Charge

Max length18
CiitemCmpFlagstring    

‘Y’ if this is a composite item, ‘N’ otherwise

💻 UI Fieldname: Composite

Max length1
CiitemMinOnhandQtynumber    

Minimum on-hand quantity

💻 UI Fieldname: Minimum On Hand

Max length16
CiitemDefaultItemTypeCodestring    

Used in ADF to create default Item Header right with the insert of Item Master

Max length2
CiitemSalesTax2Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11
CiitemMinOrderQtynumber    

Minimum order quantity

💻 UI Fieldname: Minimum Order

Max length16
CiitemInventoryItemCodestring    

Inventory Item that mapped to the Sales Product Code

💻 UI Fieldname: Item

Max length16
CiitemMaxOrderQtynumber    

Maximum order quantity

💻 UI Fieldname: Maximum Order

Max length16
CiitemTax3Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11
CiitemAffilRevAccCodestring    

Affiliate sales revenue account. Reference to the ACCOUNT table.

Max length16
CiitemItemDescstring    

Detailed description of the item

Max length2000
CiitemItemNamestring    

Item name used in most screens and reports

💻 UI Fieldname: Item Name

Max length60
CiitemCreditJcCatCodestring    Max length16
CiitemSellPriceAmtnumber    

Selling/issue price or percentage. If percentage remember to make it 100+markup.

Max length18
CiitemPartialDasmblFlagstring    

If CIITEM_CMP_FLAG=’Y’ this flag indicates whether the item can be issued only partially assembled. ‘Y’ means it can, ‘N’ means it cannot.

💻 UI Fieldname: Partial

Max length1
CiitemIuCreateDatestring    
CiitemTax1Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11
CiitemSoldAtCostAccCodestring    

Cost of goods sold account. Reference to the ACCOUNT table.

Max length16
CiitemStdOrderQtynumber    

Standard order quantity

💻 UI Fieldname: Standard Order

Max length16
CiitemBuybackPriceAmtnumber    

Buy back price or percentage. If percentage remember to make it 100+markup.

Max length18
CiitemRtrnFlagstring    

‘Y’ if this item can be returned, ‘N’ otherwise

💻 UI Fieldname: Returnable

Max length1
CiitemMarketPriceAmtnumber    

Market price

💻 UI Fieldname: Market Price

Max length18
CiitemSalesTax1Codestring    

With CiitemCompCode a reference to ARTAX table

Max length11

Responses201

Created

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json
<select class='api-response-data' aria-label='Media type'><option value='2a74d8e7-a19b-42a7-bb4b-b1ebb03b3749'>text/plain</option>
</select>

```
"{\n    \"CiitemAdjAccCode\": \"1700.300\",\n    \"CiitemAffilRevAccCode\": null,\n    \"CiitemAllowNegQtyFlag\": null,\n    \"CiitemAltWmAllowFlag\": \"N\",\n    \"CiitemBbPriceOrPctCode\": \"C\",\n    \"CiitemBuybackPriceAmt\": null,\n    \"CiitemCmpFlag\": null,\n    \"CiitemCompCode\": \"ZZ\",\n    \"CiitemCostMethCode\": \"AVG\",\n    \"CiitemCostUpdateLevelCode\": \"I\",\n    \"CiitemCreditJcCatCode\": null,\n    \"CiitemCustRevAccCode\": null,\n    \"CiitemDefaultItemTypeCode\": null,\n    \"CiitemDefaultLocCode\": null,\n    \"CiitemEmCostComponCode\": null,\n    \"CiitemInvAccCode\": \"1700.100\",\n    \"CiitemInventoryItemCode\": null,\n    \"CiitemItemClassCode\": \"TOOL\",\n    \"CiitemItemCode\": \"BD36\",\n    \"CiitemItemDesc\": null,\n    \"CiitemItemName\": null,\n    \"CiitemIuCreateDate\": null,\n    \"CiitemIuUpdateDate\": null,\n    \"CiitemMarketPriceAmt\": null,\n    \"CiitemMaxOnhandQty\": null,\n    \"CiitemMaxOrderQty\": null,\n    \"CiitemMinOnhandQty\": null,\n    \"CiitemMinOrderQty\": null,\n    \"CiitemMsAvailableFlag\": \"N\",\n    \"CiitemPartialDasmblFlag\": null,\n    \"CiitemProdFlag\": null,\n    \"CiitemRestockPriceAmt\": null,\n    \"CiitemRevAccCode\": \"4000.700\",\n    \"CiitemRtrnFlag\": null,\n    \"CiitemSalesProductFlag\": null,\n    \"CiitemSalesTax1Code\": null,\n    \"CiitemSalesTax2Code\": null,\n    \"CiitemSalesTax3Code\": null,\n    \"CiitemSellPriceAmt\": null,\n    \"CiitemSellPriceOrPctCode\": \"C\",\n    \"CiitemSerialFlag\": \"N\",\n    \"CiitemSoldAtCostAccCode\": null,\n    \"CiitemStdOnhandQty\": null,\n    \"CiitemStdOrderQty\": null,\n    \"CiitemSuspAccCode\": \"1700.400\",\n    \"CiitemTax1Code\": null,\n    \"CiitemTax2Code\": null,\n    \"CiitemTax3Code\": null,\n    \"CiitemVUuid\": \"42CC5281891FEFA2E0630B811DACC294\",\n    \"CiitemVarAccCode\": \"1700.500\",\n    \"CiitemWmCode\": \"EA\",\n    \"CiitemWriAccCode\": \"1700.200\",\n    \"links\": [\n        {\n            \"rel\": \"self\",\n            \"href\": \"https://dev6v12.cmic.ca:9999/cmicdevv12/ci-rest-api/rest/2/ciitem/42CC5281891FEFA2E0630B811DACC294\",\n            \"name\": \"ciitem\",\n            \"kind\": \"item\"\n        },\n        {\n            \"rel\": \"canonical\",\n            \"href\": \"https://dev6v12.cmic.ca:9999/cmicdevv12/ci-rest-api/rest/2/ciitem/42CC5281891FEFA2E0630B811DACC294\",\n            \"name\": \"ciitem\",\n            \"kind\": \"item\"\n        }\n    ]\n}"
```

string
