Opbyg dit Verified Account-katalog programmatisk, direkte fra dit eget system.
Catalog API er en af tre måder at opbygge dit Verified Account-katalog på, og det er muligheden for forsendere med udviklerressourcer og et system, der allerede indeholder deres produktdata—et ERP-, WMS-, PIM-system eller en forsendelsesplatform. Det system forbliver den autoritative kilde og skriver produkter direkte til Zonos i stedet for at synkronisere fra en kanalintegration eller uploade en CSV-fil. Hvis du sælger via en understøttet kanal, eller hvis du helst ikke vil skrive kode, opbygger de to muligheder det samme katalog med mindre arbejde.
Varer, der oprettes via API'et, behandles præcis som varer fra enhver anden kilde—når en vare først er i dit katalog, er det ligegyldigt for Zonos, hvordan den kom derind. Hver vare klassificeres til toldformål, hvis du ikke har angivet en HS-kode, screenes for krav fra amerikanske Partner Government Agencies (PGA) og bruges til at beregne told og afgifter på de forsendelser, den indgår i.
Én del af det ligger uden for API'et. Når PGA-screeningen markerer en vare som Needs attention, skal det compliance-spørgeskema, der ligger bag markeringen, besvares og bekræftes i Dashboard—der findes ikke noget API til det, og Zonos udfylder på forhånd, hvad der kan udfyldes, så det meste af arbejdet består i at gennemgå og bekræfte. Den person, der bygger integrationen, er som regel ikke den samme, som rydder markeringerne, så planlæg, at nogen i din organisation gennemgår dem i Dashboard, når dit katalog er indlæst. Markerede varer blokeres ikke fra at blive sendt, men ved at rydde markeringerne, før du sender, undgår du, at en forsendelse bliver tilbageholdt ved den amerikanske grænse.
Hvis du sender et produkt, hvis SKU eller produkt-id allerede findes, opdaterer Zonos det produkt i stedet for at tilføje et nyt. Genforsøg og gentagne kørsler er sikre.
Bagsiden er, at to forskellige produkter med samme SKU eller produkt-id bliver slået sammen til ét. Tjek dine data for dubletter før en masseindlæsning.
Felter
Felt↕
Påkrævet↕
Beskrivelse↕
sku
Ja*
Din unikke identifikator for produktet. *Hvert produkt skal have en SKU eller et produkt-id, eller begge.
productId
Ja*
Din platforms identifikator for produktet. *Hvert produkt skal have en SKU eller et produkt-id, eller begge.
name
Ja
Produktnavnet.
customsDescription
Anbefalet
Hvad produktet er, i klare vendinger, til tolderklæringen. Brug "Bomulds-t-shirt", ikke "Summer Vibes Tee".
countryOfOrigin
Anbefalet
Den 2-bogstavs ISO-kode for, hvor produktet er fremstillet. Nødvendig for at beregne told nøjagtigt.
measurements
Anbefalet
Vægt og dimensioner, der bruges til fragtberegning og toldindberetning.
hsCode
Nej
Den universelle 6-cifrede HS-kode. Hvis du udelader den, klassificerer Zonos produktet ud fra navn og beskrivelse.
amount
Nej
Produktets pris som et tal.
currencyCode
Nej
Den 3-bogstavs ISO-kode for prisens valuta. Påkrævet, når du angiver amount.
itemType
Nej
PHYSICAL_GOOD, DIGITAL_GOOD, SERVICE, SUBSCRIPTION, BUNDLE eller PARTIAL_ITEM. Forhindrer, at ikke-fysiske varer deklareres som handelsvarer.
provinceOfOrigin
Nej
Den stat eller provins, hvor produktet har oprindelse. Kræves af nogle destinationslande.
productComposition
Nej
En liste af {material, percentage}. Tekstiler kan ikke klassificeres ud over 6 cifre uden den.
catalogItemUrl
Nej
Et link til produktsiden på dit website. Forbedrer klassificeringens nøjagtighed.
imageUrl
Nej
En offentligt tilgængelig URL til produktbilledet. Forbedrer klassificeringens nøjagtighed.
Zonos forbinder hver forsendelseslinje med en katalogvare ved hjælp af dine identifikatorer i denne rækkefølge: produkt-id, derefter SKU og til sidst navn. Hold de identifikatorer, du bruger, nøjagtige og konsistente mellem dit katalog og de data, du sender til dit fragtselskab.
Postforsendelser har en yderligere begrænsning. Zonos modtager et begrænset sæt felter fra postselskaber, og på mange ruter er tolderklæringens varebeskrivelse det eneste felt, der indeholder noget produktspecifikt. En beskrivelse, der er identisk på tværs af hele dit katalog, kan ikke i sig selv identificere noget.
Tilføj dit produkt-id eller din SKU til slutningen af den toldbeskrivelse, du sender til dit fragtselskab.
Men's bifold wallet, cowhide leather - 123456
Den tilføjede identifikator skal matche productId eller sku på den tilsvarende katalogvare nøjagtigt.
Beskrivelsesfelter er korte. Indsendelser til Canada Post tillader for eksempel omkring 49 tegn, så forkort den beskrivende del, hvis dine identifikatorer er lange. Identifikatoren er vigtigere end teksten.
Det er ikke påkrævet at sætte varens customsDescription til den samme streng, som du sender til dit fragtselskab, men det gør de to sider direkte sammenlignelige, når en linje ikke matcher, og du skal finde ud af hvorfor.
Matchning mislykkes typisk, når:
Identifikatoren mangler i beskrivelsen.
Identifikatoren ikke svarer til nogen productId eller sku i dit katalog.
Identifikatoren afkortes af fragtselskabets tegngrænse.
Formateringen ændrer sig mellem forsendelser.
Denne funktionalitet er stadig under færdiggørelse og kan ændre sig før lancering.
Bemærk: Udeladte felter forbliver uændrede, hvilket gør delvise opdateringer sikre. At sende null rydder ikke en værdi, det ignoreres. Du kan overskrive en værdi med en anden, men du kan ikke tømme den via API'et. Kontakt din Zonos-repræsentant, hvis et felt skal ryddes.
Catalog API
Catalog API
Opbyg dit Verified Account-katalog programmatisk, direkte fra dit eget system.
Catalog API er en af tre måder at opbygge dit Verified Account-katalog på, og det er muligheden for forsendere med udviklerressourcer og et system, der allerede indeholder deres produktdata—et ERP-, WMS-, PIM-system eller en forsendelsesplatform. Det system forbliver den autoritative kilde og skriver produkter direkte til Zonos i stedet for at synkronisere fra en kanalintegration eller uploade en CSV-fil. Hvis du sælger via en understøttet kanal, eller hvis du helst ikke vil skrive kode, opbygger de to muligheder det samme katalog med mindre arbejde.
Varer, der oprettes via API'et, behandles præcis som varer fra enhver anden kilde—når en vare først er i dit katalog, er det ligegyldigt for Zonos, hvordan den kom derind. Hver vare klassificeres til toldformål, hvis du ikke har angivet en HS-kode, screenes for krav fra amerikanske Partner Government Agencies (PGA) og bruges til at beregne told og afgifter på de forsendelser, den indgår i.
Én del af det ligger uden for API'et. Når PGA-screeningen markerer en vare som Needs attention, skal det compliance-spørgeskema, der ligger bag markeringen, besvares og bekræftes i Dashboard—der findes ikke noget API til det, og Zonos udfylder på forhånd, hvad der kan udfyldes, så det meste af arbejdet består i at gennemgå og bekræfte. Den person, der bygger integrationen, er som regel ikke den samme, som rydder markeringerne, så planlæg, at nogen i din organisation gennemgår dem i Dashboard, når dit katalog er indlæst. Markerede varer blokeres ikke fra at blive sendt, men ved at rydde markeringerne, før du sender, undgår du, at en forsendelse bliver tilbageholdt ved den amerikanske grænse.
Sådan fungerer det
Opret en katalogvare for hvert produkt, du sender.
Sørg for, at hver vare har en identifikator, som dit postselskab videregiver.
Når dine forsendelsesdata når Zonos, matches hver linje tilbage til din katalogvare, og varens produktdata anvendes i beregningen.
Opret katalogvarer
catalogItemCreateaccepterer en liste, så du kan sende mange produkter i en enkelt anmodning.mutation CatalogItemCreate($input: [CatalogItemInput!]!) {catalogItemCreate(input: $input) {iditemKeynameproductIdskuhsCodecustomsDescriptioncountryOfOrigin}}Afsendelse af det samme produkt to gange
Hvis du sender et produkt, hvis SKU eller produkt-id allerede findes, opdaterer Zonos det produkt i stedet for at tilføje et nyt. Genforsøg og gentagne kørsler er sikre.
Bagsiden er, at to forskellige produkter med samme SKU eller produkt-id bliver slået sammen til ét. Tjek dine data for dubletter før en masseindlæsning.
Felter
skuproductIdnamecustomsDescriptioncountryOfOriginmeasurementshsCodeamountcurrencyCodeamount.itemTypePHYSICAL_GOOD,DIGITAL_GOOD,SERVICE,SUBSCRIPTION,BUNDLEellerPARTIAL_ITEM. Forhindrer, at ikke-fysiske varer deklareres som handelsvarer.provinceOfOriginproductComposition{material, percentage}. Tekstiler kan ikke klassificeres ud over 6 cifre uden den.catalogItemUrlimageUrlGør dine varer matchbare
Zonos forbinder hver forsendelseslinje med en katalogvare ved hjælp af dine identifikatorer i denne rækkefølge: produkt-id, derefter SKU og til sidst navn. Hold de identifikatorer, du bruger, nøjagtige og konsistente mellem dit katalog og de data, du sender til dit fragtselskab.
Postforsendelser har en yderligere begrænsning. Zonos modtager et begrænset sæt felter fra postselskaber, og på mange ruter er tolderklæringens varebeskrivelse det eneste felt, der indeholder noget produktspecifikt. En beskrivelse, der er identisk på tværs af hele dit katalog, kan ikke i sig selv identificere noget.
Tilføj dit produkt-id eller din SKU til slutningen af den toldbeskrivelse, du sender til dit fragtselskab.
Den tilføjede identifikator skal matche
productIdellerskupå den tilsvarende katalogvare nøjagtigt.Beskrivelsesfelter er korte. Indsendelser til Canada Post tillader for eksempel omkring 49 tegn, så forkort den beskrivende del, hvis dine identifikatorer er lange. Identifikatoren er vigtigere end teksten.
Det er ikke påkrævet at sætte varens
customsDescriptiontil den samme streng, som du sender til dit fragtselskab, men det gør de to sider direkte sammenlignelige, når en linje ikke matcher, og du skal finde ud af hvorfor.Matchning mislykkes typisk, når:
productIdellerskui dit katalog.Opdater katalogvarer
catalogItemUpdatebruger den samme inputtype som oprettelse. Send kun de felter, du vil ændre.mutation CatalogItemUpdate($input: [CatalogItemInput!]!) {catalogItemUpdate(input: $input) {iditemKeyhsCodecustomsDescription}}Læs dine varer tilbage
catalogItem-forespørgslen acceptererid,productIdellersku. Brug den til at bekræfte, hvilke data Zonos har for et produkt.query CatalogItem($sku: String!) {catalogItem(sku: $sku) {iditemKeynamecustomsDescriptionhsCodeproductIdskucountryOfOrigin}}Slet katalogvarer
catalogItemDeletetager Zonos-katalogvare-id'er, ikke dine SKU'er eller produkt-id'er. Find først id'et medcatalogItem-forespørgslen.mutation CatalogItemDelete($input: [ID!]!) {catalogItemDelete(input: $input)}Relateret
CatalogItemInput
catalogItemCreate catalogItemDelete catalogItemUpdate
Var denne side nyttig?