Calculer un Landed Cost

Le partyCreateWorkflowInput identifie les parties impliquées et leurs emplacements. Consultez le schéma complet dans notre référence de l'API GraphQL. Les champs requis sont :

• location
  • administrativeAreaCode : le code de l'État ou de la province, en deux lettres. Requis uniquement pour le CA et le BR.
  • countryCode : le code ISO à deux lettres du pays.
  • line1 : la première ligne de l'adresse.
  • postalCode : le code postal de l'adresse.
• person
  • email : l'adresse e-mail de la personne.
  • firstName : le prénom de la personne.
  • lastName : le nom de famille de la personne.
  • phone : le numéro de téléphone de la personne.
• type
  • DESTINATION : les informations location et person pour la destination d'expédition.
  • ORIGIN : les informations location pour l'origine d'expédition. La person associée à l'origine d'expédition n'est pas requise.

Le itemCreateWorkflowInput répertorie les articles du panier. Il existe de nombreux champs optionnels (consultez toutes les possibilités dans notre référence API), mais les champs ci-dessous sont requis.

• amount : la valeur d'une seule unité du produit expédié, avant multiplication par la quantité. Notez que cela diffère de la définition postale d'un article postal. Si la quantity de l'article est 1, il s'agit du coût total de l'article. Si la quantity de l'article est supérieure à 1, l'API multipliera le amount de l'article par sa quantity pour obtenir le total de la ligne. Ne mettez pas le prix total de toutes les unités de l'article dans amount.
• currencyCode : le code de devise du montant de l'article.
• quantity : la quantité de l'article. L'API multipliera le amount de l'article par sa quantity pour obtenir le total de la ligne.
• countryOfOrigin : le pays où l'article a été fabriqué.
• L'un des éléments suivants (selon celui défini dans votre préférence de clé d'article. Votre clé d'article relie les informations stockées dans Catalog à l'article du panier et est utilisée lors de la création de l'étiquette.)
  • productId : l'ID produit de l'article.
  • sku : le SKU de l'article.

Les measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) ne sont requises que si vous souhaitez cartoniser vos articles lors de l'obtention d'une tarification d'expédition.

Le cartonsCreateWorkflowInput ne requiert que l'input lui-même. Consultez le schéma complet dans notre référence de l'API GraphQL pour voir toutes les valeurs pouvant être transmises. Il est important de transmettre les dimensions et le poids du carton si Zonos calcule le coût d'expédition.

Ce flux de travail est utilisé lorsque vous connaissez déjà le service et le coût d'expédition ; si vous souhaitez que Zonos calcule ces coûts pour les services que vous avez activés, remplacez ce flux de travail par le shipmentRatingCalculateWorkflow.

Le shipmentRatingCreateWorkflowInput communique le coût d'expédition. Consultez le schéma complet dans notre référence de l'API GraphQL. Les champs requis sont :

• amount : le coût d'expédition.
• currencyCode : le code de devise du coût d'expédition.
• serviceLevelCode : le code indiquant le niveau de service d'expédition utilisé dans la tarification d'expédition.

Le landedCostWorkFlowInput dicte les préférences pour le calcul du Landed Cost. Consultez le schéma complet dans notre référence de l'API GraphQL. Les champs requis sont :

• calculationMethod : indique votre préférence pour la façon dont vous prévoyez d'expédier : DDP (droits et taxes prépayés) ou DAP (les droits et taxes sont soit payés à la livraison, soit, si un régime de remise s'applique, remis via un identifiant fiscal).
  • Si vous utilisez notre garantie Landed Cost, cette valeur doit toujours être DDP_PREFERRED, ce qui fournira un devis DDP lorsque cela est possible et un devis DAP si un devis DDP n'est pas autorisé. Utiliser DAP à la place peut faire que le Landed Cost ne soit plus garanti, car cela se traduit généralement par des droits et taxes payés à la livraison.
• endUse : indique si les biens sont vendus à une autre entreprise (FOR_RESALE) ou destinés à un usage final par un consommateur (NOT_FOR_RESALE).
• tariffRate : indique la méthode que Zonos doit utiliser pour calculer les taux tarifaires de ce devis, dans le cas où une plage de taux tarifaires pourrait s'appliquer. *Lorsque vous utilisez notre garantie Landed Cost, cette valeur doit toujours être ZONOS_PREFERRED.

Zonos recommande fortement d'utiliser des codes HS spécifiques à chaque produit, car cela permet d'obtenir un devis Landed Cost plus précis. Si vous connaissez vos codes HS, transmettez le hsCode pour chaque item lors du itemCreateWorkflow.

Si vous transmettez un code HS, Zonos le validera à la volée lors de l'obtention d'un devis Landed Cost. Si le code HS que vous avez fourni est invalide (c'est-à-dire qu'il n'existe pas), Zonos reclassifiera votre article à la volée et utilisera le nouveau code HS valide à la place de celui que vous avez fourni.

Si vous avez besoin d'aide pour générer des codes HS pour vos produits, découvrez Zonos Classify et comment demander une classification.

Si vous ne transmettez pas de hsCode à Zonos, nous vérifierons d'abord dans Zonos Catalog si un code HS est déjà stocké pour votre article. Si ce n'est pas le cas, nous appellerons Classify pour générer une classification alimentant votre calcul de Landed Cost, en fonction des champs de détail produit suivants du itemCreateWorkflow : description, category et material. Si vos champs de détail produit ne sont pas suffisamment détaillés pour générer une classification selon le score de confiance de Classify, le code HS par défaut assigné à votre boutique sera utilisé.

Pour que Zonos calcule les coûts d'expédition, utilisez le shipmentRatingCalculateWorkflow. Les options d'expédition renvoyées dans la réponse d'expédition calculée correspondront aux serviceLevels que vous avez assignés aux profils d'expédition dans Dashboard.

Dépannage : Si vous attendez un serviceLevel dans la réponse mais qu'il n'apparaît pas, veuillez vous assurer que le serviceLevel est activé et pris en charge par la method que vous avez sélectionnée.

Ajoutez le cartonizeWorkflow (qui n'a pas d'inputs) si vous souhaitez que Zonos regroupe vos articles en cartons avant de déterminer le coût d'expédition (utilisé pour le poids dimensionnel.

Si vous connaissez le serviceLevel et le amount d'un envoi, vous pouvez les transmettre dans la portion shipmentRatingCreateWorkflow de la requête. Nous utiliserons ces valeurs pour calculer les frais de transporteur associés et les renvoyer dans la réponse.