DOCS

Manage products

/

Administrer Katalog

Opret og modificer produkter.

Lær hvordan du tilføjer, modificerer og sletter dine Zonos Katalog produkt(er) i Dashboard eller via API. Brug Katalog i Dashboard for at undgå at skrive kode eller hvis du laver små ændringer. Hvis du ønsker at integrere direkte med Katalog til produktionsimplementeringer, brug API'en.

Opret et produkt

Dashboard
API

Opret et produkt i Katalog:

  1. Gå til Katalog og klik på Tilføj produkt i øverste højre hjørne.
  2. Tilføj dine produktoplysninger. Det eneste felt, der kræves for at oprette et produkt, er SKU og/eller produkt ID felt(er). Disse felter vil blive brugt til at referere til dine katalogprodukter. Læs mere om Katalogs identifikatorer.
  3. Valgfrit—Tilføj dine HS-kode(r).
  4. Valgfrit—Tilføj dine forsendelsesoplysninger (vægt, dimensioner, måleenheder osv.).
  5. Valgfrit—Tilføj begrænsede lande.
  6. Klik på gem produkt.

Opret flere produkter i Katalog:

Upload flere produkter eller hele dit produktkatalog på én gang.

Vigtigt: Hvis du forsøger at oprette et produkt, der allerede findes, vil Catalog genkende produktet baseret på SKU og/eller produkt-ID og overskrive de originale produktdetaljer med de nye detaljer.

Rediger et produkt

Redigering af produkter giver dig mulighed for effektivt at opdatere dine eksisterende produkter med yderligere eller opdaterede oplysninger. I stedet for at skulle slette og gen-upload produktet, kan du uploade de opdaterede oplysninger, og Catalog vil matche det med det eksisterende produkt ved hjælp af dit SKU eller produkt-ID, afhængigt af din præference for vare-nøgle. På denne måde kan du holde dit katalog opdateret med minimal indsats, uanset om du bruger Dashboard eller API til at oprette nye produkter eller redigere eksisterende produkter.

Hvis du opretter/redigerer et katalogprodukt, der allerede findes i Catalog, kan du forvente følgende:

Catalog vil skrive over tomme felter på eksisterende varer.

  • For eksempel, hvis et eksisterende produkt, SKU 321, ikke havde en værdi for vægt, og det samme produkt, SKU 321, havde en vægt på 1.3 lbs i den nye upload, ville vægten på 1.3 lbs overskrive det tidligere tomme felt.

Catalog vil overskrive eksisterende felter med nye feltværdier.

  • For eksempel, hvis et eksisterende produkt, SKU 123, havde en pris på 18.99 USD og det samme produkt, SKU 123, havde en opdateret pris på 22.99 USD, ville den nye pris på 22.99 USD overskrive den tidligere pris.

Catalog vil ikke overskrive eksisterende værdier med tomme felter.

  • For eksempel, hvis et eksisterende produkt, SKU 456, havde en HS-kode på 6109.10, men HS-koden for det opdaterede produkt, SKU 456, er tom, forbliver den eksisterende HS-kode.
Dashboard
API

For at redigere et produkt:

  1. Klik på Produkter fanen.
  2. Vælg det produkt, du vil redigere.
  3. Foretag dine ændringer.
  4. Klik på gem produkt.

For at redigere flere eller alle produkter på én gang, skal du blot uploade en opdateret CSV-fil til Catalog, inklusive dine SKU/Produkt-ID kombinationer. Dette vil udløse automatiske opdateringer til dine eksisterende varer.

Slet et produkt

Dashboard
API

For at slette et produkt:

  1. Klik på Produkter fanen i Dashboard.
  2. Vælg det/de produkter, du ønsker at slette. Når dit/dine produkt(er) er valgt, vil en sletteknap vises.
  3. Klik på Slet og derefter Slet alle for at bekræfte din sletning.

For at slette alle produkter:

  1. Vælg Produkter fanen i Dashboard.
  2. Klik på Administrer Katalog i øverste højre hjørne og derefter Slet alle.
  3. Klik på Slet alle endnu en gang for at bekræfte din sletning.

Bemærk, at hvis du sletter en stor mængde varer (mere end 20.000 produkter eller deromkring), vil en meddelelse vises, der angiver, at din sletning er i gang. I denne periode vil du ikke kunne interagere med Katalog, indtil sletningen er fuldført. Du kan dog afvise meddelelsen og navigere væk uden at forstyrre sletningsprocessen.

