Hvordan oppretter jeg et produkt i Zonos Catalog?

Du kan opprette et produkt i Zonos Catalog enten via Dashboard eller API. I Dashboard går du til Catalog og klikker på Add product i øvre høyre hjørne. Legg til produktdetaljene dine og klikk save product. Hvis du vil opprette flere produkter samtidig, følger du trinnene for å importere produkter. I API oppretter du en liste over catalogItemInputs for å legge til produkter i katalogen.

Hvordan redigerer jeg et produkt i Zonos Catalog?

Du kan redigere et produkt i Zonos Catalog enten via Dashboard eller API. I Dashboard klikker du på All products-fanen, velger produktet du vil redigere, gjør endringene dine og klikker save product. I API bruker du CatalogItemUpdate-mutasjonen til å redigere et produkt.

Hvordan sletter jeg et produkt i Zonos Catalog?

Du kan slette et produkt i Zonos Catalog enten via Dashboard eller API. I Dashboard klikker du på All products-fanen, velger produktet eller produktene du vil slette og klikker delete. I API bruker du CatalogItemDelete-mutasjonen til å slette et produkt.

Hvordan begrenser jeg et produkt i Zonos Catalog?

Hvis du vil forhindre forsendelser til et bestemt land (eller flere land), kan du legge til restriksjoner når du oppretter eller oppdaterer et produkt i Zonos Catalog. I Dashboard velger du produktet du vil legge til en begrensning for, finner begrensningsdelen nederst på redigeringssiden, legger til landene du vil begrense produktet ditt til og klikker save product. I API legger du til restrictedCountries når du oppretter eller oppdaterer en catalogItem.

Hvordan eksporterer jeg produktene dine i Zonos Dashboard?

Når du eksporterer produktene dine i Zonos Dashboard, eksporteres hele produktkatalogen din automatisk i en CSV-fil. Gå til hovedsiden i Catalog, klikk Export-knappen ved siden av Add product og finn hele katalogfilen din i nedlastingene.

Hvordan klassifiserer jeg et katalogprodukt via API?

Du kan klassifisere et produkt fra katalogen din ved å bruke catalogItemId i mutasjonen ClassificationsCreateFromCatalog. Merk at et navn er påkrevd for å klassifisere et produkt fra katalogen. For å opprette og klassifisere et katalogprodukt samtidig, legger du til mutasjonen ClassificationsCreateFromCatalog i mutasjonen CatalogItemsCreate.

HjemGlobal e-handel Catalog Administrer produkter

Administrer katalog

Opprett og endre produkter.

Lær hvordan du legger til, endrer og sletter produktene dine i Zonos Catalog i Dashboard eller via API. Bruk Catalog i Dashboard for å unngå å skrive kode eller hvis du gjør små endringer. Hvis du vil integrere direkte med Catalog for produksjonsimplementeringer, bruker du API-en.

Opprett et produkt

Opprett et produkt i Catalog:

Gå til Catalog og klikk på Add product i øvre høyre hjørne.
Legg til produktdetaljer. Det eneste obligatoriske feltet for å opprette et produkt er SKU- og/eller produkt-ID-feltet. Disse feltene brukes til å referere til katalogproduktene dine. Lær mer om Catalog-identifikatorer.
Valgfritt—Legg til HS-kode(r).
Valgfritt—Legg til fraktinformasjon (vekt, dimensjoner, måleenheter osv.).
Valgfritt—Legg til begrensede land.
Klikk save product.

Opprett flere produkter i Catalog:

Last opp flere produkter eller hele produktkatalogen din samtidig.

Viktig: Hvis du prøver å opprette et produkt som allerede finnes, vil Catalog gjenkjenne produktet basert på SKU og/eller produkt-ID og overstyre det opprinnelige produktets detaljer med de nye detaljene.

Merk et produkt som farlig gods (DHL)

For DHL-forsendelser kan du merke et produkt som farlig gods slik at riktig DHL-verditilleggstjeneste brukes automatisk hver gang du oppretter en etikett for det produktet. Dette dekker varer i kategoriene «lav risiko» eller unntak fra regulerte varer – varer som teknisk sett er regulert, men som sendes under en spesiell bestemmelse eller et mengdeunntak.

