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)
- Felder mit logarithmisch normierten Werten für:
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 | - | - |