Внешний код

Внешний код - точки расширения модуля, куда можно вставить свой код на языке 1С без правки конфигурации/расширения. Код выполняется в заданных местах обмена, создания документов, подбора номенклатуры, остатков и цен.

Раздел для специалистов: ошибка во внешнем коде может остановить обмен или создание документов.

1. Как открыть

1. Откройте Административную панель модуля:

Управляемые формы - ИТС: мБридж → Сервис → Маркетплейсы: Администрирование.

Обычные формы - Операции → Обработки → ITC: Администрирование.

2. Меню Еще → Дополнить внешним кодом.

3. Откроется список идентификаторов (точек вставки) с описанием: когда выполняется код, какие переменные доступны и что нужно вернуть.

2. Как добавить или изменить код

1. Выберите строку по Идентификатору (описание в соседней колонке подскажет контекст).

2. Откройте редактор Редактирование внешнего кода.

3. Введите код на языке 1С. Используйте только переменные и возвращаемые значения из описания точки.

4. Нажмите Сохранить.

5. При необходимости обновите список кнопкой Обновить.

3. Группы точек вставки

Состав идентификаторов зависит от версии модуля и конфигурации 1С. Ниже типовые группы.

Заказ маркетплейса - ЗаказМаркетплейса_ПередЗаписью, …ПередЗаписьюПосле, …ПриЗаписи, …ПриЗаписиПосле, …ПриИзмененииСтатуса. Обычно доступны ЭтотОбъект / Ссылка / ДокОбъект, флаг Отказ.

Добавление в заказ клиента - ДобавитьВДокументЗаказ_ПередСозданием, …_ПередЗаписью. Переменные вроде Параметры, ЗаказКлиента, Товары, ДокОбъект; перед созданием часто нужно вернуть ГУИД документа.

Подбор и остатки - ПодобратьТоварНачало, ПолучитьОстатокНачало, ПолучитьТаблицуОстатковНачало, ПолучитьТаблицуОстатков. В Параметры обычно есть настройка обмена, склады, номенклатура, sku / offer_id / штрихкод и т.п.

Цены - ПолучитьТаблицуЦенНачало, ПолучитьТаблицуЦен. На входе/выходе - Параметры и ТаблицаЗначений с колонками формул цен, скидок, порогов остатка.

Создание документов 1С - пары СоздатьДокумент…_ПередСозданием и …_ПередЗаписью (заказ, реализация, счёт-фактура, возврат, расходный ордер, отбор/размещение и др.). Перед записью доступен ДокОбъект; перед созданием - структура параметров и часто возврат ГУИД или структуры ТекстОшибки / Данные.

4. Правила и осторожность

Пишите код только под нужную точку и сверяйтесь с её описанием: имена переменных и ожидаемый результат отличаются.

Перед записью в продуктивную базу сделайте резервную копию. Проверьте сценарий на копии ИБ.

Пустой код или Возврат без нужного значения там, где требуется таблица/ГУИД/структура, может сломать штатный алгоритм.

После обновления модуля проверьте свои точки: набор идентификаторов и описание могут измениться.

См. также

Административная панель - откуда открывается команда "Дополнить внешним кодом".

Функционал и набор точек вставки могут отличаться в зависимости от версии модуля и конфигурации 1С.