Bestellungen per Massenupload

Laden Sie die CSV-Vorlage direkt von der Upload-Seite im Dashboard herunter. Die Vorlage enthält alle erforderlichen und optionalen Spalten — erforderliche Spalten sind in der Kopfzeile mit einem Sternchen (*) markiert.

Eine Zeile pro Artikel 

Jede Zeile stellt einen Artikel dar, nicht eine Bestellung. Zeilen mit derselben Order ID werden zu einer einzigen Bestellung mit mehreren Artikeln zusammengefasst, sodass eine Bestellung mit drei Artikeln aus drei Zeilen besteht. Werte auf Bestellebene — Empfänger, Adresse, Servicelevel, Versandbetrag, Währung, Duty Paid By und Karton — werden aus der ersten Zeile jeder Gruppe gelesen.

Erforderliche Spalten 

Die erforderlichen Informationen für jede Zeile fallen in drei Kategorien:

Empfänger — Name, Telefonnummer und Versandadresse des Empfängers, einschließlich Zielland. Die E-Mail-Adresse ist optional, wird aber auf ihr Format geprüft, wenn Sie eine angeben. Postleitzahl und Bundesstaat/Provinz sind nur für Länder erforderlich, deren Adressformat sie verwendet — bei einem Land ohne Postleitzahlen (z. B. Hongkong oder Tansania) lassen Sie die Zelle einfach leer. Für Länder mit einer Bundesstaats-/Provinzliste verwenden Sie einen anerkannten Regionsnamen oder -code (z. B. „Dubayy“ oder „DU“ für Dubai), damit Carrier das Ziel tarifieren können.

Artikel — Mindestens Artikelname und Preis. Die Menge ist optional und wird standardmäßig auf 1 gesetzt. Die Angabe eines HS-Codes und Ursprungslandes verbessert die Klassifizierungsgenauigkeit und kann die Bearbeitungszeit auf dem Bestätigungsbildschirm verkürzen.

Versand — Ein Servicelevel-Code, der einem auf Ihrem Konto konfigurierten Carrier entspricht (z. B. fedex.international_priority, ups_worldwide_expedited). Die Spalte Shipping Amount ist optional: Geben Sie einen Betrag ein (0 ist erlaubt), um ihn als Versandkosten der Bestellung zu verwenden, oder lassen Sie sie leer — dann wird eine Carrier-Tarifschätzung für Ihr Servicelevel berechnet. Berechnete Zeilen benötigen auf dem Bestätigungsbildschirm jeweils ein paar Sekunden mehr, und die endgültige Carrier-Gebühr bei der Label-Erstellung kann von der Schätzung abweichen. Manche Ziele können nicht automatisch tarifiert werden (Fehler „service not available for destination country“) — geben Sie für nur diese Zeilen einen Versandbetrag ein; leere und ausgefüllte Zeilen können frei in einer Datei gemischt werden.

Optionale Spalten 

Steuer-ID des Empfängers — Verwenden Sie die Spalten Tax ID Type und Tax ID Number, um eine Steuerkennnummer des Empfängers in der Bestellung anzugeben. Der Typ muss einer der unten stehenden Codes sein (Groß-/Kleinschreibung wird ignoriert). Geben Sie beide Spalten zusammen an; ein Typ ohne Nummer (oder umgekehrt) wird auf dem Bestätigungsbildschirm als Fehler markiert. Die Steuer-ID wird beim Empfänger der Bestellung gespeichert und an den Carrier übergeben, wenn ein Label erstellt wird. Bei Bestellungen mit mehreren Artikeln wird die Steuer-ID aus der ersten Zeile der Bestellung verwendet.

Verwenden Sie den länderspezifischen Code, sofern einer vorhanden ist; für jedes nicht aufgeführte Land verwenden Sie TIN.

Zusätzliche Sondercodes (FED, FTZ, DUN und die Zoll- und Steueraufschubkonten DAN/TAN/DTF) werden akzeptiert, wenn Ihr Zonos-Ansprechpartner Sie zur Verwendung eines Codes anweist.

