PUT api/item

Modify an item

Request Information

URI Parameters

None.

Body Parameters

Item

Name	Type	Description	Additional information
VisibleId	integer	Visible ID number that identifies the resource in the Visible system
ItemCode	string	Primary Item Code that the system uses for the item	Required Max length: 50
MfgItemCode	string	Manufacturer Item Code	Max length: 50
AlternateItemCode	string	Alternate Item code for any external system	Max length: 50
InternalItemCode	string	A Maersk Assigned Item Code. Used if necessary.	Max length: 50
Name	string	Name of the Item	Max length: 80
Description	string	Optional Description	Max length: 100
WMSDescription	string	Internal use. Information only	Max length: 100
ItemType	string	Item Type: Item, Kit, Box	Max length: 20
ItemStatus	string	Item status: Active, Inactive. Default is "Active"	Max length: 20
ItemClassification	string	Item Classification	Max length: 20
Vendor	string	Vendor	Max length: 20
Weight	decimal number	Weight of the item
WeightUoM	string	Unit of measure for the weight. LB - Pounds KG - Kilograms	Max length: 10
Height	decimal number	Height as decimal number
Width	decimal number	Width as decimal number
Length	decimal number	Length as decimal number
ItemPricings	Collection of ItemPricing	Pricing
Prop65	boolean	Declaration for Prop65 in California.
UnitOfMeasure	string	Unit of Measure for the item. ea - Each, mc - Master Case. Default is "ea"	Max length: 10
Cost	decimal number	Cost as decimal number
DiscontinueDate	date	Discontinue Date
UnitsInCase	decimal number	Units per case
Hazardous	string	Optional hazardous code	Max length: 10
HazardTemp	string	Hazard Temperature where the item becomes dangerous	Max length: 50
TempUoM	string	Unit of Measure for Temperature. F - Fahrenheit C - Celsius	Max length: 1
Food	boolean	Is Food
Refrigerated	boolean	Refrigeration Required
MeltTemp	string	Melting temperature	Max length: 10
WillMelt	boolean	Will Melt
WillFreeze	boolean	Will Freeze
FreezeTemp	string	FreezeTemp	Max length: 10
ItemDimensionUnit	string	Item Dimension unit of measure. in - inches, cm - centimeters. Default is "in"	Max length: 10
Volume	decimal number	Volume
VolumeUom	string	Volume Unit of measure. in - inches, cm - centimeters. Default is "in"	Max length: 20
CountryOfOrigin	string	Country of Origin iso 2 digit	Max length: 2
SpecialShippingCode	string	Special Shipping Code	Max length: 50
IsBarCoded	boolean	Item has a barcode	Required
HasSerialNumbers	boolean	Indicator if the item has serial numbers
BarCodeNumber	string	Characters representing the barcode on the item	Max length: 50
CurrencyCode	string	Currency	Max length: 10
UnHazardCode	string	UN hazard code	Max length: 20
IsLotControlled	boolean	Is Lot Controlled
ExpirationDays	integer	Days until item expires
ExternalERPLocation	string	External ERP Location	Max length: 10
HarmonizedCodes	Collection of ItemHarmonizedCode	List of Harmonized codes by country
KitItems	Collection of ItemKit	Items in the kit if the item type is shown as a kit
PerformanceInMS	integer
ClientName	string

Request Formats

application/json, text/json

Sample:

{
  "VisibleId": 1,
  "ItemCode": "sample string 2",
  "MfgItemCode": "sample string 3",
  "AlternateItemCode": "sample string 4",
  "InternalItemCode": "sample string 5",
  "Name": "sample string 6",
  "Description": "sample string 7",
  "WMSDescription": "sample string 8",
  "ItemType": "sample string 9",
  "ItemStatus": "sample string 10",
  "ItemClassification": "sample string 11",
  "Vendor": "sample string 12",
  "Weight": 13.0,
  "WeightUoM": "sample string 14",
  "Height": 15.0,
  "Width": 16.0,
  "Length": 17.0,
  "ItemPricings": [
    {
      "Id": 1,
      "ItemId": 2,
      "CountryCode": "sample string 3",
      "CurrencyCode": "sample string 4",
      "Price": 5.0,
      "PerformanceInMS": 6,
      "ClientName": "sample string 7"
    },
    {
      "Id": 1,
      "ItemId": 2,
      "CountryCode": "sample string 3",
      "CurrencyCode": "sample string 4",
      "Price": 5.0,
      "PerformanceInMS": 6,
      "ClientName": "sample string 7"
    }
  ],
  "Prop65": true,
  "UnitOfMeasure": "sample string 19",
  "Cost": 20.0,
  "DiscontinueDate": "2025-11-03T22:23:16.080103+00:00",
  "UnitsInCase": 22.0,
  "Hazardous": "sample string 23",
  "HazardTemp": "sample string 24",
  "TempUoM": "sample string 25",
  "Food": true,
  "Refrigerated": true,
  "MeltTemp": "sample string 28",
  "WillMelt": true,
  "WillFreeze": true,
  "FreezeTemp": "sample string 31",
  "ItemDimensionUnit": "sample string 32",
  "Volume": 33.0,
  "VolumeUom": "sample string 34",
  "CountryOfOrigin": "sample string 35",
  "SpecialShippingCode": "sample string 36",
  "IsBarCoded": true,
  "HasSerialNumbers": true,
  "BarCodeNumber": "sample string 39",
  "CurrencyCode": "sample string 40",
  "UnHazardCode": "sample string 41",
  "IsLotControlled": true,
  "ExpirationDays": 43,
  "ExternalERPLocation": "sample string 44",
  "HarmonizedCodes": [
    {
      "ItemCode": "sample string 3",
      "CountryCode": "sample string 4",
      "HarmonizedCode": "sample string 5",
      "CustomsValue": 6.0,
      "CustomsDescription": "sample string 7"
    },
    {
      "ItemCode": "sample string 3",
      "CountryCode": "sample string 4",
      "HarmonizedCode": "sample string 5",
      "CustomsValue": 6.0,
      "CustomsDescription": "sample string 7"
    }
  ],
  "KitItems": [
    {
      "Id": 1,
      "ItemId": 2,
      "ItemCode": "sample string 3",
      "ComponentItemId": 4,
      "ComponentItemCode": "sample string 5",
      "Quantity": 6
    },
    {
      "Id": 1,
      "ItemId": 2,
      "ItemCode": "sample string 3",
      "ComponentItemId": 4,
      "ComponentItemCode": "sample string 5",
      "Quantity": 6
    }
  ],
  "PerformanceInMS": 45,
  "ClientName": "sample string 46"
}

application/xml, text/xml

Sample:

<Item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <PerformanceInMS>45</PerformanceInMS>
  <ClientName>sample string 46</ClientName>
  <VisibleId>1</VisibleId>
  <ItemCode>sample string 2</ItemCode>
  <MfgItemCode>sample string 3</MfgItemCode>
  <AlternateItemCode>sample string 4</AlternateItemCode>
  <InternalItemCode>sample string 5</InternalItemCode>
  <Name>sample string 6</Name>
  <Description>sample string 7</Description>
  <WMSDescription>sample string 8</WMSDescription>
  <ItemType>sample string 9</ItemType>
  <ItemStatus>sample string 10</ItemStatus>
  <ItemClassification>sample string 11</ItemClassification>
  <Vendor>sample string 12</Vendor>
  <Weight>13</Weight>
  <WeightUoM>sample string 14</WeightUoM>
  <Height>15</Height>
  <Width>16</Width>
  <Length>17</Length>
  <ItemPricings>
    <ItemPricing>
      <PerformanceInMS>6</PerformanceInMS>
      <ClientName>sample string 7</ClientName>
      <Id>1</Id>
      <ItemId>2</ItemId>
      <CountryCode>sample string 3</CountryCode>
      <CurrencyCode>sample string 4</CurrencyCode>
      <Price>5</Price>
    </ItemPricing>
    <ItemPricing>
      <PerformanceInMS>6</PerformanceInMS>
      <ClientName>sample string 7</ClientName>
      <Id>1</Id>
      <ItemId>2</ItemId>
      <CountryCode>sample string 3</CountryCode>
      <CurrencyCode>sample string 4</CurrencyCode>
      <Price>5</Price>
    </ItemPricing>
  </ItemPricings>
  <Prop65>true</Prop65>
  <UnitOfMeasure>sample string 19</UnitOfMeasure>
  <Cost>20</Cost>
  <DiscontinueDate>2025-11-03T22:23:16.080103+00:00</DiscontinueDate>
  <UnitsInCase>22</UnitsInCase>
  <Hazardous>sample string 23</Hazardous>
  <HazardTemp>sample string 24</HazardTemp>
  <TempUoM>sample string 25</TempUoM>
  <Food>true</Food>
  <Refrigerated>true</Refrigerated>
  <MeltTemp>sample string 28</MeltTemp>
  <WillMelt>true</WillMelt>
  <WillFreeze>true</WillFreeze>
  <FreezeTemp>sample string 31</FreezeTemp>
  <ItemDimensionUnit>sample string 32</ItemDimensionUnit>
  <Volume>33</Volume>
  <VolumeUom>sample string 34</VolumeUom>
  <CountryOfOrigin>sample string 35</CountryOfOrigin>
  <SpecialShippingCode>sample string 36</SpecialShippingCode>
  <IsBarCoded>true</IsBarCoded>
  <HasSerialNumbers>true</HasSerialNumbers>
  <BarCodeNumber>sample string 39</BarCodeNumber>
  <CurrencyCode>sample string 40</CurrencyCode>
  <UnHazardCode>sample string 41</UnHazardCode>
  <IsLotControlled>true</IsLotControlled>
  <ExpirationDays>43</ExpirationDays>
  <ExternalERPLocation>sample string 44</ExternalERPLocation>
  <HarmonizedCodes>
    <ItemHarmonizedCode>
      <ItemCode>sample string 3</ItemCode>
      <CountryCode>sample string 4</CountryCode>
      <HarmonizedCode>sample string 5</HarmonizedCode>
      <CustomsValue>6</CustomsValue>
      <CustomsDescription>sample string 7</CustomsDescription>
    </ItemHarmonizedCode>
    <ItemHarmonizedCode>
      <ItemCode>sample string 3</ItemCode>
      <CountryCode>sample string 4</CountryCode>
      <HarmonizedCode>sample string 5</HarmonizedCode>
      <CustomsValue>6</CustomsValue>
      <CustomsDescription>sample string 7</CustomsDescription>
    </ItemHarmonizedCode>
  </HarmonizedCodes>
  <KitItems>
    <ItemKit>
      <ItemCode>sample string 3</ItemCode>
      <ComponentItemCode>sample string 5</ComponentItemCode>
      <Quantity>6</Quantity>
    </ItemKit>
    <ItemKit>
      <ItemCode>sample string 3</ItemCode>
      <ComponentItemCode>sample string 5</ComponentItemCode>
      <Quantity>6</Quantity>
    </ItemKit>
  </KitItems>
</Item>

application/x-www-form-urlencoded

Sample:

VisibleId=1&ItemCode=sample+string+1&MfgItemCode=sample+string+1&AlternateItemCode=sample+string+1&InternalItemCode=sample+string+1&Name=sample+string+1&Description=sample+string+1&WMSDescription=sample+string+1&ItemType=sample+string+1&ItemStatus=sample+string+1&ItemClassification=sample+string+1&Vendor=sample+string+1&Weight=1&WeightUoM=sample+string+1&Height=1&Width=1&Length=1&ItemPricings=System.Collections.Generic.List%601%5bPorta.Contract.ItemPricing%5d&Prop65=True&UnitOfMeasure=sample+string+1&Cost=1&DiscontinueDate=11%2f3%2f2025+8%3a22%3a12+PM&UnitsInCase=1&Hazardous=sample+string+1&HazardTemp=sample+string+1&TempUoM=sample+string+1&Food=True&Refrigerated=True&MeltTemp=sample+string+1&WillMelt=True&WillFreeze=True&FreezeTemp=sample+string+1&ItemDimensionUnit=sample+string+1&Volume=1&VolumeUom=sample+string+1&CountryOfOrigin=sample+string+1&SpecialShippingCode=sample+string+1&IsBarCoded=True&HasSerialNumbers=True&BarCodeNumber=sample+string+1&CurrencyCode=sample+string+1&UnHazardCode=sample+string+1&IsLotControlled=True&ExpirationDays=1&ExternalERPLocation=sample+string+1&HarmonizedCodes=System.Collections.Generic.List%601%5bPorta.Contract.ItemHarmonizedCode%5d&KitItems=System.Collections.Generic.List%601%5bPorta.Contract.ItemKit%5d&PerformanceInMS=1&ClientName=sample+string+1

Response Information

Resource Description

item

Item

Name	Type	Description	Additional information
VisibleId	integer	Visible ID number that identifies the resource in the Visible system
ItemCode	string	Primary Item Code that the system uses for the item	Required Max length: 50
MfgItemCode	string	Manufacturer Item Code	Max length: 50
AlternateItemCode	string	Alternate Item code for any external system	Max length: 50
InternalItemCode	string	A Maersk Assigned Item Code. Used if necessary.	Max length: 50
Name	string	Name of the Item	Max length: 80
Description	string	Optional Description	Max length: 100
WMSDescription	string	Internal use. Information only	Max length: 100
ItemType	string	Item Type: Item, Kit, Box	Max length: 20
ItemStatus	string	Item status: Active, Inactive. Default is "Active"	Max length: 20
ItemClassification	string	Item Classification	Max length: 20
Vendor	string	Vendor	Max length: 20
Weight	decimal number	Weight of the item
WeightUoM	string	Unit of measure for the weight. LB - Pounds KG - Kilograms	Max length: 10
Height	decimal number	Height as decimal number
Width	decimal number	Width as decimal number
Length	decimal number	Length as decimal number
ItemPricings	Collection of ItemPricing	Pricing
Prop65	boolean	Declaration for Prop65 in California.
UnitOfMeasure	string	Unit of Measure for the item. ea - Each, mc - Master Case. Default is "ea"	Max length: 10
Cost	decimal number	Cost as decimal number
DiscontinueDate	date	Discontinue Date
UnitsInCase	decimal number	Units per case
Hazardous	string	Optional hazardous code	Max length: 10
HazardTemp	string	Hazard Temperature where the item becomes dangerous	Max length: 50
TempUoM	string	Unit of Measure for Temperature. F - Fahrenheit C - Celsius	Max length: 1
Food	boolean	Is Food
Refrigerated	boolean	Refrigeration Required
MeltTemp	string	Melting temperature	Max length: 10
WillMelt	boolean	Will Melt
WillFreeze	boolean	Will Freeze
FreezeTemp	string	FreezeTemp	Max length: 10
ItemDimensionUnit	string	Item Dimension unit of measure. in - inches, cm - centimeters. Default is "in"	Max length: 10
Volume	decimal number	Volume
VolumeUom	string	Volume Unit of measure. in - inches, cm - centimeters. Default is "in"	Max length: 20
CountryOfOrigin	string	Country of Origin iso 2 digit	Max length: 2
SpecialShippingCode	string	Special Shipping Code	Max length: 50
IsBarCoded	boolean	Item has a barcode	Required
HasSerialNumbers	boolean	Indicator if the item has serial numbers
BarCodeNumber	string	Characters representing the barcode on the item	Max length: 50
CurrencyCode	string	Currency	Max length: 10
UnHazardCode	string	UN hazard code	Max length: 20
IsLotControlled	boolean	Is Lot Controlled
ExpirationDays	integer	Days until item expires
ExternalERPLocation	string	External ERP Location	Max length: 10
HarmonizedCodes	Collection of ItemHarmonizedCode	List of Harmonized codes by country
KitItems	Collection of ItemKit	Items in the kit if the item type is shown as a kit
PerformanceInMS	integer
ClientName	string

