Data Types and Object Structure in the REST API CRM

Type

Descriptions and Values

crm_status

String identifier of a CRM directory element (for example, NEW). Possible values for a specific directory can be obtained using the crm.status.list method with a filter by ENTITY_ID.

crm_lead

Integer identifier of a CRM lead. Information about the lead can be obtained using the crm.lead.get method.

crm_deal

Integer identifier of a CRM deal. Information about the deal can be obtained using the crm.deal.get method.

crm_contact

Integer identifier of a CRM contact. Information about the contact can be obtained using the crm.contact.get method.

crm_company

Integer identifier of a CRM company. Information about the company can be obtained using the crm.company.get method.

crm_quote

Integer identifier of a CRM estimate. Information about the estimate can be obtained using the crm.quote.get method.

crm_category

Integer identifier of a CRM funnel (direction). Information about the funnel (direction) can be obtained using the crm.category.get method.

crm_entity

Integer identifier of an element of some CRM object. Fields of this type explicitly contain information about which CRM object they belong to. For example, fields like parentId{entityTypeId} contain the identifier of the CRM entity type within their name. Information about the element can be obtained using the crm.item.get method by passing entityTypeId from the field name and id from its value.

lang_map

Object format:

{
            lang_1: value_1,
            lang_2: value_2,
            ..
            lang_n: value_n,
        }
        

where
lang_n - Language identifier
value_n - Value for language lang_n

crm_item_product_row

Integer identifier of the product item of the CRM object. Product item identifiers can be obtained using the crm.item.productrow.list method.

crm_multifield

Object describing a "multifield". Multifields are used to store phone numbers, email addresses, and other contact information. In leads, contacts, and companies, fields of this type are PHONE, EMAIL, WEB, and IM.

crm_currency

Object describing currency.

crm_currency_localization

Object describing currency localization.

crm_orderentity

Object describing the connection between CRM and online store orders.

type

Object describing a custom type of CRM object (SPA).

type.relations

Object containing relationships to other CRM entities.

relation

Object describing a linked CRM element.

type.linkedUserFields

Object describing a set of fields in which the SPA should be displayed.

Value
type

Description

ID
integer

Identifier of the multifield value.

TYPE_ID
string

Type of the multifield. Can take values PHONE, EMAIL, WEB, IM, LINK.

VALUE
string

String value of the multifield.

VALUE_TYPE
string

Type of the multifield value.
Can take values WORK, MOBILE, FAX, HOME, PAGER, MAILING, OTHER for phone,
WORK, HOME, MAILING, OTHER for email,
WORK, HOME, FACEBOOK, LIVEJOURNAL, TWITTER, OTHER for website,
FACEBOOK, TELEGRAM, SKYPE, VIBER, INSTAGRAM, BITRIX24, OPENLINE, IMOL, ICQ, MSN, JABBER, OTHER for messenger.

Value
type

Description

id
integer

Identifier of the product item.

ownerId
integer

Identifier of the CRM object.

ownerType
string

Identifier of the CRM object type.

productId
catalog_product.id

Identifier of the product from the catalog.

productName
string

Name of the product in the product item.

price
double

Price per unit of the product item, including discounts and taxes.

priceAccount
double

Price per unit of the product item, including discounts and taxes, converted to the reporting currency.

priceExclusive
double

Price per unit of the product item, including discounts but excluding taxes.

priceNetto
double

Price per unit of the product item, excluding discounts and taxes.

priceBrutto
double

Price per unit of the product item, including taxes but excluding discounts.

quantity
double

Quantity of the product.

discountTypeId
integer

Type of discount.
Possible values:

• 1 — absolute value
• 2 — percentage value.

discountRate
double

Discount value in percentage.

discountSum
double

Absolute discount value.

taxRate
double

Tax rate in percentage.

taxIncluded
string

Indicator of whether the tax is included in the price.
Possible values:

• Y – tax included
• N – tax not included.

customized
string

Deprecated.

measureCode
catalog_measure.code

Unit of measure code.

measureName
string

Text representation of the unit of measure (e.g., pcs, kg, m, l, etc.).

