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.
orders:writeGrant 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
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.