Exemption Certificate Changes
What changed when exemption certificates moved to the Ziptax certificate store, and what to update in an existing integration.
Ziptax now stores new exemption certificates for both merchant types. If your
integration already calls /merchant/cert/* or requests exemptions on carts
and orders, review the changes below before switching over.
What’s new
- Self-managed merchants can use certificates. The four
certificate endpoints no longer return
403for self-managed merchants, and their cart calculations accept anexemptionobject. - One store for both merchant types. New certificates are kept in Ziptax for TaxCloud-connected merchants too. Nothing is written to TaxCloud.
- Connected carts and orders apply Ziptax certificates. When a Ziptax certificate covers a cart, Ziptax forwards it to TaxCloud as exempt. See Exempt a Sale.
- New certificate fields. Use
orderNumberwithsinglePurchase, set aneffectiveDateorexpirationDate, and add anidentificationNumberfor each state. - Certificate origin and status.
sourceidentifies where the certificate is stored.statusreports whether it is active, disabled, or expired. - Rate lookups can report certificates.
GET /request/v60acceptsmerchantIdandcustomerIdand returns anexemptionDetailblock.
Breaking changes
Certificates already in TaxCloud
Certificates created before this release stay in the merchant’s TaxCloud account. They are not copied into Ziptax.
- For a connected merchant with TaxCloud credentials on file,
cert/getandcert/listreturn them, after the merchant’s Ziptax certificates in a list.orderNumber,effectiveDate,expirationDate, and identification numbers arenullon them. - They are read-only through Ziptax until certificate sync with TaxCloud is
available.
cert/deletereturns409. - A cart that names one by
exemptionIdis forwarded to TaxCloud unchanged, so TaxCloud applies it as before. - A self-managed merchant, or a connected merchant without TaxCloud credentials, has no TaxCloud certificates to read.
Checklist
- Treat
certificateIdas an opaque string. Expect both UUIDs and TaxCloud ids for connected merchants. - Drop saved list cursors and any
sortBy: "id". - Handle
200with a body fromcert/delete, and409for TaxCloud certificates. - Parse the new error body.
- For self-managed merchants, stop stripping
exemptionfrom carts. See Self-Managed Cart Calculation.