Skip to main content

Recalculate Numeral Tax for Sales Order

POST 

/api/sales-orders/:salesOrder/numeral/recalculate

Prices the sales order with a live Numeral tax calculation again now, even when nothing on the order changed — for example after fixing a ship-to address an earlier calculation refused. Only for orders SKU.io computes tax for itself (manual and B2B portal orders, and orders from channels without their own tax) while live tax calculation (live_calculation_enabled) is on and the connection is healthy; otherwise 422. No request body.

Required scope: orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

On success the order's line and charge taxes are replaced with Numeral's and data is the order's calculation (same fields as meta.live_calculation.calculation on List Numeral Sync Records for Sales Order). When Numeral refuses the address (ZIP / state mismatch, malformed address, invalid country) the order keeps its own tax, data.status is fallback with error_type / error_message, and meta.status is address_error. Any other Numeral error leaves data.status failed and meta.status error. meta.status is calculated, address_error or error; meta.message explains a refusal or error and is null on success. The calculation is committed to Numeral as a tax transaction later — when the order closes (per-order invoicing) or per issued invoice.

Authentication: Requires a Bearer token with the orders:write scope. Requires the sales_orders.update permission.

Request​

Responses​

OK

Response Headers
    Content-Type