Enrichir un produit nécessite généralement plusieurs appels : vérifier ses catégories, le classifier pour les pays vers lesquels vous expédiez et déterminer son code de contrôle des exportations. Appelées séparément, chacune de ces mutations exige de renvoyer les détails de l'article et son image, et votre code doit transmettre chaque résultat à l'appel suivant.
Les workflows d'articles du catalogue suppriment ce travail. Vous envoyez une seule fois les détails et l'image de l'article, sous forme de brouillon, puis vous enchaînez les étapes nécessaires en tant que champs suivants de la même mutation GraphQL. Chaque étape lit les brouillons et s'appuie sur ce que les étapes précédentes ont trouvé. Par exemple, lorsque la validation des catégories corrige les catégories d'un article, la classification et la classification à l'export utilisent les catégories corrigées.
GraphQL exécute les champs de premier niveau d'une mutation dans l'ordre, l'un après l'autre. Une opération de workflow commence toujours par catalogItemDraftsCreateWorkflow, qui crée les brouillons, suivie des étapes souhaitées, dans l'ordre où vous voulez qu'elles s'exécutent.
Étape↕
Rôle↕
catalogItemDraftsCreateWorkflow
Crée un brouillon pour chaque article à partir de ses détails et d'une image facultative. Toujours la première étape.
categoriesValidateWorkflow
Valide les catégories de chaque brouillon et, lorsqu'elles sont incorrectes, peut les remplacer par la meilleure suggestion pour les étapes suivantes. Voir Validation des catégories.
classificationsCalculateWorkflow
Classifie le code HS de chaque brouillon pour les pays de destination choisis, ou son code HS d'exportation (comme un code Schedule B). Voir Classify.
exportClassificationsInferWorkflow
Déduit la classification de contrôle des exportations de chaque brouillon, comme un ECCN. Voir Classification à l'export.
catalogItemsCreateFromDraftsWorkflow
Enregistre les brouillons en tant qu'articles du catalogue, avec les catégories et les codes HS trouvés par les étapes précédentes.
Toutes les étapes sont facultatives, sauf la première : n'incluez que celles dont vous avez besoin.
Quelques règles s'appliquent à toute opération de workflow :
Les brouillons appartiennent à une seule requête. Un brouillon n'existe que pour l'opération qui l'a créé ; chaque étape qui l'utilise doit donc se trouver dans la même mutation. Une requête ultérieure ne peut pas lire les brouillons d'une requête précédente.
Par défaut, chaque étape traite tous les brouillons. Pour limiter une étape à certains brouillons, transmettez leurs identifiants (renvoyés par catalogItemDraftsCreateWorkflow) dans le champ draftIds de cette étape.
Envoyez entre 1 et 100 brouillons par requête.
Les images sont envoyées une seule fois. Transmettez l'image de chaque article dans le champ imageBase64 de son brouillon. Les étapes suivantes la réutilisent, et l'entrée includeImage de chaque étape détermine si cette étape l'utilise. Le brouillon renvoie une imageUrl présignée valable 15 minutes.
L'exemple ci-dessous valide les catégories de deux articles, classifie leurs codes HS pour le Royaume-Uni et le Canada, classifie leurs codes HS d'exportation américains et déduit leurs classifications de contrôle des exportations à partir de ces codes d'exportation.
Comme classificationsCalculateWorkflow s'exécute deux fois, une fois pour les codes d'importation et une fois pour les codes d'exportation, chaque appel possède un alias (importClassifications et exportClassifications) afin de distinguer leurs résultats.
Le t-shirt a été soumis sous Electronics > Cell Phones. La validation des catégories a renvoyé WRONG et a remplacé ses catégories par la meilleure suggestion, Apparel > Tops > T-Shirts, indiquée dans appliedCategories.
Les deux étapes de classification et l'étape de classification à l'export ont utilisé les catégories corrigées : le t-shirt a donc été classé sous la position 6109 (t-shirts) plutôt que comme un appareil électronique.
L'étape de classification à l'export a utilisé le code EXPORT de l'étape de classification comme exportHsCode de chaque article, car exportHsCodePreference vaut CLASSIFICATION.
Les résultats de chaque étape comportent un draftId, ce qui vous permet de les associer aux brouillons que vous avez créés. La classification renvoie un résultat par brouillon et par pays, et peut renvoyer plusieurs codes par brouillon : utilisez donc hsCode.codeType et hsCode.countryCode pour choisir le code dont vous avez besoin.
L'entrée de chaque étape détermine ce qu'elle reprend des étapes précédentes.
Appliquer les suggestions de catégories
categoriesValidateWorkflow utilise applySuggestion pour décider si une suggestion remplace les catégories d'un brouillon pour les étapes suivantes :
WHEN_WRONG (par défaut) - Remplace les catégories par la meilleure suggestion lorsque le verdict est WRONG.
NEVER - Indique uniquement le verdict et les suggestions. Les brouillons conservent leurs catégories.
Pour n'appliquer que les corrections fiables, définissez minimumVerdictConfidence (le confidenceScore minimal du verdict WRONG) ou minimumSuggestionConfidence (la confidence minimale de la meilleure suggestion). Lorsqu'un minimum n'est pas atteint, le brouillon conserve ses catégories.
Les suggestions proviennent de l'arborescence de catégories de votre organisation : leur qualité dépend donc de celle de cette arborescence. La confidence de chaque suggestion est relative aux autres suggestions ; avec une arborescence réduite ou incomplète, une correspondance médiocre peut donc tout de même obtenir un score élevé. Chargez votre arborescence de catégories complète avant de vous appuyer sur WHEN_WRONG ; voir Gérer votre arborescence de catégories.
Les étapes de classification, de classification à l'export et d'articles du catalogue utilisent par défaut les catégories corrigées. Définissez useValidatedCategories: false sur une étape pour utiliser plutôt les catégories d'origine du brouillon.
Choisir les codes HS
classificationsCalculateWorkflow effectue la classification pour les pays indiqués dans shipToCountries. Pour obtenir plutôt des codes HS d'exportation (comme les codes Schedule B américains), définissez hsCodeType: EXPORT et shipFromCountry. Si vous avez besoin des deux, appelez l'étape deux fois avec un alias pour chaque appel, comme dans l'exemple ci-dessus.
exportClassificationsInferWorkflow choisit le code HS d'exportation de chaque brouillon à l'aide de exportHsCodePreference :
PROVIDED (par défaut) - Utilise l'exportHsCode du brouillon, et le code EXPORT de l'étape de classification uniquement lorsque le brouillon n'en a pas.
CLASSIFICATION - Utilise le code EXPORT de l'étape de classification, et l'exportHsCode du brouillon uniquement lorsqu'il n'y en a pas.
Lorsqu'aucun des deux codes n'existe, Zonos en détermine un dans le cadre de la classification à l'export. Fournir un code HS d'exportation donne les résultats les plus fiables.
Contrôle par rapport aux listes de munitions
Par défaut, la classification à l'export suit les paramètres de classification à l'export de votre organisation. Utilisez settingOverride pour les modifier pour une seule étape. Par exemple, définissez munitionsScreeningEnabled: true pour contrôler les articles par rapport à la liste des munitions de la juridiction (aux États-Unis, l'USML) avant sa liste des biens à double usage (la CCL). Les résultats incluent alors controlList, controlListVersion et controlTier.
exportClassificationsInferWorkflow(input:{shipFromCountry: US
settingOverride:{munitionsScreeningEnabled:true}}){
draftId
classificationCode
controlList
controlListVersion
controlTier
}
Remarque : Un résultat de munitions signale un article pour un examen de conformité. Il ne s'agit pas d'une détermination définitive.
Pour enregistrer les brouillons en tant qu'articles du catalogue, ajoutez catalogItemsCreateFromDraftsWorkflow comme dernière étape. Chaque article du catalogue reçoit les catégories issues de la validation des catégories et un code HS issu de la classification, et renvoie le draftId dont il provient.
catalogItemsCreateFromDraftsWorkflow(input:{hsCodePreference: CLASSIFICATION, shipToCountry: GB }){
id
sku
categories
hsCode
}
hsCodePreference - PROVIDED (par défaut) conserve le hsCode propre au brouillon et n'utilise le code de la classification que lorsque le brouillon n'en a pas. CLASSIFICATION privilégie le code de la classification.
shipToCountry - Choisit le pays dont la classification fournit le code HS lorsque l'étape de classification a été exécutée pour plusieurs pays.
Un article du catalogue ne reçoit jamais un code HS d'exportation comme hsCode. Les articles du catalogue sont enregistrés selon leur clé d'article, comme avec catalogItemCreate : attribuez donc un sku ou un productId à chaque brouillon. Un brouillon qui n'en a pas est enregistré comme un nouvel article du catalogue à chaque exécution du workflow.
À chaque étape, chaque brouillon réussit ou échoue indépendamment des autres. Lorsqu'un brouillon échoue, il est exclu des résultats de cette étape et signalé dans errors avec son draftId dans les extensions, tandis que les autres brouillons poursuivent. Le champ errorType en indique la raison :
BAD_REQUEST - L'entrée du brouillon n'est pas valide, par exemple un code HS d'exportation sans chiffres. Corrigez l'entrée avant de réessayer.
INTERNAL - Une erreur inattendue s'est produite.
UNAVAILABLE - Une dépendance a expiré ou était inaccessible. Relancez la requête.
6 exportClassificationsInferWorkflow(input:{shipFromCountry: US }){
7 draftId
8 classificationCode
9 exportHsCode
10}
11}
Un problème touchant une étape dans son ensemble fait échouer toute cette étape. C'est le cas, par exemple, lorsque l'étape n'a aucun brouillon à traiter parce que catalogItemDraftsCreateWorkflow est absent de la mutation, ou lorsque draftIds désigne un brouillon qui ne fait pas partie de la requête.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Workflows d'articles du catalogue
Workflows d'articles du catalogue
Validez les catégories, classifiez les codes HS et déduisez les classifications à l'export de vos articles en une seule requête.
Enchaîner les workflows en une seule requête
Enrichir un produit nécessite généralement plusieurs appels : vérifier ses catégories, le classifier pour les pays vers lesquels vous expédiez et déterminer son code de contrôle des exportations. Appelées séparément, chacune de ces mutations exige de renvoyer les détails de l'article et son image, et votre code doit transmettre chaque résultat à l'appel suivant.
Les workflows d'articles du catalogue suppriment ce travail. Vous envoyez une seule fois les détails et l'image de l'article, sous forme de brouillon, puis vous enchaînez les étapes nécessaires en tant que champs suivants de la même mutation GraphQL. Chaque étape lit les brouillons et s'appuie sur ce que les étapes précédentes ont trouvé. Par exemple, lorsque la validation des catégories corrige les catégories d'un article, la classification et la classification à l'export utilisent les catégories corrigées.
Fonctionnement
GraphQL exécute les champs de premier niveau d'une mutation dans l'ordre, l'un après l'autre. Une opération de workflow commence toujours par
catalogItemDraftsCreateWorkflow, qui crée les brouillons, suivie des étapes souhaitées, dans l'ordre où vous voulez qu'elles s'exécutent.catalogItemDraftsCreateWorkflowcategoriesValidateWorkflowclassificationsCalculateWorkflowexportClassificationsInferWorkflowcatalogItemsCreateFromDraftsWorkflowToutes les étapes sont facultatives, sauf la première : n'incluez que celles dont vous avez besoin.
Quelques règles s'appliquent à toute opération de workflow :
catalogItemDraftsCreateWorkflow) dans le champdraftIdsde cette étape.imageBase64de son brouillon. Les étapes suivantes la réutilisent, et l'entréeincludeImagede chaque étape détermine si cette étape l'utilise. Le brouillon renvoie uneimageUrlprésignée valable 15 minutes.Valider, classifier et déduire les classifications à l'export
L'exemple ci-dessous valide les catégories de deux articles, classifie leurs codes HS pour le Royaume-Uni et le Canada, classifie leurs codes HS d'exportation américains et déduit leurs classifications de contrôle des exportations à partir de ces codes d'exportation.
Comme
classificationsCalculateWorkflows'exécute deux fois, une fois pour les codes d'importation et une fois pour les codes d'exportation, chaque appel possède un alias (importClassificationsetexportClassifications) afin de distinguer leurs résultats.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}}}Dans l'exemple ci-dessus :
Electronics > Cell Phones. La validation des catégories a renvoyéWRONGet a remplacé ses catégories par la meilleure suggestion,Apparel > Tops > T-Shirts, indiquée dansappliedCategories.6109(t-shirts) plutôt que comme un appareil électronique.EXPORTde l'étape de classification commeexportHsCodede chaque article, carexportHsCodePreferencevautCLASSIFICATION.Les résultats de chaque étape comportent un
draftId, ce qui vous permet de les associer aux brouillons que vous avez créés. La classification renvoie un résultat par brouillon et par pays, et peut renvoyer plusieurs codes par brouillon : utilisez donchsCode.codeTypeethsCode.countryCodepour choisir le code dont vous avez besoin.Contrôler la façon dont les étapes s'enchaînent
L'entrée de chaque étape détermine ce qu'elle reprend des étapes précédentes.
Appliquer les suggestions de catégories
categoriesValidateWorkflowutiliseapplySuggestionpour décider si une suggestion remplace les catégories d'un brouillon pour les étapes suivantes :WHEN_WRONG(par défaut) - Remplace les catégories par la meilleure suggestion lorsque le verdict estWRONG.NEVER- Indique uniquement le verdict et les suggestions. Les brouillons conservent leurs catégories.Pour n'appliquer que les corrections fiables, définissez
minimumVerdictConfidence(leconfidenceScoreminimal du verdictWRONG) ouminimumSuggestionConfidence(laconfidenceminimale de la meilleure suggestion). Lorsqu'un minimum n'est pas atteint, le brouillon conserve ses catégories.Les suggestions proviennent de l'arborescence de catégories de votre organisation : leur qualité dépend donc de celle de cette arborescence. La
confidencede chaque suggestion est relative aux autres suggestions ; avec une arborescence réduite ou incomplète, une correspondance médiocre peut donc tout de même obtenir un score élevé. Chargez votre arborescence de catégories complète avant de vous appuyer surWHEN_WRONG; voir Gérer votre arborescence de catégories.Les étapes de classification, de classification à l'export et d'articles du catalogue utilisent par défaut les catégories corrigées. Définissez
useValidatedCategories: falsesur une étape pour utiliser plutôt les catégories d'origine du brouillon.Choisir les codes HS
classificationsCalculateWorkfloweffectue la classification pour les pays indiqués dansshipToCountries. Pour obtenir plutôt des codes HS d'exportation (comme les codes Schedule B américains), définissezhsCodeType: EXPORTetshipFromCountry. Si vous avez besoin des deux, appelez l'étape deux fois avec un alias pour chaque appel, comme dans l'exemple ci-dessus.exportClassificationsInferWorkflowchoisit le code HS d'exportation de chaque brouillon à l'aide deexportHsCodePreference:PROVIDED(par défaut) - Utilise l'exportHsCodedu brouillon, et le codeEXPORTde l'étape de classification uniquement lorsque le brouillon n'en a pas.CLASSIFICATION- Utilise le codeEXPORTde l'étape de classification, et l'exportHsCodedu brouillon uniquement lorsqu'il n'y en a pas.Lorsqu'aucun des deux codes n'existe, Zonos en détermine un dans le cadre de la classification à l'export. Fournir un code HS d'exportation donne les résultats les plus fiables.
Contrôle par rapport aux listes de munitions
Par défaut, la classification à l'export suit les paramètres de classification à l'export de votre organisation. Utilisez
settingOverridepour les modifier pour une seule étape. Par exemple, définissezmunitionsScreeningEnabled: truepour contrôler les articles par rapport à la liste des munitions de la juridiction (aux États-Unis, l'USML) avant sa liste des biens à double usage (la CCL). Les résultats incluent alorscontrolList,controlListVersionetcontrolTier.exportClassificationsInferWorkflow( input: { shipFromCountry: US settingOverride: { munitionsScreeningEnabled: true } } ) { draftId classificationCode controlList controlListVersion controlTier }Enregistrer les résultats dans votre catalogue
Pour enregistrer les brouillons en tant qu'articles du catalogue, ajoutez
catalogItemsCreateFromDraftsWorkflowcomme dernière étape. Chaque article du catalogue reçoit les catégories issues de la validation des catégories et un code HS issu de la classification, et renvoie ledraftIddont il provient.catalogItemsCreateFromDraftsWorkflow( input: { hsCodePreference: CLASSIFICATION, shipToCountry: GB } ) { id sku categories hsCode }hsCodePreference-PROVIDED(par défaut) conserve lehsCodepropre au brouillon et n'utilise le code de la classification que lorsque le brouillon n'en a pas.CLASSIFICATIONprivilégie le code de la classification.shipToCountry- Choisit le pays dont la classification fournit le code HS lorsque l'étape de classification a été exécutée pour plusieurs pays.Un article du catalogue ne reçoit jamais un code HS d'exportation comme
hsCode. Les articles du catalogue sont enregistrés selon leur clé d'article, comme aveccatalogItemCreate: attribuez donc unskuou unproductIdà chaque brouillon. Un brouillon qui n'en a pas est enregistré comme un nouvel article du catalogue à chaque exécution du workflow.Gérer les erreurs
À chaque étape, chaque brouillon réussit ou échoue indépendamment des autres. Lorsqu'un brouillon échoue, il est exclu des résultats de cette étape et signalé dans
errorsavec sondraftIddans lesextensions, tandis que les autres brouillons poursuivent. Le champerrorTypeen indique la raison :BAD_REQUEST- L'entrée du brouillon n'est pas valide, par exemple un code HS d'exportation sans chiffres. Corrigez l'entrée avant de réessayer.INTERNAL- Une erreur inattendue s'est produite.UNAVAILABLE- Une dépendance a expiré ou était inaccessible. Relancez la requête.mutation ExportOnly($drafts: [CatalogItemDraftInput!]!) {catalogItemDraftsCreateWorkflow(input: $drafts) {idname}exportClassificationsInferWorkflow(input: { shipFromCountry: US }) {draftIdclassificationCodeexportHsCode}}Un problème touchant une étape dans son ensemble fait échouer toute cette étape. C'est le cas, par exemple, lorsque l'étape n'a aucun brouillon à traiter parce que
catalogItemDraftsCreateWorkflowest absent de la mutation, ou lorsquedraftIdsdésigne un brouillon qui ne fait pas partie de la requête.CatalogItemDraftInput
catalogItemDraftsCreateWorkflow catalogItemsCreateFromDraftsWorkflow categoriesValidateWorkflow exportClassificationsInferWorkflow
Cette page a-t-elle été utile?