Release Notes
Important updates to the O Series REST APIs
For SaaS solutions, Vertex Release Notes communicate changes in behavior, enhancements, and features. In each release, Vertex also improves performance and quality and remediates security vulnerabilities. Release Notes are available on the Vertex Developer Network for all customers regardless of license. For specific information about a specific case, visit the Support section of Vertex Community or contact Customer Support.
O Series SR21 API Changes
New Tax Calculation API version
The Tax Calculation and Tax GIS RESTful API is updated to version 2.5.0.
Increased lookup range for coordinates
Lookups for Tax Area IDs using latitude and longitude coordinates are improved by increasing the date range of the lookups. The lookups now use data reaching back two years. O Series no longer returns Tax Area IDs that are not yet effective, avoiding associated calculation errors.
Jurisdiction ID added to override objects
To allow for more granularity when applying overrides to tax calculations, the Jurisdiction ID (jurisdictionId) field is added to override object arrays in the Tax Calculation and Tax GIS RESTful API. This change allows an override to be configured so it applies to a specific jurisdiction in O Series, while not applying to similar jurisdictions of the same Jurisdiction Level (jurisdictionType).
These override arrays now include the Jurisdiction ID (jurisdictionId) field:
- Citation Overrides (
citationOverrides) - Exemption Overrides (
exemptOverrides) - Imposition Types to Process (
impositionInclusions) - Nontaxable Overrides (
nonTaxableOverrides) - Rate Overrides (
rateOverrides) - Tax Deferred Percentage Overrides (
taxDeferredOverrides)
This change impacts calculation requests and responses for sellers, buyers, and owners.
New calculation fields to support Brazil calculations
New fields and response values are added to calculation requests and responses in the Tax Calculation and Tax GIS RESTful API to support tax calculation for Brazil. These changes impact tax calculation API requests and/or responses for sellers, buyers, and owners.
| Calculation API field | Calculation API field Description | Calculation API changes |
|---|---|---|
cfopTaxCode | The CFOP code returned by the Calculation Engine. Object - value- resultSource | Added to the taxes element for responses. |
cfopTaxCodeOverride | int32 0 to 9999Optional CFOP code at the line item level. When present, it overrides the Calculation Engine CFOP determination. | Added to the lineItems array for requests and responses. |
citation | string length between 1 and 512The citation value. This value references the legal document used to determine a tax rate. | Added for requests and responses: - To the transaction-level citationOverrides array- To the citationOverrides array in the lineItems array- To the taxes element for responses. |
citationOverrides | The array used to override the citation returned for an imposition during tax calculation. A citation references the legal document used to determine a tax rate. Array of objects [ - impositionType- jurisdictionType- citation- jurisdictionId] | Added as a transaction-level field and to the lineItems array for requests and responses. |
deferredTax | The deferred tax total returned for a transaction line. | Added to the taxes element for responses. |
informationOnly⚠️O Series On-Premise deployments must apply Monthly Data Update (MDU) 263 or later to configure the Information Only option for imposition types. | boolean Indicates whether the imposition type is information only. If true, the imposition type is not used to calculate tax totals, but is included to provide information about the transaction. | Added to theimpositionTypearray for requests and responses. |
resultSource | The source for the CFOP tax code value returned for a transaction line. | Added to the cfopTaxCode element for responses. |
taxDeferredFactor | double The factor that is used to calculate the deferred tax amount. The value is a decimal value that ranges from 0 to 1. For example, a value of 0.25 represents 25 percent. | Added for requests and responses: - To the taxDeferredOverrides array at the transaction level- To the taxDeferredOverrides array in the lineItems array |
taxDeferredOverrides | The array used to override deferred tax. Deferred tax is shown for informational purposes only and does not impact calculations. Array of objects [ - impositionType- jurisdictionType- taxDeferredFactor- jurisdictionId] | Added as a transaction-level field and to the lineItems array for requests and responses. |
taxDeferredPercentage | The percentage used to determine tax deferred totals that is returned by the Calculation Engine. | Added to the taxes element for responses. |
taxGovernRateReductionPercentage | The percentage value for the Govern Rate Reduction returned for a transaction line. | Added to the lineItems array for responses. |
totalDeferredTax | The total of deferred taxes returned for a calculation. | Added to responses. |
O Series SR20 API Changes
New Tax Calculation API version
The Tax Calculation and Tax GIS RESTful API is updated to version 2.4.0.
New message types and request for synchronization services
New message types and a new request are added to the Tax Calculation and Tax GIS RESTful API to initiate synchronization services for transactions. Synchronization services trigger financial events that modify your transactions in O Series so your financial host system and O Series show identical results.
Caution
Triggering synchronization services outside of the suggested time period can result in calculation errors or duplicate transactions:
- For On-Premise and On-Demand deployments, synchronization services must be triggered prior to initiating a Tax Journal Purge that includes impacted transactions.
- For Cloud deployments, synchronization services must be triggered within 90 days of tax calculation for impacted transactions.
This change impacts calculation requests and responses for sellers (Supplies) and buyers (Procurement).
| Message type or request | Endpoint | Purpose |
|---|---|---|
| ARBillingSync message type | /supplies | Modify existing Accounts Receivable transactions |
| APInvoiceSync message type | /procurement | Modify existing Accounts Payable transactions |
| APInvoiceSync message type | /procurement | Modify existing Accrual transactions |
| Rollback request | /transactions | Revert changes from previous synchronization events, restoring a transaction to its original state, prior to being modified |
New calculation fields to support 2026 Brazil tax reform
New fields and response values are added to calculation requests and responses in the Tax Calculation and Tax GIS RESTful API to support tax calculation for 2026 Brazil tax reform. These changes impact tax calculation API requests and/or responses for sellers, buyers, and owners.
| Field | Description | Changes |
|---|---|---|
additionalCommodityCode | object (CommodityCode)A standardized, unique code for the product or service. The commodityCodeType of this object must be different from the commodityCodeType of the CommodityCode object. | Added to thelineItemsarray for requests and responses |
buyerCondition | string [ 1 .. 40 ] charactersThe Buyer Condition is mandatory information for calculating taxes in Brazil. It represents the behavior of the entity that impacts tax calculation when buying goods or services. | Added for requests and responses: - As a transaction-level field - To the buyer object at the transaction level- To the buyer object in the lineItems array |
buyerCNAE | string [ 1 .. 40 ] charactersThe CNAE (National Classification of Economic Activities) five-digit numeric code that identifies optional information for calculating taxes in Brazil. This code: -Identifies what is being purchased by whom -Provides more granular information as compared to the Buyer Condition | Added for requests and responses: - As a transaction-level field - To the buyer object at the transaction level- To the buyer object in the lineItems array |
invoiceTextType | The text type of the invoice text applied to a transaction. | Added to the <InvoiceTexts> element in calculation responses for transactions with invoice text. |
InvoiceTotal | The sum of the Total Tax Included and Extended Price, which is the amount reported for the sale of services. This response value supports future functionality for tax calculation in Brazil. | Added to responses for the Quotation, Invoice, Purchase Order, and Invoice Verification message types. |
natureOfFiscalOperation | string [ 1 .. 40 ] charactersNatureOfFiscalOperation is mandatory information for calculating taxes in Brazil. A two-character alphabetical code that identifies the transaction type. | Added as a transaction-level field and to the lineItems array for requests and responses. |
sellerCondition | string [ 1 .. 40 ] charactersThe Seller Condition is mandatory information for calculating taxes in Brazil. It represents the behavior of the entity that impacts tax calculation when selling goods or services. | Added for requests and responses: - As a transaction-level field - To the seller object at the transaction level-To the seller object in the lineItems array |
sellerCNAE | string [ 1 .. 40 ] charactersThe CNAE (National Classification of Economic Activities) five-digit numeric code that identifies optional information for calculating taxes in Brazil. This code: -Identifies what is being sold by whom -Provides more granular information as compared to the Seller Condition | Added for requests and responses: - As a transaction-level field - To the seller object at the transaction level- To the seller object in the lineItems array |
taxCollectedFromParty | Identifies whether the buyer (BUYER) or the seller (SELLER) is responsible for tax collection. This response value supports future functionality for tax calculation in Brazil. | Added to the line-level Taxes element in responses for the Purchase Order message type. |
TaxRateReductionExempt | The amount of tax exempted by way of a Single Rate calculation tax rule with a rate reduction value. | Added to responses for calculations impacted by calculation tax rules with a Calculation Method set to Single Rate. |
TaxRateReductionPercentage | The rate reduction applied to a calculation via a Single Rate calculation tax rule. | Added to responses for calculations impacted by calculation tax rules with a Calculation Method set to Single Rate. |
TotalAcctPayAcctReceive | The Invoice Total less the Total Withheld, which is the amount paid to the supplier by the buyer. This response value supports future functionality for tax calculation in Brazil. | Added to responses for the Quotation, Invoice, Purchase Order, and Invoice Verification message types. |
TotalIncludedTax | The sum of all non-withholding (WHT) taxes, which is the amount the seller pays to the tax authorities. This response value supports future functionality for tax calculation in Brazil. | Added to responses for the Quotation, Invoice, Purchase Order, and Invoice Verification message types. |
TotalWHT | The sum of all withholding (WHT) taxes, which is the amount the buyer pays to the tax authorities. This response value supports future functionality for tax calculation in Brazil. | Added to responses for the Quotation, Invoice, Purchase Order, and Invoice Verification message types. |
Brazil Drivers added to Tax Configuration API
The O Series Tax Configuration API is updated with new Brazil Drivers. Requests and responses available via the /taxability-drivers endpoint are updated to support new taxability driver types for Brazil. These changes impact configuration requests and responses that:
- Create a Taxability Driver
- List Taxability Drivers
- Retrieve a Taxability Driver by ID
- Update a Taxability Driver
Correction - Audience for O Series Cloud authorization
Audience for O Series Cloud authorizationThe Audience parameter when authenticating O Series Cloud with the VERX IDP identity provider is verx://migration-api . This value is corrected for Authenticate O Series Cloud .
O Series SR19 API Changes
New field in the Calculation REST API
The Franchise Area Id (franchiseAreaId) field is added to Calculation API Requests and Responses in the Tax Calculation and Tax GIS RESTful API.
This change impacts calculation requests and responses for sellers, buyers, and owners. The new field is added at both the invoice level and the line level.
Updated 7 days ago