Dieser Artikel bietet eine umfassende Anleitung, wie du Bestellungen effizient per CSV-Datei importierst. Optimiere dein Bestellmanagement, indem du Bestellungen in großen Mengen importierst und so die manuelle Eingabe überflüssig machst.

So bereitest du deine CSV-Datei für den Import vor

Bevor du den Import startest, stelle sicher, dass deine CSV-Datei korrekt aufgebaut ist. Lade die CSV-Vorlage herunter, um eine genaue Datenformatierung zu gewährleisten. Jede Zeile in der CSV-Datei sollte eine einzelne Position darstellen, damit Bestellungen mehrere Zeilen umfassen können. Verwende die Spalte "orderReferenceId", um Positionen mit ihren entsprechenden Bestellungen zu verknüpfen.

Hinweis: Wenn Spaltenüberschriften beim Öffnen einer CSV in Excel in einer einzigen Spalte erscheinen, probiere diese Workarounds aus:

Google Sheets verwenden : Öffnet CSV-Dateien korrekt mit getrennten Spalten.
In Excel manuell anpassen: Konvertiere die Datei in das richtige Format, indem du jede Kopfzeile in eine eigene Spalte setzt.

Füge für jede Zeile die wichtigsten Bestelldetails hinzu:

Bestellreferenz-ID
Versanddetails
Artikeldetails
URLs für jeden Druckbereich

Eine detaillierte Erklärung der erforderlichen Felder in der CSV-Datei findest du auf der Seite „Create order“ in unserer API-Dokumentation. Diese umfassende Ressource bietet wertvolle Einblicke, wie du deine Importdaten effektiv strukturierst : Create order.

Bestellungen importieren: Schritt-für-Schritt-Anleitung

Folge diesen Schritten, um deine Bestellungen nahtlos zu importieren:

Rufe deine Bestellseite auf und klicke auf die Schaltfläche „Importieren“.
Wähle den zugewiesenen Shop für deine importierten Bestellungen. Diese Bestellungen werden als aus dem ausgewählten Shop aufgegeben markiert. Du hast außerdem die Flexibilität, sie als manuelle Bestellungen zu importieren.
Lade die CSV-Datei hoch, die die Bestellungen enthält, die du importieren möchtest. Du kannst auf dieser Seite auch eine neue CSV-Vorlage herunterladen.
Überprüfe noch einmal, ob du den richtigen Zielshop und die richtige Importdatei ausgewählt hast. Wenn alles passt, klicke auf "Importieren", um den Importvorgang zu starten.
Du erhältst eine Benachrichtigung, die bestätigt, dass der Importvorgang gestartet wurde.
Sobald der Import abgeschlossen ist, senden wir dir eine E-Mail-Benachrichtigung. Diese E-Mail enthält eine Zusammenfassung des Imports, einschließlich:
- Die Gesamtzahl der Bestellungen in der Importdatei.
- Die Anzahl der erfolgreich importierten Bestellungen.
- Die Anzahl der Bestellungen, die nicht importiert werden konnten.

Zusätzlich enthält die E-Mail eine CSV-Datei mit detaillierten Importergebnissen. Diese Datei hat drei Spalten:

Bestellreferenz-ID
Ergebnis (zeigt für jede Bestellung "Erfolg" oder "Fehler" an)
Fehler (mit konkreten Gründen für Importfehler)

Verständnis der erforderlichen Parameter für die CSV-Datei zum Import

Unten findest du eine detaillierte Aufschlüsselung der erforderlichen Parameter und die entsprechenden Dokumentationsverweise, damit du die Tabelle korrekt ausfüllen kannst.

Diese Methode wird hauptsächlich von Nutzer*innen verwendet, die die Plattform testen, bevor sie unsere APIs integrieren oder Ad-hoc-Bestellungen einreichen.

Allgemeine Bestellinformationen

orderReferenceId – Zeigt die Bestellnummer im Gelato-Dashboard an. Beispiel: G-250202201217.
customerReferenceId – Interne Kunden-ID-Referenz.
orderType – Kann auf draft gesetzt werden, ist standardmäßig jedoch order.
shipmentMethodUid – Gibt die Versandmethode an: normal, standard oder express.
Währung – Währung, die für die Zahlung verwendet wird.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Wird in Analysen und in verschiedenen Bereichen der Plattform verwendet, einschließlich Zollformularen.

Versandadressdetails

Diese Parameter entsprechen den Standard‑Adressfeldern im Checkout:

shippingAddress.firstName
shippingAddress.lastName
shippingAddress.addressLine1
shippingAddress.addressLine2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName

Steuer- und Compliance-Details

shippingAddress.federalTaxId – Die bundesweite Steueridentifikationsnummer des Empfängers. Wird verwendet, um CPF/CNPJ für einen Empfänger in Brasilien anzugeben. In Brasilien obligatorisch. Um CNPJ statt CPF anzugeben, setze isBusiness auf true.
shippingAddress.stateTaxId – Die staatliche Steuer-ID der Empfängerin oder des Empfängers. Wird verwendet, um IE für eine Empfängerin bzw. einen Empfänger in Brasilien anzugeben. In Brasilien verpflichtend, wenn die Empfängerin bzw. der Empfänger ein Unternehmen ist. Um dieses Feld anzugeben, setze isBusiness auf true.
shippingAddress.registrationState – Der Code einer US‑Bundesstaatennummer oder das entsprechende Pendant in anderen Ländern, der den Bundesstaat angibt, in dem das Empfängerunternehmen registriert ist. In Brasilien verpflichtend, wenn der Empfänger ein Unternehmen ist. Um dieses Feld anzugeben, setze isBusiness auf true.

Produktinformationen

item.itemReferenceId – Entspricht der Item Reference ID in der Bestellung. Bei Bestellungen über E-Commerce-Plattformen wird dies automatisch zugewiesen. Bei manuellen Bestellungen muss es definiert werden.
item.productUid – Folge unserem Leitfaden zu Produkt-UIDs und dazu, wie man Produkte zuordnet, gemäß Gelatos Standards.
item.storeProductVariantId – Gib die Varianten-ID aus der Store-URL an, z. B. https://dashboard.gelato.com/stores/e92a3ee9-e494-41bf-a031-ca80e2fa3558/products/edit/04076663-f5a3-4701-af66-be932c676697.
item.quantity – Gibt die Anzahl der bestellten Einheiten an.
item.pageCount – Erforderlich für mehrseitige Produkte (z. B. Broschüren).

Stickerei-spezifische Parameter

Für Stickdesigns sind zusätzliche Parameter erforderlich. Lies dir für alle Details den Embroidery Guide durch.

item.adjustProductUidByFileTypes
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod

Da die CSV-basierte Auftragseinreichung eine fortlaufende Pflege von Tabellen und die Erstellung druckfertiger Dateien erfordert, empfehlen wir, schlankere Fulfillment-Optionen über eine API-Integration zu nutzen. Dieser Ansatz optimiert die Effizienz und reduziert den manuellen Aufwand. Weitere Details findest du in unserer Gelato API Documentation.

Verwandte Artikel

So lädst du Bestell-CSV-Dateien von Etsy herunter und importierst sie in Gelato

Wie kann ich meine Etsy-Produkte gesammelt zu Gelato übertragen?

Wie kann ich meine WooCommerce-Produkte in großen Mengen zu Gelato übertragen?

Produktdesigns und Mockups in großen Mengen aktualisieren

Wie importierst du Bestellungen über eine CSV-Datei?