For the complete documentation index, see llms.txt. This page is also available as Markdown.

Commission Base: Tax, Duty and Discounts

Exactly which part of an order Violet charges commission on, how tax is taken out of tax-inclusive prices using a retailer's tax profile, and how duty and discounts are treated, on the sale and on ref

Commission is charged on goods only. Shipping, tax and duty are never part of it, and discounts come off before it is calculated. This page sets out how Violet arrives at that goods figure, the commission base, for every order, including retailers whose prices already include tax.

You do not send the commission base. Violet works it out from the order you submit and from settings Violet holds for each retailer.

The Calculation

goods            = sub_total − discount_total
commission_base  = goods − tax_inside_goods − transaction_fee (Net Receipts only)
commission       = commission_base × commission_rate
  • tax_inside_goods is zero unless the retailer prices its goods tax-inclusive. See Tax-inclusive prices.

  • transaction_fee applies only to a retailer on Net Receipts whose settings deduct the fee before commission. Tax comes off first, then the fee.

  • Commission is rounded half-up to the nearest minor unit (cent, penny). A base of zero or less gives no commission.

  • The same base is used whatever the retailer's return policy, so REVERSE, RETAIN and Net Receipts retailers all start from the same figure.

Order component
In the commission base?
Notes

Goods (sub_total)

Yes

Net of tax for tax-inclusive retailers.

Discounts (discount_total)

Taken off first

Commission is charged on what the shopper paid for the goods.

Shipping

No

Passed to the retailer in full.

Tax reported as its own amount

No

Paid to whoever remits tax for the order. See Tax Remitter Settings.

Tax inside tax-inclusive prices

No, once a tax profile is in force

See below.

Duty reported as its own amount

No

Paid to the retailer with its payout.

Duty inside product prices

Yes

No per-retailer duty rate exists today. See Duty.

Channel transaction fee

Only for Net Receipts retailers that deduct it

Tax-Inclusive Prices

Where tax is reported separately on the order, as on most US orders, it is already outside the goods price and there is nothing to remove.

Many retailers outside the US price their goods with VAT or GST included. For those retailers the goods price contains tax, and charging commission on it would inflate the commission. Violet removes the tax using the retailer's tax profile.

A tax profile records, for the retailer's home country:

  • whether its prices include tax, exclude tax, or are undeclared;

  • the standard rate to use when an order shows no tax of its own;

  • the date and time the profile takes effect.

Violet uses the profile rather than tax flags on individual orders. Those flags are not reliable across ecommerce platforms: the same retailer's orders can arrive flagged one way on one day and the other way the next.

What Violet does with each profile

Retailer's profile
What happens to the goods price
Example at 15% commission

Prices include tax, and the order reports its tax

The reported tax is removed.

Goods £120.00 with £20.00 VAT reported. Base £100.00, commission £15.00.

Prices include tax, and the order reports no tax

Tax is removed at the profile's rate: goods ÷ (1 + rate), rounded half-up to the minor unit.

Goods £120.00 at 20%. Base £100.00, commission £15.00.

Prices exclude tax

Nothing is removed.

Goods £100.00. Base £100.00, commission £15.00.

Undeclared, or no profile

Nothing is removed. Commission is on the goods price as submitted.

Goods £120.00. Base £120.00, commission £18.00.

An undeclared retailer is never stripped at a guessed rate. Until a retailer has a profile in force, nothing changes for it.

Rules that hold for every profile

  • Home country only. A profile applies to all of the retailer's orders, wherever they ship. A retailer that charges VAT-inclusive prices at home but sells tax-free for export cannot yet have a separate profile per destination. Tell Violet before such a retailer's profile is switched on.

  • Forward-dated, never backdated. A profile takes effect at a set date and time in the future. Orders placed before that keep the base they were placed under.

  • The profile in force when the order was placed applies, not the one in force when the bag is split or refunded.

  • One standard rate. A flat rate suits a catalogue where every item carries the standard rate, such as adult clothing. It is wrong for items taxed at a reduced or zero rate, such as children's clothing in the UK. If a tax-inclusive retailer sells such ranges, tell Violet so its profile can be adjusted.

Who manages tax profiles

Violet sets and changes tax profiles. Channels cannot read or change them through the API. To declare a retailer's basis, change a rate, or ask when a profile takes effect, contact Violet support with the retailer and the basis you want applied. Violet confirms the date it takes effect.

Duty

Duty is treated like tax: it is not part of what the retailer sold, so it stays out of the commission base. How far Violet can do that depends on where the duty sits on the order.

Where the duty is
Effect on commission

Reported as its own amount, through type: "DUTY" entries in each SKU's rates on Direct Order Submission or at checkout

Excluded, on the sale and on refunds. This is the only exact route. See Cross-Border Duties.

Built into the shipping charge

No effect. Shipping is outside the commission base. Violet cannot separate the duty from shipping unless it is reported on its own.

Built into the product price

Stays in the commission base. Violet does not currently support a duty rate per retailer.

If a retailer can report duty per order, have it do so. That keeps duty out of the base exactly.

For a retailer whose duty-inclusive prices also include VAT, the tax profile still removes VAT correctly, because import VAT is charged on the duty-inclusive value. What remains after the VAT comes out is goods plus duty.

Duty reported on an order is paid to the retailer with its payout.

Refunds Use the Same Base

The commission a refund reverses (under REVERSE) or keeps (under RETAIN) is worked out on the same basis the sale used, so the two always agree.

  • Tax-inclusive sale. A refund removes tax in the same proportion as the sale did. Returning £60.00 of goods from the £120.00 sale above gives a refund base of £50.00, and £7.50 of commission.

  • Duty on refunds. Duty the refund states is removed. If the refund does not state its duty, Violet works out the duty share of the refund from the order.

  • Never more than the sale. The commission on each refund is capped at what the sale charged. Under RETAIN it is also capped at what earlier refunds of the bag have left.

Worked Example

Tax-inclusive retailer on Net Receipts, with a discount

Retailer: prices include 20% VAT. Net Receipts settings deduct the fee before commission. Commission rate 15%.

Order: goods £130.00, discount £10.00, shipping £5.00, no tax reported on the order. Your app supplies a transaction fee of £3.00.

  1. Goods = £130.00 − £10.00 = £120.00

  2. Tax inside goods = £120.00 − (£120.00 ÷ 1.20) = £20.00, so the base is £100.00

  3. Fee deducted: £100.00 − £3.00 = £97.00

  4. Commission = £97.00 × 15% = £14.55

Shipping (£5.00) is outside the base and goes to the retailer.

Last updated

Was this helpful?