2024 Release 3 2024-07-15

This release is scheduled to go live on August 9, 2024.

Accounts Receivable

New AR invoice fields identify original transaction documents

Sage Intacct applications provide customizable workflows that enables users to set up various transaction definitions according to their business needs. When creating a workflow, users can configure multiple potential entry and exit points. This flexibility can make it cumbersome to identify:

To improve visibility into document conversions, the 2024 R3 release includes several new fields that are returned in read request results for the AR invoice (ARINVOICE) object. These new fields are returned for invoice objects that reference a transaction in Order Entry. The new fields include:

Apply custom discounts to received payments

Starting with the 2024 R3 release, users can apply custom discounts to an invoice when receiving a payment. Custom discounts streamline the process of applying a discount because, unlike existing term discounts, they don’t require that you first create an AR term that includes the discount details. The flexibility of custom discounts allows you to dynamically adjust a discount when you receive payment.

To activate custom discounts, go to the Accounts Receivable settings and select the option named Enable custom discounts. When this Accounts Receivable setting is enabled, you can use the new TRX_TOTALDISCOUNTTOAPPLY parameter to apply a custom discount in the payment details when creating a new payment or updating a draft payment.

Note the following restrictions for custom discounts:

Because custom discounts and term discounts cannot be combined, do not include a DISCOUNTDATE in AR payment details when using the TRX_TOTALDISCOUNTTOAPPLY parameter. If you provide a value for both DISCOUNTDATE and TRX_TOTALDISCOUNTTOAPPLY in the payment details, the request to create the payment fails.

For more information, see Create AR Payment and Update AR Payment.

Change in behavior for term discounts

In addition to the introduction of custom discounts, term discount behavior has also been changed. Now if you provide two or more discount dates for separate invoice lines in the payment details of a payment request, the payment request will fail. In the past when multiple discount dates were provided in the payment details, the first discount date supplied in the request was used and any additional dates were ignored. Starting with this release, that behavior has been changed so that only one discount date is expected and any additional dates provided cause the payment request to fail with an error.

Accounts Payable

New AP bill fields identify original transaction documents

Sage Intacct applications provide customizable workflows that enable users to set up various transaction definitions according to their business needs. When creating a workflow, users can configure multiple potential entry and exit points. This flexibility can make it cumbersome to identify:

To improve visibility into document conversions, the 2024 R3 release includes several new fields that are returned in read request results for the AP bill (APBILL) object. These new fields are returned for bill objects that reference a transaction in Purchasing. The new fields include:

AP adjustment line item fields no longer supported

When creating or updating an AP adjustment using the legacy create_apadjustment or update_apadjustment function, note that two lineitem fields are no longer supported:

If you include these fields in the line items of a create_apadjustment or update_apadjustment request, the provided values are ignored.

Credit-only payments

Starting with the 2024 R3 release, you can create a credit-only payment by omitting the financial entity when you issue a request to create a payment. For more information, see Create AP Payment.

To unapply credit-only payments, use the legacy reverse_appayment function. When reversing a credit-only payment, supply the record number of the credit-only payment and the date that the payment should be reversed. For more information, see Reverse AP Payment (Legacy).

New status field for payment provider method

When you read a payment provider method object, PROVIDERPAYMENTMETHOD, a new status field is returned to indicate whether the method is active or inactive. To learn more about reading this object, see Get Payment Provider Payment Method.

Purchasing

New transaction detail fields identify original transaction documents

Sage Intacct applications provide customizable workflows that enable users to set up various transaction definitions according to their business needs. When creating a workflow, users can configure multiple potential entry and exit points. This flexibility can make it cumbersome to identify:

To improve visibility into document conversions, the 2024 R3 release includes several new fields that are returned in read request results for the Purchasing transaction (PODOCUMENT) and Order Entry transaction (SODOCUMENT) objects. The new fields include:

Upcoming revision to draft transaction definition validation

In an upcoming release, changes will be implemented so that validations on draft transaction definitions occur when a transaction posts rather than when a transaction is created. These changes will allow users to create draft transaction definitions that contain minimal information to act as placeholders for accounting transactions. Performing transaction validation when a transaction posts rather than when it is created will improve workflow automation by allowing users to match draft placeholder transactions to incoming purchasing documents.

