DOCS

Workflows for katalogvarer

Valider kategorier, klassificer HS-koder og udled eksportklassificeringer for dine varer i én enkelt anmodning.

Kæd workflows sammen i én anmodning 

Berigelse af et produkt kræver som regel flere kald: kontrol af dets kategorier, klassificering til de lande, du sender til, og fastlæggelse af dets eksportkontrolkode. Kaldt hver for sig skal hver af disse mutationer have varens oplysninger og billede sendt igen, og din kode skal føre hvert resultat videre til det næste kald.

Workflows for katalogvarer fjerner det arbejde. Du sender varens oplysninger og billede én gang som et udkast og kæder derefter de trin, du har brug for, sammen som efterfølgende felter i den samme GraphQL-mutation. Hvert trin læser udkastene og bygger videre på det, tidligere trin fandt. Når kategorivalideringen for eksempel retter en vares kategorier, bruger klassificering og eksportklassificering de rettede kategorier.

Sådan fungerer det 

GraphQL kører en mutations felter på øverste niveau i rækkefølge, ét efter ét. En workflow-operation starter altid med catalogItemDraftsCreateWorkflow, som opretter udkastene, efterfulgt af de trin, du ønsker, i den rækkefølge, de skal køre i.

Trin↕Hvad det gør↕
catalogItemDraftsCreateWorkflowOpretter et udkast for hver vare ud fra dens oplysninger og eventuelle billede. Altid det første trin.
categoriesValidateWorkflowValiderer hvert udkasts kategorier og kan, når de er forkerte, erstatte dem med det bedste forslag til senere trin. Se Category Validation.
classificationsCalculateWorkflowKlassificerer hvert udkasts HS-kode for de modtagerlande, du vælger, eller dets eksport-HS-kode (såsom en Schedule B-kode). Se Classify.
exportClassificationsInferWorkflowUdleder hvert udkasts eksportkontrolklassificering, såsom en ECCN. Se Export Classification.
catalogItemsCreateFromDraftsWorkflowGemmer udkastene som katalogvarer med de kategorier og HS-koder, som de tidligere trin fandt.

Alle trin undtagen det første er valgfrie, så medtag kun dem, du har brug for.

Nogle få regler gælder for alle workflow-operationer:

  • Udkast hører til én anmodning. Et udkast findes kun for den operation, der oprettede det, så alle trin, der bruger det, skal være i den samme mutation. En senere anmodning kan ikke læse udkast fra en tidligere.
  • Hvert trin arbejder som standard på alle udkast. For at begrænse et trin til nogle udkast skal du angive deres id'er (returneret af catalogItemDraftsCreateWorkflow) i det pågældende trins draftIds.
  • Send mellem 1 og 100 udkast pr. anmodning.
  • Billeder sendes én gang. Angiv hver vares billede som imageBase64 på dens udkast. Senere trin genbruger det, og hvert trins includeImage-input styrer, om trinnet bruger det. Udkastet returnerer en forhåndssigneret imageUrl, der er gyldig i 15 minutter.

Valider, klassificer og udled eksportklassificeringer 

Eksemplet nedenfor validerer kategorierne for to varer, klassificerer deres HS-koder for Storbritannien og Canada, klassificerer deres amerikanske eksport-HS-koder og udleder deres eksportkontrolklassificeringer ud fra disse eksportkoder.

Fordi classificationsCalculateWorkflow kører to gange, én gang for importkoder og én gang for eksportkoder, har hvert kald et alias (importClassifications og exportClassifications), så resultaterne kan skelnes fra hinanden.

1mutation CatalogItemEnrich($drafts: [CatalogItemDraftInput!]!) {
2 catalogItemDraftsCreateWorkflow(input: $drafts) {
3 id
4 name
5 categories
6 }
7 categoriesValidateWorkflow(input: { applySuggestion: WHEN_WRONG }) {
8 draftId
9 verdict
10 confidenceScore
11 appliedCategories
12 suggestedCategories {
13 category
14 confidence
15 }
16 }
17 importClassifications: classificationsCalculateWorkflow(
18 input: { shipToCountries: [GB, CA] }
19 ) {
20 draftId
21 categories
22 confidenceScore
23 hsCode {
24 code
25 codeType
26 countryCode
27 }
28 }
29 exportClassifications: classificationsCalculateWorkflow(
30 input: { hsCodeType: EXPORT, shipFromCountry: US }
31 ) {
32 draftId
33 hsCode {
34 code
35 codeType
36 countryCode
37 }
38 }
39 exportClassificationsInferWorkflow(
40 input: { shipFromCountry: US, exportHsCodePreference: CLASSIFICATION }
41 ) {
42 draftId
43 classificationCode
44 confidenceScore
45 exportHsCode
46 categories
47 alternates {
48 classificationCode
49 probabilityMass
50 }
51 }
52}

I eksemplet ovenfor:

  • T-shirten blev indsendt under Electronics > Cell Phones. Kategorivalideringen returnerede WRONG og erstattede dens kategorier med det bedste forslag, Apparel > Tops > T-Shirts, som vises i appliedCategories.
  • Begge klassificeringstrin og eksportklassificeringstrinnet brugte de rettede kategorier, så t-shirten blev klassificeret under position 6109 (t-shirts) i stedet for som en elektronisk enhed.
  • Eksportklassificeringstrinnet brugte EXPORT-koden fra klassificeringstrinnet som hver vares exportHsCode, fordi exportHsCodePreference er CLASSIFICATION.

Resultater fra alle trin indeholder et draftId, så du kan matche dem med de udkast, du oprettede. Klassificering returnerer ét resultat for hvert udkast og land og kan returnere mere end én kode pr. udkast, så brug hsCode.codeType og hsCode.countryCode til at vælge den kode, du har brug for.

