Partner
A partner is a company you have a business agreement with who is not a customer or a vendor. To use partner records the Partner Relationship Management feature must be enabled at Setup > Company > Enable Features > CRM. For more details, see Creating a Partner Record.
The partner record is defined in the listsRel (relationships) XSD.
Supported Operations
The following operations can be used with partner records:
add | addList | attach / detach | delete | deleteList | get | getDeleted | getList | getSavedSearch | getSelectValue | search | searchMoreWithId | update | updateList | upsert | upsertList
You can also use the asynchronous equivalents of SOAP web services list operations. For information about asynchronous operations, see SOAP Web Services Asynchronous Operations. For more information about request processing, see Synchronous Versus Asynchronous Request Processing.
Field Definitions
The SOAP Schema Browser includes definitions for all body fields, sublist fields, search filters, and search joins available to this record. For details, see the SOAP Schema Browser’s partner reference page.
For information about using the SOAP Schema Browser, see SOAP Schema Browser.
Usage Notes
Setting a Partner as an Individual or a Company
When creating a partner record, you can specify that partner as either an individual or a company by setting the isPerson field to TRUE or FALSE respectively. The available required and non-required fields vary depending on the setting of this field as detailed in the field definitions table.
Giving Partners NetSuite Access
You can update the PartnerContactRole sublist to provide Partner Center access to contacts. You can give this access to contacts attached to partners. This sublist is available for updates of Partner records only. Partners and contacts must already exist in NetSuite and contacts must already be attached to partners. You cannot use this sublist to attach new contacts. The workflow is as follows: 1) Add partner. 2) Add contacts. 3) Attach contacts to partner. 4) Update partner with contact access information from this sublist.
The fields in this sublist map to the fields on the Access subtab in the UI. These fields include:
-
A Boolean field that indicates whether a contact has access to NetSuite
-
A field that indicates whether new notification emails are sent when access changes are made
-
A field that indicates whether the password is manually assigned or changed
-
A contact name key field
-
The email address and password used to log in to NetSuite
-
The NetSuite role (Partner Center)
Operations on this sublist do not preserve row order. In some cases, rows added to the sublist will not be returned in the same order.
As of the 2011.2 endpoint, the PartnerContactList sublist is no longer supported. You can use the partnerContactRoleList instead. In addition, you can add or update contacts through the attach/detach operations, and you can retrieve contact names and roles for an entity through an advanced search on the entity record and its associated contacts. This advanced search technique is described in Returning a Contact List for a Customer.
Working with the Tax Registration Sublist
The tax registrations sublist is available when the SuiteTax feature is enabled at Setup > Company > Setup Tasks > Enable Features, on the Tax subtab.
Whenever you change the Tax Registration Number value on a sublist line, it triggers the regeneration of the value of a hidden ID field, and the values of ID fields are regenerated on all sublist lines. The ID field is hidden in the UI, but it is visible through SOAP web services. The ID field is searchable, so you can access the updated values through SOAP web services.
For information about working with tax registration in the UI, see Assigning Tax Registrations to an Entity in SuiteTax.