Orders bulksgewijs uploaden

Download het CSV-sjabloon rechtstreeks van de uploadpagina in Dashboard. Het sjabloon bevat alle verplichte en optionele kolommen — verplichte kolommen zijn gemarkeerd met een asterisk (*) in de headerrij.

Eén rij per item 

Elke rij vertegenwoordigt één item, niet één order. Rijen die dezelfde Order ID delen, worden gegroepeerd in één order met meerdere items, dus een order met drie items bestaat uit drie rijen. Waarden op orderniveau — ontvanger, adres, serviceniveau, verzendbedrag, valuta, Duty Paid By en karton — worden gelezen van de eerste rij van elke groep.

Verplichte kolommen 

De verplichte informatie voor elke rij valt in drie categorieën:

Recipient — De naam, het telefoonnummer en verzendadres van de ontvanger, inclusief bestemmingsland. E-mail is optioneel, maar wordt op formaat gevalideerd wanneer u er een opgeeft. Postcode en staat/provincie zijn alleen verplicht voor landen waarvan het adresformaat deze gebruikt — voor een land zonder postcodes (bijv. Hong Kong of Tanzania) laat u de cel leeg. Voor landen met een staat/provincielijst gebruikt u een erkende regionaam of -code (bijv. "Dubayy" of "DU" voor Dubai) zodat vervoerders de bestemming kunnen raten.

Items — Minimaal artikelnaam en prijs. Hoeveelheid is optioneel en standaard 1. Het verstrekken van een HS-code en land van herkomst verbetert classificatienauwkeurigheid en kan verwerkingstijd op het bevestigingsscherm verkorten.

Shipping — Een serviceniveaucode die overeenkomt met een op uw account geconfigureerde vervoerder (bijv. fedex.international_priority, ups_worldwide_expedited). De kolom Shipping Amount is optioneel: voer een bedrag in (0 is toegestaan) om het als verzendkosten van de order te gebruiken, of laat leeg en een carrier-rate-schatting wordt berekend voor uw serviceniveau. Berekende rijen kosten elk een paar extra seconden op het bevestigingsscherm, en de uiteindelijke carrierkosten bij labelaanmaak kunnen afwijken van de schatting. Sommige bestemmingen kunnen niet automatisch worden gerated (fout "service not available for destination country") — voer een verzendbedrag in op alleen die rijen; lege en ingevulde rijen kunnen vrij mixen in één bestand.

Optionele kolommen 

Recipient tax ID — Gebruik de kolommen Tax ID Type en Tax ID Number om een belasting-ID van de ontvanger op de order op te nemen. Het type moet een van onderstaande codes zijn (niet hoofdlettergevoelig). Geef beide kolommen samen op; een type zonder nummer (of omgekeerd) wordt als fout gemarkeerd op het bevestigingsscherm. De belasting-ID wordt opgeslagen op de ontvanger van de order en doorgegeven aan de vervoerder wanneer een label wordt aangemaakt. Voor orders met meerdere artikelen wordt de belasting-ID van de eerste rij van de order gebruikt.

Gebruik de landspecifieke code waar die bestaat; voor elk land dat niet is vermeld, gebruik TIN.

Extra speciale codes (FED, FTZ, DUN, en de DAN/TAN/DTF-rekeningen voor uitstel van invoerrechten en belastingen) worden geaccepteerd wanneer uw Zonos-vertegenwoordiger u opdraagt er een te gebruiken.

Duty Paid By — Optioneel DDP of DDU per order. Laat leeg voor standaardgedrag: DDP waar de bestemming het ondersteunt, met automatische fallback naar DDU waar het niet ondersteund wordt. Expliciete DDP is strikt — rijen geven een fout in plaats van te fallbacken — en DDU maakt de ontvanger verantwoordelijk voor invoerrechten en belastingen bij levering. Het bevestigingsscherm en de resultaten-download tonen welke van beide elke order daadwerkelijk heeft gekregen, met een oranje badge op DDU-rijen. Voor orders met meerdere artikelen wint de eerste opgegeven waarde, en conflicterende waarden zijn een fout.

Carton quantity — Als een order in meerdere identieke dozen wordt verzonden, stel Carton Quantity in naast de kolommen Carton Length/Width/Height/Weight. De kartonkolommen beschrijven één doos (het gewicht is het gewicht van één ingepakte doos), en de hoeveelheid vermenigvuldigt dit — bijvoorbeeld 360 eenheden verpakt 30 per doos zou de doosafmetingen, het gewicht van één volle doos en een kartonaantal van 12 gebruiken. Leeg betekent 1. Orders met gemengde doosformaten kunnen niet in de CSV worden beschreven — laat de kartonkolommen leeg op die orders en Zonos doost ze automatisch op basis van artikelgewichten.

Tips 

