Hvordan opretter man et produkt i Zonos-kataloget?

Du kan oprette et produkt i Zonos-kataloget enten via Dashboard eller API. I Dashboard skal du gå til Katalog og klikke på Tilføj produkt i øverste højre hjørne. Tilføj dine produktoplysninger, og klik på Gem produkt. Hvis du vil oprette flere produkter på én gang, skal du følge trinene for import af produkter. I API skal du oprette en liste over catalogItemInputs for at tilføje produkter til dit katalog.

Hvordan redigerer man et produkt i Zonos-kataloget?

Du kan redigere et produkt i Zonos-kataloget enten via Dashboard eller API. I Dashboard skal du klikke på fanen Alle produkter, vælge det produkt, du vil redigere, foretage dine ændringer og klikke på Gem produkt. I API skal du bruge CatalogItemUpdate-mutationen til at redigere et produkt.

Hvordan sletter man et produkt i Zonos-kataloget?

Du kan slette et produkt i Zonos-kataloget enten via Dashboard eller API. I Dashboard skal du klikke på fanen Alle produkter, vælge det eller de produkter, du vil slette, og klikke på slet. I API skal du bruge CatalogItemDelete-mutationen til at slette et produkt.

Hvordan begrænser man et produkt i Zonos-kataloget?

Hvis du vil forhindre forsendelser til et bestemt land (eller lande), kan du tilføje begrænsninger, når du opretter eller opdaterer et produkt i Zonos-kataloget. I Dashboard skal du vælge det produkt, du vil tilføje en begrænsning til, finde begrænsningsafsnittet nederst på redigeringssiden, tilføje de lande, du vil begrænse dit produkt til, og klikke på Gem produkt. Tilføj restrictedCountries i API, når du opretter eller opdaterer et catalogItem.

Hvordan eksporterer du dine produkter i Zonos Dashboard?

Når du eksporterer dine produkter i Zonos Dashboard, vil det automatisk eksportere hele dit produktkatalog i en CSV-fil. Gå til hovedsiden af dit katalog, klik på knappen Eksporter ved siden af Tilføj produkt, og find din fulde katalogfil i dine downloads.

Hvordan klassificeres et katalogprodukt via API?

Du kan klassificere et produkt fra dit katalog ved at bruge catalogItemId i ClassificationsCreateFromCatalog-mutationen. Bemærk, at der kræves et navn for at klassificere et produkt fra dit katalog. For at oprette og klassificere et katalogprodukt samtidigt skal du tilføje ClassificationsCreateFromCatalog-mutationen til din CatalogItemsCreate-mutation.

HjemGlobal e-handel Katalog Administrer produkter

Administrer katalog

Opret og rediger produkter.

Lær, hvordan du tilføjer, ændrer og sletter dine Zonos-katalogprodukter i Dashboard eller via API. Brug Catalog i Dashboard for at undgå at skrive kode, eller hvis du laver små ændringer. Hvis du ønsker at integrere direkte med Catalog til produktionsimplementeringer, skal du bruge API'en.

Opret et produkt

Opret et produkt i kataloget:

Gå til Catalog, og klik på Tilføj produkt i øverste højre hjørne.
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. Få mere at vide om Katalogets identifikatorer.
Valgfrit—Tilføj dine HS-koder.
Valgfrit—Tilføj dine forsendelsesoplysninger (vægt, dimensioner, måleenheder osv.).
Valgfrit—Tilføj begrænsede lande.
Klik på gem produkt.

Opret flere produkter i kataloget:

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

Vigtig: Hvis du forsøger at oprette et produkt, der allerede eksisterer, genkender Catalog produktet baseret på SKU og/eller produkt-id og tilsidesætter det originale produkts detaljer med de nye detaljer.

Tag et produkt som farligt gods (DHL)

For DHL-forsendelser kan du mærke et produkt som farligt gods, så den korrekte DHL-tillægstjeneste anvendes automatisk, hver gang du opretter en etiket for det pågældende produkt. Dette dækker "lavrisiko" eller fritagne klasser af regulerede varer - varer, der er teknisk reguleret, men afsendes under en særlig bestemmelse eller mængdefritagelse.

