Comment cela fonctionne-t-il ?
Pour retirer les droits, taxes ou frais d'un prix inclusif, vous utiliserez la configuration reverseAmountDetails dans votre requête API. Cet objet indique à Zonos quels composants sont inclus dans votre prix d'entrée et doivent être retirés pour calculer le véritable prix de base pour la douane.
Lorsque vous envoyez un prix inclusif avec la configuration reverseAmountDetails respective, Zonos va :
- Analyser le prix inclusif et les paramètres spécifiés.
- Déterminer quels composants (droits, taxes, frais) retirer.
- Calculer le prix de base en retirant ces composants.
- Renvoyer à la fois le prix de base ajusté et une ventilation des montants inversés.
Guide API
Pour intégrer le reverse inclusive pricing dans votre flux de travail, incluez l'objet reverseAmountDetail dans la requête itemCreateWorkflow.
Configuration de la requête
Le passage de reverseAmountDetail indique à Zonos de retirer les droits, taxes et/ou frais. Si cette configuration n'est pas transmise, le calcul standard de landed cost sera effectué.
itemReverseAmountTypeDéfinit quels composants sont inclus dans le prix. Vous pouvez choisir parmi :
TAX: Seule la taxe est incluse.DUTY: Seul le droit est inclus.DUTY_TAX: Les droits et la taxe sont inclus.TAX_FEE: La taxe et les frais sont inclus.DUTY_FEE: Les droits et les frais sont inclus.DUTY_TAX_FEE: Les droits, la taxe et les frais sont tous inclus.
taxRateCountryIndique le pays dont le taux de taxe est inclus dans le prix. Ceci est facultatif.
- S'il n'est pas spécifié, le système utilise par défaut le taux de taxe du pays de destination.
- La valeur doit être un code pays ISO valide.
dutyRateCountryIndique le pays dont le taux de droit est inclus dans le prix. Ceci est facultatif.
- S'il n'est pas spécifié, le système utilise par défaut le taux de taxe du pays de destination.
- La valeur doit être un code pays ISO valide.
serviceLevelCodesRequis uniquement si itemReverseAmountType inclut FEE.
- Spécifie quels frais de niveau de service d'expédition sont inclus dans le prix.
- La valeur doit être un tableau de codes de niveau de service.
status (réponse uniquement)Indique le résultat du calcul inverse. Ce champ est renvoyé dans la réponse :
APPLIED: Le calcul inverse a été appliqué avec succès.NOT_APPLIED_UNDER_DE_MINIMIS: Aucun calcul appliqué car la valeur est inférieure au seuil de minimis.NOT_APPLIED_NEGATIVE_VALUE: Calcul ignoré pour éviter une valeur négative.
Exemple API
Une fois que vous avez préparé l'entrée requise, envoyez la mutation GraphQL à l'API à l'aide de votre client ou outil préféré.
mutation { partyCreateWorkflow( input: [ { type: ORIGIN, location: { countryCode: US } } { type: DESTINATION location: { countryCode: CA, administrativeAreaCode: "AB" } } ] ) { id } itemCreateWorkflow( input: [ { productId: "product-1" hsCode: "9503.00.9079" countryOfOrigin: US amount: 100 quantity: 1 currencyCode: USD reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA } } ] ) { id amount currencyCode quantity hsCode countryOfOrigin reverseAmountDetail { originalAmount amount status type dutyRateCountry taxRateCountry taxRate dutyRate feeAmount } } cartonsCreateWorkflow( input: { length: 8 width: 4 height: 2 dimensionalUnit: INCH weight: 1 weightUnit: POUND } ) { id } shipmentRatingCreateWorkflow( input: { amount: "30.00" currencyCode: USD serviceLevelCode: "ups.worldwide_expedited" } ) { id } landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) { id amountSubtotals { items shipping duties taxes fees } duties { amount currency note } fees { amount currency type note } taxes { amount currency } method }}
Reverse inclusive pricing
Retirez les droits, taxes et frais de votre prix inclusif via l'API.
BETA
Le reverse inclusive pricing de Zonos vous permet d'envoyer un prix inclusif — un prix qui inclut déjà les droits, taxes et/ou frais — et de recevoir en retour le prix de base pour la documentation douanière. Cela vous permet d'afficher des prix tout compris aux acheteurs tout en déclarant un prix de base propre et non inclusif pour la facture commerciale. Cette solution est idéale pour les marchés où l'inclusive pricing est attendu ou requis, vous aidant à prendre en charge les stratégies de tarification internationale tout en maintenant la précision et la conformité douanières.