[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fpayments\u002Ffields":3,"docs-tabs-entities\u002Fpayments\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля оплаты\n\n`GET \u002Fv1\u002Fpayments\u002Ffields`\n\nВозвращает схему полей оплаты: типы, флаги только-для-чтения, список агрегируемых полей.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpayments\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpayments\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\u002Fpayments\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\u002Fpayments\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| `orderId` | number | Идентификатор заказа. Источник: [`GET \u002Fv1\u002Forders`](..\u002Forders\u002Flist.md) |\n| `paySystemId` | number | Идентификатор платёжной системы. Узнать ID можно из существующих оплат: [`GET \u002Fv1\u002Fpayments`](.\u002Flist.md) или [`POST \u002Fv1\u002Fpayments\u002Faggregate`](.\u002Faggregate.md) с `groupBy: \"paySystemId\"` |\n| `paySystemName` | string | Название платёжной системы (только чтение, заполняется из карточки платёжной системы) |\n| `paySystemIsCash` | boolean | Принимает ли платёжная система наличные (только чтение) |\n| `paySystemXmlId` | string | Внешний идентификатор платёжной системы для синхронизации (только чтение) |\n| `sum` | number | Сумма оплаты |\n| `currency` | string | Валюта оплаты. Список: [`GET \u002Fv1\u002Fcurrencies`](\u002Fdocs\u002Fentities\u002Fcurrencies) |\n| `paid` | boolean | Помечена ли оплата как поступившая |\n| `datePaid` | datetime | Дата отметки оплаты |\n| `empPaidId` | number | Сотрудник, отметивший оплату (только чтение). Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `comments` | string | Комментарий к оплате |\n| `accountNumber` | string | Порядковый номер оплаты на портале (только чтение) |\n| `dateBill` | datetime | Дата выставления счёта |\n| `datePayBefore` | datetime | Срок оплаты |\n| `xmlId` | string | Внешний идентификатор для синхронизации |\n| `responsibleId` | number | Ответственный сотрудник. Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `empResponsibleId` | number | Сотрудник, ответственный за оплату (только чтение). Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `dateResponsibleId` | datetime | Дата назначения ответственного сотрудника (только чтение) |\n| `isReturn` | string | Признак возврата: `\"N\"` обычная оплата, `\"Y\"` возврат, `\"P\"` частичный возврат |\n| `marked` | boolean | Помечена ли оплата как проблемная |\n| `reasonMarked` | string | Причина пометки |\n| `empMarkedId` | number | Сотрудник, поставивший пометку (только чтение). Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `dateMarked` | datetime | Дата пометки оплаты как проблемной (только чтение) |\n| `psStatus` | string | Статус оплаты по данным платёжной системы |\n| `psStatusCode` | string | Код статуса от платёжной системы |\n| `psStatusDescription` | string | Описание статуса от платёжной системы |\n| `psStatusMessage` | string | Сообщение от платёжной системы |\n| `psSum` | number | Сумма оплаты по данным платёжного шлюза |\n| `psCurrency` | string | Валюта оплаты по данным платёжного шлюза |\n| `psResponseDate` | datetime | Дата ответа платёжного шлюза |\n| `psInvoiceId` | string | Идентификатор счёта на стороне платёжного шлюза |\n| `payVoucherNum` | string | Номер платёжного поручения |\n| `payVoucherDate` | datetime | Дата платёжного поручения |\n| `payReturnNum` | string | Номер документа возврата |\n| `payReturnDate` | datetime | Дата возврата |\n| `payReturnComment` | string | Комментарий к возврату |\n| `empReturnId` | number | Сотрудник, оформивший возврат (только чтение). Источник: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers) |\n| `priceCod` | number | Сумма наложенного платежа |\n| `companyId` | number | Компания-плательщик из CRM. Источник: [`GET \u002Fv1\u002Fcompanies`](\u002Fdocs\u002Fentities\u002Fcompanies) |\n| `externalPayment` | boolean | Оплата создана во внешней системе |\n| `id1c` | string | Идентификатор оплаты в 1С |\n| `version1c` | string | Версия оплаты в 1С |\n| `updated1c` | boolean | Обновлена ли оплата через 1С |\n\nМассив `aggregatable` перечисляет поля, доступные для числовых функций и `groupBy` в [`POST \u002Fv1\u002Fpayments\u002Faggregate`](.\u002Faggregate.md): `sum`, `currency`, `paid`, `paySystemId`, `orderId`, `responsibleId`. Массив `batch` — операции для [`POST \u002Fv1\u002Fbatch`](\u002Fdocs\u002Fbatch): `create`, `update`, `delete`.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"orderId\": { \"type\": \"number\", \"readonly\": false },\n      \"paySystemId\": { \"type\": \"number\", \"readonly\": false },\n      \"paySystemName\": { \"type\": \"string\", \"readonly\": true },\n      \"paySystemIsCash\": { \"type\": \"boolean\", \"readonly\": true },\n      \"paySystemXmlId\": { \"type\": \"string\", \"readonly\": true },\n      \"sum\": { \"type\": \"number\", \"readonly\": false },\n      \"currency\": { \"type\": \"string\", \"readonly\": false },\n      \"paid\": { \"type\": \"boolean\", \"readonly\": false },\n      \"datePaid\": { \"type\": \"datetime\", \"readonly\": false },\n      \"empPaidId\": { \"type\": \"number\", \"readonly\": true },\n      \"comments\": { \"type\": \"string\", \"readonly\": false },\n      \"accountNumber\": { \"type\": \"string\", \"readonly\": true },\n      \"dateBill\": { \"type\": \"datetime\", \"readonly\": false },\n      \"datePayBefore\": { \"type\": \"datetime\", \"readonly\": false },\n      \"xmlId\": { \"type\": \"string\", \"readonly\": false },\n      \"responsibleId\": { \"type\": \"number\", \"readonly\": false },\n      \"empResponsibleId\": { \"type\": \"number\", \"readonly\": true },\n      \"dateResponsibleId\": { \"type\": \"datetime\", \"readonly\": true },\n      \"isReturn\": { \"type\": \"string\", \"readonly\": false },\n      \"marked\": { \"type\": \"boolean\", \"readonly\": false },\n      \"reasonMarked\": { \"type\": \"string\", \"readonly\": false },\n      \"empMarkedId\": { \"type\": \"number\", \"readonly\": true },\n      \"dateMarked\": { \"type\": \"datetime\", \"readonly\": true },\n      \"psStatus\": { \"type\": \"string\", \"readonly\": false },\n      \"psStatusCode\": { \"type\": \"string\", \"readonly\": false },\n      \"psStatusDescription\": { \"type\": \"string\", \"readonly\": false },\n      \"psStatusMessage\": { \"type\": \"string\", \"readonly\": false },\n      \"psSum\": { \"type\": \"number\", \"readonly\": false },\n      \"psCurrency\": { \"type\": \"string\", \"readonly\": false },\n      \"psResponseDate\": { \"type\": \"datetime\", \"readonly\": false },\n      \"psInvoiceId\": { \"type\": \"string\", \"readonly\": false },\n      \"payVoucherNum\": { \"type\": \"string\", \"readonly\": false },\n      \"payVoucherDate\": { \"type\": \"datetime\", \"readonly\": false },\n      \"payReturnNum\": { \"type\": \"string\", \"readonly\": false },\n      \"payReturnDate\": { \"type\": \"datetime\", \"readonly\": false },\n      \"payReturnComment\": { \"type\": \"string\", \"readonly\": false },\n      \"empReturnId\": { \"type\": \"number\", \"readonly\": true },\n      \"priceCod\": { \"type\": \"number\", \"readonly\": false },\n      \"companyId\": { \"type\": \"number\", \"readonly\": false },\n      \"externalPayment\": { \"type\": \"boolean\", \"readonly\": false },\n      \"id1c\": { \"type\": \"string\", \"readonly\": false },\n      \"version1c\": { \"type\": \"string\", \"readonly\": false },\n      \"updated1c\": { \"type\": \"boolean\", \"readonly\": false }\n    },\n    \"aggregatable\": [\"sum\", \"currency\", \"paid\", \"paySystemId\", \"orderId\", \"responsibleId\"],\n    \"batch\": [\"create\", \"update\", \"delete\"]\n  }\n}\n```\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- [Создать оплату](.\u002Fcreate.md)\n- [Обновить оплату](.\u002Fupdate.md)\n- [Список оплат](.\u002Flist.md)\n- [Агрегация оплат](.\u002Faggregate.md)\n- [Заказы](..\u002Forders.md)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n","2026-07-14",{}]