Et mærke for farligt gods gemmes som en katalogvare attribut: et key/value-par på produktet. Attributter indstilles gennem API'en (catalogItemsCreate eller catalogItemsUpdate) – der er ikke noget Dashboard-felt eller CSV-kolonne for dem.

Kun DHL

Mærkning af farligt gods påvirker kun DHL-forsendelser. Tagget ignoreres for andre transportører.

Understøttet attributnøgle

DANGEROUS_GOODS er en understøttet attributnøgle til DHL-mærkning af farligt gods. Den er endnu ikke opført blandt de godkendte nøgler i ItemAttributeInput-referencen, men det er accepteret af API'en.

For at tagge et produkt skal du tilføje en attribut med nøglen DANGEROUS_GOODS og en værdi af en af de understøttede kategorier 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

Understøttede værdier for farligt gods

Værdi↕	Kategori↕
`NOT_RESTRICTED_A70`	Ikke begrænset, særlig bestemmelse A70 – tryksatte artikler, såsom gasfjedre og støddæmpere (UN3164).
`NOT_RESTRICTED_A67`	Ikke begrænset, særlig bestemmelse A67 – motorer eller maskineri drevet af brændbar væske (UN3528).
`NOT_RESTRICTED_A02`	Ikke begrænset, særlig bestemmelse A02 – undtaget i henhold til ADR-bestemmelsen om vejtransport af små belastninger.
`LIMITED_QUANTITY`	Begrænset mængde (ADR) – farligt gods pakket i små mængder inden for lovmæssige grænser.
`EXCEPTED_QUANTITY`	Undtaget mængde (IATA) - meget små mængder undtaget fra de fleste regler for farligt gods i lufttransport.
`CONSUMER_COMMODITY`	Forbrugervare ID8000—detailklare hverdagsprodukter med mindre farligt indhold, såsom aerosoler og parfume.
`MAGNETIZED_MATERIAL`	Magnetiseret materiale (UN2807) - genstande med et magnetfelt, der er stærkt nok til at påvirke flyinstrumenter.
`BIOLOGICAL_SUBSTANCE`	Biologisk stof (UN3373)—Biologiske stoffer i kategori B, såsom diagnostiske eller kliniske prøver.

Anvend tags automatisk på etiketter

At mærke et produkt er det første skridt. For at få Zonos anvende kategorien på din DHL-etiketter automatisk, slå Send farligt gods ind etiketindstillinger. Du kan også vælg en kategori manuelt på en enkelt etiket – se erklære farligt gods.

Rediger et produkt

Redigering af produkter giver dig mulighed for effektivt at opdatere dine eksisterende produkter med yderligere eller opdateret information. I stedet for at skulle slette og uploade produktet igen, 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 varenøglepræference. 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 kataloget, skal du forvente følgende:

Katalog vil skrive over tomme felter på eksisterende varer.

For eksempel, hvis et eksisterende produkt, SKU 321, ikke havde en vægtværdi, 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 tilsidesætte det tidligere tomme felt.

Katalog vil tilsidesætte 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 tilsidesætte den tidligere pris.

Katalog vil ikke tilsidesætte 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.

Sådan redigerer du et produkt:

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

For at redigere flere eller alle produkter på én gang skal du blot uploade en opdateret CSV-fil til kataloget, inklusive dit SKU eller produkt-id. Dette vil udløse automatiske opdateringer af dine eksisterende varer.

Slet et produkt

Sådan sletter du et produkt:

Klik på fanen Produkter i Dashboard.
Vælg det eller de produkter, du vil slette. Når dine produkter er valgt, vises en sletknap.
Klik på Slet og derefter på Slet alle for at bekræfte din sletning.

Sådan sletter du alle produkter:

Vælg fanen Produkter i Dashboard.
Klik på Administrer katalog i øverste højre hjørne og derefter på Slet alle.
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), vises en meddelelse, der angiver, at din sletning er i gang. I løbet af denne tid vil du ikke være i stand til at interagere med Catalog, før sletningen er fuldført. Du kan dog afvise meddelelsen og navigere væk uden at afbryde sletningsprocessen.

Restrict et produkt

