Lär er hur ni lägger till, ändrar och tar bort era Zonos Catalog-produkter i Dashboard eller via API. Använd Catalog i Dashboard om ni vill undvika att skriva kod eller om ni bara gör mindre ändringar. Om ni vill integrera direkt med Catalog för produktionsimplementationer använder ni API:et.
Skapa en produkt
Skapa en produkt i Catalog:
Gå till Catalog och klicka på Add product i det övre högra hörnet.
Lägg till era produktuppgifter. Det enda fält som krävs för att skapa en produkt är SKU- och/eller produkt-ID-fältet. Dessa fält används för att referera till era katalogprodukter. Läs mer om Catalogs identifierare.
Valfritt – Lägg till er/era HS-kod(er).
Valfritt – Lägg till er fraktinformation (vikt, mått, måttenheter osv.).
För DHL-sändningar kan ni märka en produkt som farligt gods så att rätt DHL-mervärdestjänst tillämpas automatiskt varje gång ni skapar en etikett för den produkten. Detta omfattar de ”lågrisk”- eller undantagna klasserna av reglerade varor – varor som formellt är reglerade men som fraktas enligt en särskild bestämmelse eller kvantitetsbefrielse.
En märkning för farligt gods lagras som ett attribut på katalogartikeln: ett key/value-par på produkten. Attribut anges via API:et (catalogItemsCreate eller catalogItemsUpdate) – det finns inget fält i Dashboard eller någon CSV-kolumn för dem.
Endast DHL
Märkning av farligt gods påverkar endast DHL-sändningar. Märkningen ignoreras för
andra transportörer.
Attributnyckel som stöds
DANGEROUS_GOODS är en attributnyckel som stöds för DHL:s märkning av farligt gods.
Den finns ännu inte med bland de godkända nycklarna i
ItemAttributeInput-referensen, men den
accepteras av API:et.
För att märka en produkt lägger ni till ett attribut med nyckeln DANGEROUS_GOODS och ett värde från en av kategorierna som stöds nedan.
Ej begränsat, särskild bestämmelse A70 – trycksatta artiklar, såsom gasfjädrar och stötdämpare (UN3164).
NOT_RESTRICTED_A67
Ej begränsat, särskild bestämmelse A67 – motorer eller maskiner som drivs av brandfarlig vätska (UN3528).
NOT_RESTRICTED_A02
Ej begränsat, särskild bestämmelse A02 – undantaget enligt ADR:s bestämmelse för mindre vägtransporter.
LIMITED_QUANTITY
Begränsad mängd (ADR) – farligt gods förpackat i små mängder inom de fastställda gränsvärdena.
EXCEPTED_QUANTITY
Undantagen mängd (IATA) – mycket små mängder som är undantagna från de flesta bestämmelser om farligt gods vid lufttransport.
CONSUMER_COMMODITY
Konsumentvara ID8000 – butiksfärdiga vardagsprodukter med mindre mängder farligt innehåll, till exempel aerosoler och parfym.
MAGNETIZED_MATERIAL
Magnetiserat material (UN2807) – föremål med ett magnetfält starkt nog att påverka flygplansinstrument.
BIOLOGICAL_SUBSTANCE
Biologiskt ämne (UN3373) – biologiska ämnen i kategori B, till exempel diagnostiska eller kliniska prover.
Tillämpa taggar automatiskt på etiketter
Att märka en produkt är det första steget. För att Zonos automatiskt ska tillämpa
kategorin på era DHL-etiketter aktiverar ni Ship dangerous goods i
etikettinställningarna. Ni kan
också välja en kategori manuellt på en enskild etikett – se
deklarera farligt gods.
Redigera en produkt
Genom att redigera produkter kan ni effektivt uppdatera era befintliga produkter med ytterligare eller uppdaterad information. Istället för att behöva ta bort produkten och ladda upp den igen kan ni ladda upp den uppdaterade informationen, så matchar Catalog den med den befintliga produkten utifrån ert SKU eller produkt-ID, beroende på er item key-inställning. På så sätt kan ni hålla er katalog uppdaterad med minimal ansträngning, oavsett om ni använder Dashboard eller API för att skapa nya produkter eller redigera befintliga produkter.
Om ni skapar/redigerar en katalogprodukt som redan finns i Catalog kan ni förvänta er följande:
Catalog skriver över tomma fält på befintliga artiklar.
Om en befintlig produkt, SKU 321, till exempel inte hade något värde för vikt, och samma produkt, SKU 321, i den nya uppladdningen hade en vikt på 1,3 lbs, skulle vikten 1,3 lbs skriva över det tidigare tomma fältet.
Catalog skriver över befintliga fält med nya fältvärden.
Om en befintlig produkt, SKU 123, till exempel hade ett pris på 18,99 USD och samma produkt, SKU 123, fick ett uppdaterat pris på 22,99 USD, skulle det nya priset på 22,99 USD skriva över det tidigare priset.
Catalog skriver inte över befintliga värden med tomma fält.
Om en befintlig produkt, SKU 456, till exempel hade en HS-kod på 6109.10, men HS-koden för den uppdaterade produkten, SKU 456, är tom, behålls den befintliga HS-koden.
Så redigerar ni en produkt:
Klicka på fliken Products.
Välj den produkt ni vill redigera.
Gör era ändringar.
Klicka på save product.
För att redigera flera eller alla produkter samtidigt laddar ni bara upp en uppdaterad CSV-fil till Catalog, inklusive ert SKU eller produkt-ID. Detta utlöser automatiska uppdateringar av era befintliga artiklar.
Ta bort en produkt
Så tar ni bort en produkt:
Klicka på fliken Products i Dashboard.
Välj den eller de produkter ni vill ta bort. När produkten/produkterna är valda visas en knapp för att ta bort dem.
Klicka på Delete och sedan på Delete all för att bekräfta borttagningen.
Så tar ni bort alla produkter:
Välj fliken Products i Dashboard.
Klicka på Manage Catalog i det övre högra hörnet och sedan på Delete all.
Klicka på Delete all en gång till för att bekräfta borttagningen.
Observera att om ni tar bort ett stort antal artiklar (mer än ungefär 20 000 produkter) visas en avisering som anger att borttagningen pågår. Under den tiden kan ni inte interagera med Catalog förrän borttagningen är klar. Ni kan dock stänga aviseringen och navigera bort utan att avbryta borttagningsprocessen.
Begränsa en produkt
Om ni vill förhindra sändningar till ett visst land (eller vissa länder) kan ni lägga till begränsningar när ni skapar eller uppdaterar en produkt.
Zonos Duty & Tax-appar stöder inte begränsningar på artikelnivå som tar bort enskilda produkter från internationella beställningar. Om en begränsad artikel finns i kundvagnen måste hela kundvagnen blockeras från att skickas till det landet. Detta hanteras genom en begränsningsregel på kundvagnsnivå, som måste konfigureras i förväg under onboardingen. Även om Catalog är kompatibel med Duty & Tax-appar stöds begränsningar på artikelnivå endast när ni använder Zonos Checkout.
Så begränsar ni en enskild produkt i Catalog:
Klicka på fliken Products.
Välj den produkt ni vill lägga till en begränsning för, vilket öppnar redigeringssidan.
Hitta avsnittet Restricted countries längst ned på redigeringssidan.
Lägg till de länder ni vill begränsa produkten till genom att välja eller skriva in landets/ländernas namn.
Fyll i mallen med era produktuppgifter, inklusive ert SKU/produkt-ID och begränsade länder. Ange den 2-siffriga ISO-koden separerad med vertikala streck, t.ex. AU|KR|MY|SG. För att begränsa alla länder anger ni bara ALL som värde. Om ni vill begränsa alla länder utom ett eller några få, anger ni ALL- följt av de länder ni vill ta bort begränsningen för, separerade med vertikala streck, t.ex. ALL-CA|FR|US. Läs mer om CSV-formatering. Om ni vill ta bort alla befintliga begränsade länder anger ni NONE som värde.
Spara filen som CSV och ladda upp den till Catalog genom att dra och släppa den, eller genom att klicka på browse för att välja filen på samma sida där ni laddade ner CSV-filen.
Granska era uppladdade produkter på förhandsgranskningsskärmen och klicka på upload.
Filtrera begränsade produkter:
Ni kan filtrera begränsade produkter direkt i katalogen genom att ladda ner hela er katalog i CSV-format från Dashboard och öppna den i Excel eller Google Sheets. Där kan ni använda filterfunktionen för att endast visa de begränsade produkterna. På så sätt kan ni enkelt hitta och hantera de begränsade produkterna i er katalog.
Om ni behöver uppdatera er katalog efter att ha gjort ändringar i CSV-filen laddar ni upp filen igen, och alla matchande produkter ersätts med den uppdaterade versionen. Detta görs genom att identifiera och matcha SKU och/eller produkt-ID.
Om ni använder Checkout visas ett meddelande om begränsning i er checkout när en produkt är begränsad för kundens land. Som standard lyder meddelandet: ”Den här artikeln är begränsad för import till ditt land.”
Filtrera en produkt
Ni kan söka efter produkter i Catalog via Dashboard eller API med SKU, produkt-ID eller produktnamn. Vid sökning på SKU och produkt-ID returneras endast exakta träffar; partiella träffar stöds inte. Vid sökning på produktnamn stöds dock partiella träffar.
Så filtrerar ni på SKU eller produkt-ID:
Klicka på fliken Products i Dashboard.
Välj SKU eller Product ID längst upp till vänster i er Catalog.
Ange ert SKU, produkt-ID eller produktnamn.
Klicka på Apply för att visa er filtrerade produkt/produkter.
Så söker ni på ett produktnamn:
Klicka på fliken Products i Dashboard.
Skriv produktnamnet i sökfältet längst upp till höger i er Catalog.
Visa er filtrerade produkt/produkter.
Exportera era produkter
Om ni väljer 50 eller färre artiklar från Catalog-tabellen laddas er katalog ner direkt från Dashboard. Om ni däremot väljer Export all eller fler än 50 artiklar exporteras er CSV via e-post.
Så exporterar ni 50 artiklar eller färre:
Välj 50 eller färre artiklar direkt från Catalog-tabellen.
Om ni har problem med att ladda ner CSV-filen via länken i e-posten kan det bero på att er webbläsare blockerar nedladdningen. Om så är fallet följer ni dessa steg:
Högerklicka på knappen ”Download” i e-postmeddelandet.
Välj ”Copy link address” för att kopiera nedladdningslänken.
Klistra in den kopierade länken i er webbläsare och tryck på Enter.
Er katalog laddas då ner direkt via webbläsaren.
Klassificera en produkt
Ni kan klassificera en produkt från er katalog med API:et genom att använda catalogItemId i mutationen ClassificationsCreateFromCatalog.
Observera att ett name krävs för att klassificera en produkt från er katalog. Se GraphQL API-referensen för en fullständig lista över katalog- och klassificeringsfält.
För att skapa och klassificera en katalogprodukt samtidigt lägger ni till mutationen ClassificationsCreateFromCatalog nedan i er CatalogItemsCreate-mutation.
När fältet shipToCountries är ifyllt blir klassificeringen en 8+-siffrig (landsspecifik) HS-kod. Om inget shipToCountries anges blir klassificeringen som standard en 6-siffrig (universell) HS-kod. Läs mer om skillnaderna mellan universella och landsspecifika HS-koder.
I exemplet nedan anges fältet shipToCountries för att generera en landsspecifik kod för Kanada.
Här är ett exempel på en förfrågan. Zonos Classify genererar en klassificering med bara ett name, men vi rekommenderar starkt att ni lägger till så många detaljer som möjligt för bästa klassificeringsresultat.
Ett SKU eller produkt-ID krävs för att skapa en produkt
En identifierare (SKU/produkt-ID) krävs för att skapa, redigera eller ta bort en katalogartikel. Lägg till ett SKU och/eller produkt-ID för att åtgärda detta.
Produkten ni försöker redigera finns inte*
Ni kan inte redigera en produkt som inte finns. Skapa en ny produkt med önskat SKU och/eller produkt-ID för att åtgärda detta.
Tullbeskrivningen överskrider teckengränsen på 30 tecken.
Som standard är tullbeskrivningar begränsade till 30 tecken, vilket motsvarar den vanligaste teckengränsen för handelsfakturor.
Produkttypen är ogiltig. Catalog stöder följande produkttyper: digital_good. Lämna fältet tomt för fysiska varor.
Catalog stöder endast följande produkttyper: digital_good och physical_good. Om er produkt är en fysisk vara (vanligast) lämnar ni detta fält tomt.
Förpackningspreferensen är ogiltig. Catalog stöder följande förpackningspreferenser: ships_alone och consolidated. Lämna fältet tomt om er produkt kan konsolideras med andra produkter.
Förpackningspreferensen är ogiltig. Catalog stöder följande förpackningspreferenser: ships_alone och consolidated. Om er produkt kan konsolideras med andra produkter kan ni lämna fältet tomt, eftersom consolidated är standardvärdet.
Ett land måste anges när en HS-kod anges
Om ni anger en landsspecifik HS-kod när ni skapar en artikel krävs ett mottagarland. Lägg till ett mottagarland för att åtgärda detta.
Priset måste vara större än 0
Catalog stöder inte negativa prisvärden. Lägg till ett pris större än noll för att åtgärda detta.
En valutakod måste anges när ett prisvärde anges
Om ni anger ett pris krävs en valutakod. Lägg till en valutakod för att åtgärda detta.
Ett pris måste anges när en valutakod anges
Om ni anger en valutakod krävs ett pris. Lägg till ett pris för att åtgärda detta.
Det tillhörande måttfältet kan inte lämnas tomt
Om ett måttfält anges krävs även de andra två, t.ex. om ni anger en bredd på 8 tum krävs även höjd och längd.
Måttvärdet måste vara större än 0
Catalog stöder inte negativa mätvärden eller mätvärden lika med noll. Lägg till ett värde större än noll för att åtgärda detta.
Måttenheten kan inte lämnas tom när ett måttvärde anges
Om ni anger ett måttvärde krävs en måttenhet. Lägg till en måttenhet för att åtgärda detta.
Viktenheten kan inte lämnas tom när ett viktvärde anges
Om ni anger ett viktvärde krävs en viktenhet. Lägg till en viktenhet för att åtgärda detta.
* Endast API-fel
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Hantera produkter
Hantera katalog
Skapa och ändra produkter.Lär er hur ni lägger till, ändrar och tar bort era Zonos Catalog-produkter i Dashboard eller via API. Använd Catalog i Dashboard om ni vill undvika att skriva kod eller om ni bara gör mindre ändringar. Om ni vill integrera direkt med Catalog för produktionsimplementationer använder ni API:et.
Skapa en produkt
Skapa en produkt i Catalog:
Skapa flera produkter i Catalog:
Ladda upp flera produkter eller hela er produktkatalog på en gång.
Märka en produkt som farligt gods (DHL)
För DHL-sändningar kan ni märka en produkt som farligt gods så att rätt DHL-mervärdestjänst tillämpas automatiskt varje gång ni skapar en etikett för den produkten. Detta omfattar de ”lågrisk”- eller undantagna klasserna av reglerade varor – varor som formellt är reglerade men som fraktas enligt en särskild bestämmelse eller kvantitetsbefrielse.
En märkning för farligt gods lagras som ett attribut på katalogartikeln: ett
key/value-par på produkten. Attribut anges via API:et (catalogItemsCreateellercatalogItemsUpdate) – det finns inget fält i Dashboard eller någon CSV-kolumn för dem.Märkning av farligt gods påverkar endast DHL-sändningar. Märkningen ignoreras för andra transportörer.
DANGEROUS_GOODSär en attributnyckel som stöds för DHL:s märkning av farligt gods. Den finns ännu inte med bland de godkända nycklarna iItemAttributeInput-referensen, men den accepteras av API:et.För att märka en produkt lägger ni till ett attribut med nyckeln
DANGEROUS_GOODSoch ett värde från en av kategorierna som stöds nedan.mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }]) {idnameskuattributes {keyvalueVärden för farligt gods som stöds
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCEAtt märka en produkt är det första steget. För att Zonos automatiskt ska tillämpa kategorin på era DHL-etiketter aktiverar ni Ship dangerous goods i etikettinställningarna. Ni kan också välja en kategori manuellt på en enskild etikett – se deklarera farligt gods.
Redigera en produkt
Genom att redigera produkter kan ni effektivt uppdatera era befintliga produkter med ytterligare eller uppdaterad information. Istället för att behöva ta bort produkten och ladda upp den igen kan ni ladda upp den uppdaterade informationen, så matchar Catalog den med den befintliga produkten utifrån ert SKU eller produkt-ID, beroende på er item key-inställning. På så sätt kan ni hålla er katalog uppdaterad med minimal ansträngning, oavsett om ni använder Dashboard eller API för att skapa nya produkter eller redigera befintliga produkter.
Om ni skapar/redigerar en katalogprodukt som redan finns i Catalog kan ni förvänta er följande:
Catalog skriver över tomma fält på befintliga artiklar.
Catalog skriver över befintliga fält med nya fältvärden.
Catalog skriver inte över befintliga värden med tomma fält.
Så redigerar ni en produkt:
För att redigera flera eller alla produkter samtidigt laddar ni bara upp en uppdaterad CSV-fil till Catalog, inklusive ert SKU eller produkt-ID. Detta utlöser automatiska uppdateringar av era befintliga artiklar.
Ta bort en produkt
Så tar ni bort en produkt:
Så tar ni bort alla produkter:
Observera att om ni tar bort ett stort antal artiklar (mer än ungefär 20 000 produkter) visas en avisering som anger att borttagningen pågår. Under den tiden kan ni inte interagera med Catalog förrän borttagningen är klar. Ni kan dock stänga aviseringen och navigera bort utan att avbryta borttagningsprocessen.
Begränsa en produkt
Om ni vill förhindra sändningar till ett visst land (eller vissa länder) kan ni lägga till begränsningar när ni skapar eller uppdaterar en produkt.
Zonos Duty & Tax-appar stöder inte begränsningar på artikelnivå som tar bort enskilda produkter från internationella beställningar. Om en begränsad artikel finns i kundvagnen måste hela kundvagnen blockeras från att skickas till det landet. Detta hanteras genom en begränsningsregel på kundvagnsnivå, som måste konfigureras i förväg under onboardingen. Även om Catalog är kompatibel med Duty & Tax-appar stöds begränsningar på artikelnivå endast när ni använder Zonos Checkout.
Så begränsar ni en enskild produkt i Catalog:
Så begränsar ni flera produkter i Catalog:
AU|KR|MY|SG. För att begränsa alla länder anger ni baraALLsom värde. Om ni vill begränsa alla länder utom ett eller några få, anger niALL-följt av de länder ni vill ta bort begränsningen för, separerade med vertikala streck, t.ex.ALL-CA|FR|US. Läs mer om CSV-formatering. Om ni vill ta bort alla befintliga begränsade länder anger niNONEsom värde.Filtrera begränsade produkter:
Ni kan filtrera begränsade produkter direkt i katalogen genom att ladda ner hela er katalog i CSV-format från Dashboard och öppna den i Excel eller Google Sheets. Där kan ni använda filterfunktionen för att endast visa de begränsade produkterna. På så sätt kan ni enkelt hitta och hantera de begränsade produkterna i er katalog.
Om ni behöver uppdatera er katalog efter att ha gjort ändringar i CSV-filen laddar ni upp filen igen, och alla matchande produkter ersätts med den uppdaterade versionen. Detta görs genom att identifiera och matcha SKU och/eller produkt-ID.
Om ni använder Checkout visas ett meddelande om begränsning i er checkout när en produkt är begränsad för kundens land. Som standard lyder meddelandet: ”Den här artikeln är begränsad för import till ditt land.”
Filtrera en produkt
Ni kan söka efter produkter i Catalog via Dashboard eller API med SKU, produkt-ID eller produktnamn. Vid sökning på SKU och produkt-ID returneras endast exakta träffar; partiella träffar stöds inte. Vid sökning på produktnamn stöds dock partiella träffar.
Så filtrerar ni på SKU eller produkt-ID:
Så söker ni på ett produktnamn:
Exportera era produkter
Om ni väljer 50 eller färre artiklar från Catalog-tabellen laddas er katalog ner direkt från Dashboard. Om ni däremot väljer Export all eller fler än 50 artiklar exporteras er CSV via e-post.
Så exporterar ni 50 artiklar eller färre:
Så exporterar ni alla produkter:
Problem att ladda ner från e-posten?
Om ni har problem med att ladda ner CSV-filen via länken i e-posten kan det bero på att er webbläsare blockerar nedladdningen. Om så är fallet följer ni dessa steg:
Klassificera en produkt
Ni kan klassificera en produkt från er katalog med API:et genom att använda
catalogItemIdi mutationenClassificationsCreateFromCatalog.Observera att ett
namekrävs för att klassificera en produkt från er katalog. Se GraphQL API-referensen för en fullständig lista över katalog- och klassificeringsfält.För att skapa och klassificera en katalogprodukt samtidigt lägger ni till mutationen
ClassificationsCreateFromCatalognedan i erCatalogItemsCreate-mutation.Klassificera en katalogprodukt till 8+ siffror (landsspecifik)
När fältet
shipToCountriesär ifyllt blir klassificeringen en 8+-siffrig (landsspecifik) HS-kod. Om ingetshipToCountriesanges blir klassificeringen som standard en 6-siffrig (universell) HS-kod. Läs mer om skillnaderna mellan universella och landsspecifika HS-koder.I exemplet nedan anges fältet
shipToCountriesför att generera en landsspecifik kod för Kanada.mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}Här är ett exempel på en förfrågan. Zonos Classify genererar en klassificering med bara ett
name, men vi rekommenderar starkt att ni lägger till så många detaljer som möjligt för bästa klassificeringsresultat.{"catalogItemToClassify": [{"catalogItemId": "catalog_item_893jkdkllg03k9khjd9","configuration": {"shipToCountries": ["CA"]}}]}API-fel och lösningar
digital_goodochphysical_good. Om er produkt är en fysisk vara (vanligast) lämnar ni detta fält tomt.ships_aloneochconsolidated. Om er produkt kan konsolideras med andra produkter kan ni lämna fältet tomt, eftersomconsolidatedär standardvärdet.ItemAttributeInput
Var den här sidan till hjälp?