Generic versus object-specific functions

The XML API provides two types of functions:

The following table shows examples of both types of functions. Note the difference in how multiple objects are created.

Generic functions Object-specific functions
example of generic create function examples of explicit functions

By convention, uppercase letters are used for object elements when showing examples of generic functions, and lowercase letters are used for object elements when using object-specific functions.

Note: When implementing new APIs, Intacct provides generic functions. The object-specific functions are labeled as legacy in the API documentation, which simply means they will not be enhanced. There are no plans to deprecate legacy functions, and in fact, there are cases in which they are the only functions available.

Working with transaction lines and legacy functions

When using a combination of generic and object-specific functions in your work, be aware that there can be a difference in the way transaction lines are indexed.

For example, consider order entry transactions. For this object, the generic read function uses a zero-based index for entries returned in the response. However, the object-specific update function uses a one-based index for entries you supply in the request.

So, when you perform a read on SODCUMENT, the response identifies the first entry as LINE_NO 0.

        <DOCHDRID>Sales Order-SO-00029</DOCHDRID>
        <LINE_NO>0</LINE_NO>  <!-- First entry is zero -->
        <MEMO>First line</MEMO>

When using the object-specific update_sotransaction function to modify that first line, you need to add one to the line number from the read response.

<update_sotransaction key='Sales Order-SO-00029'>
            <updatesotransitem line_num='1'>  <!-- First entry is one -->
                <memo>First line: updated!</memo>

The same math must be performed when using read in combination with:

When working with other transactions, the read response typically returns entries using a one-based index.

Warning: Before doing any large scale update operations using object-specific functions, always perform a test to make sure you are modifying the correct lines.

Provide feedback