item resource type

Represents an item in Business Central.

Note

For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central.

Methods

Method Return Type Description
GET item item Gets a item object.
DELETE item none Deletes a item object.
POST item item Creates a item object.
PATCH item item Updates a item object.
Navigation Return Type Description
itemCategory itemCategory Gets the itemcategory of the item.
inventoryPostingGroup inventoryPostingGroup Gets the inventorypostinggroup of the item.
generalProductPostingGroup generalProductPostingGroup Gets the generalproductpostinggroup of the item.
unitOfMeasure unitOfMeasure Gets the unitofmeasure of the item.
picture picture Gets the picture of the item.
defaultDimensions defaultDimensions Gets the defaultdimensions of the item.
itemVariants itemVariants Gets the itemvariants of the item.
documentAttachments documentAttachments Gets the documentattachments of the item.

Properties

Property Type Description
id GUID The unique ID of the item. Non-editable.
number string Specifies the number of the item.
displayName string Specifies the item's name. This name will appear on all sales documents for the item.
displayName2 string
type NAV.itemType Specifies the type of the item. It can be "Inventory", "Service" or "Non-Inventory".
itemCategoryId GUID The ID of the item category in the item.
itemCategoryCode string The code of the item category in the item.
blocked boolean Specifies that entries cannot be posted to the item. True indicates account is blocked and posting is not allowed.
gtin string This is the Global Trade Item Number.
inventory decimal Specifies how many units, such as pieces, boxes, or cans, of the item are in inventory. Read-Only.
unitPrice decimal Specifies the price for one unit of the item in the specified item.
priceIncludesTax boolean Specifies that the unitPrice includes tax. Set to true, if unitPrice includes tax.
unitCost decimal The unit cost of each individual item in the item.
taxGroupId GUID Specifies the ID of the Tax Group for the item.
taxGroupCode string A Tax Group represents a group of inventory items or resources that are subject to identical tax terms.
baseUnitOfMeasureId GUID Specifies the ID of the unit of measure.
baseUnitOfMeasureCode string The item's base unit of measure code.
generalProductPostingGroupId GUID
generalProductPostingGroupCode string
inventoryPostingGroupId GUID
inventoryPostingGroupCode string
lastModifiedDateTime datetime The last datetime the item was modified. Read-Only.

JSON representation

Here is a JSON representation of the item resource.

{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "displayName2": "string",
    "type": "NAV.itemType",
    "itemCategoryId": "GUID",
    "itemCategoryCode": "string",
    "blocked": "boolean",
    "gtin": "string",
    "inventory": "decimal",
    "unitPrice": "decimal",
    "priceIncludesTax": "boolean",
    "unitCost": "decimal",
    "taxGroupId": "GUID",
    "taxGroupCode": "string",
    "baseUnitOfMeasureId": "GUID",
    "baseUnitOfMeasureCode": "string",
    "generalProductPostingGroupId": "GUID",
    "generalProductPostingGroupCode": "string",
    "inventoryPostingGroupId": "GUID",
    "inventoryPostingGroupCode": "string",
    "lastModifiedDateTime": "datetime"
}

GET item
DELETE item
POST item
PATCH item