sort
integer

Sorting.

xmlId
string

External identifier of the product item.

type
integer

Type of product.
Possible values:

• 1 - Simple product
• 2 - Bundle
• 3 - Product with trade offers
• 4 - Trade offer
• 5 - Trade offer that has no product (not specified or deleted)
• 6 - Specific type, means invalid product with trade offers
• 7 — Service.

storeId
integer

Identifier of the inventory.

Value
type

Description

AMOUNT
double

Exchange rate relative to the base currency.
For the base currency, it is always equal to 1. Precision — 4 decimal places.

AMOUNT_CNT
integer

Nominal value.
For the base currency, it is always equal to 1.

BASE
string

Indicator of whether the currency is base (Y/N).

CURRENCY
string

Currency identifier. Corresponds to ISO 4217 standard.

DATE_UPDATE
datetime

Date of last modification.

SORT
integer

Sorting.

LID
string

Language code for which the localization parameters are returned.

DECIMALS
integer

Number of decimal places in the fractional part (localization parameter).

DEC_POINT
string

Decimal point for output (localization parameter).

FORMAT_STRING
string

Format template (localization parameter).

FULL_NAME
string

Name of the currency (localization parameter).

THOUSANDS_SEP
string

Thousands separator (localization parameter).

LANG
object

Currency localizations.
Object with a list of available localizations in the format {"lang_1": "value_1", ... "lang_N": "value_N"}, where lang_N — language identifier, and value — object of type crm_currency_localization.
Language identifier is a string of two Latin letters. Possible values can be found in the table of language identifiers.

Value
type

Description

DECIMALS
integer

Number of decimal places in the fractional part.

Default value — 2.

DEC_POINT
string

Decimal point for output.

Default value — . (dot symbol).

FORMAT_STRING
string

Format template. Must contain the symbol # — instead, the price value will be substituted.

Default value — #.

Examples of templates for the amount 1000:

• $ # — $ 1000
• # rub. — 1000 rub.
• € # — € 1000.

FULL_NAME
string

Name of the currency.

Default value — crm_currency.CURRENCY.

HIDE_ZERO
string

Indicator of whether to hide insignificant zeros (Y/N).

Default value — N.

THOUSANDS_SEP
string

Thousands separator.

Default value — (space).

THOUSANDS_VARIANT
string

Code for the thousands separator.

Default value — S.

When creating or modifying localization, if a value is specified for the THOUSANDS_VARIANT field, the value in THOUSANDS_SEP will be ignored and replaced according to the list:

• N — empty, no thousands separator. Example: 12345678
• C — comma. Example: 12,345,678
• D — dot. Example: 12.345.678
• S — space. Example: 12 345 678
• B — non-breaking space. Example: 12 345 678
  This differs from the previous option in that when line breaks occur, the result is not split into parts.

If a thousands separator is not needed, the THOUSANDS_VARIANT field must be explicitly passed with the value N. An empty string in the THOUSANDS_SEP field is not allowed.

Value
type

Description

OWNER_ID
integer

Identifier of the CRM object.

OWNER_TYPE_ID
integer

Identifier of the CRM object type.

ORDER_ID
sale_order.id

Identifier of the order.

Value
type

Description

id
integer

Identifier of the SPA.

title
string

Title of the SPA.

code
string

Symbolic code.

createdBy
integer

Identifier of the user who created this SPA.

entityTypeId
integer

Identifier of the entity type.

isCategoriesEnabled
boolean

Are custom funnels and sales tunnels enabled?

isStagesEnabled
boolean

Is the use of custom stages and Kanban enabled?

isBeginCloseDatesEnabled
boolean

Are the Start Date and End Date fields enabled?

isClientEnabled
boolean

Is the Client field enabled?

isUseInUserfieldEnabled
boolean

Is the use of the SPA in the user field enabled?

isLinkWithProductsEnabled
boolean

Is the linking of catalog products enabled?

isMycompanyEnabled
boolean

Is the Your Company Details field enabled?

isDocumentsEnabled
boolean

Is document printing enabled?

isSourceEnabled
boolean

