Skip to content

Latest commit

 

History

History
102 lines (79 loc) · 4.37 KB

dynamics_item.md

File metadata and controls

102 lines (79 loc) · 4.37 KB
Raw
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

items resource type (v1.0)

[!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.

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.

Navigation

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.

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"
}

See also

Error Codes
Item
Get Item
Post Item
Patch Item
Delete Item