DOCS

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.

Étape↕Rôle↕
catalogItemDraftsCreateWorkflowCrée un brouillon pour chaque article à partir de ses détails et d'une image facultative. Toujours la première étape.
categoriesValidateWorkflowValide 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.
classificationsCalculateWorkflowClassifie 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.
exportClassificationsInferWorkflowDéduit la classification de contrôle des exportations de chaque brouillon, comme un ECCN. Voir Classification à l'export.
catalogItemsCreateFromDraftsWorkflowEnregistre 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.

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 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.

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}

Dans l'exemple ci-dessus :

  • 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.

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

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.

Enregistrer les résultats dans votre catalogue 

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.

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 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.
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}

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.

Cette page a-t-elle été utile?