Are the Source and Additional Information about Source fields enabled?

isObserversEnabled
boolean

Is the Observers field enabled?

isRecyclebinEnabled
boolean

Is the use of the recycle bin enabled?

isAutomationEnabled
boolean

Are automation rules and triggers enabled?

isBizProcEnabled
boolean

Is the use of the business process designer enabled?

isSetOpenPermissions
boolean

Should new funnels be available to everyone?

isPaymentsEnabled
boolean

System field indicating whether payment capability is enabled.

isCountersEnabled
boolean

System field indicating whether counters are enabled.

createdTime
datetime

System field indicating the creation time of the SPA.

updatedTime
datetime

System field indicating the time of modification of this SPA.

updatedBy
integer

Identifier of the user who modified this SPA.

relations
object

Object containing relationships to other CRM entities.

linkedUserFields
object

Set of fields in which this SPA should be displayed.

customSections
array

List of all digital workplaces.

This parameter is deprecated. To work with digital workplaces, use the methods crm.automatedsolution.*.

customSectionId
integer

Identifier of the digital workplace.

This parameter is deprecated. To work with digital workplaces, use the methods crm.automatedsolution.*.

Value
type

Description

parent
relation[]

CRM elements that will be linked to this SPA.

child
relation[]

CRM elements to which this SPA will be linked.

Value
type

Description

entityTypeId
integer

Identifier of the system or user-defined type of CRM entity.

isChildrenListEnabled
boolean

Should the linked element be added to the card?

isPredefined
boolean

Is this relationship predefined (system)?

Value
type

Description

CALENDAR_EVENT|UF_CRM_CAL_EVENT
boolean

Calendar event.

TASKS_TASK|UF_CRM_TASK
boolean

Tasks.

TASKS_TASK_TEMPLATE|UF_CRM_TASK
boolean

Task templates.

Language Identifier

Language

ar

Arabic

br

Portuguese (Brazil)

de

German

en

English

fr

French

hi

Hindi

id

Indonesian

it

Italian

ja

Japanese

la

Spanish

ms

Malay

pl

Polish

ru

Russian

sc

Chinese

tc

Chinese (Taiwan)

th

Thai

tr

Turkish

ua

Ukrainian

vn

Vietnamese

Name
type

Description

type
string

Type of the field.

isRequired
boolean

Is the field required?

isReadOnly
boolean

Is the field read-only?

isImmutable
boolean

Indicator of whether the field value can only be filled once when creating a new element.

isMultiple
boolean

Indicator of whether the field is multiple. If true, values in the field are passed as an array.

isDynamic
boolean

Is the field user-defined?

title
string

Name of the field.

upperName
string

Name of the field in uppercase.

Name
type

Description

Example

ADDRESS_1
string

Street, house number

Small Znamenka Lane 7/10 b2

ADDRESS_2
string

Apartment, office, room, floor

5

POSTAL_CODE
string

Postal code

119019

CITY
string

Settlement

New York

REGION
string

District

Arbat District

PROVINCE
string

Region

New York

COUNTRY
string

Country

United States

LATITUDE
string

Latitude coordinates

55.748289

LONGITUDE
string

Longitude coordinates

37.60504

LOC_ADDR_ID
string

Location address identifier

10

Object Type

Numeric Identifier of Type
entityTypeId

Symbolic Code of Type
entityTypeName

Short Symbolic Code of Type
entityTypeAbbr

Type of User Field Object
userFieldEntityId

Lead

1

LEAD

L

CRM_LEAD

Deal

2

DEAL

D

CRM_DEAL

Contact

3

CONTACT

C

CRM_CONTACT

Company

4

COMPANY

CO

CRM_COMPANY

Invoice (old)

5

INVOICE

I

CRM_INVOICE

Invoice (new)

31

SMART_INVOICE

SI

CRM_SMART_INVOICE

Estimate

7

QUOTE

Q

CRM_QUOTE

Requisite

8

REQUISITE

RQ

CRM_REQUISITE

Order

14

ORDER

O

ORDER

SPA

128

DYNAMIC_128

T80

CRM_1