Styr, hvordan trinnene bygger videre på hinanden 

Hvert trins input styrer, hvad det overtager fra tidligere trin.

Anvendelse af kategoriforslag

categoriesValidateWorkflow bruger applySuggestion til at afgøre, om et forslag erstatter et udkasts kategorier i senere trin:

  • WHEN_WRONG (standard) - Erstatter kategorierne med det bedste forslag, når vurderingen er WRONG.
  • NEVER - Rapporterer kun vurderingen og forslagene. Udkastene beholder deres kategorier.

For kun at anvende sikre rettelser skal du angive minimumVerdictConfidence (den mindste confidenceScore for WRONG-vurderingen) eller minimumSuggestionConfidence (den mindste confidence for det bedste forslag). Når et minimum ikke er opfyldt, beholder udkastet sine kategorier.

Forslag kommer fra din organisations kategoritræ, så de er kun så gode som det træ. Hvert forslags confidence er relativ til de andre forslag, så med et lille eller ufuldstændigt træ kan et dårligt match stadig få en høj score. Indlæs dit fulde kategoritræ, før du forlader dig på WHEN_WRONG; se Administrer dit kategoritræ.

Trinnene for klassificering, eksportklassificering og katalogvarer bruger som standard de rettede kategorier. Angiv useValidatedCategories: false på et trin for i stedet at bruge udkastets oprindelige kategorier.

Valg af HS-koder

classificationsCalculateWorkflow klassificerer for landene i shipToCountries. For i stedet at generere eksport-HS-koder (såsom amerikanske Schedule B-koder) skal du angive hsCodeType: EXPORT og shipFromCountry. Hvis du har brug for begge, skal du kalde trinnet to gange med et alias for hvert kald som i eksemplet ovenfor.

exportClassificationsInferWorkflow vælger hvert udkasts eksport-HS-kode med exportHsCodePreference:

  • PROVIDED (standard) - Bruger exportHsCode på udkastet og kun klassificeringstrinnets EXPORT-kode, når udkastet ikke har nogen.
  • CLASSIFICATION - Bruger klassificeringstrinnets EXPORT-kode og kun udkastets exportHsCode, når der ikke er nogen.

Når ingen af koderne findes, fastlægger Zonos en som en del af eksportklassificeringen. Angivelse af en eksport-HS-kode giver de mest pålidelige resultater.

Screening mod våbenlister

Som standard følger eksportklassificeringen din organisations indstillinger for eksportklassificering. Brug settingOverride til at ændre dem for et enkelt trin. Angiv for eksempel munitionsScreeningEnabled: true for at screene varer mod jurisdiktionens våbenliste (i USA USML) før dens liste over produkter med dobbelt anvendelse (CCL). Resultaterne indeholder derefter controlList, controlListVersion og controlTier.

exportClassificationsInferWorkflow(
  input: {
    shipFromCountry: US
    settingOverride: { munitionsScreeningEnabled: true }
  }
) {
  draftId
  classificationCode
  controlList
  controlListVersion
  controlTier
}

Bemærk: Et våbenresultat markerer en vare til compliance-gennemgang. Det er ikke en endelig afgørelse.

Gem resultaterne i dit katalog 

For at gemme udkastene som katalogvarer skal du tilføje catalogItemsCreateFromDraftsWorkflow som det sidste trin. Hver katalogvare får kategorierne fra kategorivalideringen og en HS-kode fra klassificeringen og returnerer det draftId, den stammer fra.

catalogItemsCreateFromDraftsWorkflow(
  input: { hsCodePreference: CLASSIFICATION, shipToCountry: GB }
) {
  id
  sku
  categories
  hsCode
}
  • hsCodePreference - PROVIDED (standard) beholder udkastets egen hsCode og bruger kun klassificeringens kode, når udkastet ikke har nogen. CLASSIFICATION foretrækker klassificeringens kode.
  • shipToCountry - Vælger, hvilket lands klassificering leverer HS-koden, når klassificeringstrinnet kørte for mere end ét land.

En katalogvare får aldrig en eksport-HS-kode som sin hsCode. Katalogvarer gemmes efter deres varenøgle ligesom med catalogItemCreate, så giv hvert udkast en sku eller et productId. Et udkast uden en af dem gemmes som en ny katalogvare, hver gang workflowet kører.

Håndter fejl 

Hvert udkast lykkes eller fejler for sig selv i hvert trin. Når et udkast fejler, udelades det fra trinnets resultater og rapporteres i errors med sit draftId i extensions, mens de andre udkast fortsætter. errorType fortæller dig hvorfor:

  • BAD_REQUEST - Udkastets input er ugyldigt, for eksempel en eksport-HS-kode uden cifre. Ret inputtet, før du prøver igen.
  • INTERNAL - Der opstod en uventet fejl.
  • UNAVAILABLE - En afhængighed fik timeout eller kunne ikke nås. Prøv anmodningen igen.
1mutation ExportOnly($drafts: [CatalogItemDraftInput!]!) {
2 catalogItemDraftsCreateWorkflow(input: $drafts) {
3 id
4 name
5 }
6 exportClassificationsInferWorkflow(input: { shipFromCountry: US }) {
7 draftId
8 classificationCode
9 exportHsCode
10 }
11}

Et problem med et trin som helhed får hele trinnet til at fejle. Det sker for eksempel, når trinnet ikke har nogen udkast at arbejde med, fordi catalogItemDraftsCreateWorkflow mangler i mutationen, eller når draftIds angiver et udkast, der ikke er en del af anmodningen.

Book en demo

Var denne side nyttig?