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.).
- Valfritt – Lägg till begränsade länder.
- Klicka på save product.
Skapa flera produkter i Catalog:
Ladda upp flera produkter eller hela er produktkatalog på en gång.
Viktigt: Om ni försöker skapa en produkt som redan finns känner Catalog igen produkten utifrån SKU och/eller produkt-ID och skriver över den ursprungliga produktens uppgifter med de nya uppgifterna.
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 (catalogItemsCreate eller catalogItemsUpdate) – det finns inget fält i Dashboard eller någon CSV-kolumn för dem.
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.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) { id name sku attributes { key valueVärden för farligt gods som stöds
| Värde↕ | Kategori↕ |
|---|---|
NOT_RESTRICTED_A70 | 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. |
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.
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.
- Klicka på save product.
Så begränsar ni flera produkter i Catalog:
- Klicka på fliken Import/export.
- Ladda ner Catalog CSV-mallen.
- 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 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. - 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.
- Klicka på Export i det övre högra hörnet.
- Hitta er CSV-fil i er e-postinkorg.
Så exporterar ni alla produkter:
- Gå till Dashboard -> Products -> Catalog.
- Klicka på listrutan Manage Catalog bredvid Add product och klicka på Export all.
- Hitta er katalogfil i era nedladdningar.
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:
- 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.
Klassificera en katalogprodukt till 8+ siffror (landsspecifik)
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.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { 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
| Fel↕ | Lösning↕ |
|---|---|
| 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
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.