vsmsconnect — API — unmapped-tax-types

← all endpoints

GET/api/v1/businesses/:businessId/accounting/unmapped-tax-types auth: jwt (administrator | view_invoices | submit_invoices)

List provider tax codes that have arrived on invoices without a confirmed mapping. Populated fire-and-forget by sync services and webhook workers on every invoice ingestion pass. Each row includes providerTaxName and providerRate (nullable). Rows that now have an active TaxRateMappings entry are excluded server-side via NOT EXISTS join — confirming a mapping silently removes the entry; deactivating a mapping makes it reappear. Used by the home-screen banner and the Integrations nav badge to notify admins.

handlers: UnmappedTaxTypesController.list

Inputs

namerequireddefaultdescription
businessId path
uuid		yes—Target business UUID.

Outputs

200
APIResponseDataList<UnmappedTaxTypeDTO>
Provider tax codes awaiting admin mapping. Each row: { id, provider, providerTaxType, providerTaxName, providerRate, firstSeenAt, lastSeenAt }.