All transaction definitions, Order Entry, Purchasing, and Inventory Control, will be updated to support creation of draft documents without validation. More details about these planned changes will be provided in future release notes.

Construction

New joint checks and joint payees

In construction and some other fields, companies hire subcontractors to work on part or all of their projects. In some cases, the subcontractor that is hired also hires their own subcontractors to complete the contracted work. In these cases, joint checks can be issued for a primary vendor (subcontractor) and their secondary vendor (the subcontractor’s subcontractor). This ensures that the secondary subcontractor is paid for their work and can help avoid unnecessary churn and possible liens against projects by unpaid secondary vendors.

A new Joint Payee object (APBILLJOINTPAYEE) lets you define joint payees and associate them with specific AP bills. When paying a bill that has associated joint payees, you can create separate payment detail objects for each payee as needed, such as for the primary vendor and each secondary vendor.

For more details, see the page on the new Joint Payee object.

Other objects that have been updated to support joint checks:

APPYMT

APPYMTDETAIL

APPAYMENTREQUEST

New user type for construction managers

You can now create, update, or query for a construction manager user type in the Users object’s USERTYPE field. The construction manager user type tracks Sage Construction Management (CM) and Intacct Construction usage without impacting the project manager user type.

NOTE: Available only with a subscription to Construction.

For more information, see:

Purchasing multi-document conversion

When creating a purchasing transaction you can now specify a source document to convert from at the line level instead of at the transaction level. You can specify different source documents and source document lines for each transaction line in the purchasing transaction, allowing you to convert from multiple documents in a single transaction.

Valid conversions must conform to these rules:

For more information, see the sourcedocid and sourcedoclineid fields at the bottom of the potransitem table on the Purchasing Transactions page.

Item is now optional when creating a project change order

The ITEMID field has been made optional when creating a project change order, and it can be deleted when updating a change order. It must point to an active, non-inventory item for billing.

For more information, see Project Change Orders.

Construction tax enhancements

These read-only tax-related fields have been added to order entry transaction line objects (SODOCUMENTENTRY) and purchasing transaction line objects (PODOCUMENTENTRY):

2024 Release 2 2024-04-15

This release went live on May 10, 2024.

Accounts Receivable

Receive draft payments

Starting with the 2024 R2 release, users with appropriate permissions can create, edit, and delete Accounts Receivable payments in a draft state using the XML API or the Sage Intacct user interface. Draft payment functionality provides more control, flexibility, and accuracy when managing payments, especially when working with bulk payments and imports. Draft payments save time and reduce errors because they allow you to make changes before finalizing payments rather than reversing those payments. When draft payments are finalized, you can submit those payments for processing.

To create a draft payment, you must have Accounts Receivable – Manage payments - Add permissions. To submit a draft payment for processing, you must have Accounts Receivable – Manage payments – Post permissions.

You can only update a payment that is in Draft state (D). If a payment has been submitted and is Complete (C), it cannot be updated. You can update a draft payment to change header information or revise payment details. For more information about updates and the details to include for each type of update, see Update AR Payment.

You can also delete payments that are in Draft state (D). To learn more, see Delete AR Payment.

Value of state field for existing AR payments

With the introduction of draft payments, as discussed in the preceding release note, the state field for existing completed payments will be changed from null (blank) to a value of C in the weeks following the 2024 R2 release.

Get invoices - allocations affect read results

When you issue requests to read invoices as described in Get Invoice, the responses to those requests will no longer include the DEPT or LOCATION fields for invoice items that involve allocations to distribute amounts to those dimensions. This is due to a change in how split General Ledger entries are handled for transaction allocations.

If the transaction that an invoice item represents does not involve allocations to department or location, there is no change in the fields returned for the read response. Additionally, if an allocation rule allocates to only one of these dimensions, then only that field is omitted from the read response. For example, if a rule allocates to location and project, the DEPT field is returned in the read response for an invoice, but the LOCATION field is not.

Taxes

Capture payment tax (France only)