Duty Paid By — Optionales DDP oder DDU pro Bestellung. Lassen Sie es leer für das Standardverhalten: DDP, wo das Ziel es unterstützt, mit automatischem Fallback auf DDU, wo nicht. Ein explizites DDP ist strikt — Zeilen führen zu Fehlern statt Fallback — und DDU macht den Empfänger für Zölle und Steuern bei der Zustellung verantwortlich. Der Bestätigungsbildschirm und der Ergebnis-Download zeigen, auf welches jede Bestellung tatsächlich gelandet ist, mit einem orangefarbenen Badge bei DDU-Zeilen. Bei Bestellungen mit mehreren Artikeln gilt der zuerst angegebene Wert, und widersprüchliche Werte sind ein Fehler.

Kartonmenge — Wenn eine Bestellung in mehreren identischen Kartons versendet wird, setzen Sie Carton Quantity zusammen mit den Spalten Carton Length/Width/Height/Weight. Die Kartonspalten beschreiben einen Karton (das Gewicht ist das Gewicht eines einzelnen gepackten Kartons), und die Menge multipliziert ihn — zum Beispiel würden 360 Einheiten, die zu 30 pro Karton gepackt sind, die Kartonabmessungen, das Gewicht eines vollen Kartons und eine Kartonmenge von 12 verwenden. Leer bedeutet 1. Bestellungen mit gemischten Kartongrößen können in der CSV nicht beschrieben werden — lassen Sie die Kartonspalten bei diesen Bestellungen leer, und Zonos verpackt sie automatisch anhand der Artikelgewichte.

Tipps 

• Verwenden Sie die exakten Servicelevel-Codes aus Ihren Carrier-Einstellungen. Zeilen mit nicht erkannten Servicelevel-Codes zeigen auf dem Bestätigungsbildschirm eine Warnung.
• US-Territorien unterscheiden sich: Die US Virgin Islands verwenden ihren eigenen Ländercode (VI) und versenden international, während Puerto Rico US verwendet und inland versendet.
• Carrier (insbesondere UPS) lehnen Postfach-Lieferadressen ab — Zeilen mit „P.O. Box“ in einer Adresszeile können bei der Tarifierung mit einem generischen Service-Verfügbarkeitsfehler fehlschlagen. Verwenden Sie nach Möglichkeit eine Straßenadresse.
• Typografische Satzzeichen aus Word oder Excel (typografische Anführungszeichen, Gedankenstriche) werden automatisch korrigiert. Fragezeichen, wo Akzentbuchstaben sein sollten, deuten darauf hin, dass die Datei ihre Kodierung verloren hat — diese Zeilen werden markiert, damit Sie den Text erneut eingeben können.
• Für Zielländer, die einen Bundesstaats- oder Provinzcode erfordern (z. B. Brasilien, USA, Kanada), stellen Sie sicher, dass das Bundesstaatsfeld mit dem korrekten ISO-Code ausgefüllt ist.
• Die Order ID ist erforderlich und muss über Ihr Konto hinweg eindeutig sein, einschließlich früherer Uploads — eine ID, die jemals zuvor verwendet wurde (auch in einer Datei aus einer früheren Saison oder bei einer stornierten Bestellung), wird bei der Bestellerstellung abgelehnt. Datei wiederverwenden? Fügen Sie den IDs ein Suffix hinzu (z. B. ACALB-33 für Band 33). Die ID erscheint auf dem Bestätigungsbildschirm und wird als Händlerreferenz in die erstellte Bestellung übernommen.
• Empfängernamen, Adressen, Stadt, Bundesstaat/Provinz, Firmenname und Artikelnamen müssen lateinische Zeichen verwenden. Nicht-lateinische Schriften wie Japanisch oder Arabisch werden abgelehnt.
• Vollständig leere Zeilen werden ignoriert, sodass nachgestellte leere Zeilen in Ihrer Datei unbedenklich sind.

Jede Spalte der Standardvorlage, in der Reihenfolge der Vorlage. Bedingt bedeutet, dass die Spalte nur in bestimmten Fällen erforderlich ist — Details siehe Erforderliche Spalten oben.

Japan Post verwendet eine eigene CSV-Vorlage, die auf dieselbe Weise von der Upload-Seite heruntergeladen wird. Sie hat keine Servicelevel-Spalte — der Upload weist das erste Servicelevel des Carriers zu, und Sie wählen im Label-Flow eines aus — und keine Kartonmengen-Spalte, da diese Uploads immer als ein einzelner Karton versendet werden.

Spalten, die in der Standardvorlage optional sind, aber für Japan Post erforderlich sind:

• HS code
• Country of origin
• Item weight — die Gewichtseinheit bleibt hier optional und ist standardmäßig Gramm
• Postal code
• State/province
• Shipping amount — anders als bei der Standardvorlage darf dieses Feld nicht leer bleiben