Response Formats

application/json, text/json

Sample:

{
  "VisibleId": 1,
  "ItemCode": "sample string 2",
  "MfgItemCode": "sample string 3",
  "AlternateItemCode": "sample string 4",
  "InternalItemCode": "sample string 5",
  "Name": "sample string 6",
  "Description": "sample string 7",
  "WMSDescription": "sample string 8",
  "ItemType": "sample string 9",
  "ItemStatus": "sample string 10",
  "ItemClassification": "sample string 11",
  "Vendor": "sample string 12",
  "Weight": 13.0,
  "WeightUoM": "sample string 14",
  "Height": 15.0,
  "Width": 16.0,
  "Length": 17.0,
  "ItemPricings": [
    {
      "Id": 1,
      "ItemId": 2,
      "CountryCode": "sample string 3",
      "CurrencyCode": "sample string 4",
      "Price": 5.0,
      "PerformanceInMS": 6,
      "ClientName": "sample string 7"
    },
    {
      "Id": 1,
      "ItemId": 2,
      "CountryCode": "sample string 3",
      "CurrencyCode": "sample string 4",
      "Price": 5.0,
      "PerformanceInMS": 6,
      "ClientName": "sample string 7"
    }
  ],
  "Prop65": true,
  "UnitOfMeasure": "sample string 19",
  "Cost": 20.0,
  "DiscontinueDate": "2025-11-03T22:23:16.080103+00:00",
  "UnitsInCase": 22.0,
  "Hazardous": "sample string 23",
  "HazardTemp": "sample string 24",
  "TempUoM": "sample string 25",
  "Food": true,
  "Refrigerated": true,
  "MeltTemp": "sample string 28",
  "WillMelt": true,
  "WillFreeze": true,
  "FreezeTemp": "sample string 31",
  "ItemDimensionUnit": "sample string 32",
  "Volume": 33.0,
  "VolumeUom": "sample string 34",
  "CountryOfOrigin": "sample string 35",
  "SpecialShippingCode": "sample string 36",
  "IsBarCoded": true,
  "HasSerialNumbers": true,
  "BarCodeNumber": "sample string 39",
  "CurrencyCode": "sample string 40",
  "UnHazardCode": "sample string 41",
  "IsLotControlled": true,
  "ExpirationDays": 43,
  "ExternalERPLocation": "sample string 44",
  "HarmonizedCodes": [
    {
      "ItemCode": "sample string 3",
      "CountryCode": "sample string 4",
      "HarmonizedCode": "sample string 5",
      "CustomsValue": 6.0,
      "CustomsDescription": "sample string 7"
    },
    {
      "ItemCode": "sample string 3",
      "CountryCode": "sample string 4",
      "HarmonizedCode": "sample string 5",
      "CustomsValue": 6.0,
      "CustomsDescription": "sample string 7"
    }
  ],
  "KitItems": [
    {
      "Id": 1,
      "ItemId": 2,
      "ItemCode": "sample string 3",
      "ComponentItemId": 4,
      "ComponentItemCode": "sample string 5",
      "Quantity": 6
    },
    {
      "Id": 1,
      "ItemId": 2,
      "ItemCode": "sample string 3",
      "ComponentItemId": 4,
      "ComponentItemCode": "sample string 5",
      "Quantity": 6
    }
  ],
  "PerformanceInMS": 45,
  "ClientName": "sample string 46"
}

application/xml, text/xml

Sample:

<Item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <PerformanceInMS>45</PerformanceInMS>
  <ClientName>sample string 46</ClientName>
  <VisibleId>1</VisibleId>
  <ItemCode>sample string 2</ItemCode>
  <MfgItemCode>sample string 3</MfgItemCode>
  <AlternateItemCode>sample string 4</AlternateItemCode>
  <InternalItemCode>sample string 5</InternalItemCode>
  <Name>sample string 6</Name>
  <Description>sample string 7</Description>
  <WMSDescription>sample string 8</WMSDescription>
  <ItemType>sample string 9</ItemType>
  <ItemStatus>sample string 10</ItemStatus>
  <ItemClassification>sample string 11</ItemClassification>
  <Vendor>sample string 12</Vendor>
  <Weight>13</Weight>
  <WeightUoM>sample string 14</WeightUoM>
  <Height>15</Height>
  <Width>16</Width>
  <Length>17</Length>
  <ItemPricings>
    <ItemPricing>
      <PerformanceInMS>6</PerformanceInMS>
      <ClientName>sample string 7</ClientName>
      <Id>1</Id>
      <ItemId>2</ItemId>
      <CountryCode>sample string 3</CountryCode>
      <CurrencyCode>sample string 4</CurrencyCode>
      <Price>5</Price>
    </ItemPricing>
    <ItemPricing>
      <PerformanceInMS>6</PerformanceInMS>
      <ClientName>sample string 7</ClientName>
      <Id>1</Id>
      <ItemId>2</ItemId>
      <CountryCode>sample string 3</CountryCode>
      <CurrencyCode>sample string 4</CurrencyCode>
      <Price>5</Price>
    </ItemPricing>
  </ItemPricings>
  <Prop65>true</Prop65>
  <UnitOfMeasure>sample string 19</UnitOfMeasure>
  <Cost>20</Cost>
  <DiscontinueDate>2025-11-03T22:23:16.080103+00:00</DiscontinueDate>
  <UnitsInCase>22</UnitsInCase>
  <Hazardous>sample string 23</Hazardous>
  <HazardTemp>sample string 24</HazardTemp>
  <TempUoM>sample string 25</TempUoM>
  <Food>true</Food>
  <Refrigerated>true</Refrigerated>
  <MeltTemp>sample string 28</MeltTemp>
  <WillMelt>true</WillMelt>
  <WillFreeze>true</WillFreeze>
  <FreezeTemp>sample string 31</FreezeTemp>
  <ItemDimensionUnit>sample string 32</ItemDimensionUnit>
  <Volume>33</Volume>
  <VolumeUom>sample string 34</VolumeUom>
  <CountryOfOrigin>sample string 35</CountryOfOrigin>
  <SpecialShippingCode>sample string 36</SpecialShippingCode>
  <IsBarCoded>true</IsBarCoded>
  <HasSerialNumbers>true</HasSerialNumbers>
  <BarCodeNumber>sample string 39</BarCodeNumber>
  <CurrencyCode>sample string 40</CurrencyCode>
  <UnHazardCode>sample string 41</UnHazardCode>
  <IsLotControlled>true</IsLotControlled>
  <ExpirationDays>43</ExpirationDays>
  <ExternalERPLocation>sample string 44</ExternalERPLocation>
  <HarmonizedCodes>
    <ItemHarmonizedCode>
      <ItemCode>sample string 3</ItemCode>
      <CountryCode>sample string 4</CountryCode>
      <HarmonizedCode>sample string 5</HarmonizedCode>
      <CustomsValue>6</CustomsValue>
      <CustomsDescription>sample string 7</CustomsDescription>
    </ItemHarmonizedCode>
    <ItemHarmonizedCode>
      <ItemCode>sample string 3</ItemCode>
      <CountryCode>sample string 4</CountryCode>
      <HarmonizedCode>sample string 5</HarmonizedCode>
      <CustomsValue>6</CustomsValue>
      <CustomsDescription>sample string 7</CustomsDescription>
    </ItemHarmonizedCode>
  </HarmonizedCodes>
  <KitItems>
    <ItemKit>
      <ItemCode>sample string 3</ItemCode>
      <ComponentItemCode>sample string 5</ComponentItemCode>
      <Quantity>6</Quantity>
    </ItemKit>
    <ItemKit>
      <ItemCode>sample string 3</ItemCode>
      <ComponentItemCode>sample string 5</ComponentItemCode>
      <Quantity>6</Quantity>
    </ItemKit>
  </KitItems>
</Item>