Contact tax details hold the tax-related information for a single contact, keyed by the contact's ID. Their main purpose is to associate a contact with a tax exempt group, so that the contact receives the group's tax exemption automatically at checkout.
Each contact's tax details map the contact to at most one tax exempt group.
During tax calculation, the buyer's contact ID resolves their tax details, and if
taxExemptGroupId is set, the matching exemption is applied and reported as an
exempt amount in the tax breakdown.
Contacts are typically added to a group by a site owner in the dashboard, or by a VAT-validation app, such as Exemptify, that verifies a customer's VAT ID at checkout and then associates the contact with the relevant exempt group. Once associated, later checkouts by the same contact are exempt without re-entering the VAT ID.
The contact's details, such as name, email, and VAT ID.
Returned only when CONTACT_DETAILS is passed to the fields array in the request.
Date and time the contact tax details were created.
Custom field data for the contact tax details.
Extended fields must be configured in the app dashboard before they can be accessed with API calls.
Contact ID. Also serves as the ID of the contact tax details, since each contact has a single set of tax details.
Revision number, which increments by 1 each time the contact tax details are updated.
Tags associated with the contact tax details.
ID of the tax exempt group the contact is associated with. Setting this value makes the contact eligible for the group's tax exemption at checkout.
Date and time the contact tax details were updated.