Massuppladdning av order

Ladda ner CSV-mallen direkt från uppladdningssidan i Dashboard. Mallen inkluderar alla obligatoriska och valfria kolumner — obligatoriska kolumner markeras med en asterisk (*) i rubrikraden.

En rad per artikel 

Varje rad representerar en artikel, inte en order. Rader som delar samma Order ID grupperas till en enda order med flera artiklar, så en order med tre artiklar blir tre rader. Order-nivåvärden — mottagare, adress, servicenivå, fraktbelopp, valuta, duty paid by och kartong — läses från den första raden i varje grupp.

Obligatoriska kolumner 

Den obligatoriska informationen för varje rad faller in i tre kategorier:

Recipient — Namn, telefonnummer och leveransadress för mottagaren, inklusive destinationsland. E-post är valfritt, men valideras för korrekt format om ni anger en. Postnummer och stat/provins krävs endast för länder vars adressformat använder dem — för ett land utan postnummer (t.ex. Hongkong eller Tanzania) lämnar ni helt enkelt cellen tom. För länder med en lista över stater/provinser, använd ett erkänt regionsnamn eller kod (t.ex. "Dubayy" eller "DU" för Dubai) så att transportörer kan prissätta destinationen.

Items — Minst artikelnamn och pris. Kvantitet är valfritt och standardvärdet är 1. Att ange en HS-kod och ursprungsland förbättrar klassificeringsnoggrannheten och kan minska bearbetningstiden på bekräftelseskärmen.

Shipping — En servicenivåkod som matchar en transportör konfigurerad på ert konto (t.ex. fedex.international_priority, ups_worldwide_expedited). Kolumnen Shipping Amount är valfri: ange ett belopp (0 är tillåtet) för att använda det som orderns fraktavgift, eller lämna den tom så beräknas ett transportörpris för er servicenivå. Beräknade rader tar några extra sekunder vardera på bekräftelseskärmen, och den slutliga transportöravgiften vid etikettskapande kan skilja sig från uppskattningen. Vissa destinationer kan inte prissättas automatiskt (felet "service not available for destination country") — ange ett fraktbelopp endast på de raderna; tomma och ifyllda rader kan blandas fritt i samma fil.

Valfria kolumner 

Recipient tax ID — Använd kolumnerna Tax ID Type och Tax ID Number för att inkludera ett mottagarskatt-ID på ordern. Typen måste vara en av koderna nedan (skiftlägesokänslig). Ange båda kolumnerna tillsammans; en typ utan nummer (eller tvärtom) flaggas som ett fel på bekräftelseskärmen. Skatt-ID:t sparas på orderns mottagare och skickas till transportören när en etikett skapas. För order med flera artiklar används skatt-ID:t från orderns första rad.

Använd den landsspecifika koden där en sådan finns; för alla länder som inte listas, använd TIN.

Ytterligare specialkoder (FED, FTZ, DUN samt DAN/TAN/DTF-kontona för uppskov med tull och skatt) accepteras när er Zonos-representant instruerar er att använda en.

Duty Paid By — Valfritt DDP eller DDU per order. Lämna tomt för standardbeteende: DDP där destinationen stöder det, med automatisk fallback till DDU där det inte stöds. Ett explicit DDP är strikt — rader ger fel istället för fallback — och DDU gör mottagaren ansvarig för tull och skatter vid leverans. Bekräftelseskärmen och resultatnedladdningen visar vilket varje order faktiskt landade på, med en orange badge på DDU-rader. För order med flera artiklar vinner det första angivna värdet, och motstridiga värden är ett fel.

Carton quantity — Om en order skickas i flera identiska lådor, ange Carton Quantity tillsammans med kolumnerna Carton Length/Width/Height/Weight. Kartongkolumnerna beskriver en låda (vikten är vikten av en enskild packad låda), och kvantiteten multiplicerar den — till exempel, 360 enheter packade 30 per låda skulle använda låddimensionerna, vikten av en full låda och en carton quantity på 12. Tomt betyder 1. Order med blandade lådstorlekar kan inte beskrivas i CSV — lämna kartongkolumnerna tomma på de orderna så packar Zonos dem automatiskt baserat på artikelvikter.

Tips 