Die Vorlage fügt außerdem Japan-Post-Versandfelder hinzu, die bei der Bestellung gespeichert und bei der Label-Erstellung auf die Sendung angewendet werden: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number und Non-commercial. Alle sind optional. Die Textfelder akzeptieren bis zu 25 Zeichen, und Non-commercial akzeptiert nur true oder false.

Nach dem Upload zeigt ein Bestätigungsbildschirm die berechnete Landed-Cost-Aufschlüsselung für jede Bestellung an, bevor etwas erstellt wird. Der Bildschirm zeigt:

Zeilen können 0 $ Zölle, Steuern und Gebühren anzeigen, wenn das Ziel bei dem deklarierten Sendungswert keine Einfuhrgebühren erhebt (unter der De-minimis-Schwelle des Landes) — die Landed Cost ist dann tatsächlich null, nicht fehlend, und Versand ist bei diesen Bestellungen die einzige Kostenposition.

Die Schaltfläche Create orders zeigt die Anzahl der Bestellungen an, die übermittelt werden (z. B. Create 17 orders). Nur Zeilen mit dem Status Ready oder Warning werden einbezogen — Zeilen mit Fehlern sind ausgeschlossen.

Verwenden Sie Download results CSV, um die vollständige Angebotsaufschlüsselung (gewählter Tarif, Artikelsumme, Versand, Zölle, Steuern, Gebühren und Summen pro Bestellung) zu exportieren — nützlich, um Ihre Kunden zu quotieren, bevor Bestellungen erstellt werden. Klicken Sie auf Start over, um den Upload zu verwerfen und mit einer überarbeiteten Datei von vorne zu beginnen.

Wenn Sie Shipping Amount leer lassen, zeigt die Servicelevel-Spalte den Tarif, der zu Ihrem Servicelevel in der CSV passt. Wenn Ihr gewünschtes Servicelevel für ein Ziel nicht verfügbar ist, wird der nächstbeste verfügbare Tarif ausgewählt und mit einem Badge Different service level markiert — oder, wenn mehrere Alternativen existieren, lässt ein Dropdown Select a rate Sie vor der Bestellerstellung wählen.

Probleme werden inline auf dem Bestätigungsbildschirm markiert.

Fehler 

Zeilen mit Fehlern werden ausgeschlossen, wenn Sie auf Create orders klicken. Beheben Sie das Problem in Ihrer CSV und laden Sie erneut hoch, um diese Zeilen einzubeziehen. Häufige Fehler umfassen:

• Low-value orders not allowed — Der Bestellwert liegt unter dem Mindestschwellenwert für Ihren Shop.
• Invalid state code — Der Bundesstaats- oder Provinzcode ist für das Zielland nicht gültig. Erforderlich für Länder wie Brasilien, die USA und Kanada.
• Missing required field — Eine erforderliche Spalte ist leer oder kann nicht geparst werden.
• Order ID already exists — Jede Order ID muss über Ihr Konto hinweg eindeutig sein, einschließlich Bestellungen aus früheren Uploads. Zeilen mit bereits verwendeten IDs schlagen bei der Erstellung fehl, während der Rest der Datei erfolgreich ist — laden Sie nur die fehlgeschlagenen Zeilen mit neuen IDs erneut hoch (ein Suffix wie -33 funktioniert gut).

Warnungen 

Zeilen mit Warnungen werden in die Übermittlung einbezogen. Prüfen Sie diese, bevor Sie auf Create orders klicken. Häufige Warnungen umfassen:

• Service level not configured — Der Servicelevel-Code in Ihrer CSV ist nicht mit Ihrem Konto verbunden. Die Bestellung wird erstellt, tarifiert aber möglicherweise nicht korrekt. Überprüfen Sie Ihre Carrier-Einstellungen oder aktualisieren Sie den Servicelevel-Code in Ihrer CSV.

Das aktuelle Upload-Limit beträgt 200 Bestellungen pro CSV. Bestellungen werden in Stapeln von bis zu 50 pro API-Aufruf übermittelt — wenn Ihr Upload mehr als 50 bereite Bestellungen enthält, werden sie automatisch in mehreren Stapeln verarbeitet.

Demnächst: Ein zukünftiges Update hebt die Obergrenze von 200 Bestellungen auf und fügt Hintergrundverarbeitung für größere Uploads hinzu.