DOCS

Omvendt inclusive pricing

Omvendt inclusive pricing

Omvend afgifter, skatter og gebyrer fra din inklusive pris via API.

BETA

Zonos's omvendte inclusive pricing giver dig mulighed for at sende en inklusive pris—en der allerede inkluderer afgifter, skatter og/eller gebyrer—og modtage basisprisen tilbage til tolddokumentation. Dette gør det muligt for dig at vise alt-inklusive priser til kunderne, mens du stadig erklærer en ren, ikke-inklusive basispris for den kommercielle faktura. Denne løsning er ideel til markeder, hvor inclusive pricing forventes eller kræves, hvilket hjælper dig med at understøtte globale prisstrategier og opretholde toldnøjagtighed og overholdelse.

Hvordan fungerer det? 

For at omvende afgifter, skatter eller gebyrer fra en inklusive pris, skal du bruge reverseAmountDetails konfigurationen i din API-anmodning. Dette objekt fortæller Zonos hvilke komponenter der er inkluderet i din inputpris og som skal fjernes for at beregne den sande basispris til told.

Når du sender en inklusive pris med den respektive reverseAmountDetails konfiguration, vil Zonos:

  1. Analysere den inklusive pris og de specificerede parametre.
  2. Bestemme hvilke komponenter (afgifter, skatter, gebyrer) der skal omvendes.
  3. Beregne basisprisen ved at fjerne disse komponenter.
  4. Returnere både den justerede basispris og en opdeling af de omvendte beløb.

API guide 

For at integrere omvendt inclusive pricing i dit workflow, skal du inkludere reverseAmountDetail objektet i itemCreateWorkflow anmodningen.

Konfigurering af anmodningen

At sende reverseAmountDetail fortæller Zonos at omvende afgifter, skatter og/eller gebyrer. Hvis denne konfiguration ikke sendes, vil den standard landed cost beregning blive udført.

itemReverseAmountType

Definerer hvilke komponenter der er inkluderet i prisen. Du kan vælge imellem:

  • TAX: Kun skat er inkluderet.
  • DUTY: Kun afgift er inkluderet.
  • DUTY_TAX: Afgift og skat er inkluderet.
  • TAX_FEE: Skat og gebyrer er inkluderet.
  • DUTY_FEE: Afgift og gebyrer er inkluderet.
  • DUTY_TAX_FEE: Afgift, skat og gebyrer er alle inkluderet.
taxRateCountry

Angiver landet hvis skat rate er inkluderet i prisen. Dette er valgfrit.

  • Hvis ikke specificeret, defaultes systemet til destinationens lands skat rate.
  • Værdien skal være en gyldig ISO landekode.
dutyRateCountry

Angiver landet hvis afgift rate er inkluderet i prisen. Dette er valgfrit.

  • Hvis ikke specificeret, defaultes systemet til destinationens lands skat rate.
  • Værdien skal være en gyldig ISO landekode.
serviceLevelCodes

Dette er kun påkrævet hvis itemReverseAmountType inkluderer FEE.

  • Angiver hvilke forsendelsestjeneste niveau gebyrer der er inkluderet i prisen.
  • Værdien skal være et array af service niveau koder.
status (kun svar)

Angiver resultatet af den omvendte beregning. Dette felt returneres i svaret:

  • APPLIED: Den omvendte beregning blev anvendt med succes.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Ingen beregning anvendt fordi værdien er under de minimis tærsklen.
  • NOT_APPLIED_NEGATIVE_VALUE: Beregningen blev sprunget over for at undgå en negativ værdi.

API eksempel

Når du har forberedt den nødvendige input, send GraphQL mutation til API'en ved hjælp af dit foretrukne klient eller værktøj.

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 denne side nyttig?