DOCS

Manage products

/

Administrer Katalog

Opprett og endre produkter.

Lær hvordan du legger til, endrer og sletter dine Zonos Katalog produkt(er) i Dashboard eller via API. Bruk Katalog i Dashboard for å unngå å skrive kode eller hvis du gjør små endringer. Hvis du ønsker å integrere direkte med Katalog for produksjonsimplementeringer, bruk API-en.

Opprett et produkt

Dashboard
API

Opprett et produkt i Katalog:

  1. Gå til Katalog og klikk på Legg til produkt i øverste høyre hjørne.
  2. Legg til produktinformasjonen din. Det eneste feltet som kreves for å opprette et produkt er SKU og/eller produkt-ID felt(er). Disse feltene vil bli brukt til å referere til dine katalogprodukter. Lær mer om Katalogens identifikatorer.
  3. Valgfritt—Legg til HS-kode(r).
  4. Valgfritt—Legg til fraktinformasjon (vekt, dimensjoner, måleenheter, osv.).
  5. Valgfritt—Legg til begrensede land.
  6. Klikk på lagre produkt.

Opprett flere produkter i Katalog:

Last opp flere produkter eller hele produktkatalogen din på en gang.

Viktig: Hvis du prøver å opprette et produkt som allerede eksisterer, vil Katalogen gjenkjenne produktet basert på SKU og/eller produkt-ID og overskrive detaljene til det originale produktet med de nye detaljene.

Rediger et produkt

Å redigere produkter lar deg oppdatere eksisterende produkter med tilleggs- eller oppdatert informasjon effektivt. I stedet for å måtte slette og laste opp produktet på nytt, kan du laste opp den oppdaterte informasjonen, og Katalogen vil matche den med det eksisterende produktet ved hjelp av din SKU eller produkt-ID, avhengig av din preferanse for elementnøkkel. På denne måten kan du holde katalogen din oppdatert med minimal innsats, enten du bruker Dashboard eller API for å opprette nye produkter eller redigere eksisterende produkter.

Hvis du oppretter/redigerer et katalogprodukt som allerede eksisterer i Katalogen, forvent følgende:

Katalogen vil skrive over tomme felt på eksisterende elementer.

  • For eksempel, hvis et eksisterende produkt, SKU 321, ikke hadde en verdi for vekt, og det samme produktet, SKU 321, hadde en vekt på 1.3 lbs i den nye opplastingen, ville vekten på 1.3 lbs overskrive det tidligere tomme feltet.

Katalogen vil overskrive eksisterende felt med nye feltverdier.

  • For eksempel, hvis et eksisterende produkt, SKU 123, hadde en pris på 18.99 USD og det samme produktet, SKU 123, hadde en oppdatert pris på 22.99 USD, ville den nye prisen på 22.99 USD overskrive den forrige prisen.

Katalogen vil ikke overskrive eksisterende verdier med tomme felt.

  • For eksempel, hvis et eksisterende produkt, SKU 456, hadde en HS-kode på 6109.10, men HS-koden til det oppdaterte produktet, SKU 456, er tom, forblir den eksisterende HS-koden.
Dashboard
API

For å redigere et produkt:

  1. Klikk på Produkter-fanen.
  2. Velg produktet du vil redigere.
  3. Gjør endringene dine.
  4. Klikk lagre produkt.

For å redigere flere eller alle produkter samtidig, last bare opp en oppdatert CSV-fil til Katalogen, inkludert dine SKU/Produkt-ID-kombinasjoner. Dette vil utløse automatiske oppdateringer til dine eksisterende elementer.

Slett et produkt

Dashboard
API

For å slette et produkt:

  1. Klikk på Produkter-fanen i Dashbord.
  2. Velg produktet(e) du vil slette. Når produktet(e) er valgt, vil en sletteknapp vises.
  3. Klikk på Slett og deretter Slett alle for å bekrefte slettingen din.

For å slette alle produkter:

  1. Velg Produkter-fanen i Dashbord.
  2. Klikk på Administrer Katalog i øverste høyre hjørne og deretter Slett alle.
  3. Klikk på Slett alle en gang til for å bekrefte slettingen din.

Merk at hvis du sletter et stort antall varer (mer enn 20 000 produkter eller så), vil en varsling vises som indikerer at slettingen din er i gang. I løpet av denne tiden vil du ikke kunne samhandle med Katalogen før slettingen er fullført. Du kan imidlertid avvise varslingen og navigere bort uten å avbryte slettingsprosessen.

