DOCS

Bestellungen per Massenupload

Bestellungen per Massenupload

Erstellen Sie bis zu 200 Bestellungen gleichzeitig durch Hochladen einer CSV-Datei.

Anstatt Bestellungen einzeln zu erstellen, können Sie eine CSV-Datei hochladen, um Bestellungen in großen Mengen direkt aus dem Dashboard zu erstellen. Dies ist eine gute Option, wenn Sie viele Sendungen gleichzeitig verarbeiten müssen. Landed Costs werden für jede Zeile live berechnet und auf einem Bestätigungsbildschirm angezeigt, bevor Bestellungen übermittelt werden, sodass Sie die vollständige Kostenaufschlüsselung Ihres gesamten Batches prüfen können, bevor Sie sich festlegen.

Hinweis: Per Massenupload erstellte Bestellungen werden nicht in Ihre E-Commerce-Plattform importiert.

So laden Sie Bestellungen hoch 

  1. Gehen Sie zu Dashboard -> Orders -> Manage -> Upload orders.
  2. Laden Sie die CSV-Vorlage von der Upload-Seite herunter und füllen Sie sie mit Ihren Bestelldaten aus.
  3. Laden Sie Ihre ausgefüllte CSV hoch.
  4. Prüfen Sie den Bestätigungsbildschirm — Landed Costs werden pro Zeile berechnet und Fehler oder Warnungen werden inline angezeigt.
  5. Klicken Sie auf Create orders, um alle Ready-Bestellungen zu übermitteln.

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.

Erforderliche Spalten 

Jede Zeile repräsentiert eine Bestellung. Die erforderlichen Informationen für jede Zeile fallen in drei Kategorien:

Empfänger — Name, E-Mail, Telefonnummer und Versandadresse des Empfängers, einschließlich Zielland. 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, Menge und Preis. 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.

Land / RegionCodeSteuer-ID
ArgentinaCUILCUIL or CUIT
Argentina/Spain/PeruDNINational identity/tax number
AustraliaOSRAUSid GST registration
Australia/New ZealandLVGOverseas registered supplier (low-value goods)
BrazilCNPCNPJ (business federal tax ID)
BrazilCPFCPF (individual taxpayer registry)
CanadaGSTGST/HST registration number
ChileRUNRol Único Tributario (RUT/RUN)
European UnionEU_EORIEU EORI number
European UnionIOSSImport One-Stop Shop number
FranceFTPCFrench customs VAT (low-value)
IndiaPANPermanent Account Number
IndonesiaNPWPTax identification number
MexicoRFCRegistro Federal de Contribuyentes
MexicoCURPCURP (individuals)
NorwayVOECVAT on E-Commerce scheme number
NorwayVOEC_NONorwegian VAT number
Saudi ArabiaSA_VATSaudi VAT number
South AfricaTRNTax reference number
South KoreaPCCPersonal customs clearance code
United Arab EmiratesUAE_TRNTax registration number
United KingdomGB_EORIUK EORI number
United KingdomHMRCUK VAT registration (foreign sellers)
United StatesEINEmployer Identification Number
United StatesSSNSocial Security Number
United StatesSTAState tax ID
Any countryEORIEconomic operator registration ID
Any other countryTINGeneral tax identification number

Zusätzliche Sondercodes (FED, FTZ, DUN und die Duty- and Tax-Deferment-Konten 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.

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:

SpalteBeschreibung
Order IDDie Referenz-ID aus Ihrer CSV.
ItemsArtikelname und Menge.
RecipientName des Empfängers.
CountryDas Zielland.
Duty paid byOb das gewählte Angebot DDP ist (Sie zahlen Zölle und Steuern) oder DDU (der Empfänger zahlt bei der Zustellung, mit orangefarbenem Badge).
Service levelDas für die Tarifierung verwendete Versandservicelevel.
Item totalDer deklarierte Artikelwert.
ShippingDie berechneten Versandkosten.
DutiesDie berechneten Zölle.
TaxesDie berechneten Steuern.
FeesDie Zonos-Gebühren.
LC totalDie gesamte Landed Cost (Zölle + Steuern + Gebühren).
Grand totalDie Summe einschließlich Artikelwert und Landed Cost.
StatusReady, Warning oder Error.

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.

War diese Seite hilfreich?