Export Item

JSON-REST endpoint for exporting item data including related structures.

Purpose

This endpoint returns item data for a webshop channel including optional expansions such as descriptions, categories, attributes, cross-selling, and variants.

Endpoint

  • Method: GET
  • URL pattern: http://<server>:<odata-port>/<service-tier>/api/BEterna/Export/v2.0/companies(<company-system-id>)/items?$filter=webshopChannelCode eq '<webshop-channel-code>' and no eq '<item-no>'&$expand=itemDescriptions($expand=descriptions),categories,itemDynamicAttributes,itemFreeTextAttributes($expand=freeTextLanguages),crossSellingItems,itemSelectionVariants($expand=crossSellingVariants)

Required Parameters

  • webshopChannelCode in the filter
  • no (item number) in the filter

Optional Expansions

  • itemDescriptions
  • categories
  • itemDynamicAttributes
  • itemFreeTextAttributes
  • crossSellingItems
  • itemSelectionVariants

Key Response Fields

  • Item header: systemId, webshopChannelCode, no, released, firstReleasedDate, vendorNo, itemDescription
  • Descriptions: language, meta title, description types
  • Category assignment: code and main flag
  • Attributes: dynamic and free-text attributes with language values
  • Variants and cross-selling relations

Result

  • The webshop receives a consolidated item JSON payload for the requested channel and item filter.