Restrict et produkt

Hvis du ønsker å forhindre forsendelser til et bestemt land (eller land), kan du legge til restriksjoner når du oppretter eller oppdaterer et produkt.

Dashboard
API

For å restrict et enkelt produkt i Katalog:

  1. Klikk på Produkter-fanen.
  2. Velg produktet du ønsker å legge til en restriksjon på, som vil åpne redigeringssiden.
  3. Finn seksjonen Restriktive land nederst på redigeringssiden.
  4. Legg til landene du ønsker å restrict produktet ditt til ved å velge eller skrive inn landets navn.
  5. Klikk på lagre produkt.

For å restrict flere produkter i Katalog:

  1. Klikk på Import/eksport-fanen.
  2. Last ned Katalogmal CSV.
  3. Fyll ut malen med produktdetaljene dine, inkludert SKU/Produkt-ID og restriktive land. Skriv inn 2-sifret ISO-kode adskilt med vertikale streker (f.eks. AU|KR|MY|SG). For å restrict alle land, skriv inn ALL som verdien. Hvis du ønsker å restrict alle land unntatt ett eller noen få, skriv inn ALL- etterfulgt av landene du ønsker å fjerne restriksjonen fra, adskilt med vertikale streker (f.eks. ALL-CA|FR|US). Lær mer om CSV-formattering. Hvis du ønsker å fjerne alle eksisterende restriktive land, skriv inn NONE som verdien.
  4. Lagre filen din som en CSV og last opp til Katalog ved å dra og slippe eller velge filen din ved å klikke på bla gjennom på samme side som du lastet ned CSV-en fra.
  5. Gå gjennom de opplastede produktene dine i forhåndsvisnings screen og klikk på last opp.

Filtrering av restriktive produkter:

Du kan filtrere restriktive produkter direkte i katalogen ved å laste ned hele katalogen din i CSV-format fra Dashboard og åpne den i Excel eller Google Sheets. Derfra kan du bruke filtreringsfunksjonen for å se kun de restriktive produktene. Dette lar deg enkelt finne og administrere de restriktive produktene i katalogen din.

Hvis du trenger å oppdatere katalogen din etter å ha gjort endringer i CSV-en, last opp filen på nytt, og eventuelle matchende produkter vil bli erstattet med den oppdaterte versjonen. Dette gjøres ved å identifisere og matche SKU og/eller produkt-ID.

Hvis du bruker Checkout, vil en begrenset melding bli vist i din checkout når et produkt er begrenset til kundens land. Som standard vil meldingen si "Dette elementet er begrenset fra import til ditt land," men du kan tilpasse din egen begrensede melding ved å oppgi den i feltet restrictedCountriesMessage når du legger til dine landbegrensninger.

Filtrer et produkt

Du kan søke etter produkter i Katalogen gjennom Dashboard eller via API ved å bruke enten SKU eller produkt-ID. Vær oppmerksom på at kun nøyaktige treff vil returnere resultater; delvise treff vil ikke bli gjenkjent.

Dashboard
API

For å filtrere etter SKU eller produkt-ID:

  1. Klikk på Produkter-fanen.
  2. Velg SKU eller Produkt-ID i øverste venstre hjørne av Katalogen din.
  3. Skriv inn din SKU eller produkt-ID.
  4. Klikk Bruk for å se dine filtrerte produkt(er).

Eksporter produktene dine

Hvis du velger 50 eller færre elementer fra Katalog-tabellen, vil katalogen din bli lastet ned direkte fra Dashboard. Hvis du derimot velger Eksporter alt eller mer enn 50 elementer, vil CSV-filen din bli eksportert via e-post.

For å eksportere 50 elementer eller færre, følg disse trinnene:

  1. Velg 50 eller færre elementer direkte fra Katalog-tabellen.
  2. Klikk Eksporter øverst til høyre.
  3. Finn CSV-filen din i innboksen din.

For å eksportere alle produkter:

Dashboard
API
  1. Gå til Dashboard -> Produkter -> Katalog.
  2. Klikk på Administrer katalog-rullegardinmenyen ved siden av Legg til produkt og klikk Eksporter alt.
  3. Finn katalogfilen din i nedlastinger.

Problemer med å laste ned fra e-posten din?

