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 courriel 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'entrée elle-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 de landed cost, cette valeur doit toujours être DDP_PREFERRED, ce qui fournira une soumission DDP lorsque c'est possible et une soumission DAP si une soumission DDP n'est pas autorisée. Utiliser DAP à la place peut faire en sorte que les landed costs ne soient plus garantis, 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 cette soumission, dans le cas où une plage de taux tarifaires pourrait s'appliquer. *Lorsque vous utilisez notre garantie de landed cost, cette valeur doit toujours être ZONOS_PREFERRED.

Zonos recommande fortement d'utiliser des codes HS propres à chaque produit, car cela permet d'obtenir une soumission de landed cost plus précise. Si vous connaissez vos codes HS, transmettez le hsCode de chaque item lors du itemCreateWorkflow.

Si vous transmettez un code HS, Zonos le validera à la volée lors de l'obtention d'une soumission de 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 au lieu 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 qui alimentera 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 aucune entrée) 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.