Restrict et produkt

Hvis du ønsker at forhindre forsendelser til et bestemt land (eller lande), kan du tilføje restriktioner, når du opretter eller opdaterer et produkt.

Dashboard
API

For at restrict et enkelt produkt i Katalog:

  1. Klik på Produkter fanen.
  2. Vælg det produkt, du ønsker at tilføje en restriktion til, hvilket åbner redigeringssiden.
  3. Find sektionen Restrikterede lande nederst på redigeringssiden.
  4. Tilføj de lande, du ønsker at restrict dit produkt til, ved at vælge eller skrive landets navn(e).
  5. Klik på gem produkt.

For at restrict flere produkter i Katalog:

  1. Klik på Import/eksport fanen.
  2. Download Katalog skabelon CSV.
  3. Udfyld skabelonen med dine produktoplysninger, herunder din SKU/Produkt ID og restrikterede lande. Indtast den 2-cifrede ISO-kode adskilt af lodrette streger (f.eks. AU|KR|MY|SG). For at restrict alle lande, indtast blot ALL som værdien. Hvis du ønsker at restrict alle lande undtagen et eller få, indtast ALL- efterfulgt af de lande, du gerne vil fjerne restriktionen for, adskilt af lodrette streger (f.eks. ALL-CA|FR|US). Læs mere om CSV formatering. Hvis du ønsker at fjerne alle eksisterende restrikterede lande, indtast NONE som værdien.
  4. Gem din fil som en CSV og upload til Katalog ved at trække og slippe eller vælge din fil ved at klikke på gennemse på samme side, hvor du downloadede CSV'en fra.
  5. Gennemgå dine uploadede produkter i forhåndsvisningen screen og klik på upload.

Filtrering af restrikterede produkter:

Du kan filtrere restrikterede produkter direkte i kataloget ved at downloade dit samlede katalog i CSV-format fra Dashboard og åbne det i Excel eller Google Sheets. Derfra kan du bruge filtreringsfunktionen til kun at se de restrikterede produkter. Dette giver dig mulighed for nemt at finde og administrere de restrikterede produkter i dit katalog.

Hvis du har brug for at opdatere dit katalog efter at have foretaget ændringer i din CSV, skal du genupload filen, og eventuelle matchende produkter vil blive erstattet med den opdaterede version. Dette gøres ved at identificere og matche SKU og/eller produkt ID.

Hvis du bruger Checkout, vil en begrænset meddelelse blive vist i din checkout når et produkt er begrænset til kundens land. Som standard vil meddelelsen sige "Denne vare er begrænset fra import til dit land," men du kan tilpasse din egen begrænsede meddelelse ved at angive den i feltet restrictedCountriesMessage, når du tilføjer dine landebegrænsninger.

Filtrer et produkt

Du kan søge efter produkter i Kataloget gennem Dashboard eller via API ved at bruge enten SKU eller produkt-ID. Bemærk, at kun nøjagtige match vil returnere resultater; delvise match vil ikke blive genkendt.

Dashboard
API

For at filtrere efter SKU eller produkt-ID:

  1. Klik på Produkter fanen.
  2. Vælg SKU eller Produkt-ID i øverste venstre hjørne af dit Katalog.
  3. Indtast din SKU eller produkt-ID.
  4. Klik på Anvend for at se dit filtrerede produkt(er).

Eksporter dine produkter

Hvis du vælger 50 eller færre varer fra Katalog-tabellen, vil dit katalog blive downloadet direkte fra Dashboard. Men hvis du vælger Eksporter alle eller mere end 50 varer, vil din CSV blive eksporteret via e-mail.

For at eksportere 50 varer eller færre, følg disse trin:

  1. Vælg 50 eller færre varer direkte fra Katalog-tabellen.
  2. Klik på Eksporter i øverste højre hjørne.
  3. Find din CSV-fil i din e-mail-indbakke.

For at eksportere alle produkter:

Dashboard
API
  1. Gå til Dashboard -> Produkter -> Katalog.
  2. Klik på dropdown-menuen Administrer Katalog ved siden af Tilføj produkt og klik på Eksporter alle.
  3. Find din katalogfil i dine downloads.

Problemer med at downloade fra din email?

