public

POST /v1/public/pricing/tax-quote

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

Gbogbo àwọn public endpoints

Gbogbo àwọn ìwé àṣẹ olùgbékalẹ̀ àgbékalẹ̀

Ìfàṣẹ́pọ̀

Ojú-wọ̀n yìí jẹ́ ti gbogbo ènìyàn. Kò gba àmì ìdánimọ̀ kankan tàbí àgbájọ kankan — ohun tí ojú-wọ̀n ìpolówó wa àti àwọn ẹ̀rọ ìdáhùn AI ǹkà kọ́ ni.

Ojú abánisọ̀rọ̀ yìí kò gba id ajọ kankan. Kọ́kọ́rọ́ rẹ ti mọ ajọ ti o jẹ ti e, a o si fèsì nipa rẹ̀.

Gbiyanju rẹ

Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.

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

Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API

Àwọn kúlẹ̀kúlẹ̀

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.

Akoonu ibeere naa

OrúkọIruTí a nílòKini o jẹ
countrystringBẹẹkọ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…
currencystringBẹẹkọISO 4217. Defaults to the docs/29 §3.1 resolution for the request.
itemsobject[]Bẹẹni

Idahun

OrúkọIruTí a nílòKini o jẹ
currencystringBẹẹni
countrystringBẹẹniThe destination the figures were rated for, or "" if none was known.
display_modestring<gross, net>BẹẹniWhich 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…
noticestring<vat_included, reverse_charge, no_vat, vat_at_checkout>BẹẹniA 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_bpsintegerBẹẹniThe 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…
estimatedbooleanBẹẹniThe 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…
indeterminatebooleanBẹẹniThe 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_minorintegerBẹẹni
tax_total_minorintegerBẹẹni
gross_total_minorintegerBẹẹni⛔ Equal to net in the indeterminate fallback, never 0 — a caller rendering this field unconditionally must show the price rather than a free product.
linesobject[]Bẹẹni

Awọn aṣiṣe ti ibudo ipari yii le da pada

422 · 429