DOCS

Manage products

/

Hantera Katalog

Skapa och modifiera produkter.

Lär dig hur du lägger till, modifierar och tar bort dina Zonos katalogprodukter i Dashboard eller via API. Använd Katalog i Dashboard för att undvika att skriva kod eller om du gör små ändringar. Om du vill integrera direkt med Katalog för produktionsimplementationer, använd API:et.

Skapa en produkt

Dashboard
API

Skapa en produkt i Katalog:

  1. Gå till Katalog och klicka på Lägg till produkt i det övre högra hörnet.
  2. Lägg till dina produktuppgifter. Det enda fält som krävs för att skapa en produkt är SKU och/eller produkt-ID fält. Dessa fält kommer att användas för att referera till dina katalogprodukter. Lär dig mer om Katalogens identifierare.
  3. Valfritt—Lägg till dina HS-kod(er).
  4. Valfritt—Lägg till din fraktinformation (vikt, dimensioner, måttenheter, etc.).
  5. Valfritt—Lägg till begränsade länder.
  6. Klicka på spara produkt.

Skapa flera produkter i Katalog:

Ladda upp flera produkter eller hela din produktkatalog på en gång.

Viktigt: Om du försöker skapa en produkt som redan finns, kommer Katalog att känna igen produkten baserat på SKU och/eller produkt-ID och överskrida den ursprungliga produktens detaljer med de nya detaljerna.

Redigera en produkt

Att redigera produkter gör att du kan uppdatera dina befintliga produkter med ytterligare eller uppdaterad information effektivt. Istället för att behöva ta bort och ladda upp produkten på nytt, kan du ladda upp den uppdaterade informationen, och Katalog kommer att matcha den med den befintliga produkten med hjälp av din SKU eller produkt-ID, beroende på din preferens för artikelnyckel. På så sätt kan du hålla din katalog uppdaterad med minimal ansträngning, oavsett om du använder Dashboard eller API för att skapa nya produkter eller redigera befintliga produkter.

Om du skapar/redigerar en katalogprodukt som redan finns i Katalog, förvänta dig följande:

Katalog kommer att skriva över tomma fält på befintliga artiklar.

  • Till exempel, om en befintlig produkt, SKU 321, inte hade ett värde för vikt, och samma produkt, SKU 321, hade en vikt på 1.3 lbs i den nya uppladdningen, skulle vikten på 1.3 lbs överskrida det tidigare tomma fältet.

Katalog kommer att överskrida befintliga fält med nya fältvärden.

  • Till exempel, om en befintlig produkt, SKU 123, hade ett pris på 18.99 USD och samma produkt, SKU 123, hade ett uppdaterat pris på 22.99 USD, skulle det nya priset på 22.99 USD överskrida det tidigare priset.

Katalog kommer inte att överskrida befintliga värden med tomma fält.

  • Till exempel, om en befintlig produkt, SKU 456, hade en HS-kod på 6109.10, men HS-koden för den uppdaterade produkten, SKU 456, är tom, förblir den befintliga HS-koden.
Dashboard
API

För att redigera en produkt:

  1. Klicka på fliken Produkter.
  2. Välj den produkt du vill redigera.
  3. Gör dina ändringar.
  4. Klicka på spara produkt.

För att redigera flera eller alla produkter på en gång, ladda bara upp en uppdaterad CSV-fil till Katalogen, inklusive dina SKU/Produkt-ID-kombinationer. Detta kommer att utlösa automatiska uppdateringar av dina befintliga artiklar.

Ta bort en produkt

Dashboard
API

För att ta bort en produkt:

  1. Klicka på fliken Produkter i instrumentpanelen.
  2. Välj den/de produkt(er) du vill ta bort. När din produkt(er) är/är valda kommer en ta bort-knapp att visas.
  3. Klicka på Ta bort och sedan Ta bort alla för att bekräfta din borttagning.

För att ta bort alla produkter:

  1. Välj fliken Produkter i instrumentpanelen.
  2. Klicka på Hantera katalog i det övre högra hörnet och sedan Ta bort alla.
  3. Klicka på Ta bort alla en gång till för att bekräfta din borttagning.