Hvis du har problemer med at downloade CSV-filen fra email-linket, kan det skyldes, at din browser blokerer downloadet. Hvis det er tilfældet, skal du følge disse trin:

  1. Højreklik på "Download" knappen i din email.
  2. Vælg "Kopier linkadresse" for at kopiere download-URL'en.
  3. Indsæt den kopierede URL i din browser og tryk enter.
  4. Dit katalog vil derefter blive downloadet direkte fra din browser.

Classify et produkt

Du kan classify et produkt fra dit katalog med API'en ved at bruge catalogItemId i ClassificationsCreateFromCatalog mutation.

Bemærk, at et name er påkrævet for at classify et produkt fra dit katalog. Konsulter GraphQL API-referencen for en komplet liste over katalog- og klassifikationsfelter.

For at oprette og classify et katalogprodukt samtidig, tilføj ClassificationsCreateFromCatalog mutation nedenfor til din CatalogItemsCreate mutation.

Classify et katalogprodukt til den 8+ cifrede (landsspecifik)

Når shipToCountries feltet er udfyldt, vil klassifikationen være en 8+ cifret (landsspecifik) HS-kode. Hvis der ikke er angivet nogen shipToCountries, vil klassifikationen som standard være en 6-cifret (universel) HS-kode. Læs mere om forskellene mellem universelle og landsspecifikke HS-koder.

I eksemplet nedenfor er shipToCountries feltet angivet for at generere en landsspecifik kode for Canada.

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
  }
}

Her er et eksempel på en anmodning. Mens Zonos Classify vil generere en klassificering med kun et navn, anbefaler vi kraftigt at tilføje så mange detaljer som muligt for de bedste klassificeringsresultater.

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-fejl og løsninger

FejlLøsning
Et SKU eller produkt-ID er påkrævet for at oprette et produktEn identifikator (SKU/produkt-ID) er påkrævet for at oprette, redigere eller slette et katalogelement. For at løse dette, tilføj et SKU og/eller produkt-ID.
Produktet, du prøver at redigere, findes ikke*Du kan ikke redigere et produkt, der ikke findes. For at løse dette, opret et nyt produkt med dit ønskede SKU og/eller produkt-ID.
Toldbeskrivelsen overskrider tegnbegrænsningen på 30 tegn.Som standard er toldbeskrivelser begrænset til 30 tegn, hvilket stemmer overens med den mest almindelige tegnbegrænsning for kommercielle fakturaer.
Produkttype ugyldig. Kataloget understøtter følgende produkttyper: digital_good. For fysiske varer, lad det være tomt.Kataloget understøtter kun følgende produkttyper: digital_good og physical_good. Hvis dit produkt er en fysisk vare (mest almindeligt), lad dette felt være tomt.
Pakkepræference ugyldig. Kataloget understøtter følgende pakkepræferencer: ships_alone og consolidated. Hvis dit produkt kan konsolideres med andre produkter, lad det være tomt.Pakkepræference ugyldig. Kataloget understøtter følgende pakkepræferencer: ships_alone og consolidated. Hvis dit produkt kan konsolideres med andre produkter, kan du lade det være tomt, da consolidated er standard.
Land skal angives, når der gives en HS-kodeHvis du angiver en landsspecifik HS-kode ved oprettelse af et element, er et leveringsland påkrævet. For at løse dette, tilføj et leveringsland.
Prisen skal være større end 0Kataloget understøtter ikke negative prisværdier. For at løse dette, tilføj en pris større end nul.
Valuta kode skal angives, når en prisværdi leveresHvis du angiver en pris, er en valutakode påkrævet. For at løse dette, tilføj en valutakode.
Prisen skal angives, når en valutakode leveresHvis du angiver en valutakode, er en pris påkrævet. For at løse dette, tilføj en pris.
Det ledsagende dimensionale felt kan ikke efterlades tomtHvis et dimensionelt felt er angivet, er de to andre påkrævet. F.eks. hvis du angiver en bredde på “8 tommer,” så vil højden og længden være påkrævet.
Måleværdien skal være større end 0Kataloget understøtter ikke negative eller nul måleværdier. For at løse dette, tilføj en værdi større end nul.
Når der gives en dimensionel værdi, kan dimensionelle enheder ikke efterlades tommeHvis du angiver en dimensionel værdi, er en dimensionel enhed påkrævet. For at løse dette, tilføj en dimensionel enhed.
Når der gives en vægtværdi, kan vægtenheden ikke efterlades tomHvis du angiver en vægtværdi, er en vægtenhed påkrævet. For at løse dette, tilføj en vægtenhed.

* API-fejl kun

Var denne side nyttig?