You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Product Export:

  • Limit the product information you need for faster response and less load
    • Use the query parameter excludeData to specify which parts of the product information you do not want in return:
      • PRODUCT_HEAD
      • ATTRIBUTE
      • TEXT
      • MEDIA
      • RELATION
      • LINKED_TO
      • VARIANT
      • STRUCTURE
      • PACKAGING
      • ETIM
    • By excluding all parts in the list above, only a list of “identifiers” for the products in the export will be returned. This means a list of products that only have feed®'s unique internal ID and possibly the product number on the product.
    • Use the query parameter includeOptions = false to only retrieve selected values on the product and not other options where there are lists of valid choices. This can significantly reduce the data volume per product, especially where there is ETIM data or many data register attributes.
    • Do you only need data from the product head? Then you can also use productHeadOnly = true to only retrieve this information (an alternative to excludeData with everything except PRODUCT_HEAD).


  • Search for the products you need
    There are several ways to limit which products are exported. All of these can be combined and will further limit the result (AND, not OR).
    • Specify a list of product numbers, or internal IDs (importCodes) from feed using query parameters:
      • productNo = “12345”, “23456”, “34567”
      • altProductNo = “12345”, “23456”, “34567”
      • importCodes = “1”, “2”, “3”
    • Limit search results to desired values of product owners, status, product templates (productType), product group, and/or suppliers based on associated import codes:
      • productOwnerImportCodes
      • productStatusImportCodes
      • productTypeImportCodes
      • productGroupImportCodes
      • supplierImportCodes



Produkt eksport:

  • Begrens det en trenger av produktinformasjon for raskere respons og mindre belastning

    • bruk query parameter "excludeData" til å angi hvilke deler av produktinformasjonen du ikke ønsker i retur
      • PRODUCT_HEAD,
      • ATTRIBUTE,
      • TEXT,
      • MEDIA,
      • RELATION,
      • LINKED_TO,
      • VARIANT,
      • STRUCTURE,
      • PACKAGING,
      • ETIM

    • Ved å ekskludere alle delene i listen over så returneres kun en liste med "identifiers" for produktene i eksport. Det vil si en liste med produkter som har kun feed® sin unike intern ID samt eventuelt produktnummer som er på produktet.
    • Bruk query parameter "includeOptions" = false for å kun hente ut valgte verdier på produkt og ikke øvrige valgmuligheter der det finnes lister med lovlige valg. Dette kan redusere datamengden per produkt mye, spesielt der hvor en har ETIM data eller mange dataregister attributter.
    • Trenger du kun data fra produkthodet? Da kan en også bruke "productHeadOnly" = true for å kun hente ut denne informasjonen (alternativ til excludeData med alt utenom PRODUCT_HEAD)

  • Søk etter de produkter du trenger
    Det er er flere måter å begrense hvilke produkter en eksporterer. Alle disse kan kombineres og vil ytterligere begrense resultat (AND, ikke OR)
    • Angi liste av produktnummer, eller interne ID (importCodes) fra feed ved bruk av query parametre
      • productNo = "12345", "23456", "34567"
      • altProductNo = "12345", "23456", "34567"
      • importCodes = "1", "2", "3"
    • Begrens søkeresultat til ønskede verdier av produkteiere, status, produktmaler (productType), varegruppe, og/ eller leverandører basert på tilhørende importkoder
      • productOwnerImportCodes
      • productStatusImportCodes
      • productTypeImportCodes
      • productGroupImportCodes
      • supplierImportCodes
    • It is also possible to search by name or designation. Note: You must search for whole words; searching for parts of a word in the name will not yield results.
      For example, if you have a product named “adidas Yeezy Boost”, you can search for “adidas”, “Yeezy”, or “Boost”, or a combination of these to find the product. However, searching for “adida” or “Yeez” will not yield results.
      • name
      • alternativeName
    • It is also possible to search for ETIM values or custom attributes and texts. To do this, you must send a JSON body with search parameters:
      • productSearch
productSearch
{
  "attributes": [
    {
      "importCode": "kode til attributt du skal søke på",
      "value": "verdi du søker etter"
    }
  ],
  "productTexts": [
    {
      "textSearch": "string",
      "importCode": "string"
    }
  ],
  "etim": {
    "version": 0,
    "etimClassIds": [
      "string"
    ],
    "features": [
      {
        "featureId": "string",
        "value": {}
      }
    ]
  }
}

    • For attribute values, the syntax depends on the data type you are searching for.

      Excerpt from Swagger documentation:

      List of datatypes and how to send them:
      Integer where range = false:
      12
      -100
      null

      Integer where range = true:
      [0, 100]
      [null, 100]
      [0, null]
      [null, null]

      Float where range = false:
      12.3
      -100.0
      null

      Float where range = true:
      [0.0, 99.99]
      [null, 99.99]
      [0.0, null]
      [null, null]

      Date where range = false:
      "2019-12-31"
      null

      Date where range = true:
      ["2019-01-01", "2019-12-31"]
      [null, "2019-12-31"]
      [2019-01-01", null]
      [null, null]

      Text:
      {
      "nb": "Dette er en norsk attributtekst.",
      "en": "This is an English attribute text."
      }

      Boolean:
      true
      false

      Data register:
      "key_1"
      null

      Data register multi:
      ["key_1","key_2","key_2"]
      []

  • No labels