DOCS

Reverse inclusive pricing

Reverse inclusive pricing

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

KOMMER SNART

Zonos's Reverse Inclusive Pricing giver dig mulighed for at sende en inklusive pris—en pris der allerede inkluderer afgifter, skatter og/eller gebyrer—og modtage basisprisen 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 fjerne 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 angivne parametre.
  2. Bestemme hvilke komponenter (afgifter, skatter, gebyrer) der skal fjernes.
  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 reverse inclusive pricing i dit workflow, skal du inkludere reverseAmountDetail objektet i itemCreateWorkflow anmodningen.

Konfigurering af anmodningen

At sende reverseAmountDetail fortæller Zonos at fjerne 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 mellem:

  • 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 skatte rate er inkluderet i prisen. Dette er valgfrit.

  • Hvis ikke angivet, vil systemet som standard bruge destinationens lands skatte 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 angivet, vil systemet som standard bruge destinationens lands skatte 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
92
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
      feeType
      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?