Et farlig gods-merke lagres som et katalogvare-attributt: et key/value-par på produktet. Attributter angis gjennom API-en (catalogItemsCreate eller catalogItemsUpdate) – det finnes ikke noe Dashboard-felt eller CSV-kolonne for dem.

Kun DHL

Merking av farlig gods påvirker bare DHL-forsendelser. Merket ignoreres for andre transportører.

Støttet attributtnøkkel

DANGEROUS_GOODS er en støttet attributtnøkkel for DHL-merking av farlig gods. Den er ennå ikke oppført blant de godkjente nøklene i ItemAttributeInput-referansen, men den godtas av API-en.

For å merke et produkt legger du til et attributt med nøkkelen DANGEROUS_GOODS og en verdi som er en av de støttede kategoriene nedenfor.

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 ) {

9 id

10 name

11 sku

12 attributes {

13 key

14 value

Støttede farlig gods-verdier

Verdi↕	Kategori↕
`NOT_RESTRICTED_A70`	Ikke begrenset, spesiell bestemmelse A70—trykksatte artikler, for eksempel gassfjærer og støtdempere (UN3164).
`NOT_RESTRICTED_A67`	Ikke begrenset, spesiell bestemmelse A67—motorer eller maskiner drevet av brennbar væske (UN3528).
`NOT_RESTRICTED_A02`	Ikke begrenset, spesiell bestemmelse A02—unntatt etter ADR-veitransportbestemmelsen for småmengder.
`LIMITED_QUANTITY`	Begrenset mengde (ADR)—farlig gods pakket i små mengder innenfor regulatoriske grenser.
`EXCEPTED_QUANTITY`	Unntatt mengde (IATA)—svært små mengder unntatt fra de fleste lufttransportreglene for farlig gods.
`CONSUMER_COMMODITY`	Konsumentvare ID8000—detaljhandelsklare hverdagsprodukter med mindre farlig innhold, for eksempel spraybokser og parfyme.
`MAGNETIZED_MATERIAL`	Magnetisert materiale (UN2807)—gjenstander med et magnetfelt sterkt nok til å påvirke flyinstrumenter.
`BIOLOGICAL_SUBSTANCE`	Biologisk substans (UN3373)—kategori B biologiske substanser, for eksempel diagnostiske eller kliniske prøver.

Bruk merker automatisk på etiketter

Merking av et produkt er det første trinnet. For at Zonos skal bruke kategorien på DHL-etikettene dine automatisk, slår du på Ship dangerous goods i etikettinnstillinger. Du kan også velge en kategori manuelt på en enkelt etikett—se deklarere farlig gods.

Rediger et produkt

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

Hvis du oppretter/redigerer et katalogprodukt som allerede finnes i Catalog, kan du forvente følgende:

Catalog vil skrive over tomme felt på eksisterende gjenstander.

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 pund i den nye opplastingen, ville vekten på 1,3 pund overstyre det tidligere tomme feltet.

Catalog vil overstyre 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 overstyre den forrige prisen.

Catalog vil ikke overstyre 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.

For å redigere et produkt:

Klikk på Products-fanen.
Velg produktet du vil redigere.
Gjør endringene dine.
Klikk save product.

For å redigere flere eller alle produkter på en gang, laster du bare opp en oppdatert CSV-fil til Catalog, inkludert SKU-en eller produkt-ID-en. Dette vil utløse automatiske oppdateringer av eksisterende gjenstander.

Slett et produkt

For å slette et produkt:

Klikk på Products-fanen i Dashboard.
Velg produktet(ene) du vil slette. Når produktet(ene) er valgt, vises en slettknapp.
Klikk Delete og deretter Delete all for å bekrefte slettingen.

For å slette alle produkter:

Velg Products-fanen i Dashboard.
Klikk Manage Catalog i øvre høyre hjørne, og deretter Delete all.
Klikk Delete all én gang til for å bekrefte slettingen.

Merk at hvis du sletter et stort antall gjenstander (mer enn cirka 20 000 produkter), vises det et varsel som indikerer at slettingen pågår. I løpet av denne tiden kan du ikke samhandle med Catalog før slettingen er fullført. Du kan imidlertid lukke varselet og navigere bort uten å avbryte slettingsprosessen.

Begrens et produkt

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

Zonos Duty & Tax-apper støtter ikke begrensninger på artikkelnivå som fjerner spesifikke produkter fra internasjonale bestillinger. Hvis en begrenset artikkel ligger i handlekurven, må hele handlekurven blokkeres fra forsendelse til det landet. Dette håndteres gjennom en regel for begrensning på kurvenivå, som må konfigureres på forhånd under onboarding. Selv om Catalog er kompatibel med Duty & Tax-apper, støttes artikkelnivåbegrensninger bare ved bruk av Zonos Checkout.

For å begrense et enkelt produkt i Catalog:

Klikk på Products-fanen.
Velg produktet du vil legge til en begrensning for, som åpner redigeringssiden.
Finn delen Restricted countries nederst på redigeringssiden.
Legg til landene du vil begrense produktet til, ved å velge eller skrive inn landnavnet(ene).
Klikk save product.

For å begrense flere produkter i Catalog:

Klikk på Import/export-fanen.
Last ned Catalog template CSV.
Fyll ut malen med produktdetaljene dine, inkludert SKU/produkt-ID og begrensede land. Angi 2-siffers ISO-koden atskilt med loddrett strek, for eksempel AU|KR|MY|SG. For å begrense alle land, skriver du bare ALL som verdien. Hvis du vil begrense alle land unntatt ett eller noen få, skriver du ALL- etterfulgt av landene du vil oppheve begrensningen for, atskilt med loddrett strek, for eksempel ALL-CA|FR|US. Lær mer om CSV-formatering. Hvis du vil fjerne alle eksisterende begrensede land, skriver du NONE som verdien.
Lagre filen som CSV og last den opp til Catalog ved å dra og slippe, eller ved å velge filen ved å klikke browse på samme side der du lastet ned CSV-en.
Gjennomgå de opplastede produktene på forhåndsvisningsskjermen og klikk upload.

Filtrering av begrensede produkter:

Du kan filtrere begrensede produkter direkte i katalogen ved å laste ned hele katalogen i CSV-format fra Dashboard og åpne den i Excel eller Google Sheets. Derfra kan du bruke filtreringsfunksjonen for å vise bare de begrensede produktene. Dette lar deg enkelt finne og håndtere de begrensede produktene i katalogen.

Hvis du trenger å oppdatere katalogen din etter å ha gjort endringer i CSV-en, laster du opp filen på nytt, og alle samsvarende produkter erstattes med den oppdaterte versjonen. Dette gjøres ved å identifisere og matche SKU-en og/eller produkt-ID-en.

Hvis du bruker Checkout, vises det en begrensningsmelding i checkouten når et produkt er begrenset for kundens land. Som standard vil meldingen si «This item is restricted from import to your country.»

Filtrer et produkt

Du kan søke etter produkter i Catalog gjennom Dashboard eller via API ved hjelp av SKU, produkt-ID eller produktnavn. For SKU- og produkt-ID-søk returneres bare nøyaktige samsvar; delvis samsvar støttes ikke. Når du søker etter produktnavn, støttes imidlertid delvis samsvar.

For å filtrere etter SKU eller produkt-ID:

Klikk på Products-fanen i Dashboard.
Velg SKU eller Product ID i øvre venstre hjørne av Catalog.
Angi SKU-en, produkt-ID-en eller produktnavnet.
Klikk Apply for å vise de filtrerte produktene.

For å søke etter et produktnavn:

Klikk på Products-fanen i Dashboard.
I øvre høyre hjørne av Catalog skriver du produktnavnet i søkefeltet.
Vis de filtrerte produktene.

Eksporter produktene dine

Hvis du velger 50 eller færre gjenstander fra Catalog-tabellen, lastes katalogen ned direkte fra Dashboard. Hvis du derimot velger Export all eller mer enn 50 gjenstander, eksporteres CSV-en via e-post.

For å eksportere 50 gjenstander eller færre, følger du disse trinnene:

Velg 50 eller færre gjenstander direkte fra Catalog-tabellen.
Klikk Export i øvre høyre hjørne.
Finn CSV-filen i e-postinnboksen din.

For å eksportere alle produkter:

Gå til Dashboard -> Products -> Catalog.
Klikk på Manage Catalog-rullegardinmenyen ved siden av Add product og klikk Export all.
Finn katalogfilen i nedlastingene dine.

Problemer med nedlasting fra e-posten din?

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

Høyreklikk på «Download»-knappen i e-posten.
Velg «Copy link address» for å kopiere nedlastings-URL-en.
Lim inn den kopierte URL-en i nettleseren og trykk enter.
Katalogen lastes deretter ned direkte fra nettleseren.

Klassifiser et produkt

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

Merk at et name er påkrevd for å klassifisere et produkt fra katalogen. Konsulter GraphQL API-referansen for en fullstendig liste over katalog- og klassifiseringsfelt.

For å opprette og klassifisere et katalogprodukt samtidig legger du til ClassificationsCreateFromCatalog-mutasjonen nedenfor i din CatalogItemsCreate-mutasjon.

Klassifiser et katalogprodukt til 8+ sifret (landsspesifikk)

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

I eksemplet nedenfor er feltet shipToCountries gitt for å generere en landsspesifikk kode for Canada.

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

Her er et eksempel på en forespørsel. Mens Zonos Classify vil generere en klassifisering med bare et name, anbefaler vi på det sterkeste at du legger til så mange detaljer som mulig for de beste klassifiseringsresultatene.

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

API-feil og løsninger

Feil↕	Løsning↕
*A SKU or product ID is required to create a product*	En identifikator (SKU/produkt-ID) er påkrevd for å opprette, redigere eller slette en katalogvare. For å løse dette legger du til en SKU og/eller produkt-ID.
*The product you are trying to edit does not exist**	Du kan ikke redigere et produkt som ikke finnes. For å løse dette, oppretter du et nytt produkt med ønsket SKU og/eller produkt-ID.
*Customs description exceeds character limit of 30 characters.*	Som standard er tollbeskrivelser begrenset til 30 tegn, noe som samsvarer med den mest vanlige tegnbegrensningen for kommersielle fakturaer.
*Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.*	Catalog støtter bare følgende produkttyper: `digital_good` og `physical_good`. Hvis produktet ditt er en fysisk vare (mest vanlig), lar du feltet være tomt.
*Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.*	Pakkepreferanse er ugyldig. Catalog støtter følgende pakkepreferanser: `ships_alone` og `consolidated`. Hvis produktet ditt kan konsolideres med andre produkter, kan du la det være tomt da `consolidated` er standarden.
*Country must be specified when providing an HS code*	Hvis du gir en landsspesifikk HS-kode når du oppretter en vare, er et forsendelsesland påkrevd. For å løse dette legger du til et forsendelsesland.
*Price must be greater than 0*	Catalog støtter ikke negative prisverdier. For å løse dette legger du til en pris større enn null.
*Currency code must be provided when a price value is supplied*	Hvis du angir en pris, er en valutakode påkrevd. For å løse dette legger du til en valutakode.
*Price must be provided when a currency code is supplied*	Hvis du angir en valutakode, er en pris påkrevd. For å løse dette legger du til en pris.
*The accompanying dimensional field cannot be left blank*	Hvis ett dimensjonsfelt er oppgitt, er de to andre påkrevd. Hvis du for eksempel angir en bredde på 8 inches, vil høyde og lengde også være påkrevd.
*Measurement value must be greater than 0*	Catalog støtter ikke negative eller null måleverdier. For å løse dette legger du til en verdi større enn null.
*When providing a dimensional value, dimensional units cannot be left empty*	Hvis du angir en dimensjonsverdi, er en dimensjonsenhet påkrevd. For å løse dette legger du til en dimensjonsenhet.
*When providing a weight value, the weight unit cannot be left empty*	Hvis du angir en vektverdi, er en vektenhet påkrevd. For å løse dette legger du til en vektenhet.

* Kun API-feil

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

ItemAttributeInput

Bestill en demo