Contact Account field reference

  • Code: optional, if not specified it will be auto generated; (max 50 characters)

  • Description: required; (max 200 characters)

  • IntRef: optional, must be unique; (max 50 characters)

  • CompanyNo: optional; (max 50 characters)

  • TaxNo: optional; (max 50 characters)

  • LegacyRef: optional; (max 50 characters)

  • TheirRef: optional, reference field; (max 50 characters)

  • CountryCode: optional, ISO 3166-1 alpha-2

  • ContactClassificationId: optional; code (see Contact Classification)

  • Customer: JSON; if specified, it will enable the customer record for this contact account.

    • ContactGroupCustomerId: required, will also be used to default all the other unspecified fields

    The rest of the properties are optional and if they are not specified they default from the contact group:

    • Currency: ISO 4217 currency (3 characters)
    • CreditLimit: decimal
    • PaymentMethodId: code (see Payment Methods)
    • PayTermId: code (see Payment Methods)
    • ReceiveInvoices: boolean
    • ReceiveReminders: boolean
    • ReceiveStatements: boolean
    • TaxBandId: code (see Tax Band)
    • TaxBandFixed: boolean, if true, the tax band cannot be amended on transactions
    • TaxAuthorityId: code (see Tax Authority)
    • ProjectId: default project
    • ApplyDomesticReverseCharge: When applicable for the specified Tax Authority, Domestic Reverse Charge will be applied to documents produced for the customer
    • CostCentreId: default cost centre
    • CostCentreFixed: boolean, if true, the cost centre cannot be amended on transactions
    • DepartmentId: default department
    • DepartmentFixed: boolean, if true, the department cannot be amended on transactions
    • WarningMessage: default warning message

    Additional properties, not defaulted from the contact group:

    • Ext: custom fields, JSON object

  • Supplier: if specified, it will enable a supplier record for this contact account

    • ContactGroupSupplierId: required, will also be used to default all the other unspecified fields

    The rest of the properties are optional and if they are not specified they default from the contact group:

    • Currency: ISO 4217 currency (3 characters)
    • CreditLimit: decimal
    • PaymentMethodId: code (see Payment Methods)
    • PayTermId: code (see Payment Methods)
    • ReceiveInvoices: boolean
    • ReceiveReminders: boolean
    • ReceiveStatements: boolean
    • TaxBandId: code (see Tax Band)
    • TaxBandFixed: boolean, if true, the tax band cannot be amended on transactions
    • TaxAuthorityId: code (see Tax Authority)
    • ProjectId: default project
    • ApplyDomesticReverseCharge: When applicable for the specified Tax Authority, Domestic Reverse Charge will be applied to documents produced for the supplier
    • CostCentreId: default cost centre
    • CostCentreFixed: boolean, if true, the cost centre cannot be amended on transactions
    • DepartmentId: default department
    • DepartmentFixed: boolean, if true, the department cannot be amended on transactions
    • ProductId: default product
    • AccountId: default account
    • WarningMessage: default warning message

    Additional properties, not defaulted from the contact group:

    • Ext: custom fields, JSON object

  • Resource: if specified, it will enable a resource record for this contact account

    • ResourceGroupId: required, will also be used to default all the other unspecified fields

    The rest of the properties are optional and if they are not specified they default from the resource group:

    • DepartmentId: code (see Department)
    • AbsenceGroupId: code (see Absence Group)
    • CostCentreId: code (see Cost Centre)
    • ManagerResourceId: code (see Contact Account)
    • IsSalesperson: boolean
    • IsBuyer: boolean
    • IsRequestor: boolean
    • AllowExpense: boolean
    • AllowTask: boolean
    • AllowTimesheet: boolean
    • HasEmployment: boolean
    • HasUmbrella: boolean
    • PaymentMethodId: code (see Payment Methods)
    • PaymentTermsId: code (see Pay Term)
    • SendRemittance: boolean

    Additional properties, not defaulted from the resource group:

    • LocationId: optional, code (see Location)
    • NationalInsuranceNo: optional, max 50 characters
    • UniqueTaxpayerReference: optional, max 50 characters
    • ResourceEmployments: optional, JSON array:
      • DateFrom: optional, ISO 8601
      • DateTo: optional, ISO 8601
      • LegalEntityId: optional, code (see Legal Entity)
      • EmploymentTypeId: optional, code (see Employment Type)
      • JobTitle: optional, max 50 characters
      • JobGrade: optional, max 50 characters
      • PaymentFrequencyId: optional, max 50 characters
      • PreviousEmployer: optional, max characters
      • TerminationNoticeDays: optional, integer
    • ResourceUmbrellas: optional, JSON array:
      • UmbrellaContactAccountId: required, code (see Contact Account)
      • DateFrom: required, ISO 8601
      • DateTo: optional, ISO 8601
    • Ext: custom fields, JSON object

  • Contact: optional, the main contact account details

    • CompanyName: required, max 200 characters

    • Addresses: optional, JSON array:

      • PostCode: required, max 50 characters
      • Address: required, max 200 characters (may contain new line separators)
      • City: optional, max 50 characters
      • County: optional, max 50 characters
      • CountryCode: optional, ISO 3166-1 alpha-2

    • Phones: optional, JSON array:

    • Emails: optional, JSON array:

  • Contacts: optional, additional people

    • CompanyName: optional, max 200 characters
    • Title: optional, max 50 characters
    • FirstName: optional, max 150 characters
    • MiddleName: optional, max 150 characters
    • LastName: optional, max 150 characters
    • Suffix: optional, max 50 characters
    • JobTitle: optional, max 50 characters
    Note

    At least one of the CompanyName, FirstName, LastName is required to create a contact.

    • If only a CompanyName is specified, the contact will be a Company type record.
    • If any of the FirstName, LastName are specified, the contact will be a Person type record.
    • Addresses: optional, JSON array (same as above)
    • Phones: optional, JSON array (same as above)
    • Emails: optional, JSON array (same as above)