title | description | author | ms.custom | ms.topic | ms.devlang | ms.date | ms.author | ms.reviewer |
---|---|---|---|---|---|---|---|---|
(v1.0) items resource type |
(v1.0) An item object in Dynamics 365 Business Central. |
SusanneWindfeldPedersen |
evergreen |
reference |
al |
05/01/2024 |
solsen |
solsen |
[!INCLUDEd365_api_newversion]
Represents an item in [!INCLUDEprod_short].
Note
For information about enabling APIs for [!INCLUDEprod_short] see Enabling the APIs for Dynamics 365 Business Central.
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. |
Navigation | Return Type | Description |
---|---|---|
Picture | picture | Gets the picture of item. |
DefaultDimension | defaultDimension | Gets the defaultDimension of item. |
ItemCategory | itemCategory | Gets the item catgory of item. |
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. |
A Tax Group(taxGroupCode) must exist in the Tax Group table.
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"
}