NDJSON-Import

Makaira kann NDJSON-Dateien importieren. NDJSON steht für newline delimited JSON. Pro Zeile im Daten-Feed muss also ein Dokument abgelegt werden. Jedes Dokument muss sich je nach Typ an bestimmte Feldname halten.

Generelle Information zu Import-Daten:

timestamp
- Zeitstempel zum Zeit des Exports aus dem Shop (Format: YYYY-MM-DD HH:MM:ss)
additionalData
- Beliebige Key-Value-Paare an Daten die zusätzlich zu den Produkten in der API verfügbar sein sollen
groups
- Eine Menge von Daten, die basierend auf dem Constraint "group" in der API übersteuert werden - bspw. für Rabattgruppen sinnvoll. Aber auch für Zielgruppenbasierte Aussteuerung.

Hinweis: Zur besseren Übersichtlichkeit werden im Folgenden die Dokumente mehrzeilig dargestellt. Im finalen Daten-Feed muss natürlich jedes Dokument auf einer Zeile ohne Zeilenumbrüche angeliefert werden.

Dokument-Typ Produkt (product)

{
  "id": "10013859950",
  "type": "product",
  "parent": "",
  "shop": "4",
  "ean": "48690A",
  "isVariant": false,
  "active": true,
  "sort": 0,
  "stock": 0,
  "onstock": true,
  "picture_url_main": "https:\/\/images.makaira.io\/out\/pictures\/generated\/250_250\/pboxx-pixelboxx-2652106\/GRAPH%27IT+%22Brush+%26+Extra+fine%22+Marker+Komplett-Set%2C+Display+mit+96+Markern.jpg",
  "title": "GRAPH'IT \"Brush & Extra fine\" Marker Komplett-Set, Display mit 96 Markern",
  "shortdesc": "Das GRAPH'IT \"Brush & Extra fine\" enth\u00e4lt 96 Marker mit Qualit\u00e4tstinte auf Alkoholbasis und zwei unterschiedlichen Spitzen. Ideal geeignet f\u00fcr unterschiedlichste Mal- und Zeichentechniken.",
  "longdesc": "Das Komplett-Set enthält alle 96 Farbtöne der GRAPH'IT \"Brush & Extra fine\" Marker. Das transparente Display ermöglicht Ihnen jederzeit gute Übersicht und einen schnellen Zugriff zu Ihren Markern.Der GRAPH'IT \"Brush & Extra fine\" Marker verfügt über zwei unterschiedliche Spitzen. Eine lange, flexible Spitze mit synthetischen Pinselfasern, die eine optimale Strömung der Tinte gewährt. Und eine extrafeine 0,5 mm-Spitze mit Metallfassung, die sich insbesondere für Illustrationen eignet.GRAPH'IT \"Brush & Extra fine\" Marker \u2013 Die Produkt-Eigenschaften im ÜberblickKorpus aus weißem Kunststoff mit Dreikantform für hervorragende Haptik und Mal-KomfortQualitätstinte auf AlkoholbasisLeicht zu öffnender Deckel mit Farbcode zur einfachen IdentifizierungDer GRAPH'IT Marker ist ideal geeignet für:ComicsArchitekturDesignLandschaftsmalereiIllustrationuvm.",
  "price": 220.50,
  "soldamount": 0,
  "searchable": true,
  "searchkeys": "GRAPH'IT \"Brush & Extra fine\", Twin Tip, Marker, Pinselmarker, Pinselstift, Stift, Doppelmarker, Kalligrafie, Twin Marker, 2 Spitzen Maker, Comic, Architektur, Design, Illustration, GRAPH'IT Marker, Set, Komplett-Set, Brushpen, Brush Pen, Sortiment",
  "meta_keywords": "GRAPH'IT \"Brush & Extra fine\", Twin Tip, Marker, Pinselmarker, Pinselstift, Stift, Doppelmarker, Kalligrafie, Twin Marker, 2 Spitzen Maker, Comic, Architektur, Design, Illustration, GRAPH'IT Marker, Set, Komplett-Set, Brushpen, Brush Pen, Sortiment",
  "meta_description": "Das GRAPH'IT \"Brush & Extra fine\" Marker Komplett-Set finden Sie in unserem Onlineshop. \u2713 Marker mit Qualit\u00e4tstinte auf Alkoholbasis und zwei unterschiedlichen Spitzen. \u2713 Ideal f\u00fcr unterschiedlichste Mal- und Zeichentechniken. \u2713 \u00dcberzeugen Sie sich selbst! \u2794 Jetzt g\u00fcnstig online kaufen.",
  "manufacturerid": "f58f91bac483a6ea628e9d2be7a4b1e1",
  "manufacturer_title": "pebeo",
  "url": "https:\/\/demo.makaira.io\/GRAPH-IT-Brush-Extra-fine-Marker-Komplett-Set-Display-mit-96-Markern.html",
  "maincategory": "9fb3ea945468f7c61b471c7401e7bad4",
  "maincategoryurl": "https:\/\/demo.makaira.io\/Zeichnen-Grafik-Design\/",
  "groups": {
    "DISCOUNT80": {
      "price": 2.00,
      "price_no_vat": 1.68
    }
  },
  "category": [
    {
      "catid": "cb38ac47b6005b97cd1bbed61c70fb18",
      "shopid": [
        "4"
      ],
      "path": "shop\/unser-angebot\/grafik-design\/stifte-marker\/copic-layoutmarker\/",
      "title": "Layoutmarker",
      "pos": 9 # Position des Produkts innerhalb der Kategorie
    }
  ],
  "attributes": [
    {
      "d6238d67c4448e37c6bff847b097826e": [
        "Nur Neuheiten anzeigen"
      ],
      "5f65a4212ad959feb266af566d8f3b8f": [
        "Grafik + Design"
      ],
      "852264d68055531b4018323a7d2ba706": [
        "Einsteiger",
        "Schulen",
        "Studenten",
        "Hobbyk\u00fcnstler"
      ],
      "a33c9d88a89257f81eef0f4a001cc365": [
        "Marker + Fineliner"
      ],
      "4c9369a9a485d7ce007f58fa695e5812": [
        "Tinte auf Alkoholbasis"
      ],
      "d8008f87168439ac398f6927cdbd812d": [
        "Set"
      ],
      "6d9b20c89a0ffb28b56bb07ff5bb39ba": [
        "Pinselspitze",
        "metallgefasste Spitze"
      ],
      "76c7e398b67f441fdc9220e11b419945": [
        "0,5 mm"
      ]
    }
  ],
  "attributeStr": [
    {
      "id": "d6238d67c4448e37c6bff847b097826e",
      "title": "Neuheiten",
      "value": "Nur Neuheiten anzeigen"
    },
    {
      "id": "5f65a4212ad959feb266af566d8f3b8f",
      "title": "Empfohlen f\u00fcr Technik",
      "value": ["Grafik + Design", "Einsteiger", "Schulen", "Studenten", "Hobbyk\u00fcnstler"]
    },
    {
      "id": "a33c9d88a89257f81eef0f4a001cc365",
      "title": "Produktart",
      "value": "Marker + Fineliner"
    },
    {
      "id": "4c9369a9a485d7ce007f58fa695e5812",
      "title": "Marker-Basis",
      "value": "Tinte auf Alkoholbasis"
    },
    {
      "id": "d8008f87168439ac398f6927cdbd812d",
      "title": "Auswahl",
      "value": "Set"
    },
    {
      "id": "6d9b20c89a0ffb28b56bb07ff5bb39ba",
      "title": "Form Marker (Spitze)",
      "value": ["Pinselspitze", "metallgefasste Spitze"]
    },
    {
      "id": "76c7e398b67f441fdc9220e11b419945",
      "title": "Strichbreite",
      "value": "0,5 mm"
    }
  ],
  "attributeInt": [],
  "attributeFloat": [],
  "mak_boost_norm_insert": 0.07301991452214238,
  "mak_boost_norm_sold": 0.2763039747051342,
  "mak_boost_norm_rating": 0,
  "mak_boost_norm_revenue": 0.2664841710697083,
  "mak_boost_norm_profit_margin": 0,
  "timestamp": "2019-09-27 15:34:42",
  "additionalData": {}
}

Besonderheiten:

parent
- immer empty string bei products
attributes enthält alle Attribute der varianten, gruppiert nach Variante (im Beispiel existiert nur eine Variante)
- key: Attribut-ID
- value: Liste von Attribut-Werten (oder Values mit eindeutigem Delimiter getrennt - werden von uns beim Import getrennt)
- Attribute die global am Produkt stehen, müssen pro Variante noch einmal hier angegeben werden
attributeStr, attributeInt, attributeFloat
- Alle Attribute des Produkts und der Varianten
- unsortiert, je Value ein Eintrag (oder Values mit eindeutigem Delimiter getrennt - werden von uns beim Import getrennt)
- je nach Value-Typ in das jeweilige Array: String (attributeStr) / Integer (attributeInt) / Float (attributeFloat)
mak_boost_norm*
- Felder mit logarithmisch normierten Werten für:
  - Neuheit (mak_boost_norm_insert)
  - Anzahl Verkäufe (mak_boost_norm_sold)
  - Bewertung (mak_boost_norm_rating)
  - Umsatz (mak_boost_norm_revenue)
  - Marge (mak_boost_norm_profit_margin)

Dokument-Typ Variante (variant)

{
  "id": "10013860005",   "type": "variant",
  "parent": "10013859950",
  "shop": "4",
  "ean": "48690",
  "isVariant": true,
  "active": true,
  "sort": 4001,
  "stock": 10,
  "onstock": true,
  "picture_url_main": "https:\/\/images.makaira.io\/out\/pictures\/generated\/250_250\/pboxx-pixelboxx-2616996\/GRAPH%27IT+%22Brush+%26+Extra+fine%22+Marker+Komplett-Set%2C+Display+mit+96+Markern.jpg",
  "title": "GRAPH'IT \"Brush & Extra fine\" Marker Komplett-Set, Display mit 96 Markern",
  "shortdesc": "Das GRAPH'IT \"Brush & Extra fine\" enth\u00e4lt 96 Marker mit Qualit\u00e4tstinte auf Alkoholbasis und zwei unterschiedlichen Spitzen. Ideal geeignet f\u00fcr unterschiedlichste Mal- und Zeichentechniken.",
  "longdesc": "Das Komplett-Set enthält alle 96 Farbtöne der GRAPH'IT \"Brush & Extra fine\" Marker. Das transparente Display ermöglicht Ihnen jederzeit gute Übersicht und einen schnellen Zugriff zu Ihren Markern.Der GRAPH'IT \"Brush & Extra fine\" Marker verfügt über zwei unterschiedliche Spitzen. Eine lange, flexible Spitze mit synthetischen Pinselfasern, die eine optimale Strömung der Tinte gewährt. Und eine extrafeine 0,5 mm-Spitze mit Metallfassung, die sich insbesondere für Illustrationen eignet.GRAPH'IT \"Brush & Extra fine\" Marker \u2013 Die Produkt-Eigenschaften im ÜberblickKorpus aus weißem Kunststoff mit Dreikantform für hervorragende Haptik und Mal-KomfortQualitätstinte auf AlkoholbasisLeicht zu öffnender Deckel mit Farbcode zur einfachen IdentifizierungDer GRAPH'IT Marker ist ideal geeignet für:ComicsArchitekturDesignLandschaftsmalereiIllustrationuvm.",
  "price": 220,
  "soldamount": 0,
  "searchable": true,
  "searchkeys": "GRAPH'IT \"Brush & Extra fine\", Twin Tip, Marker, Pinselmarker, Pinselstift, Stift, Doppelmarker, Kalligrafie, Twin Marker, 2 Spitzen Maker, Comic, Architektur, Design, Illustration, GRAPH'IT Marker, Set, Komplett-Set, Brushpen, Brush Pen, Sortiment",
  "meta_keywords": "GRAPH'IT \"Brush & Extra fine\", Twin Tip, Marker, Pinselmarker, Pinselstift, Stift, Doppelmarker, Kalligrafie, Twin Marker, 2 Spitzen Maker, Comic, Architektur, Design, Illustration, GRAPH'IT Marker, Set, Komplett-Set, Brushpen, Brush Pen, Sortiment",
  "meta_description": "Das GRAPH'IT \"Brush & Extra fine\" Marker Komplett-Set finden Sie in unserem Onlineshop. \u2713 Marker mit Qualit\u00e4tstinte auf Alkoholbasis und zwei unterschiedlichen Spitzen. \u2713 Ideal f\u00fcr unterschiedlichste Mal- und Zeichentechniken. \u2713 \u00dcberzeugen Sie sich selbst! \u2794 Jetzt g\u00fcnstig online kaufen.",
  "manufacturerid": "f58f91bac483a6ea628e9d2be7a4b1e1",
  "manufacturer_title": "pebeo",
  "url": "https:\/\/demo.makaira.io\/GRAPH-IT-Brush-Extra-fine-Marker-Komplett-Set-Display-mit-96-Markern.html",
  "maincategory": "9fb3ea945468f7c61b471c7401e7bad4",
  "maincategoryurl": "https:\/\/demo.makaira.io\/Zeichnen-Grafik-Design\/",
  "groups": {
    "DISCOUNT80": {
      "price": 2.00,
      "price_no_vat": 1.68
    }
  },
  "category": [
    {
      "catid": "cb38ac47b6005b97cd1bbed61c70fb18",
      "shopid": [
        "4"
      ],
      "path": "shop\/unser-angebot\/grafik-design\/stifte-marker\/copic-layoutmarker\/",
      "title": "Layoutmarker"
    }
  ],
  "attributeStr": [
    {
      "id": "76c7e398b67f441fdc9220e11b419945",
      "title": "Strichbreite",
      "value": "0,5 mm"
    }
  ],
  "attributeInt": [],
  "attributeFloat": [],
  "timestamp": "2019-09-27 15:34:42",
  "additionalData": {}
}

Besonderheiten:

parent
- immer id des Eltern-Produkts
attributeStr, attributeInt, attributeFloat
- Alle Attribute des Eltern-Produkts und der aktuellen Variante
- unsortiert, je Value ein Eintrag (oder Values mit eindeutigem Delimiter getrennt - werden von uns beim Import getrennt)
- je nach Value-Typ in das jeweilige Array: String (attributeStr) / Integer (attributeInt) / Float (attributeFloat)

Dokument-Typ Hersteller (manufacturer)

{
  "id": "f58f91bac483a6ea628e9d2be7a4b1e1",
  "type": "manufacturer",
  "manufacturer_title": "pebeo",
  "shortdesc": "",
  "meta_keywords": "",
  "meta_description": "",
  "timestamp": "2019-09-27 15:34:42",
  "url": "https:\/\/demo.makaira.io\/markenwelt\/pebeo-gs\/",
  "active": true,
  "shop": "4",
  "additionalData": {}
}

Dokument-Typ Kategorie (category)

{
  "id": "ffa7bbaff96b15da5579d99247e981bf",
  "type": "category",
  "active": true,
  "hidden": false,
  "sort": 26,
  "category_title": "Tempera + Gouache Farbe",
  "shortdesc": "",
  "longdesc": "",
  "meta_keywords": "",
  "meta_description": "",
  "hierarchy": "6c52086cb1550335611b759cdf8681bd\/\/baafc2f8b5664298b7fb865762918b32\/\/ffa7bbaff96b15da5579d99247e981bf",
  "depth": 3,
  "subcategories": [],
  "timestamp": "2019-09-27 15:34:42",
  "url": "https:\/\/demo.makaira.io\/farben-hilfsmittel\/kuenstlerfarben\/tempera-gouache-farbe\/",
  "shop": "4",
  "additionalData": {}
}

Besonderheiten:

depth
- Ausgehend von der Wurzel (depth = 1)
- Es müssen alle Kategorien bereitgestellt werden, da sonst keine Kategoriebäume erzeugt werden können
subcategories
- Liste aller IDs der Unterkategorien
hierarchy
- the category ids of the category path from the root category to the current category - ids separated by double slash "//"

Mapping von Makaira Namen auf OXID- und legacy Namen

Makaira Name	Makaira Name legacy	Product	Category	Manufacturer
id	-	OXID	OXID	OXID
title	mak_title	OXTITLE	OXTITLE	OXTITLE
searchkeys	mak_searchkeys	OXSEARCHKEYS	custom	custom
category_title	mak_category_title	-	OXTITLE	-
hidden	mak_hidden	-	OXHIDDEN	-
sort	mak_sort	OXSORT	OXSORT	-
active	mak_active	(gesamte Shoplogik für active)
longdesc	mak_longdesc	OXLONGDESC	OXLONGDESC	-
shortdesc	mak_shortdesc	OXSHORTDESC	OXDESC	OXSHORTDESC
onstock	mak_onstock	(gesamte Shoplogik für onstock)	-	-
manufacturerid	mak_manufacturerId	OXMANUFACTURERID	-	-
manufacturer_title		MARM_OXSEARCH_MANUFACTURERTITLE	-	OXTITLE
category_title		-	OXTITLE	-
price	mak_price	OXPRICE	-	-
insert	mak_insert	OXINSERT	-	-
soldamount	mak_soldamount	OXSOLDAMOUNT	-	-
rating	mak_rating	OXRATING	-	-
picture_url_main	mak_pic_main	OXPIC1	-	-
searchable	mak_searchable	OXISSEARCH	-	-
stock	mak_stock	OXSTOCK (OXVARSTOCK)	-	-
ean	mak_ean	OXARTNUM	-	-
maincategory	mainCategory	ID der Hauptkategorie	-	-
maincategoryurl	mainCategoryUrl	Seo URL der Hauptkategorie	-	-

Einrichtung

Konfiguration

OXID Module Versionsunterschiede

Überschreibungen im OXID eShop

Modifier (OXID)

Templating

Templating im OXID eShop

Sortierung im OXID eShop

Nicht unterstützte Features

NDJSON-Import

NDJSON-Import

Dokument-Typ Produkt (product)

Dokument-Typ Variante (variant)

Dokument-Typ Hersteller (manufacturer)

Dokument-Typ Kategorie (category)

Mapping von Makaira Namen auf OXID- und legacy Namen