A new field that captures payment tax for a transaction line item has been added to both Purchase Order and Order Entry legacy transactions. This new field applies only to French companies and entities. If you set the new paymenttaxcapture field to true when you create or update an Order Entry or Purchasing transaction, the VAT tax record for that transaction line item is generated when the transaction line is paid.

For more information, see:

Purchasing

Add notes and project information in vendor compliance records

You can now include a note in and associate a project with a compliance record. Store information related to purchase orders and subcontract primary documents, and access everything from the record. When available, the project is retrieved via PROJECTID from the primary document header.

NOTE: To enable the Vendor Compliance subscription, first enable Accounts Payable, Purchasing, and Construction. Vendor compliance is available only for Construction at this time.

We added four new fields for this feature, but only PROJECTID and NOTES have user-supplied values. The other two fields are read-only.

For more information, see:

Inventory

Default conversion type for items

Starting with the 2024 R2 release, non-inventory type items included in transaction workflows can be converted by price or quantity. To take advantage of this capability, the following configuration options must be enabled for Order Entry and Purchasing:

With the preceding configuration options enabled, you can use the new DEFAULT_CONVERSIONTYPE field to specify the conversion type for non-inventory items. Non-inventory items can be converted by price or by quantity. This new field is supported for 3.0 XML API create and update item functions. To learn more, see:

Customization Services

List Smart Event Log Records (Legacy) to be discontinued

We want to let you know about a change that’s coming later this year: The smarteventlog object and get_list will be discontinued. For R2, you can continue to use the object. Users will be able to obtain Smart Event audit information by using a report based on the Audit Trail and adding it to an application menu for easy access. Learn more here: Use an Audit History report.

Construction

Line-level tax schedule assignment

Customers who use Advanced Tax, Multi-tax with VAT, or custom VAT can now assign tax schedules to individual document entry lines in both Purchase Order documents and Order Entry documents.

Accounts Payable

Get bills - allocations affect read results

When you issue requests to read bills as described in Get Bill, the responses to those requests will not include the DEPT or LOCATION fields for bill items that involve allocations to distribute amounts to those dimensions. This is due to a change in how split General Ledger entries are handled for transaction allocations.

If the transaction that a bill item represents does not involve allocations to department or location, there is no change in the fields returned for the read response. Additionally, if an allocation rule allocates to only one of these dimensions, then only that field is omitted from the read response. For example, if a rule allocates to location and project, the DEPT field is returned in the read response for a bill, but the LOCATION field is not.

2024 Release 1 2024-01-20

This release went live on the evening of February 16, 2024.

Construction

Enable reverse conversions for non-inventory line items in Order Entry

Only those companies with Construction subscriptions have access to the options to enable reverse conversions. For more information about subscribing to Construction functionality, see Configure Construction.

Use new fields to enable reverse conversions for non-inventory line items in order entry transactions. When reverse conversions are enabled, you can reduce the net amount previously converted for a transaction line item. You can use reverse conversion amounts when creating a transaction (using <create_sotransaction>) or updating a transaction (using <update_sotransaction>) by setting the <reverseconversion> field to true for a transaction line item (<sodocumententry>).

When the <reverseconversion> field is set to true, downstream conversions for that transaction line item must include an amount using the opposite sign (positive or negative) of the upstream document. In addition, when set to true, the <reverseconversion> field requires that the conversion for that line item be the opposite of the upstream document. For example, let’s say that on an OE order, you:

You can convert the order again to add a negative 25 (-25) units for the original converted line of 50. This conversion corrects the original converted unit amount from 50 to 25 and creates the downstream invoice with a credit for that line to the customer.

In addition, when reverse conversions are enabled for Order Entry, several new read-only fields are calculated and returned in <SODOCUMENTENTRY> and <SODOCUMENT> query and list responses:

For more information, see:

Accounts Receivable

Starting with the 2024 R1 release, several changes have been made to the fields and information provided when you use the get_companyprefs function to list Accounts Receivable (AR) preferences.

All AR selectable preferences have a new property exposed that holds the record number. The following example shows the new value for the overpayment account preference:

    <companypref>
        <application>AR</application>
        <preference>OVERPAYMENTKEY</preference>
        <prefvalue>336</prefvalue>
    </companypref>

