[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Forders\u002Ffields":3,"docs-tabs-entities\u002Forders\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля заказа\n\n`GET \u002Fv1\u002Forders\u002Ffields`\n\nВозвращает схему полей заказа: типы, флаги только-для-чтения, список агрегируемых полей.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Forders\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Forders\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Forders\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { data } = await res.json()\nconsole.log('Поля заказа:', Object.keys(data.fields))\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Forders\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | Идентификатор заказа (только чтение) |\n| `accountNumber` | string | Порядковый номер заказа на портале. Только чтение — присваивается автоматически, запись отклоняется с `400 READONLY_FIELD` |\n| `lid` | string | Идентификатор сайта-источника (всегда `\"s1\"` для облачных порталов) |\n| `personTypeId` | number | Идентификатор типа плательщика |\n| `currency` | string | Валюта заказа. Список: [`GET \u002Fv1\u002Fcurrencies`](\u002Fdocs\u002Fentities\u002Fcurrencies) |\n| `price` | number | Общая сумма заказа. Задаётся при создании. На обновлении значение пересчитывается из позиций корзины — переданное вручную игнорируется, при пустой корзине становится `0` |\n| `discountValue` | number | Значение скидки |\n| `taxValue` | number | Сумма налога |\n| `statusId` | string | Текущий статус заказа. Источник: [`GET \u002Fv1\u002Forder-statuses?filter[type]=O`](..\u002Forder-statuses\u002Flist.md) |\n| `userId` | number | Идентификатор пользователя Битрикс24 — покупателя в интернет-магазине. Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `responsibleId` | number | Ответственный сотрудник. Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `payed` | boolean | Оплачен ли заказ полностью. Только чтение — управляется подсистемой оплат. Запись отклоняется с `400 READONLY_FIELD` |\n| `canceled` | boolean | Отменён ли заказ |\n| `marked` | boolean | Отмечен ли заказ как проблемный. Задаётся при создании. На обновлении игнорируется |\n| `deducted` | boolean | Списан ли товар со склада |\n| `reasonCanceled` | string \\| null | Причина отмены. `null`, если заказ не отменён |\n| `reasonMarked` | string \\| null | Причина пометки. `null`, если пометки нет |\n| `additionalInfo` | string \\| null | Дополнительная информация. `null`, если не задана |\n| `comments` | string \\| null | Комментарий менеджера к заказу. `null`, если не задан |\n| `userDescription` | string \\| null | Комментарий покупателя к заказу. `null`, если не задан |\n| `orderTopic` | string \\| null | Тема заказа. `null`, если не задана |\n| `xmlId` | string | Внешний идентификатор для синхронизации |\n| `id1c` | string \\| null | Идентификатор в 1С. `null`, если заказ не синхронизирован с 1С |\n| `version1c` | string \\| null | Версия в 1С. `null`, если заказ не синхронизирован с 1С |\n| `updated1c` | boolean | Обновлён ли заказ через 1С |\n| `externalOrder` | boolean | Создан ли заказ во внешней системе |\n| `recountFlag` | boolean | Флаг автоматического пересчёта |\n| `affiliateId` | number \\| null | Идентификатор партнёра партнёрской программы. `null`, если не задан |\n| `lockedBy` | number \\| null | Идентификатор пользователя, заблокировавшего заказ (актуально для коробочных порталов). `null`, если заказ не заблокирован |\n| `dateLock` | datetime \\| null | Время блокировки. `null`, если заказ не заблокирован |\n| `recurringId` | number \\| null | Идентификатор подписки (если заказ создан из повторяющегося шаблона). `null`, если заказ не из подписки |\n| `dateInsert` | datetime | Дата создания (только чтение) |\n| `dateUpdate` | datetime | Дата последнего изменения (только чтение) |\n| `dateCanceled` | datetime \\| null | Дата отмены (только чтение). `null`, если заказ не отменён |\n| `dateStatus` | datetime | Дата установки текущего статуса (только чтение) |\n| `empCanceledId` | number \\| null | Сотрудник, отменивший заказ (только чтение). `null`, если заказ не отменён |\n| `empMarkedId` | number \\| null | Сотрудник, поставивший пометку (только чтение). `null`, если пометки нет |\n| `empStatusId` | number \\| null | Сотрудник, последний раз менявший статус (только чтение). `null`, если статус не менялся |\n\n### Дополнительные поля и вложенные массивы\n\nЭти поля тоже входят в схему `GET \u002Fv1\u002Forders\u002Ffields`. `companyId` доступен для чтения и записи и по нему можно фильтровать, остальные — только для чтения. Массивы `clients`, `payments`, `basketItems`, `propertyValues` возвращает только [`GET \u002Fv1\u002Forders\u002F:id`](.\u002Fget.md) — в списочном ответе [`GET \u002Fv1\u002Forders`](.\u002Flist.md) их нет. Логические поля внутри вложенных объектов приходят как `true`\u002F`false`, даты — в UTC формате `…Z`.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `companyId` | number \\| null | Идентификатор связанной CRM-компании. `null`, если компания не задана. Доступен для записи и фильтрации. Список: [`GET \u002Fv1\u002Fcompanies`](\u002Fdocs\u002Fentities\u002Fcompanies) |\n| `dateMarked` | datetime \\| null | Дата последней пометки заказа (только чтение) |\n| `personTypeXmlId` | string \\| null | Внешний идентификатор типа плательщика (только чтение) |\n| `statusXmlId` | string \\| null | Внешний идентификатор статуса (только чтение) |\n| `version` | number | Внутренний номер версии записи (только чтение) |\n| `clients` | array | CRM-привязки заказа, только чтение. Каждый элемент: `{entityTypeId, entityId, isPrimary, roleId, sort}`, где `isPrimary` — `true`\u002F`false`. `entityTypeId` равен `3` — контакт ([`GET \u002Fv1\u002Fcontacts`](\u002Fdocs\u002Fentities\u002Fcontacts)), `4` — компания ([`GET \u002Fv1\u002Fcompanies`](\u002Fdocs\u002Fentities\u002Fcompanies)) |\n| `payments` | array \\| null | Оплаты заказа, только чтение. Поля оплаты — [Оплаты](..\u002Fpayments.md). `null`, если оплат нет |\n| `basketItems` | array | Позиции корзины, только чтение. Поля позиции — [Позиции корзины](..\u002Fbasket-items.md) |\n| `propertyValues` | array | Значения свойств заказа — ФИО, e-mail, телефон, адрес доставки, только чтение. Набор зависит от настройки портала |\n| `requisiteLink` | object | Связь с реквизитами получателя (requisiteId\u002FbankDetailId\u002FmcRequisiteId\u002FmcBankDetailId); `[]` если не задана; только чтение |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"accountNumber\": { \"type\": \"string\", \"readonly\": true },\n      \"price\": { \"type\": \"number\", \"readonly\": false },\n      \"currency\": { \"type\": \"string\", \"readonly\": false },\n      \"statusId\": { \"type\": \"string\", \"readonly\": false },\n      \"userId\": { \"type\": \"number\", \"readonly\": false },\n      \"dateInsert\": { \"type\": \"datetime\", \"readonly\": true },\n      \"dateUpdate\": { \"type\": \"datetime\", \"readonly\": true },\n      \"payed\": { \"type\": \"boolean\", \"readonly\": true },\n      \"canceled\": { \"type\": \"boolean\", \"readonly\": false }\n    },\n    \"aggregatable\": [\"price\", \"statusId\", \"payed\", \"canceled\", \"personTypeId\", \"responsibleId\", \"userId\"],\n    \"batch\": [\"create\", \"update\", \"delete\"]\n  }\n}\n```\n\nПоказаны самые важные поля. Полный набор описан в таблице выше — этот же набор возвращается живым вызовом `GET \u002Fv1\u002Forders\u002Ffields`.\n\n## Пример ответа при ошибке\n\n403 — нет скоупа:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'sale' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `sale` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список заказов](.\u002Flist.md)\n- [Создать заказ](.\u002Fcreate.md)\n- [Агрегация заказов](.\u002Faggregate.md)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-07-09",{}]