PIM Kategorien und Attribute


Marktplatz-Kategorien

laets verwaltet einen hierarchischen Kategorie-Baum, um so Produkte oder Dienstleistungen zu klassifizieren. Dieser Baum kann mit Hilfe der folgenden API-Anfrage abgerufen werden:


  {{api_url}}/v1/application_category/?application={{APPLICATION_ID}}

Die Antwort wird beinhalten:

  • Alle Kategorien
  • Die Kategorie-Liste der Applikation
  
  {
  "meta": {
  "limit": 60,
  "next": null,
  "offset": 0,
  "previous": null,
  "total_count": 21
  },
  "objects": [
  {
    "application": {
        "id": 743,
        "pk": 743,
        "resource_uri": "https://api.sandbox.iceberg.technology/v1/application/743/"
    },
    "available_product_data": [],
    "breadcrumb_name": "",
    "children": [
        {
            "id": 63774,
            "pk": 63774,
            "resource_uri": "https://api.sandbox.iceberg.technology/v1/application_category/63774/"
        },
        {
            "id": 63775,
            "pk": 63775,
            "resource_uri": "https://api.sandbox.iceberg.technology/v1/application_category/63775/"
        }
    ],
    "children_count": 2,
    "description": "",
    "external_id": null,
    "google_taxonomy": null,
    "id": 63773,
    "image": "",
    "keywords": "",
    "language": "fr",
    "localization_id": 5665,
    "localized_available_product_data": [],
    "name": "Couples",
    "parent_ids_tree": [
        63773
    ],
    "parents": [],
    "resource_uri": "https://api.sandbox.iceberg.technology/v1/application_category/63773/",
    "shown_in_languages": [
        "fr"
    ],
    "slug": "books-couple",
    "sort_order": 10,
    "status": 1,
    "status_localized": "actif",
    "weight": 0
  }
  .....
  ]
  }

Die Antwort beinhaltet:

  • external_id: Die externe ID der Kategorie
  • name: Den Kategorie-Namen
  • parents: Die übergeordnete Kategorie-ID, um die Hierarchie zu verwalten

Hinweis :

Wir empfehlen, die external_id (nicht die id) zu verwenden, um so einheitlich in der Sandbox- und der Produktions-Umgebung aufzutreten.


Standard-Attribute

Um die Standard-Attribute des Marktplatzes abzurufen, müssen Sie folgende API-Anfrage verwenden:

  
  {{api_url}}/v1/mapper_entity/product_and_offer/?application_id={{APPLICATION_ID}}

Die Antwort beinhaltet:

  • id: Die einzigartige Attributs-ID
  • name: Den Attributs-Namen
  • mandatory: Die Angabe, um zu wissen, ob das Attribut notwendig ist
  • type: Den Attributs-Typen
  • choices: Die Wahl-Möglichkeiten, wenn es eine geschlossene Liste ist


Benutzerdefinierte/Ergänzende Attribute

Benutzerdefinierte Attribute sind spezielle Attribute für unterschiedliche Einheits-Typen. Um ergänzende Attribute abzufragen, müssen Sie mehrere API-Anfragen verwenden:

Hinweis :

Es ist verpflichtend, Attribute für das Loopen in Kategorien abzurufen, weil ein Attribut für die eine Kategorie verpflichtend sein kann und für eine Andere nicht.

  
  {{api_url}}/v1/productoffer/helpers/attributes/?exclude_base_attributes=1&application_categories={{application_category_id}}&application_id={{APPLICATION_ID}}
  {{api_url}}/v1/product/helpers/attributes/?exclude_base_attributes=1&application_categories={{application_category_id}}&application_id={{APPLICATION_ID}}
  {{api_url}}/v1/productoffer/helpers/attributes/?application_id={{APPLICATION_ID}}&exclude_base_attributes=1
  {{api_url}}/v1/product/helpers/attributes/?application_id={{APPLICATION_ID}}&exclude_base_attributes=1

Die Antwort beinhaltet:

  • name: Den Attributs-Namen
  • nullable: Ein Feld, um zu wissen, ob das Attribut notwendig ist
  • type: Den Attributs-Typen
  • choices: Die Wahl-Möglichkeiten, wenn es sich um eine geschlossene Liste handelt