DOCS

Administrer produkter

Administrer katalog

Opret og modificere 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 i kataloget:

  1. Gå til Catalog, 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. Få mere at vide om Katalogets identifikatorer.
  3. Valgfrit—Tilføj dine HS-koder.
  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 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.

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: akey/valuepar på produktet. Attributter indstilles gennem API'en (catalogItemsCreateellercatalogItemsUpdate) – 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_GOODSer 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' reference, men det er accepteret af API'en.

For at tagge et produkt skal du tilføje en attribut med nøglenDANGEROUS_GOODSog 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ærdiKategori
NOT_RESTRICTED_A70Ikke Restricted, Special Provision A70 – tryksatte artikler, såsom gasfjedre og støddæmpere (UN3164).
NOT_RESTRICTED_A67Ikke Restricted, Special Provision A67—motorer eller maskineri drevet af brændbar væske (UN3528).
NOT_RESTRICTED_A02Ikke Restricted, særlig bestemmelse A02 – undtaget i henhold til ADR-bestemmelsen om vejtransport af små belastninger.
LIMITED_QUANTITYBegrænset mængde (ADR) – farligt gods pakket i små mængder inden for lovmæssige grænser.
EXCEPTED_QUANTITYUndtaget mængde (IATA) - meget små mængder undtaget fra de fleste regler for farligt gods i lufttransport.
CONSUMER_COMMODITYForbrugervare ID8000—detailklare hverdagsprodukter med mindre farligt indhold, såsom aerosoler og parfume.
MAGNETIZED_MATERIALMagnetiseret materiale (UN2807) - genstande med et magnetfelt, der er stærkt nok til at påvirke flyinstrumenter.
BIOLOGICAL_SUBSTANCEBiologisk 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.

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:

  1. Klik på fanen Produkter.
  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 kataloget, inklusive dit SKU eller produkt-id. Dette vil udløse automatiske opdateringer af dine eksisterende varer.

Sådan sletter du et produkt:

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

Sådan sletter du alle produkter:

  1. Vælg fanen Produkter i Dashboard.
  2. Klik på Administrer katalog i øverste højre hjørne og derefter på 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), 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.

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:

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

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

  1. Klik på fanen Import/eksport.
  2. Download Catalog CSV-skabelon.
  3. 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 indtasteALLsom værdien. Hvis du vil begrænse alle lande undtagen et eller få, skal du indtasteALL-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. Indtast, hvis du vil fjerne alle eksisterende begrænsede landeNONEsom værdien.
  4. 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.
  5. 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.“

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 kampe understøttes ikke. Ved søgning på produktnavn understøttes dog delvise matchninger.

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

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

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

  1. Klik på fanen Produkter i Dashboard.
  2. Indtast produktnavnet i søgefeltet øverst til højre i dit katalog.
  3. Se dine filtrerede 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:

  1. Vælg 50 eller færre elementer direkte fra katalogtabellen.
  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: 

  1. Gå til Dashboard -> Produkter -> Katalog.
  2. Klik på rullemenuen Administrer katalog ud for Tilføj produkt, og klik på Eksporter alle.
  3. 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:

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

Du kan klassificere et produkt fra dit katalog med API'et ved at brugecatalogItemIdiClassificationsCreateFromCatalogmutation.

Bemærk at anameer 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øjeClassificationsCreateFromCatalogmutation nedenfor til dinCatalogItemsCreatemutation.

Classify et katalogprodukt til 8+ ciffer (landespecifikt) 

NårshipToCountriesfeltet er udfyldt, vil klassifikationen være 8+ cifret (landespecifik) HS-kode. Hvis nejshipToCountrieser angivet, 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 ershipToCountriesfeltet er 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 enname, 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 

FejlOpløsning
Der kræves en SKU eller et produkt-id 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 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_goodogphysical_good. Hvis dit produkt er et fysisk vare (mest almindeligt), skal du lade dette felt stå 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.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.
Country must be specified when providing an HS codeHvis 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 0Katalog 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 angivetHvis 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 leveresHvis 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 tomtHvis 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 0Katalog 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å tommeHvis 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å tomHvis 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
Book en demo

Var denne side nyttig?