Hvis du vil forhindre forsendelser til et bestemt land (eller lande), kan du tilføje begrænsninger, når du opretter eller opdaterer et produkt.

Zonos Duty & Tax apps understøtter ikke begrænsninger på vareniveau, der fjerner specifikke produkter fra internationale ordrer. Hvis en begrænset vare er i vognen, skal hele vognen spærres fra forsendelse til det pågældende land. Dette håndteres gennem en begrænsningsregel på vognniveau, som skal konfigureres på forhånd under onboarding. Selvom Catalog er kompatibel med told- og skat-apps, understøttes begrænsninger på vareniveau kun, når du bruger Zonos Checkout.

Sådan begrænser du et enkelt produkt i kataloget:

Klik på fanen Produkter.
Vælg det produkt, du vil tilføje en begrænsning til, hvilket åbner redigeringssiden.
Find afsnittet Restricted lande nederst på redigeringssiden.
Tilføj de lande, du vil begrænse dit produkt til, ved at vælge eller skrive landenavnet/-navnene.
Klik på gem produkt.

Sådan begrænser du flere produkter i kataloget:

Klik på fanen Import/eksport.
Download Catalog CSV-skabelon.
Udfyld skabelonen med dine produktoplysninger, inklusive dit SKU/produkt-id og lande, der er underlagt begrænsninger. Indtast den 2-cifrede ISO-kode adskilt af lodrette streger, f.eks. AU|KR|MY|SG. For at begrænse alle lande skal du blot indtaste ALL som værdien. Hvis du vil begrænse alle lande undtagen et eller få, skal du indtaste ALL- efterfulgt af de lande, du gerne vil ophæve, adskilt af lodrette streger, f.eks. ALL-CA|FR|US. Få mere at vide om CSV-formatering. Hvis du vil fjerne alle eksisterende begrænsede lande, skal du indtaste NONE som værdien.
Gem din fil som en CSV og upload til Catalog ved at trække og slippe eller vælge din fil ved at klikke på gennemse på den samme side, som du downloadede CSV'en fra.
Gennemgå dine uploadede produkter på forhåndsvisningsskærmen, og klik på upload.

Filtrering af begrænsede produkter:

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

Hvis du har brug for at opdatere dit katalog efter at have foretaget ændringer i din CSV, skal du uploade filen igen, og alle 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, vises en begrænsningsmeddelelse i din Checkout, når et produkt er begrænset til kundens land. Som standard siger meddelelsen: „Denne vare må ikke importeres til dit land.“

Filtrer et produkt

Du kan søge efter produkter i kataloget gennem Dashboard eller via API ved hjælp af SKU, produkt-id eller produktnavn. For SKU- og produkt-id-søgninger vil kun eksakte matches returnere resultater; delvise matchninger understøttes ikke. Ved søgning på produktnavn understøttes dog delvise matchninger.

Sådan filtrerer du efter SKU eller produkt-id:

Klik på fanen Produkter i Dashboard.
Vælg SKU eller Produkt-id øverst til venstre i dit katalog.
Indtast dit SKU, produkt-id eller produktnavn.
Klik på Anvend for at se dine filtrerede produkter.

Sådan søger du efter et produkts navn:

Klik på fanen Produkter i Dashboard.
Indtast produktnavnet i søgefeltet øverst til højre i dit katalog.
Se dine filtrerede produkter.

Eksporter dine produkter

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

Følg disse trin for at eksportere 50 varer eller færre:

Vælg 50 eller færre elementer direkte fra katalogtabellen.
Klik på Eksporter i øverste højre hjørne.
Find din CSV-fil i din e-mail-indbakke.

For at eksportere alle produkter:

Gå til Dashboard -> Produkter -> Katalog.
Klik på rullemenuen Administrer katalog ud for Tilføj produkt, og klik på Eksporter alle.
Find din katalogfil i dine downloads.

Problemer med at downloade fra din e-mail?

Hvis du har problemer med at downloade CSV'en fra e-mail-linket, kan det skyldes, at din browser blokerer overførslen. Hvis ja, følg disse trin:

Højreklik på knappen "Download" i din e-mail.
Vælg "Kopiér linkadresse" for at kopiere download-URL'en.
Indsæt den kopierede URL i din browser, og klik på Enter.
Dit katalog vil derefter downloades direkte fra din browser.

Classify et produkt

Du kan klassificere et produkt fra dit katalog med API'et ved at bruge catalogItemId i ClassificationsCreateFromCatalog-mutationen.

Bemærk, at et name er påkrævet for at klassificere et produkt fra dit katalog. Se GraphQL API reference for en komplet liste over kataloger og klassifikationsfelter.

For at oprette og klassificere et katalogprodukt samtidigt skal du tilføje ClassificationsCreateFromCatalog-mutationen nedenfor til din CatalogItemsCreate mutation.

Classify et katalogprodukt til 8+ cifre (landespecifikt)

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

I eksemplet nedenfor er shipToCountries-feltet angivet for at generere en landespecifik 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 anmodning. Mens Zonos Classify vil generere en klassifikation med kun et name, anbefaler vi kraftigt at tilføje så mange detaljer som muligt til bedste klassificeringsresultater.

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

API fejl og opløsninger

Fejl↕	Opløsning↕
*Der kræves en SKU eller et produkt-id for at oprette et produkt*	En identifikator (SKU/produkt-id) er påkrævet for at oprette, redigere eller slette et katalogelement. For at løse dette skal du tilføje en SKU og/eller et produkt-id.
*Produktet du forsøger at redigere eksisterer ikke**	Du kan ikke redigere et produkt, der ikke eksisterer. For at løse dette skal du oprette et nyt produkt med din ønskede SKU og/eller produkt-id.
*Tilpasset beskrivelse overskrider tegngrænsen på 30 tegn.*	Som standard er toldbeskrivelser begrænset til 30 tegn, hvilket stemmer overens med den mest almindelige tegngrænse for handelsfakturaer.
*Produkttype ugyldig. Katalog understøtter følgende produkttyper: digital_good. For fysiske varer, lad det stå tomt.*	Katalog understøtter kun følgende produkttyper: `digital_good` og `physical_good`. Hvis dit produkt er en fysisk vare (mest almindeligt), skal du lade dette felt stå tomt.
*Pakningspræference ugyldig. Katalog understøtter følgende pakningspræferencer: ships_alone og consolidated. Hvis dit produkt kan konsolideres med andre produkter, lad det stå tomt.*	Pakningspræference ugyldig. Katalog understøtter følgende pakkepræferencer: `ships_alone` og `consolidated`. Hvis dit produkt kan konsolideres med andre produkter, kan du lade feltet stå tomt — `consolidated` er standard.
*Der skal angives et land, når der oplyses en HS-kode*	Hvis du angiver en landespecifik HS-kode, når du opretter en vare, kræves et forsendelsesland. Tilføj et forsendelsesland for at løse fejlen.
*Prisen skal være større end 0*	Katalog understøtter ikke negative prisværdier. For at løse dette skal du tilføje en pris, der er større end nul.
*Valutakode skal angives, når en prisværdi er angivet*	Hvis du angiver en pris, kræves en valutakode. For at løse dette skal du tilføje en valutakode.
*Pris skal oplyses, når en valutakode leveres*	Hvis du angiver en valutakode, er en pris påkrævet. Tilføj en pris for at løse dette.
*Det medfølgende dimensionsfelt må ikke efterlades tomt*	Hvis der er angivet et dimensionsfelt, er de to andre påkrævet, f.eks. Hvis du angiver en bredde på 8 tommer, vil højden og længden være påkrævet.
*Måleværdi skal være større end 0*	Katalog understøtter ikke negative eller nul måleværdier. For at løse dette skal du tilføje en værdi større end nul.
*Når der angives en dimensionsværdi, må dimensionsenheder ikke stå tomme*	Hvis du angiver en dimensionel værdi, er en dimensionel enhed påkrævet. For at løse dette skal du tilføje en dimensionel enhed.
*Når der angives en vægtværdi, kan vægtenheden ikke stå tom*	Hvis du angiver en vægtværdi, kræves en vægtenhed. For at løse dette skal du tilføje en vægtenhed.

* kun API-fejl

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

INPUTS

ItemAttributeInput

Book en demo