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.
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↕
catalogItemDraftsCreateWorkflow
Opretter et udkast for hver vare ud fra dens oplysninger og eventuelle billede. Altid det første trin.
categoriesValidateWorkflow
Validerer hvert udkasts kategorier og kan, når de er forkerte, erstatte dem med det bedste forslag til senere trin. Se Category Validation.
classificationsCalculateWorkflow
Klassificerer hvert udkasts HS-kode for de modtagerlande, du vælger, eller dets eksport-HS-kode (såsom en Schedule B-kode). Se Classify.
exportClassificationsInferWorkflow
Udleder hvert udkasts eksportkontrolklassificering, såsom en ECCN. Se Export Classification.
catalogItemsCreateFromDraftsWorkflow
Gemmer 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.
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.
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.
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.
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.
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.
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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Workflows for katalogvarer
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.catalogItemDraftsCreateWorkflowcategoriesValidateWorkflowclassificationsCalculateWorkflowexportClassificationsInferWorkflowcatalogItemsCreateFromDraftsWorkflowAlle trin undtagen det første er valgfrie, så medtag kun dem, du har brug for.
Nogle få regler gælder for alle workflow-operationer:
catalogItemDraftsCreateWorkflow) i det pågældende trinsdraftIds.imageBase64på dens udkast. Senere trin genbruger det, og hvert trinsincludeImage-input styrer, om trinnet bruger det. Udkastet returnerer en forhåndssigneretimageUrl, 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
classificationsCalculateWorkflowkører to gange, én gang for importkoder og én gang for eksportkoder, har hvert kald et alias (importClassificationsogexportClassifications), så resultaterne kan skelnes fra hinanden.mutation CatalogItemEnrich($drafts: [CatalogItemDraftInput!]!) {catalogItemDraftsCreateWorkflow(input: $drafts) {idnamecategories}categoriesValidateWorkflow(input: { applySuggestion: WHEN_WRONG }) {draftIdverdictconfidenceScoreappliedCategoriessuggestedCategories {categoryconfidence}}importClassifications: classificationsCalculateWorkflow(input: { shipToCountries: [GB, CA] }) {draftIdcategoriesconfidenceScorehsCode {codecodeTypecountryCode}}exportClassifications: classificationsCalculateWorkflow(input: { hsCodeType: EXPORT, shipFromCountry: US }) {draftIdhsCode {codecodeTypecountryCode}}exportClassificationsInferWorkflow(input: { shipFromCountry: US, exportHsCodePreference: CLASSIFICATION }) {draftIdclassificationCodeconfidenceScoreexportHsCodecategoriesalternates {classificationCodeprobabilityMass}}}I eksemplet ovenfor:
Electronics > Cell Phones. Kategorivalideringen returneredeWRONGog erstattede dens kategorier med det bedste forslag,Apparel > Tops > T-Shirts, som vises iappliedCategories.6109(t-shirts) i stedet for som en elektronisk enhed.EXPORT-koden fra klassificeringstrinnet som hver varesexportHsCode, fordiexportHsCodePreferenceerCLASSIFICATION.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å brughsCode.codeTypeoghsCode.countryCodetil 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
categoriesValidateWorkflowbrugerapplySuggestiontil 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 erWRONG.NEVER- Rapporterer kun vurderingen og forslagene. Udkastene beholder deres kategorier.For kun at anvende sikre rettelser skal du angive
minimumVerdictConfidence(den mindsteconfidenceScoreforWRONG-vurderingen) ellerminimumSuggestionConfidence(den mindsteconfidencefor 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
confidenceer 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: falsepå et trin for i stedet at bruge udkastets oprindelige kategorier.Valg af HS-koder
classificationsCalculateWorkflowklassificerer for landene ishipToCountries. For i stedet at generere eksport-HS-koder (såsom amerikanske Schedule B-koder) skal du angivehsCodeType: EXPORTogshipFromCountry. Hvis du har brug for begge, skal du kalde trinnet to gange med et alias for hvert kald som i eksemplet ovenfor.exportClassificationsInferWorkflowvælger hvert udkasts eksport-HS-kode medexportHsCodePreference:PROVIDED(standard) - BrugerexportHsCodepå udkastet og kun klassificeringstrinnetsEXPORT-kode, når udkastet ikke har nogen.CLASSIFICATION- Bruger klassificeringstrinnetsEXPORT-kode og kun udkastetsexportHsCode, 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
settingOverridetil at ændre dem for et enkelt trin. Angiv for eksempelmunitionsScreeningEnabled: truefor at screene varer mod jurisdiktionens våbenliste (i USA USML) før dens liste over produkter med dobbelt anvendelse (CCL). Resultaterne indeholder dereftercontrolList,controlListVersionogcontrolTier.exportClassificationsInferWorkflow( input: { shipFromCountry: US settingOverride: { munitionsScreeningEnabled: true } } ) { draftId classificationCode controlList controlListVersion controlTier }Gem resultaterne i dit katalog
For at gemme udkastene som katalogvarer skal du tilføje
catalogItemsCreateFromDraftsWorkflowsom det sidste trin. Hver katalogvare får kategorierne fra kategorivalideringen og en HS-kode fra klassificeringen og returnerer detdraftId, den stammer fra.catalogItemsCreateFromDraftsWorkflow( input: { hsCodePreference: CLASSIFICATION, shipToCountry: GB } ) { id sku categories hsCode }hsCodePreference-PROVIDED(standard) beholder udkastets egenhsCodeog bruger kun klassificeringens kode, når udkastet ikke har nogen.CLASSIFICATIONforetræ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 medcatalogItemCreate, så giv hvert udkast enskueller etproductId. 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
errorsmed sitdraftIdiextensions, mens de andre udkast fortsætter.errorTypefortæ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.mutation ExportOnly($drafts: [CatalogItemDraftInput!]!) {catalogItemDraftsCreateWorkflow(input: $drafts) {idname}exportClassificationsInferWorkflow(input: { shipFromCountry: US }) {draftIdclassificationCodeexportHsCode}}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
catalogItemDraftsCreateWorkflowmangler i mutationen, eller nårdraftIdsangiver et udkast, der ikke er en del af anmodningen.CatalogItemDraftInput
catalogItemDraftsCreateWorkflow catalogItemsCreateFromDraftsWorkflow categoriesValidateWorkflow exportClassificationsInferWorkflow
Var denne side nyttig?