CompanyModel

A Company represents a customer, a vendor, or a company within the organization of the account holder.
Companies can have parents and children, representing an organizational hierarchy of corporate entities.
You can use Companies to track projects and financial data under this Company label.

See Vendors, Customers, and Companies for more information.

Methods

Fields

companyId

uuid, read-only

The unique ID of this record, automatically assigned by Lockstep when this record is
added to the Lockstep platform.

For the ID of this record in its originating financial system, see ErpKey.

companyName

string, nullable, 0-100 characters

The short name of the company.

erpKey

string, nullable, 0-100 characters

The unique ID of this record as it was known in its originating financial system.

If this company record was imported from a financial system, it will have the value ErpKey
set to the original primary key number of the record as it was known in the originating financial
system. If this record was not imported, this value will be null.

For more information, see Identity Columns.

companyType

string, nullable, 0-20 characters

This field indicates the type of company. It can be one of a limited number of values:
Company, Customer, Group, or Vendor. A company that represents both a customer and a vendor
is identified as a CustomerVendor.

  • Company - This record represents a company that is part of the organization of the account holder.
  • Customer - This record represents a business entity that purchases things from the account holder.
  • Group - Only one record of type GROUP exists in each account. Contains your account profile.
  • Vendor - This record represents a business entity that sells things to the account holder.
  • CustomerVendor - Both a customer and a vendor.

companyStatus

string, nullable, 0-20 characters

The status of the company. Companies can be either Active or Inactive. When matched to a
Lockstep corporate profile, this value will change to reflect that this record will be kept
in sync with that company's identity.

parentCompanyId

uuid, nullable

If this business entity is part of an organization, this value is non-null and it is set
to the CompanyId value of the parent company of this business entity.

If this value is null, this business entity is a standalone.

enterpriseId

uuid

For convenience, this field indicates the top-level parent company. This can be used
to jump directly to the top parent in complex organizational hierarchies.

groupKey

uuid, read-only

The GroupKey uniquely identifies a single Lockstep Platform account. All records for this
account will share the same GroupKey value. GroupKey values cannot be changed once created.

For more information, see Accounts and GroupKeys.

isActive

boolean

This flag indicates whether the company is currently active. An inactive company
should be hidden from the user interface but will still be available for querying.

defaultCurrencyCode

string, nullable, 0-3 characters

The default currency code used by this business entity. This value can be overridden
for invoices in a different currency code.

For a list of defined currency codes, see Query Currencies

companyLogoUrl

string, nullable, 0-512 characters

The URL of this company's logo, if known.

primaryContactId

uuid, nullable

The Lockstep ContactId of the primary contact for this company.

address1

string, nullable, 0-80 characters

Address info

address2

string, nullable, 0-80 characters

Address info

address3

string, nullable, 0-80 characters

Address info

city

string, nullable, 0-100 characters

Address info

stateRegion

string, nullable, 0-20 characters

Address info

postalCode

string, nullable, 0-10 characters

Address info

country

string, nullable, 0-20 characters

Address info

phoneNumber

string, nullable, 0-20 characters

Phone number

faxNumber

string, nullable, 0-20 characters

Fax number

created

date-time, nullable, read-only

The date this company was created

createdUserId

uuid, read-only

The ID of the user who created this company

modified

date-time, nullable, read-only

The date this company was last modified

modifiedUserId

uuid, read-only

The ID of the user who last modified this company

modifiedUserName

string, nullable, read-only

The name of the user who last modified this company

taxId

string, nullable, 0-20 characters

Federal Tax ID

dunsNumber

string, nullable, 0-10 characters

Dun & Bradstreet Number

apEmailAddress

email, nullable, 0-254 characters

AP (Accounts Payable) Email Address

arEmailAddress

email, nullable, 0-254 characters

AR (Accounts Receivable) Email Address

domainName

string, nullable, 0-254 characters

For companies that use a custom domain name for their email system, this is
the domain name used by this company. If this value is known, new emails that
come in from this domain will be connected to this company.

companyClassificationCodeDefId

uuid, nullable

Identifier for classification of this company.

description

string, nullable, 0-254 characters

Description of the company.

website

string, nullable, 0-512 characters

Website URL for this company.

appEnrollmentId

uuid, nullable, read-only

The AppEnrollmentId of the application that imported this company record. For accounts
with more than one financial system connected, this field identifies the originating
financial system that produced this record.

notes

NoteModel[], nullable, read-only

All notes attached to this company.

To retrieve this collection, specify Notes in the "Include" parameter for your query.

attachments

AttachmentModel[], nullable, read-only

All attachments attached to this company.

To retrieve this collection, specify Attachments in the "Include" parameter for your query.

contacts

ContactModel[], nullable, read-only

All contacts attached to this company.

To retrieve this collection, specify Contacts in the "Include" parameter for your query.

invoices

object[], nullable, read-only

All invoices attached to this company.

To retrieve this collection, specify Invoices in the "Include" parameter for your query. For more information on Invoices, see InvoiceModel.

customFieldDefinitions

CustomFieldDefinitionModel[], nullable, read-only

All definitions attached to this company.

To retrieve this collection, specify CustomFieldValues in the "Include" parameter for your query.

customFieldValues

CustomFieldValueModel[], nullable, read-only

All values attached to this company.

To retrieve this collection, specify CustomFieldValues in the "Include" parameter for your query.

companyClassificationCodeDefinition

CodeDefinitionModel, nullable, read-only

Classification code definition for this company.

To retrieve this collection, specify Classification in the "Include" parameter for your query.

Deprecated Fields

Deprecated fields are maintained for backwards compatibility with previous versions of the Lockstep API. Deprecated fields may be removed in a future release of the API.

corpCity

string, nullable, 0-100 characters

Corporate Address info

corpState

string, nullable, 0-20 characters

Corporate Address info

corpPostalCode

string, nullable, 0-10 characters

Corporate Address info

corpCountry

string, nullable, 0-20 characters

Corporate Address info

corpPhone

string, nullable, 0-20 characters

Corporate phone number

corpFax

string, nullable, 0-20 characters

Corporate fax number


Did this page help you?