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