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 å opprett et produkt er SKU- og/eller produkt-ID-feltet. Disse feltene brukes til å referere til katalogproduktene dine. Lær mer om Catalog's identifiers.
- Valgfritt—Legg til HS-kode(r).
- Valgfritt—Legg til fraktinformasjon (vekt, dimensjoner, måleenheter osv.).
- Valgfritt—Legg til begrensel land.
- Klikk save product.
Opprett flere produkter i Catalog:
Last opp flere produkter eller hele produktkatalogen din samtidig.
Viktig: Hvis du prøver å opprett 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-verditilleggtjeneste brukes automatisk hver gang du opprett en etikett for det produktet. Dette dekker klassene "lav risiko" eller unntatt regulerte varer - varer som teknisk sett er regulert, men sendes under en spesiell bestemmelse eller mengdunntakelse.
En farlig gods-merke lagres som et katalogproduktattributt: et key/value-par på produktet. Attributter angis gjennom API-en (catalogItemsCreate eller catalogItemsUpdate) - det er ingen Dashboard-felt eller CSV-kolonne for dem.
For å merke et produkt, legger du til et attributt med nøkkelen DANGEROUS_GOODS og en verdi på en av de støttede kategoriene nedenfor.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) { id name sku attributes { key value }Støttede farlig gods-verdier
| Verdi↕ | Kategori↕ |
|---|---|
NOT_RESTRICTED_A70 | Ikke begrenset, spesiell bestemmelse A70 - trykkluftartikler, for eksempel gassstag og stødempere (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 vegtransportbestemmelsen for småmengder. |
LIMITED_QUANTITY | Begrenset mengde (ADR) - farlig gods pakket i små mengder innenfor regulatoriske grenser. |
EXCEPTED_QUANTITY | Unntatt mengde (IATA) - meget små mengder unntatt fra de fleste lufttransportreglene for farlig gods. |
CONSUMER_COMMODITY | Konsumentvare ID8000 - detaljhandelsklar hverdagsprodukt 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. |
Rediger et produkt
Redigering av produkter lar deg oppdatere dine eksisterende produkter med tilleggs- eller oppdatert informasjon effektivt. I stedet for å måtte slette og laste opp produktet på nytt, kan du laste opp oppdatert informasjon, og Catalog vil matche det 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, forventer du 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 det 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 automatisk oppdateringer av dine eksisterende gjenstander.
Slett et produkt
For å slette et produkt:
- Klikk Products-fanen i Dashboard.
- Velg produktet(ne) du vil slette. Når produktet(ne) 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 ennå en gang for å bekrefte slettingen.
Merk at hvis du sletter et stort antall gjenstander (mer enn 20 000 produkter eller så), 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 avvise varslingen og navigere bort uten å avbryte slettingsprosessen.
Begrensel 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.
For å begrensel 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 begrensel produktet ditt for ved å velge eller skrive inn landnavnet(ne).
- Klikk save product.
For å begrensel 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 begrensel land. Angi 2-siffers ISO-koden atskilt med loddrett strek, for eksempel
AU|KR|MY|SG. For å begrensel alle land, skriver du bareALLsom verdien. Hvis du vil begrensel alle land unntatt ett eller noen få, skriver duALL-etterfulgt av landene du vil oppheve begrensningen for, atskilt med loddrett strek, for eksempelALL-CA|FR|US. Lær mer om CSV-formatering. Hvis du vil fjerne alle eksisterende begrensel land, skriver duNONEsom verdien. - Lagre filen som CSV og last opp til Catalog ved å dra og slippe eller velg 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 begrensel produkter:
Du kan filtrere begrensel 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 begrensel produktene. Dette lar deg enkelt finne og håndtere de begrensel produktene i katalogen.
Hvis du trenger å oppdatere katalogen din etter å ha gjort endringer i CSV-en, laster du 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.
If you're using Checkout, vises en begrensel melding i Checkout når et produkt er begrensel til kundens land. Som standard vil meldingen si "This item is restricted from import to your country."
Filtrering av 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 samsvarer støttes ikke. Når du søker etter produktnavn, støttes imidlertid delvis samsvarer.
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 det filtrerte produktet.
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 det filtrerte produktet.
Eksporter produktene dine
Hvis du velger 50 eller færre gjenstander fra Catalog-tabellen, lastes katalogen ned direkte fra Dashboard. Imidlertid, hvis du 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 innboksen 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 katalog og klassifiseringsfeltliste.
For å opprette og klassifisere et katalogprodukt samtidig, legger du til mutasjonen ClassificationsCreateFromCatalog nedenfor til mutasjonen CatalogItemsCreate mutation.
Klassifiser et katalogprodukt til 8+ siffer (landsspesifikk)
Når feltet shipToCountries er populert, vil klassifiseringen være 8+ siffer (landsspesifikk) HS-kode. Hvis ingen shipToCountries er gitt, vil klassifiseringen som standard være en 6-siffer (universal) 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.
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 name, anbefaler vi på det sterkeste at du legger til så mange detaljer som mulig for de beste klassifiseringsresultatene.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}API-feil og løsninger
| Feil↕ | Løsning↕ |
|---|---|
| A SKU or product ID is required to create a product | En identifikator (SKU/product 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 gitt, er de to andre påkrevd, for eksempel Hvis du angir en bredde på 8 inches, ville høyden og lengden vært 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
Administrer katalog
Opprett og endre produkter.Lær hvordan du legger til, endrer og sletter dine Zonos Catalog-produkter 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.