Сохранить объект в 1С

POST

https://business.tbank.ru/openapi/hs/knapApi/save

Создаёт или обновляет объект (документ, справочник и т.п.) в 1С. Поддерживает табличные части, ссылочные поля, перечисления, даты. Возможна запись с проведением, отменой проведения и т.д.

Авторизация

Security

Bearer API Token

RPS

Ограничение — 20 запросов в секунду

Scopes

Интеграция с КНАП → Методы для работы с документами в Бухгалтерии

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

ManagerName

String

Полное имя менеджера объекта в 1С (например, ДокументМенеджер.СчетНаОплатуПокупателю).

Required

CreationMethod

String

Requirements: [CreateDocument, CreateItem, CreateFolder, CreateDataRegister]

Способ создания объекта.

PostType

String

Requirements: [Save, Post, Unpost, UnpostThenPost]

Режим записи документа.

OwnGuid

String<uuid>

Опциональный ГУИД для создания объекта с заданным идентификатором.

ignoreRestrictDate

Boolean

Если true — игнорировать запрет на запись по дате.

Required

Fields

Array of objects ()

Requirements: <= 1000 items

Список полей объекта.

Required

Name

String

Required

Type

String

Requirements: [Default, String, Number, Date, Boolean, GuidReference, Enum, List, SyncList]

Value

Object

Значение поля объекта 1С.

oneOf

MOD1
MOD2
MOD3

string

ManagerName

String

Requirements: <= 150 characters

Ответ

200

Объект успешно сохранён.

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку