In diesem Artikel finden Sie eine umfassende Anleitung, wie Sie Bestellungen effizient per CSV-Datei importieren. Vereinfachen Sie Ihr Auftragsmanagement, indem Sie mehrere Bestellungen auf einmal importieren – so sparen Sie sich die mühsame manuelle Eingabe.
So bereiten Sie Ihre CSV-Datei für den Import vor
Bevor Sie mit dem Import beginnen, stellen Sie sicher, dass Ihre CSV-Datei richtig aufgebaut ist. Laden Sie die CSV-Vorlage herunter, um eine korrekte Datenformatierung zu gewährleisten. Jede Zeile in der CSV-Datei sollte einen Einzelfaden abbilden, sodass Bestellungen über mehrere Zeilen verteilt werden können. Verwenden Sie die Spalte "orderReferenceId", um Einzelfäden den jeweiligen Bestellungen zuzuordnen.
Hinweis: Wenn die Spaltenüberschriften in Excel alle in einer einzigen Spalte angezeigt werden, probieren Sie diese Lösungen aus:
Google Sheets verwenden: Öffnet CSV-Dateien so, dass die Spalten richtig getrennt sind.
Manuell in Excel anpassen: Bringen Sie die Datei ins richtige Format, indem Sie jede Überschrift in eine eigene Spalte setzen.
Fügen Sie für jede Zeile die wichtigsten Bestelldetails hinzu:
Bestellreferenz-ID
Versanddetails
Artikeldetails
URLs für jede Druckfläche
Eine ausführliche Erklärung zu den erforderlichen Feldern in der CSV-Datei finden Sie auf der Seite „Bestellung einreichen“ in unserer API-Dokumentation.
Bestellungen importieren: Schritt-für-Schritt-Anleitung
Folgen Sie diesen Schritten, um Ihre Bestellungen ganz einfach zu importieren:
Melden Sie sich bei Gelato Connect an
Gehen Sie zu https://storefronts.gelato.com/stores/list
Fügen Sie ein Geschäft manuell hinzu.
Gehen Sie zu https://storefronts.gelato.com/orders/list
Öffnen Sie die Bestellseite in GelatoConnect Storefronts und klicken Sie auf die Schaltfläche „Importieren“.
Wählen Sie das vorgesehene Geschäft für Ihre importierten Bestellungen aus. Diese Bestellungen werden so gekennzeichnet, als wären sie aus dem ausgewählten Geschäft aufgegeben worden. Sie haben außerdem die Möglichkeit, diese Bestellungen als manuelle Aufträge zu importieren.
Laden Sie die CSV-Datei hoch, die die Bestellungen enthält, die Sie importieren möchten. Sie können auch eine neue CSV-Vorlage von dieser Seite herunterladen.
Überprüfen Sie noch einmal, ob Sie das richtige Zielgeschäft und die richtige Importdatei ausgewählt haben. Wenn alles passt, klicken Sie auf "Importieren", um den Importvorgang zu starten.
Sie erhalten eine Benachrichtigung, sobald der Importvorgang gestartet wurde.
Sobald der Import abgeschlossen ist, erhalten Sie eine E-Mail-Benachrichtigung von uns. In dieser E-Mail finden Sie eine Zusammenfassung des Imports, unter anderem mit folgenden Informationen:
Die Gesamtanzahl der Bestellungen in der Importdatei.
Die Anzahl der erfolgreich importierten Bestellungen.
Die Anzahl der Bestellungen, die nicht importiert werden konnten.
Außerdem enthält die E-Mail eine CSV-Datei mit detaillierten Importergebnissen. Diese Datei besteht aus drei Spalten:
Bestellreferenznummer
Ergebnis (zeigt für jede Bestellung an, ob sie erfolgreich war oder nicht)
Fehler (mit genauen Gründen für eventuelle Importprobleme)
So verstehen Sie die erforderlichen Parameter für den CSV-Import
Im Folgenden finden Sie eine ausführliche Übersicht der erforderlichen Parameter sowie die entsprechenden Dokumentationshinweise, damit Sie die Tabelle korrekt ausfüllen können.
Diese Methode wird vor allem von Nutzerinnen und Nutzern verwendet, die unsere Plattform testen möchten, bevor sie unsere APIs integrieren oder einzelne Aufträge einreichen.
Allgemeine Bestellinformationen
orderReferenceId – Zeigt die Bestellnummer im Gelato Dashboard an. Beispiel:
G-250202201217
.customerReferenceId – Interne Kunden-ID-Referenz.
orderType – Kann als
draft
festgelegt werden, standardmäßig ist jedochorder
eingestellt.shipmentMethodUid – Gibt die Versandart an:
normal
,standard
oderexpress
.Währung – Die Währung, die für die Bezahlung verwendet wird.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Wird in Analysen und verschiedenen Bereichen der Plattform verwendet, einschließlich Zollformularen.
Versandadressdetails
Diese Parameter entsprechen den üblichen Adressfeldern:
shippingAddress.vorname
shippingAddress.nachname
Versandadresse.Adresszeile 1
shippingAddress.Adresszusatz
Versandadresse.Stadt
shippingAddress.postCode
shippingAddress.Bundesland
Versandadresse.Land
shippingAddress.email
Versandadresse.Telefon
shippingAddress.firmenname
Produktinformationen
item.itemReferenceId – Entspricht der
Artikel-Referenz-ID
in der Bestellung. Bei Bestellungen über E-Commerce-Plattformen wird diese automatisch vergeben. Bei manuellen Bestellungen muss sie festgelegt werden.item.productUid
item.storeProductVariantId
item.quantity – Gibt an, wie viele Einheiten bestellt wurden.
item.pageCount – Erforderlich für Produkte mit mehreren Seiten (z. B. Broschüren).
Stickerei-spezifische Parameter
Für Stickdesigns sind weitere Angaben erforderlich.
Artikel-UID je nach Dateityp anpassen
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 Auftragserstellung per CSV eine fortlaufende Pflege von Tabellen und die Vorbereitung druckfertiger Dateien erfordert, empfehlen wir Ihnen, auf effizientere Fulfillment-Optionen per API-Integration zu setzen. So sparen Sie Zeit und minimieren den manuellen Aufwand.