DOCS

Reverse inclusive pricing

Reverse inclusive pricing

Fjern avgifter, skatter og gebyrer fra din inkluderte pris via API.

KOMMER SNART

Zonos' Reverse Inclusive Pricing lar deg sende en inkludert pris—en som allerede inkluderer avgifter, skatter og/eller gebyrer—og motta basisprisen tilbake for tolldokumentasjon. Dette lar deg vise alt-inkludert priser til kunder samtidig som du erklærer en ren, ikke-inkludert basispris for den kommersielle fakturaen. Denne løsningen er ideell for markeder der inclusive pricing forventes eller kreves, og hjelper deg med å støtte globale prisstrategier og opprettholde nøyaktighet og samsvar med toll.

Hvordan fungerer det? 

For å reversere avgifter, skatter eller gebyrer fra en inkludert pris, må du bruke reverseAmountDetails-konfigurasjonen i API-forespørselen din. Dette objektet forteller Zonos hvilke komponenter som er inkludert i din inngangspris og som skal fjernes for å beregne den sanne basisprisen for toll.

Når du sender en inkludert pris med den respektive reverseAmountDetails-konfigurasjonen, vil Zonos:

  1. Analysere den inkluderte prisen og spesifiserte parametere.
  2. Bestemme hvilke komponenter (avgifter, skatter, gebyrer) som skal reverseres.
  3. Beregne basisprisen ved å fjerne disse komponentene.
  4. Returnere både den justerte basisprisen og en oversikt over de reverserte beløpene.

API-guide 

For å integrere reverse inclusive pricing i arbeidsflyten din, inkluder reverseAmountDetail-objektet i itemCreateWorkflow-forespørselen.

Konfigurere forespørselen

Å sende reverseAmountDetail forteller Zonos å reversere avgifter, skatter og/eller gebyrer. Hvis denne konfigurasjonen ikke sendes, vil den standard landed cost-beregningen bli utført.

itemReverseAmountType

Definerer hvilke komponenter som er inkludert i prisen. Du kan velge mellom:

  • TAX: Bare skatt er inkludert.
  • DUTY: Bare avgift er inkludert.
  • DUTY_TAX: Avgift og skatt er inkludert.
  • TAX_FEE: Skatt og gebyrer er inkludert.
  • DUTY_FEE: Avgift og gebyrer er inkludert.
  • DUTY_TAX_FEE: Avgift, skatt og gebyrer er alle inkludert.
taxRateCountry

Indikerer landet hvis skatt rate er inkludert i prisen. Dette er valgfritt.

  • Hvis ikke spesifisert, vil systemet bruke destinasjonslandets skatte rate som standard.
  • Verdien bør være en gyldig ISO landkode.
dutyRateCountry

Indikerer landet hvis avgift rate er inkludert i prisen. Dette er valgfritt.

  • Hvis ikke spesifisert, vil systemet bruke destinasjonslandets skatte rate som standard.
  • Verdien bør være en gyldig ISO landkode.
serviceLevelCodes

Dette er kun nødvendig hvis itemReverseAmountType inkluderer FEE.

  • Spesifiserer hvilke fraktservice nivå gebyrer som er inkludert i prisen.
  • Verdien bør være et array av service nivå koder.
status (bare respons)

Indikerer resultatet av den reverserte beregningen. Dette feltet returneres i responsen:

  • APPLIED: Den reverserte beregningen ble vellykket anvendt.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Ingen beregning ble anvendt fordi verdien er under de minimis terskelen.
  • NOT_APPLIED_NEGATIVE_VALUE: Beregningen ble hoppet over for å unngå en negativ verdi.

API-eksempel

Når du har forberedt den nødvendige inngangen, send GraphQL-mutasjonen til API-en ved hjelp av din foretrukne klient eller verktøy.

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 siden nyttig?