The preference value, <prefvalue>, for all General Ledger accounts previously included both the account number and account name. Now only the account number for General Ledger accounts is returned as shown in the following example:

    <companypref>
        <application>AR</application>
        <preference>RO_ACCOUNT</preference>
        <prefvalue>7502</prefvalue>
    </companypref>

The preference value, <prefvalue>, for all General Ledger journals previously included both the journal symbol and name. Now only the journal symbol is returned as shown in the following example:

    <companypref>
        <application>AR</application>
        <preference>RI_JOURNAL_A</preference>
        <prefvalue>BAJ</prefvalue>
    </companypref>

In previous releases, the Aging setup was returned with the name and a single set of preference values like so:

    <companypref>
        <application>AR</application>
        <preference>AGP01</preference>
        <prefvalue>0-30, 31-60</prefvalue>
    </companypref>

Now several objects are returned to represent the Aging setup, including the name, record number, module key, and more, as shown in the following example:

    <companypref>
        <application>AR</application>
        <preference>AGINGSETUP.RECORDNO</preference>
        <prefvalue>1</prefvalue>
    </companypref>
    <companypref>
        <application>AR</application>
        <preference>AGINGSETUP.MODULEKEY</preference>
        <prefvalue>0-30, 31-60</prefvalue>
    </companypref>

For more information about the get_companyprefs function, see List Subscription Preferences.

Purchasing

Option not to generate Lien waivers in Vendor Compliance Definitions

The Vendor Compliance feature continues to offer more flexibility. A lien waiver is a document between two parties that states payment is made for work performed or material supplied. You might not want lien waivers with negative amounts, though. Use the new Vendor Compliance Definition field, ALLOWNEGATIVELIENWAIVERS, to indicate your preference.

When using create or update, use true (default) to indicate that lien waivers can be generated with negative amounts, otherwise use false. This value only affects the generation of future lien waiver compliance records and applies when CATEGORY is set to ‘Lien waiver’. If CATEGORY is not set to ‘Lien waiver’ and a value is supplied, an error is returned.

Track Insurance and Miscellaneous compliance records by either Primary document or Vendor.

With this release, you can use a Primary document to track Insurance and Miscellaneous compliance records. Previously, you could only track Insurance and Miscellaneous compliance records by Vendor. The Vendor Compliance Definition’s TRACKBY field description has been updated to reflect this change.

NOTE: To enable the Vendor Compliance subscription, first enable Accounts Payable, Purchasing, and Construction. Vendor compliance is available only for Construction at this time.

For more information, see:

Project Contracts

Project Contract Billing enhancements

New fields have been added to the Accounts Receivable invoice object (ARINVOICE) for better integration with project contract billing:

Contracts

Renewal dates in contract object

A recent release added read-only fields for renewal dates to both the CONTRACT and CONTRACTDETAIL objects.

2023 Release 4 2023-10-14

This release went live on the evening of November 10, 2023.

Accounts Payable

Recall bills

Starting with the 2023 R4 release, submitted AP bills can be recalled using a new recallApBill function. This new function provides a more flexible approval workflow for bills. Now when a bill is submitted and not yet approved or declined, if changes are required due to an error or new information, you can recall the bill, make the necessary updates, and then re-submit the bill.

To successfully recall a bill:

When a bill is successfully recalled:

Note that there are no restrictions on the number of times a bill in Submitted state can be recalled. To learn more about the new recallApBill function, see Recall Bill.

Vendor approvals

Vendor approvals can now be managed using the XML API. Vendor approval adds controls to your vendor creation and update workflow, requiring approval before new and updated vendors can be used in Accounts Payable and Purchasing transactions.

When vendor approval is enabled, existing vendors are automatically approved. From that point on, new and edited vendors are submitted to the Approve Vendor queue after they are created or revised. Designated approvers review the vendor records and either approve or decline them.

The read-only STATE field in the VENDOR object shows the approval state of the vendor. Possible values are:

Several new functions have been added to the XML API to support vendor approvals, including: getVendorsToApprove, approveVendor, declineVendor, and getVendorApprovalHistory. After setting up vendor approval, you can use these new functions to manage approvals. For more information, see Vendor Approvals.

