{"id":1898,"date":"2020-09-22T13:46:10","date_gmt":"2020-09-22T13:46:10","guid":{"rendered":"https:\/\/support.itscope.hostpress.me\/?post_type=kb&p=1898"},"modified":"2025-11-11T17:06:25","modified_gmt":"2025-11-11T15:06:25","slug":"company-metadata-methods","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/company-metadata-methods\/","title":{"rendered":"company metadata methods"},"content":{"rendered":"\n

Manufacturer list (metadata)<\/h2>\n\n\n\n

The API provides methods for accessing manufacturer metadata<\/a>.<\/p>\n\n\n\n

    \n
  1. manufacturer\/company.xml: list of all manufacturers in XML format<\/li>\n\n\n\n
  2. manufacturer\/company.json: list of all manufacturers in the JSON format<\/li>\n<\/ol>\n\n\n\n

    for example:
    https:\/\/api.itscope.com\/2.1\/company\/manufacturer\/company.xml<\/a>
    or
    https:\/\/api.itscope.com\/2.1\/company\/manufacturer\/company.json<\/a><\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Supplier list (metadata)<\/h2>\n\n\n\n

    The API provides methods for accessing supplier metadata<\/a>.<\/p>\n\n\n\n

    The supplier ID<\/strong> is the unique ITscope number of the distributor.<\/p>\n\n\n\n

      \n
    1. company\/distributor\/company.xml: list of all suppliers in XML format<\/li>\n\n\n\n
    2. company\/distributor\/company.json: list of all suppliers in JSON format<\/li>\n<\/ol>\n\n\n\n

      for example:
      https:\/\/api.itscope.com\/2.1\/company\/distributor\/company.xml<\/em><\/a>
      or
      https:\/\/api.itscope.com\/2.1\/company\/distributor\/company.json<\/em><\/a><\/p>\n\n\n\n

      Sample in XML-Format:<\/p>\n\n\n\n

      <companies>\n  ...  \n  <company>\n    <name>ALSO Belgium BV<\/name>\n    <street>Schali\u00ebnhoevedreef 20e<\/street>\n    <zip>2800 <\/zip>\n    <city>Mechelen<\/city>\n    <country>BEL<\/country>\n    <supplier>\n      <id>10000940<\/id>\n      <name>ALSO Belgique<\/name>\n      <deeplink>https:\/\/www.itscope.com\/red\/app#companies\/page\/aeivP1_IThamCfPL7jrpgA\/-<\/deeplink>\n      <customerAccountNumber>123456<\/customerAccountNumber>\n      <orderAccountNumber>DE123456<\/orderAccountNumber>\n      <weeeRegNo>DE 1234<\/weeeRegNo>\n    <\/supplier>\n  <\/company>\n ...\n<\/companies><\/code><\/pre>\n\n\n\n
      The customerAccountNumber <\/strong>field contains the customer number that you have stored for the supplier in ITscope.<\/p>\n\n\n\n
      The orderAccountNumber <\/strong>field contains the customer number in the format required for transmission when placing supplier orders via the ITscope API. For some suppliers (such as Ingram), this is generated from the customer number.<\/p>\n\n\n\n
      List of all suppliers with additionally available eServices, the respective eService features and the order conditions<\/h3>\n\n\n\n
      The company\/distributor\/eservices endpoint can be used to query a list of all distributors with additional information on the available\/established eServices<\/a> and order conditions<\/a>. The result can be queried both as XML and as JSON, e.g. https:\/\/api.itscope.com\/2.1\/company\/distributor\/<\/em>eservices.xml<\/a><\/p>\n\n\n\n
      Overview of order conditions<\/h4>\n\n\n\n
      If my own company has overwritten the supplier’s default values, these are also displayed in the order conditions<\/a>. If my company has not overwritten the supplier’s default values, these are displayed.<\/p>\n\n\n\n
      Name<\/th>DatAtypE<\/th>Description<\/th><\/tr><\/thead>
      partialDeliveryAvailable<\/td>Boolean<\/td>If the supplier offers a partial delivery<\/td><\/tr>
      partialDeliveryConfigured<\/td>Boolean<\/td>Has a partial delivery been activated by my company for the supplier<\/td><\/tr>
      ownDeliveryNoteAvailable<\/td>Boolean<\/td>If the supplier offers shipping with its own delivery note<\/td><\/tr>
      ownDeliveryNoteConfigured<\/td>Boolean<\/td>Has shipping been activated with my company’s own delivery note for the supplier<\/td><\/tr>
      orderOnlyValidItemIds<\/td>Boolean<\/td>Only items that are available in ITscope may be ordered, or are item numbers that ITscope does not recognize also permitted<\/td><\/tr>
      absoluteShippingCosts<\/td>Double<\/td>Absolute shipping costs – The net shipping costs (without weight\/size-dependent surcharges) incurred for standard shipping<\/td><\/tr>
      relativeShippingCosts<\/td>Double<\/td>Percentage of shipping costs – Percentage value of the net order total for the shipping costs<\/td><\/tr>
      freightFreeLimit<\/td>Double<\/td>Freight free limit – Net amount above which no shipping costs apply. Other insurances and flat rates are not affected<\/td><\/tr>
      lowQuantitySurcharge<\/td>Double<\/td>Low quantity surcharge – Additional costs if the low quantity threshold is not reached<\/td><\/tr>
      lowQuantitySurchargeThreshold<\/td>Double<\/td>Low quantity surcharge threshold – Amount up to which a low quantity surcharge will be charged<\/td><\/tr>
      ownDeliveryNoteCosts<\/td>Double<\/td>Additional costs if shipping with own delivery note is used<\/td><\/tr>
      absoluteTransportInsurance<\/td>Double<\/td>Absolute amount for the transport insurance<\/td><\/tr>
      relativeTransportInsurance<\/td>Double<\/td>Percentage of net order amount for transport insurance<\/td><\/tr>
      environmentalFee<\/td>Double<\/td>Environmental fee rate for each order<\/td><\/tr>
      tollCharges<\/td>Double<\/td>Toll charges rate for each order<\/td><\/tr>
      packagingFee<\/td>Double<\/td>Packaging fee rate for each order<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Values of the \u201cfeatures\u201d field for eServices<\/h4>\n\n\n\n
      The supported features from the eservice<\/a> of the distributor are listed under the field supplier -> eservices -> features. Each feature is assigned to a type<\/p>\n\n\n\n