De Catalog API is een van de drie manieren om uw Verified Account-catalogus op te bouwen, en het is de optie voor verzenders met ontwikkelcapaciteit en een systeem dat hun productgegevens al bevat—een ERP, WMS, PIM of verzendplatform. Dat systeem blijft de bron van waarheid en schrijft producten rechtstreeks naar Zonos, in plaats van te synchroniseren via een kanaalintegratie of een CSV-bestand te uploaden. Verkoopt u via een ondersteund kanaal, of schrijft u liever geen code, dan bouwen die twee opties dezelfde catalogus op met minder werk.
Artikelen die via de API worden aangemaakt, worden precies zo behandeld als artikelen uit elke andere bron—zodra een artikel in uw catalogus staat, maakt het voor Zonos niet uit hoe het daar is gekomen. Elk artikel wordt voor de douane geclassificeerd als u geen HS-code hebt opgegeven, gescreend op Amerikaanse Partner Government Agency (PGA)-vereisten en gebruikt om invoerrechten en belastingen te berekenen voor de zendingen waarin het voorkomt.
Eén onderdeel daarvan valt buiten de API. Wanneer PGA-screening een artikel markeert als Needs attention, moet de compliancevragenlijst achter die markering in Dashboard worden ingevuld en bevestigd—daar is geen API voor, en Zonos vult vooraf in wat mogelijk is, zodat het meeste werk bestaat uit controleren en bevestigen. Degene die deze integratie bouwt, is meestal niet degene die die markeringen afhandelt, dus reken erop dat iemand in uw organisatie ze in Dashboard doorloopt nadat uw catalogus is geladen. Gemarkeerde artikelen worden niet geblokkeerd voor verzending, maar door ze af te handelen voordat u verzendt, voorkomt u dat een zending aan de Amerikaanse grens wordt vastgehouden.
Maak een catalogusartikel aan voor elk product dat u verzendt.
Zorg dat elk artikel een identifier heeft die uw postvervoerder doorgeeft.
Wanneer uw zendingsgegevens Zonos bereiken, wordt elke regel gekoppeld aan uw catalogusartikel en worden de productgegevens van dat artikel toegepast op de berekening.
Als u een product verstuurt waarvan de SKU of product-ID al bestaat, werkt Zonos dat product bij in plaats van een tweede toe te voegen. Nieuwe pogingen en herhaalde runs zijn veilig.
De keerzijde is dat twee verschillende producten met dezelfde SKU of product-ID worden samengevoegd tot één. Controleer uw gegevens op duplicaten voordat u een bulkupload uitvoert.
Velden
Veld↕
Verplicht↕
Beschrijving↕
sku
Ja*
Uw unieke identifier voor het product. *Elk product heeft een SKU of een product-ID nodig, of beide.
productId
Ja*
De identifier van uw platform voor het product. *Elk product heeft een SKU of een product-ID nodig, of beide.
name
Ja
De productnaam.
customsDescription
Aanbevolen
Wat het product is, in eenvoudige bewoordingen, voor de douaneaangifte. Gebruik „Katoenen T-shirt”, niet „Summer Vibes Tee”.
countryOfOrigin
Aanbevolen
De 2-letterige ISO-code van het land waar het product is vervaardigd. Nodig om invoerrechten nauwkeurig te berekenen.
measurements
Aanbevolen
Gewicht en afmetingen, gebruikt voor tariefberekening en douaneaangifte.
hsCode
Nee
De universele 6-cijferige HS-code. Als u deze weglaat, classificeert Zonos het product op basis van de naam en beschrijving.
amount
Nee
De productprijs als getal.
currencyCode
Nee
De 3-letterige ISO-code van de valuta van de prijs. Verplicht wanneer u amount opgeeft.
itemType
Nee
PHYSICAL_GOOD, DIGITAL_GOOD, SERVICE, SUBSCRIPTION, BUNDLE of PARTIAL_ITEM. Voorkomt dat niet-fysieke artikelen als handelswaar worden aangegeven.
provinceOfOrigin
Nee
De staat of provincie waar het product vandaan komt. Vereist door sommige bestemmingslanden.
productComposition
Nee
Een lijst van {material, percentage}. Zonder deze gegevens kunnen textielproducten niet verder dan 6 cijfers worden geclassificeerd.
catalogItemUrl
Nee
Een link naar de productpagina op uw site. Verbetert de nauwkeurigheid van de classificatie.
imageUrl
Nee
Een openbaar toegankelijke URL voor de productafbeelding. Verbetert de nauwkeurigheid van de classificatie.
Zonos koppelt elke zendingsregel aan een catalogusartikel met behulp van uw identifiers, in deze volgorde: product-ID, dan SKU, dan naam. Zorg dat de identifiers die u gebruikt accuraat en consistent zijn tussen uw catalogus en de gegevens die u naar uw vervoerder stuurt.
Voor postzendingen geldt een extra beperking. Zonos ontvangt een beperkte set velden van postvervoerders, en op veel routes is de douanebeschrijving het enige veld dat iets productspecifieks bevat. Een beschrijving die in uw hele catalogus identiek is, kan op zichzelf niets identificeren.
Voeg uw product-ID of SKU toe aan het einde van de douanebeschrijving die u naar uw vervoerder stuurt.
Men's bifold wallet, cowhide leather - 123456
De toegevoegde identifier moet exact overeenkomen met de productId of sku van het bijbehorende catalogusartikel.
Beschrijvingsvelden zijn kort. Aanleveringen bij Canada Post staan bijvoorbeeld ongeveer 49 tekens toe, dus kort het beschrijvende deel in als uw identifiers lang zijn. De identifier is belangrijker dan de tekst.
Het is niet verplicht om de customsDescription van het artikel gelijk te stellen aan de tekst die u naar uw vervoerder stuurt, maar het maakt beide kanten direct vergelijkbaar wanneer een regel niet overeenkomt en u moet uitzoeken waarom.
Koppelen mislukt vaak wanneer:
De identifier ontbreekt in de beschrijving.
De identifier niet overeenkomt met een productId of sku in uw catalogus.
De identifier wordt afgekapt door de tekenlimiet van de vervoerder.
De opmaak verschilt tussen zendingen.
Dit gedrag wordt nog uitgewerkt en kan wijzigen vóór de lancering.
Opmerking: Weggelaten velden blijven ongewijzigd, waardoor gedeeltelijke updates veilig zijn. Het versturen van null wist geen waarde; het wordt genegeerd. U kunt een waarde overschrijven met een andere, maar u kunt deze niet leegmaken via de API. Neem contact op met uw Zonos-vertegenwoordiger als een veld moet worden gewist.
Catalog API
Catalog API
Bouw uw Verified Account-catalogus programmatisch op, rechtstreeks vanuit uw eigen systeem.
De Catalog API is een van de drie manieren om uw Verified Account-catalogus op te bouwen, en het is de optie voor verzenders met ontwikkelcapaciteit en een systeem dat hun productgegevens al bevat—een ERP, WMS, PIM of verzendplatform. Dat systeem blijft de bron van waarheid en schrijft producten rechtstreeks naar Zonos, in plaats van te synchroniseren via een kanaalintegratie of een CSV-bestand te uploaden. Verkoopt u via een ondersteund kanaal, of schrijft u liever geen code, dan bouwen die twee opties dezelfde catalogus op met minder werk.
Artikelen die via de API worden aangemaakt, worden precies zo behandeld als artikelen uit elke andere bron—zodra een artikel in uw catalogus staat, maakt het voor Zonos niet uit hoe het daar is gekomen. Elk artikel wordt voor de douane geclassificeerd als u geen HS-code hebt opgegeven, gescreend op Amerikaanse Partner Government Agency (PGA)-vereisten en gebruikt om invoerrechten en belastingen te berekenen voor de zendingen waarin het voorkomt.
Eén onderdeel daarvan valt buiten de API. Wanneer PGA-screening een artikel markeert als Needs attention, moet de compliancevragenlijst achter die markering in Dashboard worden ingevuld en bevestigd—daar is geen API voor, en Zonos vult vooraf in wat mogelijk is, zodat het meeste werk bestaat uit controleren en bevestigen. Degene die deze integratie bouwt, is meestal niet degene die die markeringen afhandelt, dus reken erop dat iemand in uw organisatie ze in Dashboard doorloopt nadat uw catalogus is geladen. Gemarkeerde artikelen worden niet geblokkeerd voor verzending, maar door ze af te handelen voordat u verzendt, voorkomt u dat een zending aan de Amerikaanse grens wordt vastgehouden.
Hoe het werkt
Maak een catalogusartikel aan voor elk product dat u verzendt.
Zorg dat elk artikel een identifier heeft die uw postvervoerder doorgeeft.
Wanneer uw zendingsgegevens Zonos bereiken, wordt elke regel gekoppeld aan uw catalogusartikel en worden de productgegevens van dat artikel toegepast op de berekening.
Catalogusartikelen aanmaken
catalogItemCreateaccepteert een lijst, zodat u veel producten in één request kunt versturen.mutation CatalogItemCreate($input: [CatalogItemInput!]!) {catalogItemCreate(input: $input) {iditemKeynameproductIdskuhsCodecustomsDescriptioncountryOfOrigin}}Hetzelfde product twee keer versturen
Als u een product verstuurt waarvan de SKU of product-ID al bestaat, werkt Zonos dat product bij in plaats van een tweede toe te voegen. Nieuwe pogingen en herhaalde runs zijn veilig.
De keerzijde is dat twee verschillende producten met dezelfde SKU of product-ID worden samengevoegd tot één. Controleer uw gegevens op duplicaten voordat u een bulkupload uitvoert.
Velden
skuproductIdnamecustomsDescriptioncountryOfOriginmeasurementshsCodeamountcurrencyCodeamountopgeeft.itemTypePHYSICAL_GOOD,DIGITAL_GOOD,SERVICE,SUBSCRIPTION,BUNDLEofPARTIAL_ITEM. Voorkomt dat niet-fysieke artikelen als handelswaar worden aangegeven.provinceOfOriginproductComposition{material, percentage}. Zonder deze gegevens kunnen textielproducten niet verder dan 6 cijfers worden geclassificeerd.catalogItemUrlimageUrlMaak uw artikelen koppelbaar
Zonos koppelt elke zendingsregel aan een catalogusartikel met behulp van uw identifiers, in deze volgorde: product-ID, dan SKU, dan naam. Zorg dat de identifiers die u gebruikt accuraat en consistent zijn tussen uw catalogus en de gegevens die u naar uw vervoerder stuurt.
Voor postzendingen geldt een extra beperking. Zonos ontvangt een beperkte set velden van postvervoerders, en op veel routes is de douanebeschrijving het enige veld dat iets productspecifieks bevat. Een beschrijving die in uw hele catalogus identiek is, kan op zichzelf niets identificeren.
Voeg uw product-ID of SKU toe aan het einde van de douanebeschrijving die u naar uw vervoerder stuurt.
De toegevoegde identifier moet exact overeenkomen met de
productIdofskuvan het bijbehorende catalogusartikel.Beschrijvingsvelden zijn kort. Aanleveringen bij Canada Post staan bijvoorbeeld ongeveer 49 tekens toe, dus kort het beschrijvende deel in als uw identifiers lang zijn. De identifier is belangrijker dan de tekst.
Het is niet verplicht om de
customsDescriptionvan het artikel gelijk te stellen aan de tekst die u naar uw vervoerder stuurt, maar het maakt beide kanten direct vergelijkbaar wanneer een regel niet overeenkomt en u moet uitzoeken waarom.Koppelen mislukt vaak wanneer:
productIdofskuin uw catalogus.Catalogusartikelen bijwerken
catalogItemUpdategebruikt hetzelfde invoertype als create. Verstuur alleen de velden die u wilt wijzigen.mutation CatalogItemUpdate($input: [CatalogItemInput!]!) {catalogItemUpdate(input: $input) {iditemKeyhsCodecustomsDescription}}Uw artikelen teruglezen
De
catalogItem-query accepteertid,productIdofsku. Gebruik deze om te controleren welke gegevens Zonos voor een product heeft.query CatalogItem($sku: String!) {catalogItem(sku: $sku) {iditemKeynamecustomsDescriptionhsCodeproductIdskucountryOfOrigin}}Catalogusartikelen verwijderen
catalogItemDeleteaccepteert Zonos-catalogusartikel-ID's, niet uw SKU's of product-ID's. Zoek het ID eerst op met decatalogItem-query.mutation CatalogItemDelete($input: [ID!]!) {catalogItemDelete(input: $input)}Gerelateerd
CatalogItemInput
catalogItemCreate catalogItemDelete catalogItemUpdate
Was deze pagina nuttig?