Observera att om du tar bort en stor mängd artiklar (mer än 20 000 produkter eller så) kommer en avisering att visas som indikerar att din borttagning pågår. Under denna tid kommer du inte att kunna interagera med Katalogen förrän borttagningen är klar. Du kan dock avvisa aviseringen och navigera bort utan att avbryta borttagningsprocessen.

Restrict en produkt

Om du vill förhindra leveranser till ett visst land (eller länder) kan du lägga till begränsningar när du skapar eller uppdaterar en produkt.

Dashboard
API

För att restrict en enskild produkt i Katalogen:

  1. Klicka på fliken Produkter.
  2. Välj den produkt du vill lägga till en begränsning på, vilket öppnar redigeringssidan.
  3. Hitta avsnittet Begränsade länder längst ner på redigeringssidan.
  4. Lägg till de länder du vill restrict din produkt till genom att välja eller skriva landets namn.
  5. Klicka på spara produkt.

För att restrict flera produkter i Katalogen:

  1. Klicka på fliken Importera/exportera.
  2. Ladda ner Katalogmall CSV.
  3. Fyll i mallen med dina produktuppgifter, inklusive din 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 restrict alla länder, ange helt enkelt ALL som värde. Om du vill restrict alla länder utom ett eller några, ange ALL- följt av de länder du vill avgränsa, separerade med vertikala streck (t.ex. ALL-CA|FR|US). Lär dig mer om CSV-formattering. Om du vill ta bort alla befintliga begränsade länder, ange NONE som värde.
  4. Spara din fil som en CSV och ladda upp till Katalogen genom att dra och släppa eller välja din fil genom att klicka på bläddra på samma sida som du laddade ner CSV-filen från.
  5. Granska dina uppladdade produkter i förhandsgranskningen screen och klicka på ladda upp.

Filtrering av begränsade produkter:

Du kan filtrera begränsade produkter direkt i katalogen genom att ladda ner hela din katalog i CSV-format från Dashboard och öppna den i Excel eller Google Sheets. Därifrån kan du använda filtreringsfunktionen för att endast visa de begränsade produkterna. Detta gör att du enkelt kan lokalisera och hantera de begränsade produkterna i din katalog.

Om du behöver uppdatera din katalog efter att ha gjort ändringar i din CSV, ladda upp filen igen och alla matchande produkter kommer att ersättas med den uppdaterade versionen. Detta görs genom att identifiera och matcha SKU och/eller produkt-ID.

Om du använder Checkout kommer ett begränsat meddelande att visas i din checkout när en produkt är begränsad för kundens land. Som standard kommer meddelandet att säga "Denna artikel är begränsad från import till ditt land," men du kan anpassa ditt eget begränsade meddelande genom att ange det i fältet restrictedCountriesMessage när du lägger till dina landsbegränsningar.

Filtrera en produkt

Du kan söka efter produkter i Katalogen via Dashboard eller via API med antingen SKU eller produkt-ID. Observera att endast exakta träffar kommer att returnera resultat; delvisa träffar kommer inte att kännas igen.

Dashboard
API

För att filtrera efter SKU eller produkt-ID:

  1. Klicka på fliken Produkter.
  2. Välj SKU eller Produkt-ID i det övre vänstra hörnet av din Katalog.
  3. Ange din SKU eller produkt-ID.
  4. Klicka på Tillämpa för att se din filtrerade produkt(er).

Exportera dina produkter

Om du väljer 50 eller färre artiklar från Katalogtabellen kommer din katalog att laddas ner direkt från Dashboard. Men om du väljer Exportera alla eller mer än 50 artiklar kommer din CSV att exporteras via e-post.

För att exportera 50 artiklar eller färre, följ dessa steg:

  1. Välj 50 eller färre artiklar direkt från Katalogtabellen.
  2. Klicka på Exportera i det övre högra hörnet.
  3. Hitta din CSV-fil i din e-postinkorg.

För att exportera alla produkter:

Dashboard
API
  1. Gå till Dashboard -> Produkter -> Katalog.
  2. Klicka på rullgardinsmenyn Hantera katalog bredvid Lägg till produkt och klicka på Exportera alla.
  3. Hitta din katalogfil i dina nedladdningar.

Problem med att ladda ner från din e-post?

