billing
POST /v1/pricing/tax-quote
What these net prices look like to this customer, after VAT.
ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ
ផ្ញើគ្រាប់ចុច API ជាតូកែន bearer ។ ចំណុចបញ្ចប់នេះមិនបញ្ជាក់ពីសិទ្ធិជាក់លាក់ណាមួយនៅក្នុងការបញ្ជាក់នោះទេ ដូច្នេះសូមផ្ដល់សិទ្ធិអប្បបរមាដែលគ្រាប់ចុចរបស់អ្នកត្រូវការ ហើយពិនិត្យមើលការឆ្លើយតបជំនួសឱ្យការសន្មត់។
ចំនុចបញ្ចប់នេះមិនត្រូវការលេខសម្គាល់ស្ថាប័នទេ។ ពស័្ដកូនរបស់អ្នករួចហើយកំណត់អត្តសញ្ញាណស្ថាប័នដែលវាជាកម្មសិទ្ធិ ហើយការឆ្លើយតបគឺត្រូវបានកំណត់វិសាលភាពទៅតាមនោះ។
សាកល្បង
ជំនួសអ្វីមួយនៅក្នុងសញ្ញាពងក្រពើ < > ដោយប្រើតម្លៃផ្ទាល់ខ្លួនរបស់អ្នក ហើយជំនួសកន្លែងរក្សាទុកសោដោយប្រើសោចេញពីផ្ទាំងគ្រប់គ្រងរបស់អ្នក។
curl -X POST https://api.zinndigital.com/v1/pricing/tax-quote \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "items": <object[]> }'បានចូលគណនីរួចហើយមែនទេ? កុងសូល API ក្នុងផ្ទាំងគ្រប់គ្រងរបស់អ្នក បំពេញលេខសម្គាល់ស្ថាប័នពិតប្រាកដរបស់អ្នក និងសោផ្ទាល់ខ្លួនរបស់អ្នក ហើយដំណើរការសំណើទល់នឹង API ផ្ទាល់ ដូច្នេះអ្នកអាចមើលឃើញការឆ្លើយតបពិតប្រាកដ។ បើកចំណុចបញ្ចប់នេះក្នុងកុងសូល API
ព័ត៌មានលម្អិត
⚖️ Net-constant pricing (owner ruling 2026-08-04, docs/34 §2.1a ruling 3, #1482). The advertised figure is net and VAT is added on top at the destination rate, so our revenue per sale is identical everywhere: a €10 plan nets €10 whether the buyer is in Germany or Hungary, and their total differs (€11.90, €12.70) because their own rate does. A consumer is shown the VAT-inclusive figure; a business with a VIES-validated VAT number is shown net. display_mode says which — read it, never derive it. The discriminator is validation state, not "has typed a VAT number": an unvalidated number is charged VAT (§2.3), so treating it as a business would understate what the customer pays. ⛔ This endpoint rates; it never prices. The caller passes amounts it already holds from the catalogue, so this cannot become a second source of prices that drifts from the first. ⭐ Both figures always come back, whichever one leads, so a frontend picks a field rather than multiplying by a rate. A rate applied in TypeScript is a float applied to money (§2.8) and a second implementation of the tax rules — one rounding rule away from the invoice, for ever. ⛔ indeterminate: true means the supply could not be rated (usually a member state with no TaxRate row) and the net figure is being returned with notice: vat_at_checkout. It is not an error to surface: the charge path refuses in that situation, correctly, but a pricing page that refused would go blank for a whole country. In the fallback gross_total_minor equals net and is never 0, so a caller rendering the gross field unconditionally shows the price rather than a free product.
សំណើរបស់រាងកាយ
| ឈ្មោះ | ប្រភេទ | តម្រូវការ | តើវាជាអ្វី |
|---|---|---|---|
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[] | បាទ/ចាស | — |
កំហុសដែលចំណុចបញ្ចប់នេះអាចបង្វិលត្រឡប់មកវិញ
401 · 422