• Använd exakt de servicenivåkoder som visas i era transportörinställningar. Rader med okända servicenivåkoder visar en varning på bekräftelseskärmen.
• Amerikanska territorier skiljer sig: Amerikanska Jungfruöarna använder sin egen landskod (VI) och skickas som internationellt, medan Puerto Rico använder US och skickas som inrikes.
• Transportörer (särskilt UPS) avvisar P.O. Box-leveransadresser — rader med "P.O. Box" i en adressrad kan misslyckas med prissättning med ett generiskt fel om att tjänsten inte är tillgänglig. Använd en gatuadress där det är möjligt.
• Typografisk interpunktion från Word eller Excel (krulliga citattecken, en/em-streck) korrigeras automatiskt. Frågetecken där accentuerade bokstäver borde vara indikerar att filen förlorat sin kodning — de raderna flaggas så att ni kan ange texten igen.
• För destinationsländer som kräver en stats- eller provinskod (t.ex. Brasilien, USA, Kanada), se till att statsfältet är ifyllt med korrekt ISO-kod.
• Order ID är obligatoriskt och måste vara unikt över hela ert konto, inklusive tidigare uppladdningar — ett ID som någonsin använts tidigare (även i en fil från en tidigare säsong eller en avbruten order) avvisas vid orderskapande. Återanvänder ni en fil? Lägg till ett suffix till ID:n (till exempel ACALB-33 för volym 33). ID:t visas på bekräftelseskärmen och förs vidare till den skapade ordern som handlarens referens.
• Mottagarnamn, adresser, ort, stat/provins, företagsnamn och artikelnamn måste använda latinska tecken. Icke-latinska skriftsystem som japanska eller arabiska avvisas.
• Helt tomma rader ignoreras, så överflödiga tomma rader i slutet av filen är ofarliga.

Alla kolumner i standardmallen, i mallens ordning. Villkorlig betyder att kolumnen endast krävs i vissa fall — se Obligatoriska kolumner ovan för detaljer.

Japan Post använder sin egen CSV-mall, som laddas ner från uppladdningssidan på samma sätt. Den har ingen kolumn för servicenivå — uppladdningen tilldelar transportörens första servicenivå och ni väljer en igen i etikettflödet — och ingen kolumn för carton quantity, eftersom dessa uppladdningar alltid skickas som en enda kartong.

Kolumner som är valfria i standardmallen men obligatoriska för Japan Post:

• HS code
• Country of origin
• Item weight — viktenheten förblir valfri här och standardvärdet är gram
• Postal code
• State/province
• Shipping amount — till skillnad från standardmallen kan denna inte lämnas tom

Mallen lägger även till Japan Post-fraktfält som sparas på ordern och tillämpas på försändelsen när en etikett skapas: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number och Non-commercial. Alla är valfria. Textfälten accepterar upp till 25 tecken, och Non-commercial accepterar endast true eller false.

Efter uppladdning visar en bekräftelseskärm den beräknade landed cost-uppdelningen för varje order innan något skapas. Skärmen visar:

Rader kan visa 0 USD i tull, skatter och avgifter när destinationen inte tar ut importavgifter vid försändelsens deklarerade värde (den är under landets de minimis-tröskel) — landed cost är genuint noll, inte saknad, och frakt är den enda kostnaden för de orderna.

Knappen Create orders visar antalet order som kommer att skickas in (t.ex. Create 17 orders). Endast rader med status Ready eller Warning inkluderas — rader med fel exkluderas.

Använd Download results CSV för att exportera hela offertuppdelningen (valt pris, artikeltotal, frakt, tull, skatter, avgifter och totaler per order) — användbart för att offerera era kunder innan några order skapas. Klicka på Start over för att kasta uppladdningen och börja om med en reviderad fil.

När ni lämnar Shipping Amount tom visar servicenivåkolumnen priset som matchar er CSV:s servicenivå. Om er begärda servicenivå inte är tillgänglig för en destination väljs det närmaste tillgängliga priset och flaggas med en Different service level-badge — eller, när flera alternativ finns, låter en Select a rate-rullgardinsmeny er välja innan ordern kan skapas.

Problem flaggas inline på bekräftelseskärmen.

Fel 

Rader med fel exkluderas när ni klickar på Create orders. Åtgärda problemet i er CSV och ladda upp igen för att inkludera de raderna. Vanliga fel inkluderar:

• Low-value orders not allowed — Ordervärdet är under minimigränsen för er butik.
• Invalid state code — Stats- eller provinskoden är inte giltig för destinationslandet. Krävs för länder som Brasilien, USA och Kanada.
• Missing required field — En obligatorisk kolumn är tom eller kan inte tolkas.
• Order ID already exists — Varje order-ID måste vara unikt över ert konto, inklusive order från tidigare uppladdningar. Rader med redan använda ID:n misslyckas vid skapande medan resten av filen lyckas — ladda upp bara de misslyckade raderna igen med nya ID:n (ett suffix som -33 fungerar bra).

Varningar 

Rader med varningar inkluderas i inskickningen. Granska dem innan ni klickar på Create orders. Vanliga varningar inkluderar:

• Service level not configured — Servicenivåkoden i er CSV är inte ansluten till ert konto. Ordern skapas men kan inte prissättas korrekt. Verifiera era transportörinställningar eller uppdatera servicenivåkoden i er CSV.

Den nuvarande uppladdningsgränsen är 200 order per CSV. Order skickas in i batchar om upp till 50 per API-anrop — om er uppladdning innehåller fler än 50 redo order bearbetas de i flera batchar automatiskt.

Kommer snart: En framtida uppdatering tar bort gränsen på 200 order och lägger till bakgrundsjobbbearbetning för större uppladdningar.