Hvis du har problemer med å laste ned CSV-filen fra e-postlenken, kan dette skyldes at nettleseren din blokkerer nedlastingen. Hvis det er tilfelle, følg disse trinnene:

  1. Høyreklikk på "Last ned"-knappen i e-posten din.
  2. Velg "Kopier lenkeadresse" for å kopiere nedlastings-URL-en.
  3. Lim inn den kopierte URL-en i nettleseren din og trykk enter.
  4. Katalogen din vil da lastes ned direkte fra nettleseren din.

Classify et produkt

Du kan classify et produkt fra katalogen din med API-en ved å bruke catalogItemId i ClassificationsCreateFromCatalog mutasjonen.

Merk at et name er påkrevd for å classify et produkt fra katalogen din. Se GraphQL API-referansen for en komplett liste over katalog- og klassifiseringsfelt.

For å opprette og classify et katalogprodukt samtidig, legg til ClassificationsCreateFromCatalog mutasjonen nedenfor til din CatalogItemsCreate mutasjon.

Classify et katalogprodukt til 8+ sifret (land-spesifikk)

Når shipToCountries-feltet er fylt ut, vil klassifiseringen være 8+ sifret (land-spesifikk) HS-kode. Hvis ingen shipToCountries er oppgitt, vil klassifiseringen som standard være en 6-sifret (universell) HS-kode. Lær mer om forskjellene mellom universelle og land-spesifikke HS-koder.

I eksemplet nedenfor er shipToCountries-feltet oppgitt for å generere en land-spesifikk kode for Canada.

Mutasjon

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 forespørsel. Mens Zonos Classify vil generere en klassifisering med bare et navn, anbefaler vi sterkt å legge til så mange detaljer som mulig for de beste klassifiseringsresultatene.

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

FeilLøsning
En SKU eller produkt-ID er nødvendig for å opprette et produktEn identifikator (SKU/produkt-ID) er nødvendig for å opprette, redigere eller slette et katalogelement. For å løse dette, legg til en SKU og/eller produkt-ID.
Produktet du prøver å redigere eksisterer ikke*Du kan ikke redigere et produkt som ikke eksisterer. For å løse dette, opprett et nytt produkt med ønsket SKU og/eller produkt-ID.
Tollbeskrivelse overskrider tegnbegrensningen på 30 tegn.Som standard er tollbeskrivelser begrenset til 30 tegn, noe som samsvarer med den vanligste tegnbegrensningen for kommersielle fakturaer.
Produkttype ugyldig. Katalogen støtter følgende produkttyper: digital_good. For fysiske varer, la det stå tomt.Katalogen støtter kun følgende produkttyper: digital_good og physical_good. Hvis produktet ditt er en fysisk vare (mest vanlig), la dette feltet stå tomt.
Pakkeinnstilling ugyldig. Katalogen støtter følgende pakkeinnstillinger: ships_alone og consolidated. Hvis produktet ditt kan konsolideres med andre produkter, la det stå tomt.Pakkeinnstilling ugyldig. Katalogen støtter følgende pakkeinnstillinger: ships_alone og consolidated. Hvis produktet ditt kan konsolideres med andre produkter, kan du la det stå tomt, da consolidated er standard.
Land må spesifiseres når en HS-kode oppgisHvis du oppgir en landsspesifikk HS-kode når du oppretter et element, er et leveringsland nødvendig. For å løse dette, legg til et leveringsland.
Prisen må være større enn 0Katalogen støtter ikke negative prisverdier. For å løse dette, legg til en pris større enn null.
Valuta kode må oppgis når en prisverdi er oppgittHvis du oppgir en pris, er en valutakode nødvendig. For å løse dette, legg til en valutakode.
Pris må oppgis når en valutakode er oppgittHvis du oppgir en valutakode, er en pris nødvendig. For å løse dette, legg til en pris.
Det medfølgende dimensjonsfeltet kan ikke stå tomtHvis ett dimensjonsfelt er oppgitt, er de to andre nødvendige. F.eks., hvis du oppgir en bredde på “8 tommer,” så vil høyde og lengde være nødvendige.
Målverdi må være større enn 0Katalogen støtter ikke negative eller null målverdier. For å løse dette, legg til en verdi større enn null.
Når du oppgir en dimensjonsverdi, kan ikke dimensjonsenheter stå tommeHvis du oppgir en dimensjonsverdi, er en dimensjonsenhet nødvendig. For å løse dette, legg til en dimensjonsenhet.
Når du oppgir en vektverdi, kan ikke vekt enheten stå tommeHvis du oppgir en vektverdi, er en vekt enhet nødvendig. For å løse dette, legg til en vekt enhet.

* API-feil kun

Var denne siden nyttig?