Om du har problem med att ladda ner CSV-filen från e-postlänken kan det bero på att din webbläsare blockerar nedladdningen. Om så är fallet, följ dessa steg:

  1. Högerklicka på "Ladda ner"-knappen i din e-post.
  2. Välj "Kopiera länkadress" för att kopiera nedladdnings-URL:en.
  3. Klistra in den kopierade URL:en i din webbläsare och tryck på enter.
  4. Din katalog kommer då att laddas ner direkt från din webbläsare.

Classify en produkt

Du kan classify en produkt från din katalog med API:et genom att använda catalogItemId i ClassificationsCreateFromCatalog mutation.

Observera att ett name krävs för att classify en produkt från din katalog. Konsultera GraphQL API-referensen för en komplett lista över katalog- och klassificeringsfält.

För att skapa och classify en katalogprodukt samtidigt, lägg till ClassificationsCreateFromCatalog mutation nedan till din CatalogItemsCreate mutation.

Classify en katalogprodukt till den 8+ siffriga (landsspecifika)

När fältet shipToCountries är ifyllt kommer klassificeringen att vara en 8+ siffrig (landsspecifik) HS-kod. Om inga shipToCountries anges kommer klassificeringen att som standard vara en 6-siffrig (universell) HS-kod. Lär dig 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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Här är ett exempel på en begäran. Medan Zonos Classify kommer att generera en klassificering med bara ett namn, rekommenderar vi starkt att lägga till så många detaljer som möjligt för de bästa klassificeringsresultaten.

Variabler

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Svar

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

API-fel och lösningar

FelLösning
Ett SKU eller produkt-ID krävs för att skapa en produktEn identifierare (SKU/produkt-ID) krävs för att skapa, redigera eller ta bort en katalogpost. För att lösa detta, lägg till ett SKU och/eller produkt-ID.
Produkten du försöker redigera finns inte*Du kan inte redigera en produkt som inte finns. För att lösa detta, skapa en ny produkt med ditt önskade SKU och/eller produkt-ID.
Tullbeskrivning överskrider teckenbegränsningen på 30 tecken.Som standard är tullbeskrivningar begränsade till 30 tecken, vilket överensstämmer med den vanligaste teckenbegränsningen för kommersiella fakturor.
Produkt typ ogiltig. Katalogen stöder följande produkttyper: digital_good. För fysiska varor, lämna det tomt.Katalogen stöder endast följande produkttyper: digital_good och physical_good. Om din produkt är en fysisk vara (vanligast), lämna detta fält tomt.
Packningspreferens ogiltig. Katalogen stöder följande packningspreferenser: ships_alone och consolidated. Om din produkt kan konsolideras med andra produkter, lämna tomt.Packningspreferens ogiltig. Katalogen stöder följande packningspreferenser: ships_alone och consolidated. Om din produkt kan konsolideras med andra produkter kan du lämna det tomt eftersom consolidated är standard.
Land måste anges när ett HS-kod angesOm du anger en landsspecifik HS-kod när du skapar en post, krävs ett leveransland. För att lösa detta, lägg till ett leveransland.
Priset måste vara större än 0Katalogen stöder inte negativa prisvärden. För att lösa detta, lägg till ett pris som är större än noll.
Valuta kod måste anges när ett prisvärde angesOm du anger ett pris krävs en valutakod. För att lösa detta, lägg till en valutakod.
Pris måste anges när en valutakod angesOm du anger en valutakod krävs ett pris. För att lösa detta, lägg till ett pris.
Det medföljande dimensionella fältet kan inte lämnas tomtOm ett dimensionellt fält anges krävs de andra två. T.ex. om du anger en bredd på “8 tum”, krävs då höjd och längd.
Mätningsvärdet måste vara större än 0Katalogen stöder inte negativa eller noll mätningsvärden. För att lösa detta, lägg till ett värde som är större än noll.
När ett dimensionellt värde anges, kan dimensionella enheter inte lämnas tommaOm du anger ett dimensionellt värde krävs en dimensionell enhet. För att lösa detta, lägg till en dimensionell enhet.
När ett viktvärde anges, kan viktenheten inte lämnas tommaOm du anger ett viktvärde krävs en vikt enhet. För att lösa detta, lägg till en vikt enhet.

* API-fel endast

Var den här sidan hjälpsam?