HemiKnowledge BaseHemiIntegrations
Table of Contents
Related Articles
Knowledge Base
Hemi System Administration Integrations Hemi PRD Library Hemi Content Stream General Information Custom additions Core Integrations & Marketplace Documentation Hemi Advanced Functionalities Data Management MP Tokens generation Hemi Technology Trainings Hemi Platform Integrations Release Notes
FAQs

Marketplaces / The Iconic Technical Scope Overview / The Iconic Product Taxonomy

The Iconic Product Taxonomy

Get Brands

In order to get all product brands.

GET - https://api.sellercenter.net/?Action=GetBrands

Parameters:

Parameter Name Parameter Value Comment Required
1 Action “GetBrands“ for product remove our action will always be “GetBrands“ Yes
2 Format “XML“ or “JSON“ both options are available, If not supplied, 'XML' is assumed. No
3 Timestamp the current time in ISO8601 format relative to UTC e.g., Timestamp=2015-04-01T10:00:00+02:00 for Berlin Yes
4 UserID Account The Iconic > User ID The ID of the user making the call Yes
5 Version “2.6.20“ hardcoded the latest available version Yes
6 Signature Account The Iconic > Signature The cryptographic signature, authenticating the request. A caller must create this value by computing the SHA256 hash of the request, using the API key of the user specified in the UserID parameter Yes

Example:

url = "https://api.sellercenter.net/"
get
data-urlencode Action=GetBrands
data-urlencode Timestamp=2015-07-01T11:11+0000
data-urlencode UserID=maintenance@sellercenter.net
data-urlencode Version=1.0
data-urlencode Signature=01286525c2fdba58296a61ed1f5e559d0e25972c288d2464b6c25fccc6be729a

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
  <Head>
    <RequestId/>
    <RequestAction>GetBrands</RequestAction>
    <ResponseType>Brands</ResponseType>
    <Timestamp>2015-07-01T11:11:11+0000</Timestamp>
  </Head>
  <Body>
    <Brands>
      <Brand>
        <BrandId>1</BrandId>
        <Name>Commodore</Name>
        <GlobalIdentifier>commodore</GlobalIdentifier>
      </Brand>
      <Brand>
        <BrandId>2</BrandId>
        <Name>Atari</Name>
        <GlobalIdentifier/>
      </Brand>
    </Brands>
  </Body>
</SuccessResponse>

Mapping:

The Iconic field Required Comment Type
Body
Brands
Brand
BrandId Yes Identifier of this Brand as assigned by SellerCenter Integer
Name Yes The actual name for the brand which we push to the Marketplace String
GlobalIdentifier No A globally-unique string identifier for the brand across different systems. For example: ADIDAS, NIKE, APPLE String

Get Category Tree

To get list of all product categories.

GET - https://api.sellercenter.net/?Action=GetCategoryTree

Parameters

Parameter Name Parameter Value Comment
Action “GetCatergoryTree“ for product remove our action will always be “GetCategoryTree“
Format “XML“ or “JSON“ both options are available, If not supplied, 'XML' is assumed.
Timestamp the current time in ISO8601 format relative to UTC e.g., Timestamp=2015-04-01T10:00:00+02:00 for Berlin
UserID Account The Iconic > User ID The ID of the user making the call
Version “2.6.20“ hardcoded the latest available version
Signature Account The Iconic > Signature The cryptographic signature, authenticating the request. A caller must create this value by computing the SHA256 hash of the request, using the API key of the user specified in the UserID parameter

Example:

url = "https://api.sellercenter.net/"
get
data-urlencode Action=GetCategoryTree
data Timestamp=2015-07-01T11:11+0000
data-urlencode UserID=maintenance@sellercenter.net
data-urlencode Version=1.0
data-urlencode Signature=1a497a8bc55c08b9c124ea3f23b1af44ec7f4a2a5f20e2eae9080d6db25f3c36

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
  <Head>
    <RequestId/>
    <RequestAction>GetCategoryTree</RequestAction>
    <ResponseType>Categories</ResponseType>
    <Timestamp>2015-07-01T11:11:11+0000</Timestamp>
  </Head>
  <Body>
    <Categories>
      <Category>
        <Name>Quadrilaterals</Name>
        <CategoryId>2790</CategoryId>
        <GlobalIdentifier>QUADRILATER</GlobalIdentifier>
        <AttributeSetId>1</AttributeSetId>
        <Children>
          <Category>
            <Name>Rectangles</Name>
            <CategoryId>589</CategoryId>
            <GlobalIdentifier>RECTANGLE</GlobalIdentifier>
            <AttributeSetId>1</AttributeSetId>
            <Children>
              <Category>
                <Name>Squares</Name>
                <CategoryId>603</CategoryId>
                <GlobalIdentifier>SQUARE</GlobalIdentifier>
                <AttributeSetId>2</AttributeSetId>
                <Children/>
              </Category>
            </Children>
          </Category>
        </Children>
      </Category>
    </Categories>
  </Body>
</SuccessResponse>

Mapping:

The Iconic Required Comment Type
Body
Categories
Category
Name Yes The name of the category which we use for mapping between Item Account > PrimaryCategoryID and the category name in the class in order to get the CategoryID which we pass to the MP string
GlobalIdentifier No An unique identifier for this category across countries string
CategoryId Yes Category ID - the value we push to the MP integer
Children If there are any children categories will be listed here in the same structure as the root category.
List of all child categories (category resources)

Using get category tree we obtain all available categories for the Marketplace which we

Get Category Attributes

Returns a list of attributes with options for a given category. With this we call each category separately in order to get category attributes.

GET - https://api.sellercenter.net/?Action=GetCategoryAttributes

Parameters:

Parameter Name Parameter Value Comment
Action “GetCatergoryAttributes“ for product remove our action will always be “GetCategoryAttributes“
Format “XML“ or “JSON“ both options are available, If not supplied, 'XML' is assumed.
Timestamp the current time in ISO8601 format relative to UTC e.g., Timestamp=2015-04-01T10:00:00+02:00 for Berlin
UserID Account The Iconic > User ID The ID of the user making the call
Version “2.6.20“ hardcoded the latest available version
Signature Account The Iconic > Signature The cryptographic signature, authenticating the request. A caller must create this value by computing the SHA256 hash of the request, using the API key of the user specified in the UserID parameter
PrimaryCategory Identifier of the category for which the caller wants the list of attributes

Example:

url = "https://api.sellercenter.net/"
get
data-urlencode PrimaryCategory=1
data-urlencode Action=GetCategoryAttributes
data-urlencode Timestamp=2015-07-01T11:11+0000
data-urlencode UserID=maintenance@sellercenter.net
data-urlencode Version=1.0
data-urlencode Signature=e845aab0aeface7edfcff0395210df888ed645de5c723ad2db3806912493d44b

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
  <Head>
    <RequestId/>
    <RequestAction>GetCategoryAttributes</RequestAction>
    <ResponseType>Attributes</ResponseType>
    <Timestamp>2015-07-01T11:11:11+0000</Timestamp>
  </Head>
  <Body>
    <Attribute>
      <Label>Memory Size (GB)</Label>
      <Name>storage_capacity</Name>
      <GlobalIdentifier/>
      <isMandatory>0</isMandatory>
      <Description> Memory Size</Description>
      <AttributeType>value</AttributeType>
      <ExampleValue/>
      <Options/>
    </Attribute>
    <Attribute>
      <Label>Processor</Label>
      <Name>cpu_brand</Name>
      <GlobalIdentifier/>
      <isMandatory>0</isMandatory>
      <Description/>
      <AttributeType>option</AttributeType>
      <ExampleValue/>
      <Options>
        <Option>
          <GlobalIdentifier/>
          <Name>Intel</Name>
          <isDefault>0</isDefault>
        </Option>
        <Option>
          <GlobalIdentifier/>
          <Name>AMD</Name>
          <isDefault>0</isDefault>
        </Option>
        <Option>
          <GlobalIdentifier/>
          <Name>NVIDIA</Name>
          <isDefault>0</isDefault>
        </Option>
      </Options>
    </Attribute>
    <Attribute>
      <Label>TaxClass</Label>
      <Name>TaxClass</Name>
      <GlobalIdentifier/>
      <isMandatory>0</isMandatory>
      <Description/>
      <AttributeType>option</AttributeType>
      <ExampleValue/>
      <Options>
        <Option>
          <GlobalIdentifier/>
          <Name>default 23</Name>
          <isDefault>1</isDefault>
        </Option>
        <Option>
          <GlobalIdentifier/>
          <Name>zero</Name>
          <isDefault>0</isDefault>
        </Option>
      </Options>
    </Attribute>
    <Attribute>
      <Label>ShipmentType</Label>
      <Name>ShipmentType</Name>
      <GlobalIdentifier/>
      <isMandatory>0</isMandatory>
      <Description/>
      <AttributeType>option</AttributeType>
      <ExampleValue/>
      <Options>
        <Option>
          <GlobalIdentifier/>
          <Name>Dropshipping</Name>
          <isDefault>0</isDefault>
        </Option>
        <Option>
          <GlobalIdentifier/>
          <Name>Cross docking</Name>
          <isDefault>0</isDefault>
        </Option>
      </Options>
    </Attribute>
  </Body>
</SuccessResponse>
The Iconic Required Comment Type
Body
Attribute
Name Yes Identifier of the attribute which we use as a name of the attribute node. <Megapixels>490</Megapixels> string
Label No Human-readable display name of the attribute string
isMandatory Yes Whether the attribute is mandatory. boolean
Description No Attribute description string
AttributeType Yes/No Attribute type indicates if option or value string
ExampleValue Example value for the attribute string
Options Lists all Option nodes node
Option Here all the attribute values will be listed.
If empty then there are not enumerations.
GlobalIdentifier No
Name Yes The value of the attribute node example:
490 string
isDefault No

Errors:

Error code Message
57 E057: No attribute sets linked to that category.
Is this article helpful?
0 0 0