This release is scheduled to go live on the evening of May 18, 2018 Pacific Time.


Web Services enhancements

Introducing Web Services authorizations

With this release, company administrators can use Web Services authorizations to control who makes Web Services requests to a given company. Previously, anyone with a Web Services sender ID could send requests to any Sage Intacct company for which they had company login credentials. Now, sender IDs must be included in a company’s Web Services authorizations list first.

Web Services authorization list

Sage Intacct will perform a onetime update to automatically add sender IDs that made Web Services requests to a company within the last six months to the company’s Web Services authorizations list. Despite this, it’s possible that integrations or other Web Services activity might fail with the following error:

<response>
    <control>
        <status>success</status>
        <senderid>test_sender_id</senderid>
        <controlid>hello_world</controlid>
        <uniqueid>false</uniqueid>
        <dtdversion>3.0</dtdversion>
    </control>
    <operation>
        <authentication>
            <status>failure</status>
            <userid>test_user_id</userid>
            <companyid>test_company_id</companyid>
        </authentication>
        <errormessage>
            <error>
                <errorno>XL03000006</errorno>
                <description>Invalid Web Services Authorization</description>
                <description2>The sender ID &#039;test_sender_id&#039; is not authorized to make Web Services requests to company ID &#039;test_company_id&#039;.</description2>
                <correction>Contact the company administrator to grant Web Services authorization to this sender ID.</correction>
            </error>
        </errormessage>
    </operation>
</response>

If this happens, ask the company administrator to review the Web Services authorizations list on the Company Configuration Security tab, and add your sender ID if it’s not present. For more information, see Web Services authorizations in the Sage Intacct product help.

The ajax sender ID must be included in the authorizations list when the Platform Services AJAX gateway is used from page scripts.


User changes

Improved Web Services user management for company administrators

The purpose of a Web Services user has not changed—it still provides company login credentials that allow for Web Services access, but not UI access. However, with this release, company administrators can create a separate Web Services user in the Sage Intacct UI directly. They no longer need to create a standard user and check the Web Services only checkbox. The underlying functionality is the same.

Partners should consider updating any documentation they provide explaining how to create a Web Services user.

New warehouse user type - coming soon!

A new warehouse user type on the USERINFO object provides access to select features in the Order Entry, Purchasing, and Inventory Control applications.

For more, see the information about the USERTYPE parameter on these functions:


Advanced Audit Trail

You can now get information about personal data access in the system. With a subscription to Advanced Audit Trail, you can track access to all records that contain personal data stored in contact, vendor, and customer records. You can return information about who made changes to the data as well who simply read it, which can be important for regulatory purposes.

Information about read access covers using listers in the UI, accessing objects that reference other objects with personal data, viewing reports, using Smart Events, and making read, readByQuery, readMore, and readByName API calls. Returned elements have an ACCESSMODE of Personal data access, for example:

<advaudithistory>
    <OBJECTTYPE>customer</OBJECTTYPE>
    <OBJECTKEY>C-0018</OBJECTKEY>
    <USERID>jjr</USERID>
    <ACCESSTIME>05/07/2018 20:11:49</ACCESSTIME>
    <ACCESSMODE>Personal data access</ACCESSMODE>
    <WORKFLOWACTION>Create</WORKFLOWACTION>
    <IPADDRESS>xxx.xxx.xx.xx</IPADDRESS>
    <SOURCE>ui</SOURCE>
    <ID>sessionidxxx</ID>
</advaudithistory>

Information about write access corresponds with information that is returned by the existing audit trails functions, with the difference that all returned elements have an ACCESSMODE of System audit.

For more information:


Platform Services and Customization Services enhancements

Change in requirements for Smart Event API calls and Smart Event emails

In previous releases, you could create a Smart Event API in the UI without providing any content for the API body. You could also create a Smart Event email without supplying a subject for the email message. Both of these error cases are now prevented, and you will be prompted if you forget to supply this information when creating new Smart Events. If you edit an existing Smart Event that does not meet these requirements, you will need to correct the problem before saving your changes.

If your Customization Services package or Platform Services application has Smart Events that do not meet these requirements, it will not be installable. You can either fix the Smart Events or remove them, then republish the package or application.

Change in requirements for conditions

In previous releases, a condition for a Smart Rule, Smart Event, Smartlink Click, or Smartlink Fetch could include an expression that resulted in a divide-by-zero or a modulo-by-zero operation. For example, a condition that divided the value of one field by the value of a second field was allowed even though the value of the second field (INVOICE.QTY in our example) might be zero:

( {!INVOICE.PRICE!} / {!INVOICE.QTY!} ) > 5000

The current release provides better error checking and prevents any such conditions from being saved in the UI. You can easily correct the problem by providing logic to test for the error case. For example, the following ensures that INVOICE.QTY is not zero before performing the division:

{!INVOICE.QTY!} != 0 && ( {!INVOICE.PRICE!} / {!INVOICE.QTY!} ) > 500

If you edit an existing Smart Rule, Smart Event, Smartlink Click, or Smartlink Fetch with one of the problematic conditions, you will need to correct the problem before saving your changes.

If your Customization Services package or Platform Services application includes one of the conditions, it will not be installable. Also, if you notice incorrect behavior in your company that might be related to a Smart Rule, Smart Event, Smartlink Click, or Smartlink Fetch, it’s possible you are using an existing Customization Services package or Platform Services application that has not been updated to address the new requirements. In either case, the solution is to fix the condition or remove the Smart “item” altogether, then republish the package or application.

Improved error message in AJAX SDK for JavaScript

UI error messages thrown by the Platform Services AJAX SDK for JavaScript have been improved for clarity and completeness. Instead of printing only the first description line of an error, the second description and any correction is also printed.


Enhancements to Contracts

