Zum Hauptinhalt springen

[Order Intake - GCW] Wie importiere ich Bestellungen über eine CSV-Datei?

T
Verfasst von Toby Dawson
Vor über 3 Wochen aktualisiert

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:

  1. Melden Sie sich bei Gelato Connect an

  2. Fügen Sie ein Geschäft manuell hinzu.

  3. Öffnen Sie die Bestellseite in GelatoConnect Storefronts und klicken Sie auf die Schaltfläche „Importieren“.

  4. 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.

  5. 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.

  6. Ü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.

  7. Sie erhalten eine Benachrichtigung, sobald der Importvorgang gestartet wurde.

  8. 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 jedoch order eingestellt.

  • shipmentMethodUid – Gibt die Versandart an: normal, standard oder express.

  • 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.

Hat dies deine Frage beantwortet?