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 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 type of tax behavior of the entity 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. ⚠️We are sharing this new response value with you so you can prepare for upcoming enhancements to tax calculation responses for Brazil. We will be making more enhancements to Brazil functionality in future releases. | 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 type of tax behavior of the entity 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.⚠️We are sharing this new response value with you so you can prepare for upcoming enhancements to tax calculation responses for Brazil. We will be making more enhancements to Brazil functionality in future releases. | 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. ⚠️We are sharing this new response value with you so you can prepare for upcoming enhancements to tax calculation responses for Brazil. We will be making more enhancements to Brazil functionality in future releases. | 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. ⚠️We are sharing this new response value with you so you can prepare for upcoming enhancements to tax calculation responses for Brazil. We will be making more enhancements to Brazil functionality in future releases. | 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. ⚠️We are sharing this new response value with you so you can prepare for upcoming enhancements to tax calculation responses for Brazil. We will be making more enhancements to Brazil functionality in future releases. | 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 13 days ago