Commerce

`setTaxRate`

Set Tax Rate

Set the sales-tax rate a shop charges, either for the ONLINE SHOP (omit location) or for ONE pickup location (name it in location, which overrides the shop for orders fulfilled there).

write

Arguments

locationstringoptionalWHICH pickup location this applies to: its name (e.g. "Beverly") or its id, as returned by getTaxSettings. Omit to target the ONLINE SHOP's own rate, which every location without its own rate follows.
rateBpsintegerrequiredThe rate in basis points: 100 = 1%, so 625 is 6.25%. Max 10000 (100%). Must be above zero. Use setNoTax to say nothing is charged.
spacestringoptionalSpace id or slug (see listPageSpaces) for a Space-owned shop. Omit for your personal shop.

Returns

The registry does not declare a return shape.

Declared limits

rateBps: minimum 1
rateBps: maximum 10000

Ask for it

The Cloud routes these requests to this verb.

set my sales tax to 6.25%
charge 7% tax at the Salem counter
change the tax rate for Beverly
my online shop charges 8.25% tax

Pair it with

The verbs that finish the job.