• Gebruik de exacte serviceniveaucodes getoond in uw carrier settings. Rijen met niet-herkende serviceniveaucodes tonen een waarschuwing op het bevestigingsscherm.
• US-territoria verschillen: de US Virgin Islands gebruiken hun eigen landcode (VI) en verzenden als internationaal, terwijl Puerto Rico US gebruikt en als binnenlands verzendt.
• Vervoerders (vooral UPS) weigeren P.O. Box-bezorgadressen — rijen met "P.O. Box" in een adresregel kunnen falen bij rating met een generieke service-availability-fout. Gebruik waar mogelijk een straatadres.
• Typografische leestekens uit Word of Excel (gebogen aanhalingstekens, en/em-streepjes) worden automatisch gecorrigeerd. Vraagtekens waar accentletters horen te staan duiden op verlies van encoding — die rijen worden gemarkeerd zodat u de tekst opnieuw kunt invoeren.
• Voor bestemmingslanden die een staat- of provinciecode vereisen (bijv. Brazilië, VS, Canada), zorg dat het staatsveld is ingevuld met de juiste ISO-code.
• De Order ID is verplicht en moet uniek zijn over uw account, inclusief eerdere uploads — een ID dat ooit eerder is gebruikt (zelfs in een bestand van een eerder seizoen of een geannuleerde order) wordt afgewezen bij orderaanmaak. Bestand hergebruiken? Voeg een suffix toe aan de ID's (bijvoorbeeld ACALB-33 voor volume 33). De ID verschijnt op het bevestigingsscherm en gaat door naar de aangemaakte order als referentie voor de handelaar.
• Namen van ontvangers, adressen, plaatsnaam, staat/provincie, bedrijfsnaam en artikelnamen moeten Latijnse tekens gebruiken. Niet-Latijnse schriften zoals Japans of Arabisch worden geweigerd.
• Volledig lege rijen worden genegeerd, dus overtollige lege rijen aan het einde van uw bestand zijn onschadelijk.

Elke kolom in het standaardsjabloon, in sjabloonvolgorde. Conditional betekent dat de kolom alleen in bepaalde gevallen verplicht is — zie Verplichte kolommen hierboven voor de details.

Japan Post gebruikt zijn eigen CSV-sjabloon, op dezelfde manier gedownload van de uploadpagina. Het heeft geen serviceniveaukolom — de upload wijst het eerste serviceniveau van de vervoerder toe en u selecteert er opnieuw een in de labelflow — en geen kolom voor kartonaantal, aangezien deze uploads altijd als één karton worden verzonden.

Kolommen die optioneel zijn in het standaardsjabloon maar verplicht zijn voor Japan Post:

• HS code
• Country of origin
• Item weight — de gewichtseenheid blijft hier optioneel en is standaard gram
• Postal code
• State/province
• Shipping amount — anders dan in het standaardsjabloon kan dit niet leeg blijven

Het sjabloon voegt ook Japan Post-verzendvelden toe die op de order worden opgeslagen en op de zending worden toegepast wanneer een label wordt aangemaakt: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number en Non-commercial. Alle zijn optioneel. De tekstvelden accepteren tot 25 tekens, en Non-commercial accepteert alleen true of false.

Na upload toont een bevestigingsscherm de berekende landed cost-uitsplitsing voor elke order voordat iets wordt aangemaakt. Het scherm toont:

Rijen kunnen $0 invoerrechten, belastingen en fees tonen wanneer de bestemming geen importkosten heft bij de gedeclareerde waarde van de zending (onder de de minimis-drempel van het land) — de landed cost is echt nul, niet ontbrekend, en verzending is de enige kosten voor die orders.

De knop Create orders toont het aantal orders dat wordt ingediend (bijv. Create 17 orders). Alleen rijen met status Ready of Warning zijn inbegrepen — rijen met fouten zijn uitgesloten.

Gebruik Download results CSV om de volledige offerte-uitsplitsing te exporteren (geselecteerd tarief, artikel totaal, verzending, invoerrechten, belastingen, fees en totalen per order) — nuttig om uw klanten te offreren voordat orders worden aangemaakt. Klik op Start over om de upload te negeren en opnieuw te beginnen met een herzien bestand.

Wanneer u Shipping Amount leeg laat, toont de serviceniveaukolom het tarief dat overeenkomt met het serviceniveau in uw CSV. Als uw gevraagde serviceniveau niet beschikbaar is voor een bestemming, wordt het dichtstbijzijnde beschikbare tarief geselecteerd en gemarkeerd met een Different service level-badge — of, wanneer meerdere alternatieven bestaan, laat een Select a rate-dropdown u kiezen voordat de order kan worden aangemaakt.

Problemen worden inline op het bevestigingsscherm gemarkeerd.

Fouten 

Rijen met fouten zijn uitgesloten wanneer u op Create orders klikt. Los het probleem op in uw CSV en upload opnieuw om die rijen op te nemen. Veelvoorkomende fouten zijn:

• Low-value orders not allowed — De orderwaarde ligt onder de minimumdrempel voor uw winkel.
• Invalid state code — De staat- of provinciecode is niet geldig voor het bestemmingsland. Verplicht voor landen zoals Brazilië, de VS en Canada.
• Missing required field — Een verplichte kolom is leeg of kan niet worden geparseerd.
• Order ID already exists — Elke order-ID moet uniek zijn over uw account, inclusief orders van eerdere uploads. Rijen met reeds gebruikte ID's falen bij aanmaak terwijl de rest van het bestand slaagt — upload alleen de mislukte rijen opnieuw met nieuwe ID's (een suffix zoals -33 werkt goed).

Waarschuwingen 

Rijen met waarschuwingen zijn inbegrepen in de indiening. Beoordeel ze voordat u op Create orders klikt. Veelvoorkomende waarschuwingen zijn:

• Service level not configured — De serviceniveaucode in uw CSV is niet gekoppeld aan uw account. De order wordt aangemaakt maar rate mogelijk niet correct. Verifieer uw carrier settings of werk de serviceniveaucode in uw CSV bij.

De huidige uploadlimiet is 200 orders per CSV. Orders worden ingediend in batches van maximaal 50 per API-aanroep — als uw upload meer dan 50 ready orders bevat, worden ze automatisch in meerdere batches verwerkt.

Coming soon: Een toekomstige update verwijdert de limiet van 200 orders en voegt verwerking van achtergrondtaken toe voor grotere uploads.