{"id":2328,"date":"2020-09-24T11:49:46","date_gmt":"2020-09-24T11:49:46","guid":{"rendered":"https:\/\/support.itscope.hostpress.me\/?post_type=kb&#038;p=2328"},"modified":"2026-02-28T00:39:03","modified_gmt":"2026-02-27T22:39:03","slug":"differences-api-2-1-to-api-2-0","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/differences-api-2-1-to-api-2-0\/","title":{"rendered":"Differences between API 2.1 and API 2.0"},"content":{"rendered":"\n<p>API version 2.1 has the same methods in all areas (products, metadata, business) as the API 2.0.<\/p>\n\n\n\n<p>However, there are some differences in the fields within data formats or in the behaviour of the API itself.<\/p>\n\n\n\n<p>Here you will find an overview of the changes.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">producs\/ method<\/h2>\n\n\n\n<p>The data formats <a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>, <a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-product-data-format-standardupdate\/\">standardupdate<\/a> have been supplemented in the API 2.1 by a few fields.<\/p>\n\n\n\n<p>In the <strong>product<\/strong> section (<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>), the following fields are new:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>eClassV7:&nbsp;eClass Version 7.0<\/li>\n\n\n\n<li>customsTariffNumber: this field has only been moved to a new position within the document<\/li>\n\n\n\n<li>UNSPSC:&nbsp;UNSPSC Classification Code<\/li>\n\n\n\n<li>colorFamilyId: ID of the colour family (normalised colour)<\/li>\n\n\n\n<li>colorFamily: colour family (normalised colour) &#8211; e.g. &#8216;grey&#8217; instead of &#8216;space-grey&#8217;<\/li>\n\n\n\n<li>combinedLengthAndGirth: girth dimension<\/li>\n\n\n\n<li>netWeight:&nbsp;net weight<\/li>\n\n\n\n<li>netDimX:&nbsp;net dimension X<\/li>\n\n\n\n<li>netDimY:&nbsp;net dimension Y<\/li>\n\n\n\n<li>netDimZ:&nbsp;net dimension Z<\/li>\n\n\n\n<li>valueAddedTaxGermany:&nbsp;German VAT rate<\/li>\n\n\n\n<li>energyEfficiencyClass:&nbsp;energy effieciency class<\/li>\n\n\n\n<li>keySellingPoints: Key Selling Points<\/li>\n\n\n\n<li>packageContents: scope of delivery<\/li>\n\n\n\n<li>productFeatures:&nbsp;product features<\/li>\n\n\n\n<li>htmlMainSpecs: main technical specifications of the product in short form, separated with br-tags<\/li>\n\n\n\n<li>image1 renamed to imageHighRes1<\/li>\n\n\n\n<li>contractTypeId: the ID of the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/product-family\/\">product family<\/a> for licence\/service products<\/li>\n\n\n\n<li>contractTypeName: the name of the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/product-family\/\">product family<\/a> for licence\/service products.<\/li>\n<\/ul>\n\n\n\n<p>In the <strong>supplierItem<\/strong>\u00a0section (<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>), the following fields are new:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>contractTypeId: the ID of the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/product-family\/\">product family<\/a> for licence\/service products<\/li>\n\n\n\n<li>contractTypeName: the name of the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/product-family\/\">product family<\/a>&nbsp;for licence\/service products.<\/li>\n<\/ul>\n\n\n\n<p>In the <strong>attributes<\/strong> section (only in <a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>), the following fields are new:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>value: the base value for the feature (see article on <a href=\"https:\/\/guide.itscope.com\/en\/kb\/units-for-product-properties-in-the-form-of-a-number\/\">base units<\/a>), for text as a text module, for numbers as the smallest value.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Neu: Packaging Units<\/h3>\n\n\n\n<p>The section <strong>supplierPackagingInfo<\/strong> (<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>, <a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-product-data-format-standardupdate\/\">standardupdate<\/a>) is completely new and contains information on packaging units, if available.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Neu: Scaled Prices<\/h3>\n\n\n\n<p>The section <strong>scaledPriceInfo<\/strong> (<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>, <a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-product-data-format-standardupdate\/\">standardupdate<\/a>)\u00a0is completely new and contains information on scaled prices, if available.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">New: Additional product identification numbers<\/h3>\n\n\n\n<p>The section <strong>keyContent <\/strong>(<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>) is completely new and contains information on further product information, if available. E.g. various UNSPSC numbers in different UNSPSC versions, various Eclass numbers in different Eclass versions, various ETIM numbers in different ETIM versions, customs tariff numbers.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">New: Historical Data (on demand)<\/h3>\n\n\n\n<p>The section\u00a0<strong>historicalDataItem<\/strong>\u00a0(<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-products-data-format-standard\/\">standard<\/a>)\u00a0is completely new and contains\u00a0<a href=\"https:\/\/guide.itscope.com\/en\/?post_type=kb&#038;p=2353\">historical price and stock data<\/a>.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">business\/deals\/search method<\/h2>\n\n\n\n<p>Orders (deals) can also be searched for in API 2.1 by providing the shopping cart ID (cartId). It is possible to specify multiple cartIds, this will then return all orders contained within the specified shopping carts.<\/p>\n\n\n\n<p>The following field has been added to the data format&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/format-description-for-orders\/\">carts<\/a>&nbsp;in API 2.1:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>cartId:&nbsp;ID of the cart containing the deal<\/li>\n<\/ul>\n\n\n\n<p>The cartIds can be passed as the filter parameter to our API, e.g.:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>cartId=9d40ec2e-19bb-4126-9231-43a01ce675dd<\/code><\/pre>\n\n\n\n<p>The general cart&#8217;s ID is &#8216;pool&#8217;. We could now, for example, specify a search for the general cart and a second cart as follows:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>cartId=9d40ec2e-19bb-4126-9231-43a01ce675dd,pool<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>API version 2.1 has the same methods in all areas (products, metadata, business) as the API 2.0. However, there are some differences in the fields within data formats or in &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[179],"kbtag":[],"class_list":["post-2328","kb","type-kb","status-publish","hentry","kbtopic-api-2-0-en"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2328","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/comments?post=2328"}],"version-history":[{"count":22,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2328\/revisions"}],"predecessor-version":[{"id":20157,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2328\/revisions\/20157"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=2328"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=2328"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=2328"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}