Aus dem Englischen übersetzt. Bei Abweichungen gilt die englische Seite. Auf Englisch lesen
Exporte
CSV-Exporte von Produkten und Bestellungen: jedes Format, sein Trennzeichen und seine Spalten und wie seine IDs der API entsprechen.
Alle Exporte sind CSV, UTF-8 mit BOM (EF BB BF, damit Excel Umlaute und Akzente korrekt öffnet), zuerst eine Kopfzeile, \n als Zeilenende. Sie werden als text/csv; charset=utf-8 mit Content-Disposition: attachment gestreamt.
Was die API anders schreibt als der Download im Dashboard (ansonsten gleiche Spalten):
- Produkt-IDs sind
prod_<hex>, genau wie inGET /products(die Dashboard-Datei enthält die reine Hex-ID); - Preise haben als Text genau 2 Dezimalstellen (
"15.90"), wie in der API; - Bestellexporte enden mit der Bestell-ID der API und den Kanalreferenzen (Spalten unten).
Eine über die API exportierte Produktdatei kann mit POST /imports (csv) erneut importiert werden: Die prod_…-IDs werden erkannt, vorhandene Produkte werden also aktualisiert und nicht dupliziert.
Werte: Textfelder, die das Trennzeichen enthalten können, werden in "…" eingeschlossen; ein " darin wird zu '; # wird aus jeder Zeile entfernt (Kompatibilität mit Altsystemen). Leere Zelle = kein Wert.
Produkte: format=standard (Standard)
Trennzeichen ,. Eine Zeile pro Variante; Spalten auf Produktebene (Titel, Beschreibung, Optionsnamen, Bilder, Marke, Tags, Kategorie, Gewicht, Abmessungen) sind nur in der ersten Zeile des Produkts ausgefüllt, die folgenden Variantenzeilen wiederholen nur id und die Variantenspalten.
| Spalte | Bedeutung | Beispiel |
|---|---|---|
id | Produkt-ID (prod_…), in jeder Zeile | prod_6ad22d0ee891b034a5693aa0 |
title | Produkttitel (erste Zeile) | Ceramic mug |
description | Produktbeschreibung (HTML erlaubt, erste Zeile) | "<p>Hand made</p>" |
option_1_name | Name der ersten Option (erste Zeile) | Size |
option_1_value | Wert dieser Variante | M |
option_2_name / option_2_value | Zweite Option | Color / Blue |
option_3_name / option_3_value | Dritte Option | |
sku | SKU der Variante | TSHIRT-M-BLUE |
gtin | Barcode der Variante (EAN/UPC) | 0080694175826 |
asin | Amazon-ASIN | B009DEA0SQ |
quantity | Bestand (0, wenn leer) | 25 |
price | Preis in der Shop-Währung, 2 Dezimalstellen | 15.90 |
image_link | URL des Hauptbilds des Produkts (erste Zeile) | https://…/a.jpg |
additional_image_link | Weitere Bild-URLs des Produkts, kommagetrennt in Anführungszeichen (erste Zeile) | |
variant_image_link | Eigenes Bild dieser Variante | |
variant_additional_image_link | Weitere Bilder dieser Variante | |
brand | Marke (erste Zeile) | Acme |
tags | Tags, kommagetrennt in Anführungszeichen (erste Zeile) | "mug,kitchen" |
category | Eigene Kategoriebezeichnung des Verkäufers (erste Zeile) | Kitchen |
weight / weight_unit | Gewicht und Einheit (erste Zeile) | 0.4 / kg |
height / width / length / dimensions_units | Abmessungen und Einheit (erste Zeile) | 10 / 8 / 8 / cm |
Produkte: format=inventory
Trennzeichen ,. Eine Zeile pro Variante. Fokus auf Bestand und Preis.
| Spalte | Bedeutung | Beispiel |
|---|---|---|
id | Produkt-ID (prod_…) | prod_6ad22d0ee891b034a5693aa0 |
name | Produkttitel (nur in der ersten Zeile des Produkts) | Cotton T-shirt |
option_1_name … option_3_value | Wie bei standard | |
sku, gtin, asin | Wie bei standard | |
quantity | Bestand | 3 |
price | Preis, 2 Dezimalstellen | 19.90 |
variant_image_link, variant_additional_image_link | Wie bei standard |
Produkte: format=google
Trennzeichen | (Pipe; | und # werden aus Titeln und Beschreibungen entfernt). Eine Zeile pro Produkt, aufgebaut aus seiner ersten Variante (Feed für Google Merchant Center). Produkte mit „Prüfung erforderlich“ werden ausgelassen.
| Spalte | Bedeutung | Beispiel |
|---|---|---|
id | Angebots-ID: die SKU der ersten Variante, sonst die Produkt-ID (prod_…) | MUG-1 |
title | Titel (Zeilenumbrüche entfernt) | Ceramic mug |
description | Beschreibung als reiner Text (HTML entfernt, Zeilenumbrüche entfernt) | Hand made |
link | Die URL des Produkts auf dem ersten Marktplatz, auf dem es gelistet ist, sonst seine Nembol-Storefront-Seite | https://nembolitalia.myshopify.com/products/ceramic-mug |
image_link | Hauptbild | https://…/a.jpg |
additional_image_link | Weitere Bilder, kommagetrennt | |
availability | Immer in stock | in stock |
price | Preis der ersten Variante, 2 Dezimalstellen, ohne Währung (füge sie in Merchant Center hinzu; es ist die Shop-Währung) | 15.90 |
brand | Marke | Acme |
gtin | Barcode der ersten Variante | 0080694175826 |
condition | Immer new | new |
google_product_category | Immer leer (lege sie in Merchant Center fest) |
Bestellungen: format=standard (Standard)
Trennzeichen ; (Semikolon). Eine Zeile pro Bestellposition; Spalten auf Bestellebene stehen nur in der ersten Zeile der Bestellung.
| Spalte | Bedeutung | Beispiel |
|---|---|---|
Order | Die Bestellnummer, die der Kanal dem Verkäufer anzeigt (Shopify „#1011“ → 1011), in jeder Zeile | 1011 |
Channel | Kanal (erste Zeile) | shopify |
Date | Bestelldatum YYYY-MM-DD HH:mm:ss (erste Zeile) | 2026-10-16 21:00:00 |
Title | Titel der Position | Cotton T-shirt |
SKU | SKU der Position | TSHIRT-S-RED |
Variant | Name der Variante | S / Red |
Quantity | Menge | 1 |
Item price | Stückpreis, 2 Dezimalstellen | 9.90 |
Total price | Summe der Positionen (erste Zeile) | 19.80 |
Address1, Address2, City, Zip, Province, Country | Lieferadresse (erste Zeile) | |
Email, Name, Phone | Käufer (erste Zeile) | |
Currency | Währung der Bestellung (erste Zeile) | USD |
Subtotal, Shipping, Discount, Tax | Aufschlüsselung der Beträge, wenn der Kanal sie liefert (erste Zeile; leer bei Bestellungen, die vor der Erfassung der Steuern importiert wurden) | 19.80 / 5.00 / 0.00 / 1.60 |
Tax remitted by | seller oder der Marktplatz, der die Steuer eingezogen hat (z. B. etsy) | seller |
Order total | Was der Käufer bezahlt hat (erste Zeile) | 26.40 |
Order ID | Nur API: die Bestell-ID in der API (ord_…, wie in GET /orders), in jeder Zeile | ord_057ca3ae7912e009d01612d7 |
Order ID on channel | Nur API: die eigene Bestell-ID des Kanals, = order_id_on_channel in der API, in jeder Zeile | 18968716083351 |
Status | Nur API: der Status der Bestellung, wie status in GET /orders (awaiting_shipment, shipped, canceled, refunded…), in jeder Zeile. Stornierte und erstattete Bestellungen sind in dieser Datei enthalten: Filtere für Umsatzsummen nach dieser Spalte | shipped |
Bestellungen: format=quickbooks
Trennzeichen ,. Layout für den Rechnungsimport in QuickBooks Online (Settings → Import data → Invoices): eine Zeile pro Bestellposition, die Rechnungsspalten werden in jeder Zeile wiederholt. Die erforderlichen QuickBooks-Spalten bleiben unverändert; die API hängt am Ende zwei Spalten an, die du im Zuordnungsbildschirm von QuickBooks überspringen kannst. Stornierte und erstattete Bestellungen werden ausgelassen, damit sie nie zu Rechnungen werden; teilweise erstattete Bestellungen bleiben mit ihren ursprünglichen Beträgen enthalten (erfasse die Erstattung in QuickBooks).
| Spalte | Bedeutung | Beispiel |
|---|---|---|
InvoiceNo | <channel>-<channel order id> (eindeutig pro Kanalbestellung) | shopify-18968716083351 |
Customer | Name des Käufers, sonst E-Mail, sonst <channel> buyer | Test Buyer |
InvoiceDate / DueDate | Bestelldatum YYYY-MM-DD (Marktplatzbestellungen sind bereits bezahlt: fällig am Rechnungsdatum) | 2026-10-16 |
Item(Product/Service) | SKU, sonst Titel (≤ 100 Zeichen) | TSHIRT-S-RED |
ItemDescription | Titel und Variante | Cotton T-shirt — S / Red |
ItemQuantity | Menge | 1 |
ItemRate | Stückpreis, 2 Dezimalstellen | 9.90 |
ItemAmount | Preis × Menge, 2 Dezimalstellen | 9.90 |
Currency | Währung der Position | USD |
ItemTaxAmount | Steuer der Bestellung, nur in der ersten Zeile der Bestellung | 1.60 |
OrderId | Nur API: Bestell-ID der API (ord_…), in jeder Zeile | ord_057ca3ae7912e009d01612d7 |
OrderNumber | Nur API: die Nummer, die der Kanal anzeigt (1011) | 1011 |
Eine Bestellung, drei Referenzen
| Wo | Wert für die Shopify-Bestellung #1011 |
|---|---|
Bestell-ID der API (GET /orders, Exporte Order ID / OrderId) | ord_057ca3ae7912e009d01612d7 |
Eigene ID des Kanals (order_id_on_channel, standard Order ID on channel, in QuickBooks innerhalb von InvoiceNo) | 18968716083351 |
Nummer, die der Verkäufer auf dem Kanal sieht (API number, standard Order, QuickBooks OrderNumber) | 1011 |
Ordne Exporte der API mit Order ID / OrderId (Bestellungen) und id (Produkte) zu.
Zuletzt aktualisiert am 20. Oktober 2026
Brauchst du Hilfe?
Schreib uns, und ein Mensch antwortet, meist innerhalb eines Werktags.
Bestellungen abwickeln
Rufe Bestellungen mit vollständiger Lieferadresse ab, markiere sie als versendet, füge die Sendungsverfolgung hinzu und benachrichtige den Marktplatz.
Produkte importieren
Hol den Katalog eines verbundenen Kanals oder eine CSV-Datei aus deiner App oder deinem Agenten in Nembol: nur neue Artikel, Verknüpfung über die SKU, Filter für einen einzelnen Import, Live-Fortschritt und Rückgängigmachen.