Создание, изменение, удаление

​

Методы

• строки регистров, подчинённых регистратору (…_RecordType): наборы движений пишутся целиком через регистратор;
• журналы документов;
• наборы табличных частей: строки пишутся через объект-владелец;
• результаты виртуальных таблиц.

​

Пример

POST /base/hs/odata/v4/Catalog_Номенклатура HTTP/1.1
Content-Type: application/json
Authorization: Basic …

{
  "Description": "Кабель ВВГ 3х2,5",
  "Parent_Key": "5c1b1b38-7a7c-11e6-80d9-005056b6e1a1",
  "ЕдиницаИзмерения_Key": "1b2f8c12-7a7c-11e6-80d9-005056b6e1a1"
}

PATCH /base/hs/odata/v4/Catalog_Номенклатура(guid'0f1e9c66-…') HTTP/1.1
Content-Type: application/json
If-Match: W/"AAAAAAAAB4k="

{ "Description": "Кабель ВВГнг 3х2,5" }

POST /base/hs/odata/v4/Document_РеализацияТоваровУслуг HTTP/1.1
Content-Type: application/json

{
  "Date": "2026-10-01T12:00:00",
  "Контрагент_Key": "7d3a…",
  "Товары": [
    { "Номенклатура_Key": "0f1e…", "Количество": 2, "Цена": 150 },
    { "Номенклатура_Key": "1a2b…", "Количество": 1, "Цена": 990 }
  ]
}

​

Тело запроса

• Ссылки — Имя_Key с GUID или Имя@odata.bind: "[email protected]": "Catalog_Склады(guid'…')". Форма OData v4 Catalog_Склады(…) и полный адрес тоже принимаются.
• Составные поля — пара Имя и Имя_Type. Тип: StandardODATA.Catalog_X, Edm.String, Edm.Decimal, Edm.Boolean, Edm.DateTimeOffset, StandardODATA.Undefined или перечисление.
• Перечисления — имя значения.
• Даты с часовым поясом переводятся в местное время базы, без пояса — пишутся как есть.
• Табличные части — массивы объектов. LineNumber в строке необязателен.

​

Ответ

​

Бизнес-логика

• Один запрос — одна транзакция с управляемой блокировкой объекта. Любая ошибка откатывает всё.
• Перед записью вызывается ПроверитьЗаполнение(). Проверку выключает флажок «Проверять заполнение перед записью» на вкладке «Запись». По умолчанию он включён, это строже, чем у standard.odata.
• Проведённый документ после PATCH/PUT перепроводится, как кнопка «Записать» в форме 1С.
• Пометка удаления проведённого документа снимает проведение.

{
  "error": {
    "code": "BadRequest",
    "message": "Объект Document_РеализацияТоваровУслуг не записан: не пройдена проверка заполнения",
    "details": [
      { "code": "Message", "message": "Поле \"Организация\" не заполнено", "target": "Организация_Key" },
      { "code": "Message", "message": "Не заполнена цена", "target": "Товары[0]/Цена" }
    ]
  }
}

​

Удаление

• Пометка удаления — по умолчанию.
• Физическое удаление по праву профиля. Без профиля объект удаляется при праве 1С «Удаление». С профилем нужны ещё права профиля «Физическое удаление» и «Удаление». В остальных случаях ставится пометка.

​

Права

1. Профиль, если он есть у субъекта, проверяет операцию: Добавление, Изменение, Удаление, ФизическоеУдаление, Проведение, ОтменаПроведения. Отказ — 403 «Операция «Изменение» над набором Catalog_X запрещена профилем».
2. Права 1С пользователя или служебной учётки проверяются до бизнес-логики. Нарушение — 403, обработчики не запускаются.

• запись требует права «Чтение»: закрытый набор отвечает 404;
• изменение DeletionMark требует права «Удаление»;
• изменение проведённого документа требует права «Проведение».

• строка с прежним номером получает свои скрытые значения;
• строка без номера или с новым номером получает пустые;
• повтор номера — 400;
• если в объекте строки есть, а ни у одной строки тела номера нет, — 400 «…передайте LineNumber строк», данные не меняются.

​

Сознательные отличия от standard.odata