Contact rules tell Kolleno where NetSuite holds the contacts of a customer or an invoice. Each time Kolleno syncs with NetSuite, every enabled rule runs and updates the contacts in Kolleno.
To open the rules, go to the NetSuite settings page and click Contacts.
Only company admins and the Kolleno team can open the NetSuite settings page. It is turned off by default. Contact your Customer Success Manager or Kolleno Support to enable it for your account.
Turn on contact rules
When Use contact rules for this company is off, Kolleno pulls contacts with the settings that Kolleno Support set up.
When you turn it on, Kolleno copies your current contact settings into rules. Kolleno asks you to confirm and shows what will change. When you turn it on, Kolleno:
links your existing NetSuite contacts to the rules
merges copies of one invoice contact into one contact
leaves copies that a user edited, and lists them
This can take a few minutes for a large company. If Kolleno cannot turn on contact rules yet, the dialog lists the reasons. Contact Kolleno Support to move these settings.
The dialog lists the contacts that Kolleno will link, merge or leave for you to check. If there is nothing to change, it shows No existing contact changes, as in the example above.
If you turn contact rules off, Kolleno goes back to the settings that Kolleno Support set up. The rules do not run while this is off.
Hide contacts that disappear from NetSuite applies to customer rules only. Kolleno hides a contact that a rule no longer finds in NetSuite. A contact that is linked to an invoice stays.
Add a rule
The tab has two lists:
Customer contacts: rules that read the contacts of a customer, such as the billing contact.
Invoice contacts: rules that read the contacts of one invoice, such as the contact of a site.
Each rule shows when it last ran, where it reads the contacts, its positions and the number of contacts that it made.
In the correct list, click Add rule.
Type a Rule name.
Choose where the contacts are.
Add the contact fields and their positions.
Check the preview.
Click Save.
When you save, Kolleno applies the rule to your customers, or to the open invoices with a balance. You do not need a sync.
Where the contacts are
Under Where NetSuite holds them, choose a place. Most used marks the place that most companies use. Each place has an ⓘ hint with an example.
Place | Where Kolleno reads the contacts |
On the invoice | Fields on the invoice itself, for example a field with the billing email. |
On the invoice lines | Fields on the invoice lines. One invoice can give several contacts. Lines with the same contact give it once. |
On a record linked from the invoice | A field on the invoice points to another record, for example a project. Kolleno reads the contact fields on that record. |
On a record linked from the invoice lines | Each line points to another record, for example a site. A record that several lines share gives its contacts once. |
The customer's contact records | The contact records that NetSuite lists under the customer. Kolleno takes the name from each record and the email from the field that you pick. Only one rule can use this place. |
On the customer | Fields on the customer record, for example a field with the accounts payable email. |
On a record linked from the customer | A field on the customer points to another record, for example a custom record for the billing team. |
In NetSuite, the customer's contact records are the contacts in the Contacts list of the customer record:
Linked records
For a place with a linked record, fill in two more fields:
Link field: the field that points at the other record, such as a site. You can pick it from the list, or type or paste its field ID.
Linked record: the record that the link field points at. Kolleno fills it in when NetSuite names it. If NetSuite does not name it, pick the record or paste its ID, then click Test.
For example, each line of this invoice has a Customer Site. For the place On a record linked from the invoice lines, Customer Site is the link field:
The site record is the linked record. Its contact fields, such as Billing Contact, are the fields that the rule reads:
Contact fields and positions
Add one row for each field that holds a contact. Click Add field to add a row.
Field: the field that holds the contact. The list shows the fields of the place that you chose.
Holds: what the field holds: A NetSuite contact, One email address or A list of email addresses. Kolleno skips a contact that has no email address.
Contact name: the field that gives the name of the contact. Choose Same as the email to use the email address as the name.
Position: the role of the contact, such as Billing contact. Kolleno shows it next to the contact. Give each field its own position.
Primary contact: Kolleno marks all the contacts from this field as primary. A user can still change one contact, and a sync keeps that change.
Link to the invoice: for invoice rules. When this is off, Kolleno adds the contact to the customer but does not link it to the invoice.
Under Advanced, Split address lists gives one contact for each address in a list of email addresses. If it is off, Kolleno makes one contact for the whole list. For Extra columns, see Showing NetSuite contact details as columns in the contacts table.
Preview a rule
The Preview panel shows what the rule would add, update and link for one customer or invoice.
Click a customer or an invoice under the list of suggestions, or search for one.
Read the result.
The preview includes your unsaved changes. It does not save anything. The preview starts when the rule has no errors.
Turn off or delete a rule
To turn off a rule, open it and turn off Enabled. The contacts that the rule made stay in Kolleno, but they no longer update.
To delete a rule:
Open the rule.
Click Delete.
To also remove the contacts that the rule made, select Also delete these contacts. Kolleno removes them in the background. They disappear from contact lists and dunning.
Click Delete.
Contacts that you keep stay in Kolleno, but they no longer update.
If a rule shows Last pull failed
The rule row shows Last pull failed and the reason from NetSuite. Check the fields of the rule and the NetSuite connection. If the reason is not clear, contact your Customer Success Manager or Kolleno Support.














