Skip to content
Console
Menu

Generated Assets

Workflows

Getting Started

Authentication

KV Store

On this page

Tax threshold statuses

A Tax Threshold Status is where the environment's consumer (B2C) paid sales stand against one jurisdiction's registration threshold for…

A Tax Threshold Status is where the environment's consumer (B2C) paid sales stand against one jurisdiction's registration threshold for digital services. It is computed on read from the sales Money recorded and the threshold table; nothing about it is written by a caller.

Service Sylphx Money · Resource type money.sylphx.com/TaxThresholdStatus · Name pattern orgs/{org}/projects/{project}/envs/{env}/tax_threshold_statuses/{tax_threshold_status} · Shape record

#Fields

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/tax_threshold_statuses/{threshold}, the threshold's id (au-gst, us-tx).
uidstringThe threshold's id, as in name. Output only.
metaResourceMetaResource metadata; not set for a computed view.
region_codestringThe jurisdiction's country, upper-case ISO 3166-1 alpha-2. Output only.
subdivision_codestringThe jurisdiction's subdivision (a US state, TX); empty for a country. Output only.
tax_namestringThe tax the threshold registers for, for example GST. Output only.
currency_codestringThe threshold's currency, upper-case ISO 4217. Output only.
threshold_amountstringThe amount that triggers registration, integer minor units of currency_code; "0" when the threshold is a transaction count only. Output only.
threshold_transaction_countint64The transaction count that triggers registration; 0 when none. Output only.
window_kindstringrolling_12_months, calendar_year, or prior_or_current_calendar_year. Output only.
window_start_timetimestampThe start (inclusive) of the window the figures below cover. Output only.
window_end_timetimestampThe end of the window (the moment of the read for a rolling window). Output only.
sales_amountstringThe consumer paid sales in the window, net of tax, in currency_code minor units. Business sales (a tax id was given) are excluded. Output only.
sales_transaction_countint64The number of those sales. Output only.
percentint32How close the sales are to the threshold, in whole percent (the higher of the amount and the count); it can exceed 100. Output only.
alerted_percentint32The highest alert level (70, 90, 100) already sent for this window; 0 if none. Output only.
unconverted_currency_codesstring[]Currencies of sales that could not be converted into currency_code (no rate in the rate table) and so are not counted in sales_amount. Output only.
source_urlstringThe authority page the threshold comes from. Output only.
effective_timetimestampWhen the threshold row took effect. Output only.

#Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETlistLists where the environment's consumer sales stand against each jurisdiction's digital-services tax registration threshold, per its own window. EU and UK have no threshold and are not tracked.

#list

Lists where the environment's consumer sales stand against each jurisdiction's digital-services tax registration threshold, per its own window. EU and UK have no threshold and are not tracked.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/tax_threshold_statuses · scope billing:read · effect read · paginated · Request, response and examples