Unified Tax Calculation & Validation (Sandbox)

Simulate tax calculation and tax ID validation in a single unified request.

Use this endpoint in the Sandbox environment to simulate both tax rate calculation and tax ID validation in a single call. It is useful for validating your end-to-end integration during development for workflows such as checkout, invoice generation, or regulatory compliance.

---

Valid Tax ID Scenarios

The Sandbox supports specific Tax IDs for deterministic test cases. Use only the values listed below for expected behavior.

Show Valid Tax ID – Sandbox

Country	Tax ID	Simulated Outcome
DE	DE123456789	Valid, name matches
IN	29ABCDE1234F1Z5	Valid, name mismatch
US	123-45-6789	Invalid ID

---

Tax Rate Simulation

These combinations return predictable tax calculations in the Sandbox.

Show Valid Tax Rates – Sandbox

Country	Product Category	Customer Type	Outcome Description
DE	SAAS	B2B	Reverse charge applied
IN	PRSFT	B2C	Standard GST 18%
US	CSS	NGO	Tax-exempt scenario

Use these combinations to simulate edge cases such as exemption, reverse charge, and invalid IDs.

---

Request Parameters

Request Parameters

Product & Delivery

• product_id: (string, optional) – Internal product identifier.
• product_category: (string, optional) – Required if product_id is absent. Acceptable values include: CSS, DTSP, DAW, DAVW, DB, DP, IAAS, PAAS, SAAS, PRSFT, RNGT, DSWS, GMO, SSS, DTSS, INGMO
• is_security: (boolean, optional) – Indicates if product is classified as a financial/security item.
• delivery_method: (string, required) – One of: CLOUD, PHYSICAL, DOWN

Customer

• customer_id: (string, optional) – Internal customer identifier.
• customer_type: (string, optional) – Used if no customer_id is provided. One of: B2C, B2B, PRISCH, PRIEDUI, GOV, PUBSCH, PUBEDU, PRIHOS, PUBHOS, NGO

Location

• country: (string, required) – ISO country code.
• state, county, postal_code, ip_address: (optional) – Additional location context.

Tax ID Validation

• tax_id: (string, required) – The tax identifier to validate.
• customer_name: (string, optional) – Used for name matching with registry.

---

Response Fields

Response Fields

Tax Calculation

• taxability: (boolean) – Whether the product is taxable.
• country_rate, state_rate, county_rate, special_rate, additional_rate, total_rate: (integer) – Tax rates in basis points.
• reverse_charge_applicable: (boolean) – Reverse charge status.
• exempt: (boolean) – Whether tax is fully exempt.

Tax ID Validation

• tax_id_valid: (boolean) – Whether the ID is valid.
• customer_name_registry: (string) – Name returned by registry.
• customer_name_match: (boolean) – If provided name matches registry.
• customer_type: (string) – Inferred customer type.
• validated_country, validated_state: (string) – Jurisdictional confirmation.
• registry_address: (string) – Registry’s address (if available).
• validation_source: (string) – Validation source such as VIES, GSTN.
• validation_timestamp: (string) – ISO timestamp of the validation.
• request_id: (string) – Internal reference for debugging and audits.

---

Notes

All rate fields are returned in basis points. 18000 = 18%.

Only specific test combinations and IDs work in the Sandbox. Any other inputs may yield default or empty responses.

product_id takes precedence over product_category if both are present.

customer_id takes precedence over customer_type if both are present.

Reverse charge is computed automatically based on customer classification and location.

This unified endpoint is ideal for real-time compliance, especially in invoicing or payment workflows.

Authorizations

Authorization · string · header · required

Headers

Idempotency-Key · string

Body

application/json

product_id · string · required

customer_id · string · required

country · string · required

tax_id · string · required

product_category · enum<string>

Available options:

CSS,

DTSP,

DAW,

DAVW,

DB,

DP,

IAAS,

PAAS,

SAAS,

PRSFT,

RNGT,

DSWS,

GMO,

SSS,

DTSS,

INGMO

is_security · boolean

delivery_method · enum<string>

Available options:

CLOUD,

PHYSICAL,

DOWN

customer_type · enum<string>

Available options:

B2C,

B2B,

PRISCH,

PRIEDUI,

GOV,

PUBSCH,

PUBEDU,

PRIHOS,

PUBHOS,

NGO

state · string

county · string

postal_code · string

ip_address · string

customer_name · string

Response

200

application/json

taxability · boolean

country_rate · integer

state_rate · integer

county_rate · integer

additional_rate · integer

special_rate · integer

total_rate · integer

reverse_charge_applicable · boolean

exempt · boolean

tax_id_valid · boolean

customer_name_registry · string

customer_name_match · boolean

customer_type · string

validated_country · string

validated_state · string

registry_address · string

validation_source · string

validation_timestamp · string<date-time>

request_id · string