This article provides information about custom merge codes. It is possible to create your own custom merge codes, however our Support team are happy to assist with this as it is quite technical.


Expressions are configured on the System Tab > Expressions.


Note: Users require certain permissions to create new custom merge codes.


Custom Merge Code Expressions are written in a third-party language (designed for templating and friendly writing of simple logic) called Twig. You can find full online syntax information for twig as a language at - https://twig.symfony.com/. The version currently installed is 1.5.x.

 

Twig utilises common objects, variables and components, but depending on the situation different objects will be available. 


This article provides an introduction to Twig syntax and how you can perform basic operations, provides information on which objects are available for the different expression types and gives a full definition list of the properties of all those objects as a glossary should you ever need to know how to access certain properties and use them. This list (which will be at the end of this article) is quite extensive and should be used to locate any information that you need in expressions.



Expression Syntax Examples


The text below gives some examples of syntax and how to perform basic operations inside of expressions. These pieces of syntax are common to any expression section of Equinox that utilises Twig expressions.


Twig Statement

A twig statement is held between these characters:

{% STATEMENT %}

 

Twig Echoing of Text

Text can be output from variables e.g. the example below outputs the name John


{% set name = “John” %}

{{ name }}


IF Statement

This is the general structure for “if”, “elseif” and “else” statements. Any text enclosed in {# #} tags are comments and will be ignored by the programme.

{% if 1 == 1 %}

    {# Do something #}

{% elseif 1 == 2 %}

    {# Do something else #}

{% else%}

    {# Do a different thing #}

{% endif %}


Empty Example

The code below will tell you whether a particular property is empty, in the same below if a matters priority date has a value or not.


{% if matter.priority.date is empty %}

    {# Do something #}

{% endif %}


Merge Code Expressions


Merge Code expressions allow the user to declare custom Merge Codes in a template-like fashion. The output a Merge Code expression should be in Text or HTML, which will then be converted into the appropriate format for use in the correspondence it will be placed into. Anything that is returned “outside” of the twig tags ({{ }}) will be included in the content of the Merge Code.


Below is an example of a Merge Code that will display: Hello world! 


This HTML can be pulled into the template using the merge code #CUSTOM_MERGE CODE#



The merge code expressions have access to the following properties when they are run (see property definitions at the end of the document for more information on how to use the properties).


Variable Name

Object Type (for looking up in defs)

Description

matter

Matter

The matter the correspondence is being generated from

contact

Person

The recipient of the letter

 


Merge Code Expression Examples


Contact fields from the address book

The contact (who a letter is written to or the recipient on a task) can be accessed via the “contact” variable which maps to the person object: {{ contact.lastName }}

 

Relational Case Contacts

It is possible to pull through the contact details for the parent or child matter using:

child.matter 

parent.matter

Accessing a parent matter gives you access to the matter model, so you can access all matter properties that way.

{{ matter.parentMatter.client.name }}

 

Child Matters

These contacts can be accessed by looking through the array

{% for childMatter in matter.childrenMatters %}

{% if (childMatter.country == "US") %}

        {{ childMatter.client.name }}

    {% endif %}

{% endfor %}

 

Case History Dates

Case history dates can be accessed through set variable:

{{ matter.priority.date }}

{{ matter.application.country }}

{{ matter.publication.code }}

{{ matter.natRegEntry.date }}

{{ matter.natRegPublication.country }}

{{ matter.grant.code }}

 

Dates Manipulation

Date functions can manipulate the date. The dateAdd function allow manipulation for addition and subtraction to dates:


{% if dateAdd(matter.application.date, '+', '6', 'WEEKS')|date(‘Y-m-d’) > matter.grant.date|date(‘Y-m-d’) %}

    {# Do something #}

{% endif %}

 {# 5 years after application date #}

{{ dateAdd(matter.application.date, '+', '60', 'MONTHS') }}


All History Dates

For further history dates and array of all history dates that can be cycled through:

{% for historyDate in matter.allHistoryDates %}

{% if (historyDate.hId == 11) %}

        {{ historyDate.date }}

    {% endif %}

{% endfor %}

 

Custom fields

Custom fields can be accessed via their unique ID:

Matter custom date: {{ matter.getCustomFieldById(1).value.format("Y-m-d") }}

Contact: {{ contact.getCustomFieldById(3).value }}

Location: {{ contact.location.getCustomFieldById(4).value }}

Organisation: {{ contact.location.organisation.getCustomFieldById(5).value }}

 

Task Due Dates

The dates of a task can be accessed through their respective variables: 

{{ task.dueDate }}

{{ task.originalDueDate }}

{{ task.doneDate }}

{{ task.setupDate }}


Object Definitions

The glossary below gives definitions of objects available. Please bear in mind that multiple objects can be used in one expression i.e. matter.client.orgCode. 

Variable Name

Data Type

Description

matter.id

Int

The ID of the matter internally in Equinox

matter.oldCode

String

The oldcode field

matter.country

String

The country code

matter.countryName

String

The full country name

matter.status

MatterStatus

Object detailing the status of this matter

matter.matterCode

String

The matter code

matter.shortTitle

String

The short title

matter.longTitle

String

The long title

matter.formalTitle

String

The formal title

matter.clientRef

String

The client reference

matter.parentage

String

The parent field value

matter.designatedCountries

String

The designated countries field value (comma separated country codes)

matter.application

HistoryDate

The application date/number information

matter.publication

HistoryDate

The publication date/number information

matter.natRegEntry

HistoryDate

The national regional entry date/number information

matter.natRegPublication

HistoryDate

The national regional publication date/number information

matter.grant

HistoryDate

The grant date/number information

matter.priority

HistoryDate

The priority date/number information

matter.applicants

ApplicantInventor[]

An array of applicants attached to this matter

matter.inventors

ApplicantInventor[]

An array of inventors attached to this matter

matter.licensees

ApplicantInventor[]

An array of licensees attached to this matter

matter.associates

MatterLocation

WithContact

Reference[]

An array of associates and the associated references attached to this matter

matter.otherSideClients

MatterLocation

WithContact

Reference[]

An array of other side clients and the associated references attached to this matter

matter.otherSideSolicitors

MatterLocation

WithContact

Reference[]

An array of other side solicitors and the associated references attached to this matter

matter.clientKeyContactId

Int

The internal ID of the client key contact in Equinox

matter.category

MatterCategory

A matter category object representing the category

matter.subCategory

MatterSubcategory

A matter subcategory object representing the subcategory

matter.imageId

Int

The internal ID of the main image associated with the matter in Equinox

matter.typeOfMark

String

The type of mark selected for a matter

matter.businessUnit

Int

The internal ID of the business unit 

matter.businessGroup

Int

The internal ID of the business group

matter.expiryDate

String

A date string representing the expiry date of the matter

matter.client

Organisation

An organisation object representing the client of the matter

matter.clientId

Int

The internal ID of the matter

matter.billingAddress

Location

A location object representing the billing address of the matter

matter.billingAddressId

Int

The internal ID representing the billing address of the matter

matter.user

User

A user object describing the primary matter user

matter.user2

User

A user object describing the secondary matter user

matter.user3

User

A user object describing the tertiary matter user

matter.user4

User

A user object describing the quaternary matter user

matter.family

Family

A family object describing the family associated with the matter

matter.familyId

Int

The internal ID representing the family associated with the matter

matter.office

Int

An internal ID in Equinox representing the associated office with the matter

matter.notes

String

Notes field

matter.internationalRegistrationId

Int

The internal ID representing international registrations associated with the matter

matter.classes

String

Classes field

matter.goods

String

Goods field

matter.openDate

String

Open date string

matter.designatedStates

String

The designated countries field value (comma separated country codes)

matter.parentMatterId

Int

The internal ID of the parent this matter (when the matter is in a family)

matter.typeId

Int

The internal ID of the category group that the matter is in

matter.correspondenceNotes

String

Correspondence notes set on the matter

matter.renewalClient

RenewalClient

A renewal client object describing the renewal client of the matter

matter.renewalClientId

Int

The internal ID of the renewal client for the matter

matter.renewalBillingAddress

RenewalBillingAddress

A renewal billing address object describing the billing address for the matter’s renewals

matter.renewalBillingAddressId

Int

The internal ID of the renewal billing address for the matter

matter.legalEntity

Int

The internal ID of the legal entity this matter is assigned to

matter.allHistoryDates

HistoryDate

Array of all history dates

matter.getCustomFieldById(FIELD_ID)

Custom Field

Object of the various custom filed properties

 

MatterStatus Object

Variable Name

Data Type

Description

matterstatus.id

Int

ID of status

matterstatus.name

String

Status name

 

HistoryDate Object

Variable Name

Data Type

Description

historydate.hId

Int

The internal ID of the history date

historydate.date

String

The date of a specific history date 

historydate.country

String

Country code relevant to the history date

historydate.code

String

The code corresponding to the history date

 

ApplicantInventor Object

Variable Name

Data Type

Description

applicantinventor.id

Int

The ID of the contact internally in Equinox

applicantinventor.oldId

Int

The previous ID of the contact internally in Equinox

applicantinventor.type

String

Type of contact i.e. Applicant

applicantinventor.name

String

Name of contact

applicantinventor.formalName

String

Formal name of contact

applicantinventor.formalNameTitle

String

Formal title of contact

applicantinventor.formalNameFirst

String

Formal first name of contact

applicantinventor.formalNameMiddle

String

Formal middle name of contact

applicantinventor.formalNameLast

String

Formal last name of contact

applicantinventor.addressName

String

Address name of contact

applicantinventor.salutation

String

Name used on letters addressed to that contact

applicantinventor.nationality

String

Nationality of contact

applicantinventor.secondaryNationality

String

Secondary nationality of contact

applicantinventor.domicile

String

Contact’s country of residence 

applicantinventor.address

String

Contact’s full address

applicantinventor.street1

String

Line 1 of address

applicantinventor.street2

String

Line 2 of address

applicantinventor.street3

String

Line 3 of address

applicantinventor.city

String

City of address

applicantinventor.country

String

Country of address

applicantinventor.postcode

String

Address postcode

applicantinventor.phone

String

Contact’s telephone number

applicantinventor.email

String

Contact’s email address

applicantinventor.cc

String 

Email address commonly cc’d when emailing contact

applicantinventor.dateOfBirth

Date

Contact’s date of birth

applicantinventor.notes

String

Notes listed for the contact

applicantinventor.entity

String

Size of contact (micro, small, large)

applicantinventor.active

Boolean

0 or 1 depending on whether the contact is active

applicantinventor.licensee

Boolean

0 or 1 depending on whether the contact is active

applicantinventor.active

 

 

 

MatterLocationWithContactReference Object

Variable Name

Data Type

Description

matterlocationcontactwithreference.id

Int

The internal ID of the contact in Equinox

matterlocationcontactwithreference.location

String

Location associated with Contact

matterlocationcontactwithreference.reference

String

Contact’s reference

matterlocationcontactwithreference.sequence

Int

A numeric score for ordering the contacts by preference

 

Organisation Object

Variable Name

Data Type

Description

organisation.id

Int

ID of organisation internally in Equinox

organisation.name

String

Name of organisation

organisation.orgCode

String

Code associated with organisation

organisation.categories

Categories[]

An array of this organisations categories 

organisation.type

OrganisationType

An object detailing the organisations type

organisation.secondaryType

OrganisationType

An object detailing the organisations (secondary) type

organisation.exportNumber

String

Organisation reference used when exporting to external accounts package

organisation.tags

String

Tags related to the organisation separated by comas

organisation.extraCareNotes

String

Extra Care Notes field

organisation.setupDateTime

String

Date the organisation was added to Equinox

organisation.setupByUser

String

User that added the organisation to Equinox 

organisation.nominator

Int

The Equinox internal ID for the nominator associated with the organisation

organisation.modifiedDateTime

String

Date the organisation’s details were last modified

organisation.modifiedByUser

String

User that last modified the organisation

organisation.hasGeneralPowerAttorney

Boolean

0 or 1 depending on whether the attorney has general power over the organisation

organisation.generalPowerAttorneyStartDate

String

Date general power of began

organisation.generalPowerAttorneyEndDate

String

Date general power will end

organisation.contactChecked

Boolean

0 or 1 depending on whether the contact has been checked

organisation.contactCheckedBy

Int

The internal ID in Equinox of the user that set the case to checked

organisation.contactCheckedDate

String

The date that the contact was set to checked

organisation.linkedMatterId

Int

ID of matter linked to organisation

organisation.notes

String

Notes set on the organisation

organisation.correspondenceNotes

String

Correspondence notes set on the organisation

organisation.organisationGroupId

Int

ID of the group the organisation belongs to

organisation.getCustomFieldById(FIELD_ID)

Custom field

Object of the various custom filed properties

 

Address Object

Variable Name

Data Type

Description

location.id

Int

ID of the location internally in Equinox

location.organisationId

Int

ID of the organisation associated with the location

location.categories

LocationCategory

An object of the location’s categories

location.type

String

Type of the location

location.name

String

Name of location

location.address

String

Full address 

location.street1

String

Line one of address

location.street2

String

Line two of address

location.street3

String

Line three of address

location.city

String

City of location

location.county

String

County of location

location.postCode

String

Post code of location

location.country

String

Location’s country

location.website

String

Website associated with location

location.phone

String

Location’s primary phone number

location.phone2

String

Location’s fax or secondary phone number

location.phone3

String

Location’s tertiary phone number

location.email

String

Location’s email address

location.email2

String

Location’s secondary email address

location.email3

String

Location’s tertiary email address

location.notes

String

Notes listed for the location

location.extraCareNotes

String

Extra care notes for the location

location.extraCareNotesColor

String

Colour categorisation for the location’s extra care notes

location.setupDateTime

String

Date location was added to Equinox

location.setupByUser

String

User that added location

location.modifiedDateTime

String

Date location details were last modified

location.modifiedByUser

String

User that last modified the location details 

location.active

Boolean

0 for inactive locations, 1 for active

location.VATNumber

String

Location’s VAT number

location.badPayer

Boolean

1 if location is marked as a bad payer, 0 is not

location.taxCode

String

The regional tax code this location is situated within

location.exportCode

String

A code representing the organisation for exporting to external accounts packages

location.oldId

String

The internal ID of the location in the previous system used

location.companyNumber

String

The official registered company number

location.bankAccount

String

The bank account number of the organisation at the location

location.matterToSaveInvoicesOn

Int

The internal ID in Equinox of a matter, to which all invoices should be assigned, for this location

location.accountsContactId

Int

The internal ID in Equinox of a contact that has been specified as the point of contact for accounts 

location.invoiceSettings

LocationInvoiceSettings

An object detailing the invoice settings

 

Contact (Person) Object

Variable Name

Data Type

Description

person.id

Int

The ID of the contact internally in Equinox

person.organisationId

Int

ID of the organisation associated with the person

person.locationId

Int

ID of the location associated with the person

person.title

String

Person’s title

person.firstName

String

Person’s first name

person.middleName

String

Person’s middle name

person.lastName

String

Person’s last name

person.addressNameTitle

String

Person’s title used on correspondence

person.addressNameFirst

String

Person’s first name used on correspondence

person.addressNameMiddle

String

Person’s middle name used on correspondence

person.addressNameSecond

String

Person’s second name used on correspondence

person.name

String

Person’s full name

person.addressName

String

Person’s full name used on correspondence

person.letterName

String

Person’s letter name 

person.CC

String

Email address to be CC’d when emailing this person

person.suffix

String

 

person.address

String

Primary full address linked to this person

person.address2

String

Secondary full address linked to this person

person.postCode

String

Post code of primary address

person.phone

String

Primary phone number for person

person.phone2

String

Person’s fax or secondary phone number

person.phone3

String

Person’s tertiary phone number

person.phone4

String

Person’s quaternary phone number

person.phone5

String

Person’s quinary phone number

person.phone6

String

Person’s senary phone number

person.email

String

Person’s primary email address

person.email2

String

Person’s secondary email address

person.jobTitle

String

Person’s job title

person.salutation

String

Person’s salutation

person.webPage

String

Web page associated with this person

person.birthday

String

Person’s birthday

person.setupDateTime

String

Date this person was added to Equinox

person.setupByUser

String

User that added this person to Equinox

person.modifiedDateTime

String

Date this person’s details were last updated

person.modifiedByUser

String

User that last updated this person’s details 

person.groupId

String

ID of the group this person is associated with

person.location

Location

An object detailing the location this person is attached to

person.oldId

Int

The internal ID of the person in the previous system used

person.language

String

The preferred language for correspondence with this person

person.gender

String

Person’s gender

person.xMasLetter

Boolean

0 or 1 depending on whether the person is set to receive a xmas letter

person.newsletter

Boolean

0 or 1 depending on whether the person is set to receive a news letter

person.mailingList

Boolean

0 or 1 depending on whether the person is included in the mailing list

person.notes

String

Notes added the this person’s record

person.active

Int

0 or 1 depending on whether the person 

 

User Object

Variable Name

Data Type

Description

user.id

Int

ID of the Equinox user

user.oldId

Int

The internal ID of the user in the previous system used

user.subscriberId

Int

The internal ID of the organisation the user is a part of in Equinox

user.username

String

User’s username

user.email

String

Primary email address for this user

user.secondaryEmail

String

Secondary email address for this user

user.firstName

String

User’s first name

user.secondName

String

User’s second name

user.subscriberRef

String

The text-based reference of the organisation that the user is a part of

user.loginCount

Int

The total amount of times the user has logged in

user.lastLogin

Int

A timestamp of the last time that the user logged in

user.notes

String

Notes added to this user’s record

user.gender

String

User’s gender

user.initials

String

The initials of user’s name

user.legalEntity

String

The legal entity within the organisation that the user is a part of

 

MatterCategory Object

Variable Name

Data Type

Description

mattercategory.id

Int

ID of category

mattercategory.definition

String

Definition of category

mattercategory.name

String

Name of category

 

MatterStatus Object

Variable Name

Data Type

Description

matterstatus.id

Int

ID of status 

matterstatus.name

String

Name of status 

 

MatterSubCategory Object

Variable Name

Data Type

Description

mattersubcategory.id

Int

ID of subcategory

mattersubcategory.name

String

Name of Subcategory

mattersubcategory.categoryType

String

Type of category the subcategory is associated with 

 

PresetTaskItem Object

Variable Name

Data Type

Description

presettaskitem.id

Int

ID of preset task item

presettaskitem.presetGroupId

Int

ID of this task item’s preset group

presettaskitem.baseDate

Sting

Base date of task item

presettaskitem.description

String

Description of task item

presettaskitem.offsetOperator

String

Operator of the offset of this task item

presettaskitem.offsetUnit

String

Units of the offset

presettaskitem.offsetAmount

String

Amount the task item is offset by

presettaskitem.importance

Int

Number value of the task’s importance

presettaskitem.user

String

Equinox user associated with the task item

presettaskitem.emailReminder

Boolean

0 or 1 depending on whether the email reminder is turned on

presettaskitem.endOfMonth

Boolean

Does task get pushed to end of month automatically

presettaskitem.taskType

Int

Number value of the type of task 

presettaskitem.documentId

Int

ID of the linked document template

presettaskitem.parentId

Int

ID of the parent task

presettaskitem.hasOverride

Boolean

0 or 1 depending on where the task item has an override

presettaskitem.generateForClient

Boolean

0 or 1 depending on whether the task item has been generated for the client

presettaskitem.customisableByClient

Boolean

0 or 1 depending on whether the task item is can be modified by the client

presettaskitem.overrideForClient

Boolean

0 or 1 depending on whether the client has an override

presettaskitem.markAsDoneWithParent

Boolean

0 or 1 depending on whether the task item should be marked as done when it’s parent is marked as done

presettaskitem.moveTaskOnUntillParentDueDate

Boolean

0 or 1 depending on whether the task item due date should be moved on to match the parent due date

presettaskitem.expressionId

Int

ID of the expression

presettaskitem.expressionAnswer

Boolean

Required value to generate the task

presettaskitem.disableManualClose

Boolean

0 or 1 depending on whether the task item should be allowed to be closed manually 

presettaskitem.components

ComponentInterface[]

Array of components associated with preset

presettaskitem.workingInstructions

String

Instructions related to the task item

 

LocationInvoiceSettings Object

Variable Name

Data Type

Description

locationinvoicesettings.locationId

Int

ID of the location

locationinvoicesettings.repeatFrequency

Int

How frequently invoices are autogenerated

locationinvoicesettings.repeatUnit

String

How regularly invoices are auto generated

locationinvoicesettings.startDate

String

Start date of invoice

locationinvoicesettings.dayOfWeek

String

Which day of the week the invoice is generated on

locationinvoicesettings.dayOfMonth

String

Which day of the month the invoice is generated on 

locationinvoicesettings.mode

Int

The type of invoice to be produced (combined or case by case)

locationinvoicesettings.templateId

String

ID of the templated used when generating invoice

locationinvoicesettings.currency

String

Currency set for the invoice

locationinvoicesettings.VATmode

String

VAT mode that is set

locationinvoicesettings.deliveryMethod

String

Delivery method set for the invoice generation

locationinvoicesettings.taskUser

String

User of tasks associated with invoices

locationinvoicesettings.language

String

Language of invoice

locationinvoicesettings.isUpFrontPayer

Boolean

0 or 1 depending on whether the client will pay the invoice upfront, or may use specified payment terms

locationinvoicesettings.billingContact

Int

The internal ID in Equinox of a contact that has been specified as the point of contact for billing

locationinvoicesettings.renewalBillingContact

Int

The internal ID in Equinox of a contact that has been specified as the point of contact for renewals billing

locationinvoicesettings.paymentTerm

String

Specific payment term details for the client on this invoice

locationinvoicesettings.notesForFinanceWizard

String

Notes to appear when creating an invoice through the wizard

locationinvoicesettings.badDebtor

Boolean

0 or 1 depending on whether the client has been logged as a bad payer

 

Custom Field Object

Variable Name

Data Type

Description

customField.id

Int

ID of the custom field

customField.name

String

Name of the custom field

customField.type

String

Type of data the custom field stores

customField.value

String

Value entered to this custom field

customField.entityType

String

Area of the system the custom field applies to (e.g. documents, charges)

customField.required

Boolean

0 or 1 depending on whether the field is required

customField.possibleValues

PossibleValues[]

An array of valid values that can be selected for this custom field 

 
Charge Object

Variable Name

Data Type

Description

charge.id

Int

ID of the custom field

charge.orgId

Int

ID of the organisation

charge.userId

Int

ID of the user

charge.matterUserId

Int

ID of the user related to a charge on a matter

charge.matterId

Int

ID of the matter the charge is related to

charge.time

Int

The total time recorded by a user when inputting a charge

charge.billDate

String

The date the invoice was billed if the charge was included on an invoice

charge.description

String

A text-based description of what the charge is for

charge.legalEntityId

Int

The ID of the legal entity the charge is associated with

charge.category

String

The main type of the charge; either Time, Fixed or Cost

charge.subCategory

Int

The ID of the sub type of the charge

charge.paymentReference

String

A payment reference that has been applied to a charge

charge.supportingDocId

Int

The ID of a document related to this charge

charge.notes

String

Notes providing extra details about a charge 

charge.status

String

The current state of a charge in it’s lifecycle

charge.amount

Int

The original charge amount before any adjustments have been made to it

charge.adjustment

Int

A figure to adjust the amount of a charge by

charge.discount

Int

The amount of a charge’s total that has been marked as a discount.

charge.discountPercentage

Int

Percentage discount, indicating the percentage of this charge that should be marked as a discount. Value should be between 0 and 100.

charge.chargeRate

Int

The hourly rate that time charges are worked out against

charge.currency

String

A text reference for the type of currency the charge has been created as

charge.currencyAmount

Int

The converted charge amount into the selected currency

charge.currencyRate

Int 

The conversion rate used to convert the charge amount to the selected currency

charge.currencyMarkup

Int

The amount of the mark up that has been applied to a converted charge

charge.currencyCharge

Int

The amount of the currency charge

charge.billed

Boolean

0 or 1 depending on whether the charge has been billed

charge.potentialForVAT

Boolean

0 or 1 depending on whether the charge 

charge.billGuideNumber

Int

The internal ID representing the invoice that a billed charge has been associated with

charge.invoiceNumber

Int

The user supplied invoice reference number associated with a billed charge

charge.adjustmentReason

String

A text-based explanation for why an adjustment was applied to a charge

charge.writeOffReason

String

A text-based explanation for why a charge was written off

charge.discountReason

String

A text-based explanation for why an discount was applied to a charge

charge.chargeSheetId

Int

The internal ID of the chargesheet item that this charge has been created from

charge.setupBy

Int

The internal ID of the user that created the charge

charge.setupDateTime

String

A time stamp of when the charge was initially created

charge.chargeSheetEntry

ChargeSheetItem[]

An object representing the chargesheet item related to the charge

charge.disableSaving

Boolean

True or False depending on whether saving has been disabled for the charge

charge.multiplier

Int

A multiplier that can be used to increase the value of a charge

charge.discountRuleAppliedId

Int

The internal ID of the discount rule applied to the charge

charge.discountRuleObject

DiscountRule[]

An object representing the discount rule that has been applied

charge.invoiceAmount

Int

The total amount of the invoice which the charge was included on when billed

charge.vatAmount

Int

The amount of VAT that is applicable on the charge

charge.vatCurrencyAmount

Int

The amount of VAT that is applicable on a charge converted to a different currency

charge.nonChargeable

Boolean

0 or 1 depending on whether the charge has been marked as non-chargeable or not

charge.isRenewalCharge

Boolean

0 or 1 depending on whether the charge is listed as a renewals charge

charge.associatedLocationStringCharge Associated associated Location
 
ChargeSheetItem

Variable Name

Data Type

Description

chargeSheetItem.id

Int

The internal ID of the chargesheet item

chargeSheetItem.subscriberId

Int

The internal ID of the Equinox subscriber

chargeSheetItem.group

String

A group name applied to the chargesheet item

chargeSheetItem.code

String

A reference number that applies to the chargesheet item

chargeSheetItem.sequence

Int

A number that can be used to place the chargesheet item higher or lower in relation to other charge sheet items

chargeSheetItem.description

String

A text-based description of the chargesheet item

chargeSheetItem.descriptionDutch

String

A text-based description of the chargesheet item in Dutch

chargeSheetItem.descriptionFrench

String

A text-based description of the chargesheet item in French

chargeSheetItem.nominator

Int

The internal ID of the nominator associated with this chargesheet item

chargeSheetItem.country

String

A text-based ISO reference that allows chargesheet items to be filtered against countries

chargeSheetItem.matterCategory

Int

The internal ID of a category in Equinox that this chargesheet item should relate to

chargeSheetItem.matterSubCategory

Int

The internal ID of a category in Equinox that this chargesheet item should relate to

chargeSheetItem.chargeCategory

String

The main type of the chargesheet item; either Time, Fixed or Cost

chargeSheetItem.chargeSubCategory

Int

The ID of the sub type of the chargesheet item

chargeSheetItem.currency

String

A text-based ISO reference for the currency 

chargeSheetItem.amount

Int

A default amount for the chargesheet item when it is added as a charge

chargeSheetItem.includeMarkup

Boolean

0 or 1 depending on whether the mark up should be included on the chargesheet item when it is added as a charge

chargeSheetItem.notes

String

A text-based note providing additional information about a chargesheet item

chargeSheetItem.isRenewal

Boolean

0 or 1 depending on whether the chargesheet item will be used for renewals

chargeSheetItem.year

Int

A year reference for chargesheet items to determine which renewal period it is for

chargeSheetItem.discountsDisabled

Boolean

0 or 1 depending whether discounts should be disabled for the chargesheet item

chargeSheetItem.autoWIPApproval

Boolean

0 or 1 depending whether the charge should be automatically approved for WIP

chargeSheetItem.fixedFeeChargeBehaviour

Boolean

0 or 1 depending whether the charge should have fixed fee behaviour 

chargeSheetItem.incomingLedgerCode

Int

A reference representing the incoming ledger code

chargeSheetItem.expression

String

An expression that has been set on the chargesheet item to enable custom functionality

chargeSheetItem.expressionData1

Int

Data required for the expression to work on the chargesheet item

chargeSheetItem.expressionData2

Int

Data required for the expression to work on the chargesheet item

chargeSheetItem.special

Int

The internal ID of the type of special functionality that has been enabled on a charge. 0 is off, 1 is multiplier, 2 is expression

chargeSheetItem.collection

Int

The internal ID of the workflow group (or collection) that the chargesheet item belongs to.

chargeSheetItem.user

String

Either the internal ID of the user assigned to the charge or a reference to which key user on any case should be responsible for a charge

chargeSheetItem.extraCharge

Boolean

0 or 1 depending on whether there is a renewal extra charge associated with the chargesheet item

chargeSheetItem.nonChargeable

Boolean

0 or 1 depending on whether the chargesheet item has been marked as chargeable or nonchargeable 

 
Task

Variable Name

Data Type

Description

task.parentTask

Int

The internal ID of the parent task of the current task

task.id

Int

The internal ID of the task

task.description

String

A textual description of the task

task.doneDate

String

The date at which the task was set to completed by the user

task.matterId

Int

The internal ID of the matter within Equinox which the task is assigned to

task.matterCode

String

The reference number of the matter within Equinox which the task is assigned to

task.clientId

Int

The internal ID of the client the task has been associated with

task.client

String

The name of the client with which the task is associated with

task.presetItemId

Int

The internal ID of the preset item that the task has been created from

task.dueDate

String

The current date that the task is due to be completed by

task.status

Int

The status code for the task

task.statusName

String

A text-based reference for the status code of the task 

task.importance

Int

The importance code for the task

task.importanceName

String

A text-based reference for the importance code of the task 

task.formallyExtended

Boolean

0 or 1 depending on whether the task’s due date has had a formal extension

task.user

Int

The internal ID of the user that has been set as responsible for the task

task.type

 

 

task.typeName

 

 

task.notes

 

 

task.parentTaskId

 

 

task.components

 

 

task.workFlowLogId

 

 

task.attachedTemplate

 

 

task.setupDate

 

 

task.linkedDocuments

 

 

task.outgoingDiscarded

 

 

task.recipientId

 

 

task.deliveryMethodOverride

 

 

task.workflowPromptId

 

 

task.originalDueDate

String

The date that the task was due to be completed by when the task was created