Import-API: Daten per POST & PUT importieren

{
  "type": "categories",
  "data": [
    {
      "categories_id": 142,
      "parent_id": 110,
      "status": 1,
      "languages": {
        "de": {
          "categories_name": "Produktattribute",
          "categories_description": "<p>Beschreibung als HTML-String...</p>"
        }
      }
    }
  ]
}

{
  "success": true,
  "api_version": "2.1.0",
  "type": "categories",
  "stats": {
    "total": 2,
    "inserted": 1,
    "updated": 1,
    "failed": 0
  },
  "errors": [],
  "timestamp": "2026-01-27 14:00:00",
  "records": [
    {"index": 1, "categories_id": 144, "status": "inserted"},
    {"index": 2, "categories_id": 142, "status": "updated"}
  ]
}

Zusatzfelder eines Produkts werden ausschließlich über das Feld extra_fields geschrieben – nicht als Feld auf oberster Ebene des Produkts. Ein Schlüssel wie google_product_category direkt neben products_model wird ignoriert (und in der Response als UNKNOWN_FIELD gemeldet).

Ab v2.51.0 wird jede der folgenden Schreibweisen akzeptiert – wahlweise über die Feld-ID oder den Feldnamen (Groß-/Kleinschreibung und Leerzeichen sind tolerant):

{
  "type": "products",
  "data": [{
    "products_model": "ABC-123",

    "extra_fields": {
      "Google Produktkategorie (xoPort)": "1234",
      "Google Zustand (xoPort)": "new",
      "Google Verfügbarkeit (xoPort)": "in stock"
    }

    // ... alternativ nach Feld-ID:
    // "extra_fields": {"7": "1234", "8": "new", "9": "in stock"}

    // ... oder als Liste:
    // "extra_fields": [{"products_extra_fields_id": 7, "products_extra_fields_value": "1234"}]
  }]
}

Auch die Struktur, die der JSON-Export zurückliefert (Objekt, gekeyt nach Feld-ID), ist unverändert wieder importierbar.

Google-Shopping-Felder

Die Felder des Google-Feeds sind Standard-Zusatzfelder mit festen IDs:

Produkt-Tabs (z. B. „Leistungsbeschreibung“, „Datenblatt“, „Montagehinweise“) werden über das Feld tabs gepflegt – ein flaches Array von Tab-Objekten. Ein sprachgeschachteltes Format wie {"de": […]} wird nicht unterstützt und ohne Fehlermeldung ignoriert (keine Warnung, keine Tabs).

{
  "type": "products",
  "data": [{
    "products_model": "ABC-123",

    "tabs": [
      {
        "tab_name": "Leistungsbeschreibung",
        "tab_content": "<h3>Leistungsbeschreibung</h3><p>...</p>",
        "language_id": 2,
        "sort_order": 0
      },
      {
        "tab_name": "Service description",
        "tab_content": "<h3>Service description</h3><p>...</p>",
        "language_id": 1,
        "sort_order": 0
      }
    ]
  }]
}

Verhalten im Detail

• Neuanlage: Jeder Eintrag ohne tab_id legt einen neuen Tab mit eigener tab_id an – auch pro Sprache. Mehrsprachige Tabs werden also als ein Eintrag je Sprache gesendet (siehe Beispiel oben); das Frontend zeigt sprachgefiltert jeweils nur die Tabs der aktiven Sprache.
• Update: Mit tab_id wird der bestehende Tab in der angegebenen Sprache aktualisiert – allerdings nur, wenn die Sprachzeile bereits existiert. Eine fehlende Sprachfassung eines bestehenden Tabs kann per API nicht nachträglich angelegt werden (dafür einen neuen Tab ohne tab_id senden).
• Kein Delete-on-absent: Nicht mitgesendete Tabs bleiben unverändert bestehen. Tabs löschen erfolgt im Backend am Produkt.
• Export-Round-Trip: GET /products liefert die Tabs als Objekt gekeyt nach tab_id (inkl. tab_name, tab_content, language_id, sort_order).

Bestand, Sicherheitsbestand und Meldebestand je Lager werden im Produkt-Import ausschließlich über das Feld storages gepflegt – ein flaches Array von Lager-Objekten, jedes mit storages_id (Alias warehouse_id). Seit v2.45.0 ist das ein partielles Update: ein Teil-Payload wie {"storages_id": 3, "products_reorder_level": 10} ändert nur den Meldebestand dieses Lagers und setzt die übrigen Lagerspalten nicht auf 0.

Voraussetzung ist das aktivierte erweiterte Lagersystem (EXTENDED_STORAGE_SYSTEM); andernfalls wird das Feld ignoriert und die Antwort enthält die Warnung STORAGE_SYSTEM_DISABLED. Alle Felder, die Semantik und die Fallstricke stehen im Abschnitt Lagerbestände & Meldebestände je Lager der Products-Referenz.