DOCS

Reverse inclusive pricing

Reverse inclusive pricing

Keer invoerrechten, belastingen en kosten om vanuit uw inclusive prijs via API.

BETA

Met reverse inclusive pricing van Zonos kunt u een inclusive prijs sturen — een prijs die al invoerrechten, belastingen en/of kosten bevat — en ontvangt u de basisprijs terug voor douanedocumentatie. Zo kunt u all-in prijzen aan shoppers tonen terwijl u toch een schone, niet-inclusive basisprijs declareert voor de commerciële factuur. Deze oplossing is ideaal voor markten waar inclusive pricing wordt verwacht of vereist, en helpt u wereldwijde prijsstrategieën te ondersteunen met douaannauwkeurigheid en compliance.

Hoe werkt het? 

Om invoerrechten, belastingen of kosten om te keren vanuit een inclusive prijs, gebruikt u de reverseAmountDetails-configuratie in uw API-request. Dit object vertelt Zonos welke componenten in uw invoerprijs zijn opgenomen en moeten worden verwijderd om de werkelijke basisprijs voor douane te berekenen.

Wanneer u een inclusive prijs stuurt met de bijbehorende reverseAmountDetails-configuratie, zal Zonos:

  1. De inclusive prijs en opgegeven parameters analyseren.
  2. Bepalen welke componenten (invoerrechten, belastingen, kosten) moeten worden omgekeerd.
  3. De basisprijs berekenen door deze componenten te verwijderen.
  4. Zowel de aangepaste basisprijs als een uitsplitsing van de omgekeerde bedragen retourneren.

API-gids 

Om reverse inclusive pricing in uw workflow te integreren, neemt u het reverseAmountDetail-object op in de itemCreateWorkflow-request.

De request configureren

Door reverseAmountDetail door te geven, vertelt u Zonos invoerrechten, belastingen en/of kosten om te keren. Als deze configuratie niet wordt doorgegeven, wordt de standaard landed cost-berekening uitgevoerd.

itemReverseAmountType

Definieert welke componenten in de prijs zijn opgenomen. U kunt kiezen uit:

  • TAX: Alleen belasting is opgenomen.
  • DUTY: Alleen invoerrechten zijn opgenomen.
  • DUTY_TAX: Invoerrechten en belasting zijn opgenomen.
  • TAX_FEE: Belasting en kosten zijn opgenomen.
  • DUTY_FEE: Invoerrechten en kosten zijn opgenomen.
  • DUTY_TAX_FEE: Invoerrechten, belasting en kosten zijn allemaal opgenomen.
taxRateCountry

Geeft het land aan waarvan het belastingtarief in de prijs is opgenomen. Dit is optioneel.

  • Indien niet opgegeven, valt het systeem terug op het belastingtarief van het bestemmingsland.
  • De waarde moet een geldige ISO country code zijn.
dutyRateCountry

Geeft het land aan waarvan het invoerrechtentarief in de prijs is opgenomen. Dit is optioneel.

  • Indien niet opgegeven, valt het systeem terug op het belastingtarief van het bestemmingsland.
  • De waarde moet een geldige ISO country code zijn.
serviceLevelCodes

Dit is alleen vereist als itemReverseAmountType FEE bevat.

  • Specificeert welke shipping service level fees in de prijs zijn opgenomen.
  • De waarde moet een array van service level codes zijn.
status (alleen response)

Geeft het resultaat van de reverse-berekening aan. Dit veld wordt in de response geretourneerd:

  • APPLIED: De reverse-berekening is succesvol toegepast.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Geen berekening toegepast omdat de waarde onder de de minimis-drempel ligt.
  • NOT_APPLIED_NEGATIVE_VALUE: Berekening overgeslagen om een negatieve waarde te voorkomen.

API-voorbeeld

Zodra u de vereiste invoer hebt voorbereid, stuurt u de GraphQL-mutation naar de API met uw voorkeursclient of -tool.

1mutation {
2 partyCreateWorkflow(
3 input: [
4 { type: ORIGIN, location: { countryCode: US } }
5 {
6 type: DESTINATION
7 location: { countryCode: CA, administrativeAreaCode: "AB" }
8 }
9 ]
10 ) {
11 id
12 }
13 itemCreateWorkflow(
14 input: [
15 {
16 productId: "product-1"
17 hsCode: "9503.00.9079"
18 countryOfOrigin: US
19 amount: 100
20 quantity: 1
21 currencyCode: USD
22 reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
23 }
24 ]
25 ) {
26 id
27 amount
28 currencyCode
29 quantity
30 hsCode
31 countryOfOrigin
32 reverseAmountDetail {
33 originalAmount
34 amount
35 status
36 type
37 dutyRateCountry
38 taxRateCountry
39 taxRate
40 dutyRate
41 feeAmount
42 }
43 }
44 cartonsCreateWorkflow(
45 input: {
46 length: 8
47 width: 4
48 height: 2
49 dimensionalUnit: INCH
50 weight: 1
51 weightUnit: POUND
52 }
53 ) {
54 id
55 }
56 shipmentRatingCreateWorkflow(
57 input: {
58 amount: "30.00"
59 currencyCode: USD
60 serviceLevelCode: "ups.worldwide_expedited"
61 }
62 ) {
63 id
64 }
65 landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
66 id
67 amountSubtotals {
68 items
69 shipping
70 duties
71 taxes
72 fees
73 }
74 duties {
75 amount
76 currency
77 note
78 }
79 fees {
80 amount
81 currency
82 type
83 note
84 }
85 taxes {
86 amount
87 currency
88 }
89 method
90 }
91}
Boek een demo

Was deze pagina nuttig?