items resource type

Article
01/21/2019

Represents an item in Dynamics 365 Business Central.

Note

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

Methods

Method	Return Type	Description
GET item	items	Gets an item object.
POST item	items	Creates an item object.
PATCH item	items	Updates an item object.
DELETE item	none	Deletes an item object.

Subpages

Method	Return Type	Description
GET item defaultDimensions	default dimensions	Gets the default dimensions of item.
POST item defaultDimensions	default dimensions	Creates the default dimensions of item.
PATCH item defaultDimensions	default dimensions	Updates the default dimensions of item.
DELETE item defaultDimensions	default dimensions	Deletes the default dimensions of item.

Properties

Property	Type	Description
id	GUID	The unique ID of the item. Non-editable.
number	string	The item number.
displayName	string	Specifies a description of the item.
type	string	The inventory type for the item; Inventory, Service, and Non-Inventory. This is a required property.
blocked	boolean	Specifies that transactions with the item cannot be posted, for example, because the item is in quarantine. Set to true, if item is blocked.
baseUnitOfMeasureId	GUID	Specifies the ID of the unit of measure.
baseUnitOfMeasure	NAV.UnitOfMeasure	Specifies the unit in which the item is held in inventory.
gtin	numeric	This is the Global Trade Item Number.
itemCategory	NAV.ItemCategory	Specifies the category that the item belongs to.
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 currency.
priceIncludesTax	boolean	Specifies that the unitPrice includes tax. Set to true, if unitPrice includes tax.
unitCost	decimal	Specifies the cost per unit of the item.
taxGroupId	GUID	Specifies the ID of the Tax Group for the item.
taxGroupCode	numeric	A Tax Group represents a group of inventory items or resources that are subject to identical tax terms.
lastModifiedDateTime	datetime	The last datetime the item was modified. Read-Only.

Relationships

A Tax Group(taxGroupCode) must exist in the Tax Group table.

JSON representation

Here is a JSON representation of the resource.

{
      "id": "GUID",
      "number": "string",
      "displayName": "string",
      "type": "string",
      "blocked": "boolean",
      "baseUnitOfMeasureId": "GUID",
      "baseUnitOfMeasure": "NAV.UnitOfMeasure",
      "gtin": "numeric",
      "itemCategory": "NAV.ItemCategory",
      "inventory": "decimal",
      "unitPrice": "decimal",
      "priceIncludesTax": "boolean",
      "unitCost": "decimal",
      "taxGroupId": "GUID",
      "taxGroupCode": "string",
      "lastModifiedDateTime": "datetime"
}

Share via