The contract service has two additional methods to get and set the additional parties. These methods work on lists of AdditionalParty objects, which contains the following fields: 

Field Name

Type

Description

company

NovatusCompany

A complete NovatusCompany object

notes

String

Notes that are displayed as a description of the additional party

effectiveDate

XML Gregorian Calendar Date

The date that the additional party becomes effective

expirationDate

XML Gregorian Calendar Date

The date that the additional party expires

The additional parties for a contract can be obtained with getAdditionalParties(String contractId) where contractId is the ID of the contract, or set on a contract with setAdditionalParties(String contractId, List<AdditionalParty> parties). As with contracts, when updating or creating an additional party, only the id field of the NovatusCompany object is used; other fields will be ignored. So, to add AAA Software Company to a contract:

NovatusCompany aaa = getMyCompany();

String contractId = "2da3438b-81f1-4c95-8b4e-0171179d1606";

AdditionalParty newParty = new AdditionalParty();

newParty.setCompany(aaa);

service.setAdditionalParties(

   contractId,

   service.getAdditionalParties(contractId).add(newParty)

);