public

POST `/v1/public/pricing/tax-quote`

What these net prices look like to a signed-out visitor, after VAT.

Аутентификация

Этот эндпоинт является публичным. Он не требует учетных данных и организации — его читают наш собственный маркетинговый сайт и поисковые системы на базе ИИ.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X POST https://api.zinndigital.com/v1/public/pricing/tax-quote \
  -H "Content-Type: application/json" \
  -d '{ "items": <object[]> }'

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

The anonymous half of quoteTaxDisplay (#1482). Same answer, one difference that matters: there is no organisation, so there is no validated VAT number and every visitor is treated as a consumer. ⛔ This route accepts no buyer-validation flag, deliberately. Reverse charge turns on a VIES-validated number and the seller carries the liability for granting it wrongly (docs/34 §2.3), so a client-supplied validation claim would be a request to zero-rate a sale on the buyer's own say-so. Treating everyone as a consumer is also the safe direction: it over-states rather than under-states the tax due. Country comes from the request body or Cloudflare's CF-IPCountry. The answer is always estimated: true — a pricing page runs on a geo hint, and the charge is rated again at checkout against real place-of-supply evidence.

Тело запроса

Имя	Тип	Обязательно	Что это
`country`	`string`	Нет	ISO 3166-1 alpha-2 destination. On the signed-in route this overrides the stored billing country (the customer may be pricing an address they have not saved). Omitted on the…
`currency`	`string`	Нет	ISO 4217. Defaults to the `docs/29` §3.1 resolution for the request.
`items`	`object[]`	Да	—

Ответ

Имя	Тип	Обязательно	Что это
`currency`	`string`	Да	—
`country`	`string`	Да	The destination the figures were rated for, or `""` if none was known.
`display_mode`	`string<gross, net>`	Да	Which figure leads. `gross` for a consumer (with the VAT shown separately), `net` for a validated business and for any supply carrying no VAT. ⛔ Read it; do not re-derive it — the…
`notice`	`string<vat_included, reverse_charge, no_vat, vat_at_checkout>`	Да	A key, never rendered prose — every user-facing string goes through the frontend i18n layer in all 58 locales (§2.7, §2.19), so a wording change is a translation change rather…
`rate_bps`	`integer`	Да	The single rate behind `notice`, or `0` where the basket carries more than one. A mixed basket (hosting at the buyer's rate, a website build at UK 20%) genuinely has no single…
`estimated`	`boolean`	Да	The figures ran on weak evidence (a geo hint, no billing address) and are indicative. The charge is rated again at checkout against full place-of-supply evidence, and that is…
`indeterminate`	`boolean`	Да	The supply could not be rated and the net figure is being shown with `notice: vat_at_checkout`. Never true alongside a non-zero `tax_total_minor`.
`net_total_minor`	`integer`	Да	—
`tax_total_minor`	`integer`	Да	—
`gross_total_minor`	`integer`	Да	⛔ Equal to net in the `indeterminate` fallback, never 0 — a caller rendering this field unconditionally must show the price rather than a free product.
`lines`	`object[]`	Да	—

Ошибки, которые может возвращать этот эндпоинт

422 · 429

POST /v1/public/pricing/tax-quote