Modify the GL posting date for contract lines with unbilled accounting entries

You can now specify the dates that Unbilled AR and Unbilled deferred revenue will post for contract lines.

For more, see the information about the GLPOSINGDATE parameter on these functions:

New deliver function for contract lines

A new deliver function for contract lines lets you set the delivery status and date for contract lines as part of an event-driven revenue recognition flow.

For more information:

Support for bill in advance for renewals

The API now supports bill-in-advance for contract renewals.

For more information, see the RENEWALADVBILLBY and RENEWALADVBILLBYTYPE parameters on:


Simple tax rate at the line level for Purchasing and Order Entry transactions

Previously, Simple Tax automatically applied the same tax (amounts or percentages) across all the items in a transaction for Order Entry or Purchasing. With this release, you can apply different tax rates at the line level, which lets you reduce the number of transaction definitions and streamline transaction entry.

For more, see the information about the linelevelsimpletaxtype parameter on these functions:


Reallocate previously posted revenue recognition schedule entries in Order Entry

You can now reallocate the entire revenue recognition schedule, including entries that already posted. The new unpostall parameter on reallocate_revrecschedule unposts any previously posted entries and reallocates all entries in the given time period.

See the information about the unpostall parameter:


Deliver to contact for Purchasing transactions

You can now provide a Deliver to contact for purchasing transactions to help with tax calculations. You can configure at the header level, then override for the individual line items if need be.

For more, see the information about the deliverto parameter on these functions:


This release is scheduled to go live on the evening of February 9, 2018 Pacific Time.


Get information about user restrictions

A new, read-only object called USERRESTRICTION allows admins to access information about which users are restricted to given entities or departments.

For more information:


Smart Events and Smart Rules

In previous releases, the body length of Smart Event API actions was limited to 500 characters or less. This has been increased to 5000 characters.

In addition, new IN and NOTIN operators for Smart Event and Smart Rule conditions are available. For example, the following condition checks whether the currency for an AP Bill is specified in USD or INR:

IN({!APBILL.CURRENCY!},['USD','INR'])

For more, see the information about writing conditions in the Sage Intacct product help.


SDKs

Version 2 of the Sage Intacct SDK for .NET is now available. The SDK now targets .NET Standard 1.6 in order to support both .NET Framework and .NET Core. Make sure you check out the updated overview and guides that accompany this.


Contracts

Support for bill in advance

The API now supports bill-in-advance for contracts. You can set bill-in-advance options for specific customers, then optionally override those settings in your contracts. You can also set the options directly for each contract.

For more information, see the ADVBILLBY and ADVBILLBYTYPE parameters on:

Behavior change when posting multiple revenue and/or expense schedule entries

When posting multiple revenue or expense schedule entries, Sage Intacct will now skip any contract with scheduled entries that have errors, then post all other scheduled entries. Previously, when the system encountered an error during post, the process would terminate without posting any of the requested scheduled entries.

Force the Renewal of Contracts

You can now force the renewal of a contract that failed to renew at the scheduled time. For example, this can be useful if you uploaded multiple contracts as part of an integration and want to avoid manually renewing them in the Sage Intacct UI.

For more information:


On March 16, 2018, Sage Intacct will begin to disable support for older versions of the TLS protocol, which encrypts data that is communicated across networks. To enhance security and meet compliance requirements, we are requiring the use of TLS 1.2 and higher for all browser and Web Services (API) access to our cloud software.

Note: Previous communications stated that TLS 1.1 would be supported, but this is no longer correct.

How will users/developers be impacted?

Once Sage Intacct disables support for TLS 1.0 and 1.1, any browser or API access originating from a resource that does not support TLS 1.2 or higher will fail.

What do users/developers need to do?

Users

Ensure that your browser supports TLS 1.2 or higher (most modern browsers do). You can use the following third-party resource to test your browser’s compatibility:

Developers

Ensure your application is configured to negotiate connections using TLS 1.2 or higher. Depending on the programming language and OS, the requirements will vary. Some helpful information is provided below, but you should not rely solely on this information and must fully test your code.

Language Info
PHP Ensure your PHP version supports cURL version 7.34.0 or higher
Java Java 8: No action required
Java 7: Explicitly enable support for TLS 1.2 and higher
Java 6: Explicitly enable support for TLS 1.2 and higher
Java 5 or earlier versions: Upgrade to Java 6 or higher and explicitly enable support for TLS 1.2
.NET .NET 4.6: No action required
Earlier versions: Research required changes

Developers who want to test API clients can use the following resource:

API - How’s My SSL? https://www.howsmyssl.com/s/api.html

Support

The changes required to address the TLS 1.0/1.1 disablement may require help from your IT resources or other resources familiar with your environment. If you are unsure of what is required and would like Sage Intacct to provide additional advice or guidance, we are happy to help. Contact Sage Intacct Customer and Partner Support or your Account Manager. We can put you in touch with Sage Intacct Professional Services who can assist with performing the necessary changes on a fee based engagement


Updates for the 2017-R4 release are available.


1099 options for Purchasing

You can now provide 1099 form and box options for vendor invoices at the line level.

For more information:


Updates for the 2017-R4 release are available.


Creating contract invoices

You can now use the API to create invoices for any contracts with billable transactions. You can use filters to preview a set of potential invoices, then execute an invoice run based on that preview.

Depending on how many invoices you have, you can choose to create them online or offline.

For more information:


Ship to contact on sales transaction line items

To accurately calculate sales tax, you might need to use the tax rate associated with the address where the customer will take possession of the products or services. You can now provide different contact names at the sales transaction line level to override the ship to contact name on the transaction itself.

For more information, see the shipto parameter on:


API documentation for legacy functions

This release provides additional documentation for legacy functions—the majority of these functions are now documented.