POST public-api/ic/item/createInventoryItems

This method is used to create new inventory items. You can pass in a list of ItemInventoryInfo to create several new items at once. It creates only inventory type items. Requires Create Item permission.



Request Information

URI Parameters

None.

Body Parameters

Collection of ItemInventoryInfo
NameDescriptionTypeAdditional information
RowNumber

Read Only. Long; When creating/updating/deleting multiple records, this can be used to identify what records has errors, if any.

integer

None.

ItemNumber

Required. This is a unique identifier of an item.

string

None.

AlternateItemNumber

This is a secondary identifier of an item, can be used in a search to find an item.

string

None.

ItemDescription

A description about the item.

string

None.

CategoryDescription

This is used to group similar items together.

string

None.

ManufacturerName

The name of the manufacturer of the item.

string

None.

CheckOutLengthMinutes

Indicates how long an item can be checked out before it is due back and the checkout length is shown in minutes.

integer

None.

StockingUnit

Required. Indicates the unit of measure for stocking to keep track of stocked items.

string

None.

PurchaseUnit

Required. Indicates the unit of measure for purchase, most often used to order items.

string

None.

SalesUnit

Required. Indicates the unit of measure for sales, most often used to sell items.

string

None.

Cost

Required. Indicates how much it cost to purchase an item.

decimal number

None.

SalesPrice

Indicates the price of an item used on pick orders.

decimal number

None.

ListPrice

Indicates the list price from the manufacturer.

decimal number

None.

CostMethod

Required. Indicates how the cost of the item should be tracked.

CostMethodEnum

None.

AverageCost

Read Only. Indicates the current average cost of an item. If FIFO or LIFO then this is the next cost.

decimal number

None.

TaxCode

Required. Indicates how an item should be taxed on an order.

string

None.

AttachmentInfo

The attachment information for the item.

ItemAttachmentInfo

None.

TrackbyInfo

Contains true/false values for how the item is tracked.

ItemTrackbyInfo

None.

DimensionInfo

The dimension info, units and measurements, of an item.

ItemDimensionInfo

None.

ItemVendors

A list of all vendor information for the item.

Collection of ItemVendorInfo

None.

ItemPrices

A list of all pricing information for the item.

Collection of ItemPrices

None.

ItemLocationSettings

A list of all location settings for the item.

Collection of ItemLocationSettings

None.

ItemSiteSettings

A list of all site settings for this item.

Collection of ItemSiteSettings

None.

CustomFields

A list of custom fields and their values for the item.

Collection of DcfValueInfo

None.

Request Formats

application/json

Sample:
[
  {
    "RowNumber": 0,
    "ItemNumber": "DateCodeItem8d9a872876bb80c",
    "CheckOutLengthMinutes": 0,
    "StockingUnit": "each",
    "PurchaseUnit": "each",
    "SalesUnit": "each",
    "Cost": 123.45,
    "SalesPrice": 0.0,
    "ListPrice": 0.0,
    "CostMethod": 0,
    "AverageCost": 0.0,
    "TaxCode": "Tax",
    "TrackbyInfo": {
      "TrackedBySerialNumber": false,
      "TrackedByLot": false,
      "TrackedByDateCode": true,
      "TrackedBySerialNumberOnlyOnInvoicing": false,
      "AutoGenerateSerialNumber": false,
      "TrackedByReferenceNumber": false,
      "TrackedByVendor": false,
      "TrackedByCustomer": false
    },
    "DimensionInfo": {
      "DimensionUnit": "each",
      "Height": 0.0,
      "Width": 0.0,
      "Depth": 0.0,
      "WeightUnit": "Kilogram",
      "Weight": 0.0,
      "VolumeUnit": "each",
      "MaxVolume": 0.0
    }
  }
]

application/json

Sample:
InventoryItem
[
  {
    "RowNumber": 0,
    "ItemNumber": "SDK Item 1",
    "CheckOutLengthMinutes": 0,
    "StockingUnit": "cm",
    "PurchaseUnit": "m",
    "SalesUnit": "cm",
    "Cost": 20.0,
    "SalesPrice": 0.0,
    "ListPrice": 0.0,
    "CostMethod": 20,
    "AverageCost": 0.0,
    "TaxCode": "Tax",
    "DimensionInfo": {
      "DimensionUnit": "Inch",
      "Height": 0.0,
      "Width": 0.0,
      "Depth": 0.0,
      "WeightUnit": "Pound",
      "Weight": 0.0,
      "VolumeUnit": "Cubic Inch",
      "MaxVolume": 0.0
    },
    "ItemLocationSettings": [
      {
        "SiteName": "Warehouse 1",
        "LocationCode": "Pack",
        "PrimaryLocation": true,
        "MinimumQuantity": 10.0,
        "MaximumQuantity": 100.0,
        "ReorderQuantity": 80.0
      }
    ]
  }
]