The new getVendorApprovalHistory function returns data about each approval for a specific vendor. That data includes information such as the date that the vendor was approved, whether the vendor is new or was updated, who created or updated the vendor, and who approved the vendor.

For more information about vendor approvals, see these topics in the Sage Intacct Help Center:

Error message generated when applied credits fail

In previous releases, credits used to pay bills were not applied when:

For example, if a credit existed with the LOCATIONID set to San Diego and you attempted to pay two outstanding bill items with that single credit, one with the LOCATIONID set to San Diego and the other with the LOCATIONID set to Atlanta, only the bill item with the San Diego location was paid. And, no error was generated to notify you that the other bill item was not paid.

Now in these scenarios, if location IDs do not match, an error message is generated to notify you that: Payments include one or more credits that are restricted to a different location.

Accounts Receivable

Sage Intacct to change value of state field for existing AR payments

To support an upcoming Accounts Receivable enhancement, Sage Intacct plans to update the STATE field for existing ARPYMT and legacy ARPAYMENT objects with record types of ro (applied AR overpayment) and rp (overpayment). In early 2024, Sage Intacct will change the STATE field for existing ARPYMT and legacy ARPAYMENT objects from a null value to a value of C. The new C value indicates that these existing AR payments are confirmed.

Company

Global transaction security setup

A new AFRSETUP object lets you configure Global Transaction Security, which can be set to prevent users from editing, deleting, or reclassifying transactions posted to the General Ledger. Companies with multiple entities can configure this security at the entity level.

For more information see:

Consolidation

Run consolidations in companies that are multi-tiered or have entities that are partially owned

Beginning with the 2023 R4 release, you can use new ownership structure objects and ownership structure entity objects. The new objects enable companies with multi-tiers or those that are partially owned entities (or both) to run consolidations that reflect the complexity of their companies.

Let’s say that you purchase or sell an entity during a specific period. You can edit your ownership structure to reflect this change. For example, you can include a new entity purchased in February of 2020 in its relevant ownership structure. Consolidations will then include the new entity as of February 2020.

After defining an ownership structure, you can run consolidations for the ownership structure per period. For each consolidation, you can specify a reporting period. Then, you can convert the base currencies used by different entities into a designated base currency for the consolidated data. To learn more about ownership structures, see Ownership Structure workflow.

For more information, see:

Contracts

Recognize sales revenue on contract line invoice

A new field in the contractdetail object allows you to control whether revenue recognition for a contract line is deferred or recognized when the line is posted. When the REV_REC_ON_INVOICE field is set to true, Intacct automatically assigns the “Recognize on revenue” revenue template to both revenue journals. This template indicates there’s no revenue schedule or requirement for the user to post revenue separately.

Later when the contract line is invoiced, Intacct automatically posts the revenue. The contract line’s journal balances will only display unbilled, billed, and paid values for sales revenue and Accounts Receivable.

General Ledger

Option to include period balance details in account balances

You can use the new showperiodbalancedetail option in get_accountbalancesbydimensions requests to obtain details as well as balances. Details in the response include bifurcation of credit, debit, adj-credit, and adj-debit values. The sum of the periodbalancedetail amounts will equal the periodbalance amount.

Inventory

Identify if a kit is enabled for a contract in Items

A kit item is associated with two or more kit component items. Kit component items are the individual products or services that could be sold alone or included in product bundles.

In 2023 R2, we added an enhancement. You can identify when kits are enabled for contracts using the CONTRACTENABLED field for Items. This field is only available for items with the ITEMTYPE field set to kit. When set to true, the item must adhere to restrictions for the kit.

In addition, the ITEMID field in Contract Lines now includes contract-enabled kit items.

For more information, see:

Miscellaneous

3rd row in addresses

All objects that contain mailing addresses now have an optional address3 field to contain a 3rd row of address information when needed. Affected objects are:

Purchasing

Purchasing and Order Entry transactions (Construction only)

New fields show taxable amounts after deduction of retainage

For Construction customers using a VAT or GST tax solution, two new read-only fields in the PODOCUMENTENTRY and SODOCUMENTENTRY objects show taxable amounts after deduction of any retainage held for a Construction contract. The new read-only fields are:

For more information about Construction contracts and retainage, see these topics in the Sage Intacct Help Center:

Lien waiver option is now available in Vendor Compliance

In the previous release, we introduced the Vendor Compliance feature, which allows you to define compliance requirements and types for your vendors. We enhanced the feature and added a lien waiver category to compliance definitions. This enhancement impacts the following objects.

NOTE: To enable the Vendor Compliance subscription, first enable Accounts Payable, Purchasing, and Construction. Vendor compliance is available only for Construction at this time.

Vendor Compliance Definitions

We added three new fields:

We made the following changes to the existing Vendor Compliance Definition fields:

The create and update functions include the new fields and new values for existing fields. The delete function is not affected by the Vendor Compliance Definition updates.

The read, readbyname, query, readbyquery, and lookup responses now include the new fields and new values for existing fields.

Vendor Compliance Types

We added two new fields:

The create, update, and delete functions are not affected by the Vendor Compliance Type updates.

The read, readbyname, query, readbyquery, and lookup responses now include the new fields.

Vendor Compliance Records

We added 38 new fields:

NOTE: Only FINALCOMPLIANCE and SENDTOCONTACTNAME have user-supplied values. The rest of the new fields are read-only.

COMPLIANCESENDTO:

COMPLIANCESENDTO.MAILADDRESS

We also made the following changes to existing Vendor Compliance Record fields:

The delete function is not affected by the Vendor Compliance Record updates.

The create function returns an error if fields applicable to lien waivers have values when CATEGORY is not Lien waiver.

The update function returns an error if fields applicable to lien waivers have values when CATEGORY is not Lien waiver. The call can optionally contain FINALCOMPLIANCE and SENDTOCONTACTNAME.

The read, readbyname, query, readbyquery, and lookup responses now include the new fields and new values for existing fields.

For more information, see:

2023 Release 3 2023-07-24

This release went live on the evening of August 18, 2023.

Purchasing

Define requirements for vendors to ensure compliance

The 2023 R3 release introduces a feature in which you can define vendor compliance requirements and validate that vendors have provided required documents. For example, you might require contractors to have adequate liability insurance or a specific license. In R3 you can define compliance requirements in the insurance and miscellaneous categories, specify whether to validate by document or expiration date, and optionally prevent bill payments to out-of-compliance vendors. You create compliance records to apply your requirements to specified vendors and track their compliance.

NOTE: To enable the Vendor Compliance subscription, first enable Accounts Payable, Purchasing, and Construction. Vendor compliance is available only for Construction at this time.

For more information, see:

Accounts Receivable

Single payments for multiple customers — Early Adopter

The 2023 R3 release introduces a new early adopter feature: the ability to receive payments for multiple customers in a single request. You can use this feature at times when you need to receive a single payment, but apply the payment to invoices that belong to different customers. For example, when an insurance company submits a single payment for multiple patients at a facility. To learn more about this feature, see Receive a payment for multiple customers. If you would like to consider being an early adopter of this capability, contact Customer Support.

After this feature is enabled and set up, you can create an ARPYMT to receive payments for multiple customers in a single request as follows:

For more information, see Create AR Payment.

When you read an ARPYMT as described in Get AR Payment and that AR payment includes payments for multiple customers:

Document sequencing

Starting with 2023 R3, you can establish the sequence number for your Accounts Receivable payment documents. To learn more about how to set up Document Sequencing, see Configure Accounts Receivable.

If Document Sequencing is enabled, when you read an ARPYMT as described in Get AR Payment, the RECORDID field in the payment details contains the document number based on the sequence you established. If Document Sequencing is not enabled, the RECORDID field in the payment details does not contain a value.

New field to designate an existing summary for AR advances

With the 2023 R3 release, you can now post an AR advance to an existing summary using the PRBATCH field or the new PRBATCHKEY field. See Create AR Advance and Update AR Advance for more information.

Accounts Payable

Vendor approvals

A new read-only STATE field in the VENDOR object shows the approval state of the vendor. Possible values are A (approved) and S (submitted). Vendors in submitted state cannot be paid until approved.