Tax-included pretty price

Learn how to apply landed cost with tax-included pretty price.

Tax-included pretty price is a feature that allows you to display a price that appeals to your shoppers. This guide shows you how to enable the tax-included pretty price with landed cost.

See Best practice flows by payment type for more information.

Prerequisites

The tax-included pretty price is based on the landed cost feature. Customer Success must enable landed cost and tax-included pretty price to use this feature. Contact your Customer Success Manager for assistance.

To enable a tax-included pretty price, you need to:

  1. Work with your Customer Success Manager to enable landed cost.

  2. Work with your Customer Success Manager to enable landed cost with a tax-included pretty price.

  3. Create a price list and enable Prices Include Value Added Tax (VAT).

  4. Set the shipping cost to tax-inclusive.

Creating a price list with a tax-included pretty price

Price lists allow you to define how to convert product prices from the default currency to other currencies for different locales. Create a price list with Prices Include Value Added Tax (VAT) enabled to enable the tax-included pretty price.

  1. Sign in to Global Commerce.

  3. Select Catalog, select Pricing & Plans, and then choose one of the following options:

    • Click Create Price List.

    • Click Manage Price Lists and then click Create Price List.

    The Create Price List page appears.

  4. Complete the fields, and select the Prices Include Value Added Tax (VAT) checkbox to enable tax-inclusive pricing. See Create Price List attributes for more information.

  5. Click Save. The Price List Details page appears.

  6. Complete the fields on the Price List Details page. See the Price List Details attributes for more information.

  7. Scroll down and click Done.

Setting the shipping cost to tax-inclusive

The Features tab on the Configure Site Settings page allows you to enable or disable features that appear in your store. For landed cost and landed cost with a tax-included pretty price, shipping costs should be tax-inclusive.

  1. From Global Commerce, select Administration, select Site, then click Configure Site Settings. The Configure Site Settings page appears.

  2. To set the shipping cost to tax exclusive, click the Features tab, scroll down to Input Tax-Inclusive Shipping Cost, and set the toggle for Input Tax-Inclusive Shipping to ON. Digital River will send the tax-inclusive shipping costs to the shipping carrier for the landed cost calculation. This ensures the shopper is not double-taxed by the shipping carrier. Note: If you need to support shipping a product to another locale within a country (non-cross border), and the locale supports the landed cost solution, contact your Customer Success Manager.

  3. Click Apply.

Landed cost without a tax-inclusive pretty price

When you disable the tax-inclusive pretty price, the landed cost solution can only accept the Tax Exclusive Product Price. You need to manually calculate a tax-exclusive price, and then add the tax-exclusive price to the price list. If the tax-inclusive price is $1599, you can back-calculate the product price to $1279.2 without taxes. Digital River rounds the price to $1279 if a locale does not accept decimals.

Product pricing setup:

  • Physical product price (tax exclusive): $1279

  • Shipping cost (tax exclusive): $0 (free shipping)

  • Estimated tax rate configured by Digital River: 25%

In the following table, you can see the final price (orderTotal) is $1598.75. While it's not a pretty price, it's close to the expected $1599.

Cart without address inputCart with address / submit cart

Physical line item

listPrice: 1279

salePrice: 1279

productTax: 319.75

shippingTax: 0

feeTax: 0

taxRate: 0.25

importTax: 0

importDuty: 0

listPrice: 1279

salePrice: 1279

productTax: 0

shippingTax: 0

feeTax: 0

taxRate: 0

importTax: 319.75

importDuty: 0

Order level

subtotal: 1598.75

discount: 0

shippingAndHandling: 0

importTaxAndDuty: 0

tax: 319.75

orderTotal: 1598.75

subtotal: 1598.75

discount: 0

shippingAndHandling: 119

importTaxAndDuty: 319.75

tax: 0

orderTotal: 1598.75

Tax inclusive flag

taxinclusive: false

taxInclusive: false

Landed cost with a tax-inclusive pretty price

Product pricing setup:

  • Physical product price (tax inclusive): $1599

  • Shipping cost (tax exclusive): $0 (free shipping)

  • Estimated tax rate configured by Digital River: 25%

In the following table, you can see the tax-inclusive pretty price in the final price where the orderTotal is $1599.

Cart without address inputCart with address / submit cart

Physical line item

listPrice: 1599

salePrice: 1599

productTax: 319.8

shippingTax: 0

feeTax: 0

taxRate: 0.25

importTax: 0

importDuty: 0

listPrice: 1599

salePrice: 1599

productTax: 0

shippingTax: 0

feeTax: 0

taxRate: 0

importTax: 319.8

importDuty: 0

Order level

subtotal: 1599

discount: 0

shippingAndHandling: 0

importTaxAndDuty: 0

tax: 319.8

orderTotal: 1599

subtotal: 1599

discount: 0

shippingAndHandling: 119

importTaxAndDuty: 319.8

tax: 0

orderTotal: 1599

Tax inclusive flag

taxInclusive: true

taxInclusive: true

See Pricing fields for more information.

Tax-inclusive pretty price in the shopper's checkout flow

Cart