application/json

Sample:
- MandatoryField
[
  {
    "RowNumber": 0,
    "CheckOutLengthMinutes": 0,
    "StockingUnit": "each",
    "PurchaseUnit": "each",
    "SalesUnit": "each",
    "Cost": 20.0,
    "SalesPrice": 0.0,
    "ListPrice": 0.0,
    "CostMethod": 20,
    "AverageCost": 0.0,
    "TaxCode": "Tax",
    "DimensionInfo": {
      "DimensionUnit": "Inch",
      "Height": 0.0,
      "Width": 0.0,
      "Depth": 0.0,
      "WeightUnit": "Pound",
      "Weight": 0.0,
      "VolumeUnit": "Cubic Inch",
      "MaxVolume": 0.0
    }
  }
]

application/json

Sample:
- AlreadyExists
[
  {
    "RowNumber": 0,
    "ItemNumber": "SDK Item 1",
    "CheckOutLengthMinutes": 0,
    "StockingUnit": "cm",
    "PurchaseUnit": "m",
    "SalesUnit": "cm",
    "Cost": 20.0,
    "SalesPrice": 0.0,
    "ListPrice": 0.0,
    "CostMethod": 20,
    "AverageCost": 0.0,
    "TaxCode": "Tax",
    "DimensionInfo": {
      "DimensionUnit": "Inch",
      "Height": 0.0,
      "Width": 0.0,
      "Depth": 0.0,
      "WeightUnit": "Pound",
      "Weight": 0.0,
      "VolumeUnit": "Cubic Inch",
      "MaxVolume": 0.0
    },
    "ItemLocationSettings": [
      {
        "SiteName": "Warehouse 1",
        "LocationCode": "Pack",
        "PrimaryLocation": true,
        "MinimumQuantity": 10.0,
        "MaximumQuantity": 100.0,
        "ReorderQuantity": 80.0
      }
    ]
  }
]



Response Information

Resource Description

WaspResultOfResults
NameDescriptionTypeAdditional information
Data

Type specific result that always depends on the function called.

Results

None.

Messages

List of Messages. All APIs should return messages. If an API function returns an error you can find more information about the error or errors in this collection of messages.

Collection of WtResult

None.

BatchNumber

This is a global batch number generated by a mass group of transaction records to be returned to the consumer on each call to rolling transaction rules. This requests that each group of Move/Add/Remove transaction batches is tied together. In prior products (such as Mobile Asset Cloud), all are set to null and the only time when the batch number is generated is for multiple check-out transactions but the old is to generate for each responsible party.

integer

None.

HasError

True if an API function result has an error message in the results. If this is false, the function succeeded but other informative messages may be available.

boolean

None.

HasHttpError

True if an API function call could not be fully posted to the server or the results could not be fully returned.

boolean

None.

HasMessage

True if any message is available.

boolean

None.

HasSuccessWithMoreDataRemaining

True if the server sent part of the data and there is more data available. Use with paging APIs to fetch data one page at a time.

boolean

None.

TotalRecordsLongCount

This is the total number of records available in the database based on the query and filer conditions provided. It is possible that the value can change from call to call as users add and delete records so this should not be used to page through multiple recordsets of data. This is used, for example, to set relative scroll bar sizes. When paging through data using functions like the assetadvancedinfosearch, calculating TotalRecordsLongCount for every page full of data is an time-consuming operation. To avoid that extra calculation, and help prevent throttling, assign TotalRecordsLongCount to TotalCountFromPriorFetch in the AdvancedSearchParameters to skip recalculating this total page count and to page thru the records faster.

integer

None.

Response Formats

application/json

Sample:
{
  "Data": {
    "ResultList": [
      {
        "ResultCode": 0,
        "Message": "Success.",
        "HttpStatusCode": 200
      }
    ],
    "SuccessfullResults": 0,
    "TotalResults": 1
  },
  "Messages": [
    {
      "ResultCode": 0,
      "Message": "Success.",
      "HttpStatusCode": 200,
      "FieldName": ""
    }
  ],
  "HasSuccessWithMoreDataRemaining": false,
  "HasError": false,
  "HasMessage": true,
  "HasHttpError": false
}