DOCS

Omvänd inclusive pricing

Omvänd inclusive pricing

Omvänd avgifter, skatter och avgifter från ditt all-inclusive pris via API.

BETA

Zonos's omvända inclusive pricing låter dig skicka ett all-inclusive pris—ett som redan inkluderar avgifter, skatter och/eller avgifter—och få tillbaka baspriset för tulldokumentation. Detta gör att du kan visa priser som är heltäckande för kunderna samtidigt som du deklarerar ett rent, icke-inkluderande baspris för den kommersiella fakturan. Denna lösning är idealisk för marknader där inclusive pricing förväntas eller krävs, vilket hjälper dig att stödja globala prissättningsstrategier och upprätthålla tullnoggrannhet och efterlevnad.

Hur fungerar det? 

För att omvända avgifter, skatter eller avgifter från ett all-inclusive pris, kommer du att använda reverseAmountDetails-konfigurationen i din API-förfrågan. Detta objekt talar om för Zonos vilka komponenter som ingår i ditt ingångspris och som bör tas bort för att beräkna det verkliga baspriset för tull.

När du skickar ett all-inclusive pris med den respektive reverseAmountDetails-konfigurationen, kommer Zonos att:

  1. Analysera det all-inclusive priset och angivna parametrar.
  2. Bestämma vilka komponenter (avgifter, skatter, avgifter) som ska omvändas.
  3. Beräkna baspriset genom att ta bort dessa komponenter.
  4. Återvända både det justerade baspriset och en uppdelning av de omvända beloppen.

API-guide 

För att integrera omvänd inclusive pricing i ditt arbetsflöde, inkludera reverseAmountDetail-objektet i itemCreateWorkflow-förfrågan.

Konfigurera förfrågan

Att skicka reverseAmountDetail talar om för Zonos att omvända avgifter, skatter och/eller avgifter. Om denna konfiguration inte skickas, kommer den standardmässiga landed cost-beräkningen att utföras.

itemReverseAmountType

Definierar vilka komponenter som ingår i priset. Du kan välja mellan:

  • TAX: Endast skatt ingår.
  • DUTY: Endast avgift ingår.
  • DUTY_TAX: Avgift och skatt ingår.
  • TAX_FEE: Skatt och avgifter ingår.
  • DUTY_FEE: Avgift och avgifter ingår.
  • DUTY_TAX_FEE: Avgift, skatt och avgifter ingår alla.
taxRateCountry

Anger landet vars skatt rate ingår i priset. Detta är valfritt.

  • Om det inte anges, standardiserar systemet till destinationens lands skatt rate.
  • Värdet bör vara en giltig ISO landskod.
dutyRateCountry

Anger landet vars avgift rate ingår i priset. Detta är valfritt.

  • Om det inte anges, standardiserar systemet till destinationens lands skatt rate.
  • Värdet bör vara en giltig ISO landskod.
serviceLevelCodes

Detta krävs endast om itemReverseAmountType inkluderar FEE.

  • Specificerar vilka fraktservicenivåavgifter som ingår i priset.
  • Värdet bör vara en array av servicenivåkoder.
status (endast svar)

Anger resultatet av den omvända beräkningen. Detta fält returneras i svaret:

  • APPLIED: Den omvända beräkningen tillämpades framgångsrikt.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Ingen beräkning tillämpades eftersom värdet är under de minimis-tröskeln.
  • NOT_APPLIED_NEGATIVE_VALUE: Beräkningen hoppades över för att undvika ett negativt värde.

API-exempel

När du har förberett den nödvändiga ingången, skicka GraphQL-mutation till API:et med hjälp av din föredragna klient eller verktyg.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
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
  }
}

Svar

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
  "data": {
    "partyCreateWorkflow": [
      { "id": "party_cc85f44d-567a-4cb0-984f-17a0e2d97f78" },
      { "id": "party_0kcf5m0x404q6" }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_0kcf5rsa420zy",
        "amount": 95.0,
        "currencyCode": "USD",
        "quantity": 1,
        "hsCode": "9503.00.9079",
        "countryOfOrigin": "US",
        "reverseAmountDetail": [
          {
            "originalAmount": 100,
            "amount": 95.0,
            "status": "APPLIED",
            "type": "DUTY_TAX",
            "dutyRateCountry": "CA",
            "taxRateCountry": "CA",
            "taxRate": 0.05,
            "dutyRate": null,
            "feeAmount": null
          }
        ]
      }
    ],
    "cartonsCreateWorkflow": [{ "id": "carton_0kcf5rth4057g" }],
    "shipmentRatingCreateWorkflow": {
      "id": "shipment_rating_0kcf5rtpc057t"
    },
    "landedCostCalculateWorkflow": [
      {
        "id": "lc-6bfd94d67d2e43e5b5cf1143d56ca01e",
        "amountSubtotals": {
          "items": 95.0,
          "shipping": 30.0,
          "duties": 0.0,
          "taxes": 5.2,
          "fees": 9.5
        },
        "duties": [],
        "fees": [
          {
            "amount": 7.16,
            "currency": "USD",
            "feeType": "ADVANCEMENT",
            "type": "ADVANCEMENT",
            "note": null
          },
          {
            "amount": 1.77,
            "currency": "USD",
            "feeType": "BROKERAGE_FEE",
            "type": "BROKERAGE_FEE",
            "note": null
          },
          {
            "amount": 0.57,
            "currency": "USD",
            "feeType": "CURRENCY_CONVERSION_FEE",
            "type": "CURRENCY_CONVERSION_FEE",
            "note": null
          }
        ],
        "taxes": [
          { "amount": 4.75, "currency": "USD" },
          { "amount": 0.36, "currency": "USD" },
          { "amount": 0.09, "currency": "USD" }
        ],
        "method": "DDP"
      }
    ]
  }
}

Var den här sidan till hjälp?