The callouts in the following list show the API response payloads corresponding with the tax-inclusive pretty price values that appear on the Cart page.

  1. The total calculated price for the line item with quantity (listPriceWithQuantity). You can find it here in the response: "lineItems": { ... "lineItem": { "pricing": { ... "listPriceWithQuantity": { "currency": "USD", "value": 3016.00 ... }, ... } ... } ... }

  2. The total calculated price for the line item with quantity (salePriceWithQuantity). You can find it here in the response: "lineItems": { ... "lineItem": { "pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 ... }, ... } ... } ... }

  3. The shipping and handling fee of the order (shippindAndHandling). You can find it here in the response: "pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }

  4. The final price of the order (orderTotal). You can find it here in the response: "pricing": { ... "orderTotal": { "currency": "USD", "value": 2513.00 }, ... }

See Pricing fields for more information.

Order review

The callouts in the following list show the API response payloads corresponding with the tax-inclusive pretty price values that appear on the Order Review page.

  1. The final price of the order (orderTotal). You can find it here in the response: pricing > orderTotal "pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }

  2. The import taxes and duties of the order, which is the sum of import taxes and duties for all the line items (importTaxAndDuty). Make sure the value for landedCostState is PREPAID. You can find it here in the response: pricing > orderTotal "pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 152.00 }, ... }

See Pricing fields for more information.

Thank you

The callouts in the following list show the API response payloads that correspond with the tax-inclusive pretty price values that appear on the Thank You page.

  1. The final price of the order (orderTotal). You can find it here in the response: "pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }

See Pricing fields for more information.

Invoice

The callouts in the following list show the API response payloads corresponding with the tax-inclusive pretty price values that appear on the Invoice.

  1. The total calculated price for the line item with quantity (salePriceWithQuantity). You can find it here in the response: "lineItems": { ... "lineItem": { "pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 ... }, ... } ... } ... }

  2. The shipping and handling fee (shippindAndHandling). You can find it here in the response: "pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }

  3. The final price of the order (orderTotal). You can find it here in the response: "pricing": { ... "orderTotal": { "currency": "USD", "value": 2513.00 }, ... }

  4. The order-level import taxes and duties (importTaxAndDuty) is the sum of all line items' import taxes (importTax) and import duties (importDuty). For example:

    • importDutyTax: 75

    • lineItem: A

      • importTax: 15

      • importDuty: 10

    • lineItem: B

      • importTax: 30

      • importDuty: 20

    Make sure the value for landedCostState is PREPAID. You can find it here in the response: "pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 75.00 }, ... "importTax": { "currency": "USD", "value": 15.00 }, ... "importDuty": { "currency": "USD", "value": 10.00 }, ... "importTax": { "currency": "USD", "value": 30.00 }, ... "importDuty": { "currency": "USD", "value": 20.00 }, ... }

See Pricing fields for more information.

Additional pricing information

The callouts in the following list show the API response payloads corresponding with the tax-inclusive pretty price values that appear on the Invoice as additional pricing information.

  1. The total calculated price for the line item with quantity (salePriceWithQuantity). You can find it here in the response: "lineItems": { ... "lineItem": { "pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2261.00 ... }, ... } ... } ... }

  2. The tax amount for the product (productTax) at the line-item level with quantity. You can find it here in the response: "lineItems": { ... "lineItem": { ... "id="488822300023", ... "pricing": { ... "productTax": { "currency": "USD", "value": 0.00 ... }, ... } ... } "lineItem": { ... "id="488822300024", ... "pricing": { ... "productTax": { "currency": "USD", "value": 5.00 ... }, ... } ... } ... }

  3. The sum of the import tax (importTax) and import duty (importDuty). (Make sure the value for landedCostState is PREPAID.) You can find it here in the response: "lineItems": { ... "lineItem": { ... "id="488822300023", ... "pricing": { ... "importTax": { "currency": "USD", "value": 103.00 }, ... "importDuty": { "currency": "USD", "value": 49.00 }, ... } "lineItem": { ... "id="488822300024", ... "pricing": { ... "importTax": { "currency": "USD", "value": 0.00 }, ... "importDuty": { "currency": "USD", "value": 0.00 }, ... } ... }

  4. The sale price with quantity (salePriceWithQuantity) excluding the import tax (importTax) and import duty (importDuty). "lineItems": { ... "lineItem": { ... "id="488822300023", ... "pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 }, ... } "lineItem": { ... "id="488822300024", ... "pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 100.00 }, ... } ... }

  5. The shipping and handling fee (shippindAndHandling). You can find it here in the response: "pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }

  6. The sum of import taxes and duties for all the line items (importTaxAndDuty). Make sure the value for landedCostState is PREPAID. You can find it here in the response: "pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 152.00 }, ... }

  7. The sum of all taxes (tax) for the order. You can find it here in the response: "pricing": { ... "tax": { "currency": "USD", "value": 5.00 }, ... }

  8. The final price of the order (orderTotal). You can find it here in the response: "pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }

See Pricing fields for more information.

PreviousMixed cart supportNextRedirecting to a Digital River-hosted cart

Last updated