Инструкция для поставщика и его специалиста: как передавать товары, поддерживать остатки и получать заказы. Способ передачи каталога и получение заказов настраиваются отдельно. Документацию можно изучить до регистрации.
Зарегистрируйте организацию. Заполните заявку поставщика и контакты сотрудника. Результат рассмотрения и необходимые уточнения появятся в кабинете.
Выберите способ передачи товаров. Для небольшой номенклатуры можно загрузить файл. Для регулярного обновления — настроить HTTPS-фид, SFTP или API. Что подготовить для каждого способа, описано ниже.
Определите, кто отвечает на заказы. Сотрудник может подтверждать резерв в кабинете. Для автоматической работы специалист вашей учётной системы настраивает получение заявок и ответы через API. Одной загрузки файла с товарами для этого недостаточно.
После одобрения загрузите небольшой набор реальных товаров. Начните с 5–20 карточек и прочитайте результат загрузки. Принятые строки сохраняются в вашем каталоге; ошибочные нужно исправить. Это не пробный запрос без записи.
Подготовьте обновление остатков. Передавайте точное количество для каждого склада и сразу сообщайте ноль, когда товар закончился. Пропущенная строка не означает нулевой остаток.
Проверьте обмен заказами. Для API запустите пробный обмен в кабинете. Затем отдельно проверьте резервирование и защиту от повторной обработки в своей учётной системе.
Подготовьте ЭДО для документов. Реквизиты «Бери товар» появятся на странице регистрации и в кабинете. УПД, документы поставки и сведения «Честного знака» будут передаваться через ЭДО после подключения оператора и согласования обмена.
Успешная загрузка ещё не означает публикацию. Фотографии, категория, характеристики, упаковка и условия поставки проходят подготовку и проверку. Состояние товаров видно в кабинете.
Для модуля 1С планируем обновлять описательные данные карточек раз в два дня. Цены и свободные остатки идут отдельным, более частым обменом. Новые сведения дополняют товар с прежним ID; создавать новую карточку из-за заполненного ТН ВЭД или изменённого веса не нужно.
Что передать вашему специалисту: ссылку на эту документацию, выбранный способ загрузки товаров и требование получать заявки на резерв через API. Ключ создайте в кабинете после одобрения и сохраните в защищённых настройках интеграции.
Если программиста пока нет: товары можно загрузить файлом, а заявки обрабатывать в кабинете. Для автоматического обмена потребуется настроить вашу систему; один выпуск ключа не включает получение заказов.
Модуль 1С «Бери товар»: установка и работа
Это наша собственная разработка «Бери товар» для подключения 1С поставщика к нашему сайту.
Доступно расширение «Бери товар» версии 0.9.0 для «1С:Управление торговлей 11.5.22.67». Это тот же файл, в котором проверены передача товаров и плановый обмен с резервированием тестового заказа. В файле нет ключа или настроек поставщика. Установку в вашей базе выполняет администратор 1С; совместимость с другими релизами и конфигурациями не подтверждена.
Установку и права готовит администратор 1С. После этого поставщик подключает свой кабинет, выбирает товары и отдельно включает расписание.
1. Подготовьтесь к установке
Поставщик вместе с администратором 1С
Получите одобрение заявки поставщика.
Войдите в кабинет поставщика «Бери товар». Доступ к номеру поставщика и выпуску ключа открывается после одобрения заявки. Номер поставщика и ключ — разные значения.
Согласуйте совместимость вашей базы.
Передайте администратору название и версии конфигурации и платформы 1С, а также уточните, используется файловая база или сервер 1С. Поддерживаемый релиз — «Управление торговлей 11.5.22.67»; модуль проверяет этот номер. Для другого релиза нужен совместимый выпуск. Расширение использует режим совместимости платформы 8.3.27; совместимость со всеми вариантами базы пока не подтверждена.
Базовые версии и облачные базы могут ограничивать установку расширений. Доступность установки проверяет администратор или обслуживающий партнёр 1С.
Скачайте модуль и эту инструкцию.
Нажмите «Скачать модуль 1С» выше: загрузится BeriTovar-UT11.5.22.67-0.9.0.cfe, версия 0.9.0. Сохраните также инструкцию, чтобы пользоваться ею при установке в 1С. Файл расширения не содержит вашу базу, чужой ключ или заранее выбранные организацию, склад и товары.
2. Установите расширение
Эти действия выполняет администратор 1С
Подготовьте резервную копию и отдельную проверку.
Администратор сохраняет резервную копию базы, проверяет восстановление и сначала проверяет совместимость модуля в отдельной копии. Для установки требуется право «Администрирование расширений конфигурации»; права работы поставщика с товарами проверяются отдельно.
Откройте список расширений в УТ 11.5.
Путь из руководства 1С: НСИ и администрирование → Администрирование → Печатные формы, отчеты и обработки → Расширения. Если пункт недоступен, установку продолжает администратор или обслуживающий партнёр; поставщику не требуется изменять конфигурацию вручную.
Добавьте выпущенный файл модуля.
В списке расширений администратор добавляет полученный файл .cfe, проверяет название, версию и применимость именно модуля «Бери товар». При обновлении используется штатное обновление того же расширения: удаление настроек и журналов обмена не требуется.
Если установку выполняют через Конфигуратор, откройте «Конфигурация» → «Расширения конфигурации». Загрузка файла должна выполняться в контексте нашего расширения: для уже установленного модуля выберите его строку и команду «Конфигурация» → «Загрузить конфигурацию из файла». После загрузки примените изменения именно этого расширения. Основную конфигурацию УТ этим файлом не заменяют.
Настройте доступ только для этого модуля.
Администратор проверяет права на выбранную организацию, склад, цены, товары, фотографии и собственный экран модуля. Для обмена нужен доступ к HTTPS сайта «Бери товар». Настройки доверия и безопасности согласуются для конкретного расширения.
Установка не требует отключать все защиты базы или менять настройки остальных расширений. Общее разрешение внешних ресурсов в копии базы рассматривается отдельно: оно влияет и на другие интеграции.
Примените изменения и откройте новый сеанс.
Завершите применение расширения штатным способом 1С и перезапустите сеансы, как предложит программа. Администратор проверяет, что расширение применилось без ошибок, и даёт поставщику доступ к форме нашего расширения.
Откройте «Сервис и настройки» → «Функции для технического специалиста» → «Обработки». Найдите «B t supplier exchange settings» — это фактическое имя нашей обработки в версии 0.9.0 — и откройте её. Техническое имя: BT_SupplierExchangeSettings, форма «Настройки». Отдельного пункта «Обмен с Бери товар» в основном меню этого выпуска нет. Если технические функции скрыты, администратор включает их отображение через «Сервис и настройки» → «Настройки» → «Параметры» и проверяет права. Названия общих команд зависят от интерфейса 1С; этот стандартный путь основан на метаданных расширения и справке 1С, отдельный повтор первого открытия после выпуска не выполнялся.
Подготовьте параметры чтения вашей 1С.
Один раз выберите и проверьте организацию, склад, вид цены, валюту обмена и необходимые параметры отбора. Используйте фактические данные вашей базы. Не подставляйте отсутствующий вес, размеры или характеристики: недостающие сведения можно заполнить позже.
Поле «Склад» относится к складу вашей 1С: из него читается свободный остаток и на нём должен резервироваться товар. Администратор сверяет его с тем складом поставщика на сайте, которому относятся эти заказы. Совпадение названий или штрихкодов не заменяет правильную привязку складов.
Проверьте соглашение для заказов.
В поле «Соглашение для заказа» выбирается действующее соглашение вашей 1С для продаж через «Бери товар». При сохранении нового выбранного товара оно закрепляется за этим товаром. Администратор проверяет, что в соглашении указаны нужные партнёр и контрагент, а организация, валюта, вид цены и склад соответствуют настройкам обмена.
Для проверяемого варианта требуется индивидуальное соглашение с заполненным партнёром и контрагентом. Работа баз, в которых обязательно используются договоры контрагентов, пока не подтверждена: точный договор ещё должен быть поддержан и проверен модулем. Отключать договоры в вашей базе ради подключения не требуется.
3. Подключитесь к своему кабинету
Поставщик
Загрузите сохранённые настройки.
В экране модуля нажмите «Загрузить настройки». Проверьте выбранные организацию, склад и вид цены. При первом подключении первоначальные параметры подготавливаются вместе с администратором.
Возьмите номер поставщика и свой ключ.
В кабинете откройте «Ключ интеграции». Скопируйте номер поставщика из одноимённого поля. При первом подключении, если ключа ещё нет, нажмите «Создать ключ», затем «Скопировать» и сразу вставьте полный ключ в модуль 1С. Если ключ уже выпущен, используйте этот действующий ключ; создавать новый для каждого запуска не нужно.
Полный ключ показывается при выпуске, а позднее кабинет показывает только маску. Маска не подходит для подключения. Передавайте полный ключ только в поле «Ключ подключения» вашего модуля; не отправляйте его в чат, фотографии экрана или общие журналы.
Если полный ключ утрачен, но уже сохранён в модуле 1С, повторно вводить его для расписания не нужно. Если подключение создаётся заново и полного ключа нет, согласуйте замену с ответственным за обмен: «Заменить ключ» отключает прежний ключ, и все использующие его подключения потребуется обновить.
Подключите модуль и сохраните ключ.
Вставьте номер в поле «Номер поставщика из кабинета платформы», а полный ключ — в поле «Ключ подключения». Нажмите «Подключить и сохранить ключ». Успешный результат отдельно подтверждает подключение и сохранение ключа; расписание остаётся выключенным.
Ключ сохраняется в собственном безопасном хранилище БСП в 1С. Поле ввода очищается после действия. Это не означает, что сохранённый доступ удалён.
Проверьте доступ после повторного открытия.
Заново откройте модуль, нажмите «Загрузить настройки», затем «Показать состояние автообновления». Должно быть указано, что сохранённый доступ найден. Сам ключ не показывается.
Наличие сохранённого доступа подтверждает чтение хранилища, но само по себе не проверяет соединение с сайтом. Проверка текущего соединения выполняется отдельно при включении автообновления.
4. Передайте выбранные товары первый раз
Поставщик
Выберите небольшой набор товаров.
Нажмите «Показать товары УТ» или найдите нужный товар. Отметьте товары, которые хотите передавать. Проверяйте выбор перед сохранением; автоматический обмен не выгружает всю номенклатуру сам по себе.
В карточке товара должен быть заполнен артикул, а в модуле — «Соглашение для заказа». Если товар не добавился, прочитайте пояснение в его строке. Кнопка «Выбрать всё на странице» относится к текущей странице списка; общий сохранённый выбор можно проверить кнопкой «Выбранные товары».
Сохраните выбор и посмотрите отправку.
Нажмите «Сохранить выбор и подключение», затем «Что будет отправлено». Проверьте цену, свободный остаток, фотографии и пояснения по каждому товару. Если изменились данные или выбор, сохраните выбор и обновите просмотр.
Выполните первую ручную синхронизацию.
В версии 0.9.0 первая ручная отправка использует ключ из поля формы. Перед нажатием «Синхронизировать» повторно вставьте действующий полный ключ в «Ключ подключения». После действия поле очистится; сохранённый ключ для расписания останется.
Прочитайте результат: сколько принято, пропущено, ожидает подтверждения и изменилось после просмотра. Исправляйте указанные причины. При неподтверждённой отправке повторяйте её через модуль с прежними товарами: не создавайте новые товары только для повтора.
Проверьте результат в кабинете.
Убедитесь, что нужные товары появились в вашем кабинете с верными ценой и свободным остатком. Проверьте все переданные фотографии и подсказки «Что дозаполнить». Приём неполной карточки ещё не означает публикацию или готовность к продаже.
Товары, уже принятые сайтом, повторно отправлять для включения расписания не требуется. Новые выбранные товары сначала проходят первую синхронизацию.
5. Включите, проверьте и остановите автообновление
Поставщик после проверки администратором
Включите и проверьте расписание.
Оставьте поле ключа пустым и нажмите «Включить автообновление». Модуль использует сохранённый ключ и проверяет текущее соединение. Сохранение ключа само по себе расписание не включает.
Для выбранных товаров, уже принятых сайтом, предусмотрен интервал 5 минут (300 секунд). В этом расширении собственное задание также получает заявки сайта и подтверждает их резервы. Обновление описаний карточек раз в 2 дня пока выключено. После установки в вашей базе приём товаров и путь заказа проверяются отдельно.
Закройте форму, сохранив условия работы 1С.
После включения окно модуля можно закрыть. В файловой базе должен оставаться работающий сеанс 1С; в серверной базе условия выполнения регламентных заданий проверяет администратор сервера.
Для первой проверки оставьте условия работы 1С неизменными до подтверждения нового автоматического приёма на сайте.
Проверьте именно завершённый автоматический обмен.
Нажмите «Показать состояние автообновления» и проверьте дату завершённого автоцикла. Затем сверяйте новый приём цены и свободного остатка в кабинете. Сообщение «включено» ещё не означает, что данные уже дошли до сайта.
В тестовой 1С подтверждены последовательные автоматические обновления цены и свободного остатка примерно каждые пять минут, без ручного запуска. После подключения вашей базы нужно отдельно подтвердить такой же приём. Если показывается блокировка внешних ресурсов или нет завершённого автоцикла, действуйте по следующему разделу.
Остановите расписание при необходимости.
Нажмите «Остановить автообновление», затем проверьте состояние. Сохранённый ключ остаётся для следующего включения. Если прежняя отправка ещё выполняется, дождитесь её завершения и повторно проверьте состояние.
Кнопка «Забыть сохранённый ключ» — отдельное действие. Она не нужна для обычной остановки; отзыв ключа в кабинете сайта также выполняется отдельно.
6. Как принимаются заказы и подтверждаются резервы
Поставщик и администратор 1С; свою установку проверяют отдельно
Сверьте подтверждённый этап проверки.
8 октября 2026 года в тестовой «УТ11-Копии» 11.5.22.67 подтверждена имитация заказа сайта: собственное регламентное задание получило заявку, создало и провело один заказ на 1 единицу, проверило резерв и отправило подтверждение сайту. Последующие естественные циклы не создали второй документ или резерв. Реальный заказ маркетплейса и физическая передача товара в этом испытании не выполнялись.
Обмен выполняется собственным заданием модуля. Дополнительный ручной запуск тестовых команд поставщику не нужен. После установки в вашей базе администратор отдельно проверяет тот же путь с вашими товарами, складом и соглашением.
Получайте заказы своего подключения и склада.
Модуль получает ожидающие резервирования заявки сайта для вашего номера поставщика и сохранённого склада. Заказ содержит товар, количество, срок подтверждения и закреплённое направление передачи. Обработка использует сохранённый выбор товаров и соответствия с номенклатурой вашей 1С. Тестовое направление из имитации не применяется к реальным заказам.
Если товар исключён из обмена, изменён склад или нарушены условия соглашения, модуль не должен подменять их другим товаром, складом или контрагентом. Администратор исправляет конкретную причину; уже сохранённые заказы и история остаются для сверки.
Подтверждайте полный фактический резерв.
Модуль должен создать или продолжить тот же заказ в 1С и подтвердить сайту результат только после проверки нужного товара и полного количества в резерве. Например, для заявки на 3 единицы резерв 1 единицы не считается успешным выполнением заявки.
Отправка запроса в 1С и создание документа сами по себе не означают подтверждённый резерв. Сайт должен получить ответ о результате. При неподтверждённом резерве дальнейшая подготовка этого заказа ожидает; другие заявки могут обрабатываться независимо.
Продолжайте прежний заказ после сбоя.
При обрыве связи повтор должен использовать сохранённый заказ и прежний результат резерва. Не создавайте второй заказ вручную только потому, что сайт ещё не получил подтверждение; сначала сверяйте прежнюю заявку и документ 1С.
Срок заявки задаёт сайт. Повтор не продлевает его автоматически. Если срок прошёл или данные заказа изменились, требуется сверка состояния; удалять журнал обмена и выдавать старый резерв за новый результат нельзя. Проверенные естественные повторные циклы не создали дубль; искусственная потеря ответа в этом испытании отдельно не проверялась.
Отдельно проверяйте готовность и фактическую отгрузку.
Подтверждение резерва означает, что товар закреплён за заказом. Оно не означает, что товар уже собран или отгружен. Сообщения о готовности и отгрузке должны опираться на фактические действия и документы вашей 1С; их полный маршрут через модуль ещё не подтверждён.
Этикетки и документы маркетплейсов подготавливает сайт по своему расписанию. Проверка товаров и печать в фулфилменте относятся к отдельному этапу и не заменяют подтверждение резерва поставщика.
7. Найдите реквизиты «Бери товар» для ЭДО
Поставщик в своём кабинете на сайте
Откройте раздел «Документы через ЭДО».
В кабинете поставщика сайт показывает реквизиты получателя «Бери товар», которые заполнил администратор: название, ИНН, оператор, контур и идентификатор участника ЭДО. Поставщик не вводит за нас эти реквизиты.
Если реквизиты ещё не настроены или временно недоступны, кабинет покажет это прямо. Отсутствующий идентификатор не заменяется примером; повторно откройте страницу после настройки или восстановления доступа.
Скопируйте именно идентификатор участника ЭДО.
В поле «Идентификатор участника ЭДО «Бери товар»» нажмите «Копировать». Если браузер не разрешил копирование, выделите значение в поле и скопируйте его вручную.
Номер поставщика нужен для подключения модуля 1С, ключ нужен для защищённого обмена с сайтом, а идентификатор ЭДО нужен для поиска получателя у вашего оператора ЭДО. Это разные значения; идентификатор ЭДО не вставляют в поле «Ключ подключения».
Проверьте контур и дождитесь подключения.
Тестовые реквизиты предназначены для тестового контура. Рабочие реквизиты появятся после настройки администратором. Подключение оператора и автоматический приём документов ещё готовятся.
После подтверждения подключения найдите «Бери товар» по скопированному идентификатору в кабинете своего оператора, сверьте получателя и отправьте приглашение к обмену. Отправку документов согласуйте после принятия приглашения. Наличие поля для копирования само по себе не означает, что обмен документами уже работает.
8. Если обмен не запускается или данные не обновляются
Поставщик и администратор 1С
Если 1С сообщает о копии базы или внешних ресурсах.
Обратитесь к администратору 1С. Подтверждённый путь проверки заданий: НСИ и администрирование → Обслуживание → Регламентные операции → Регламентные и фоновые задания. Проверяется собственное задание модуля «Бери товар».
Поставщику не нужно самостоятельно снимать общую блокировку копии. Такое разрешение может запустить и остальные интеграции базы; решение принимает администратор после проверки их изоляции.
Если сохранённый доступ отсутствует или не подтверждён.
Проверьте «Показать состояние автообновления». «Не подтверждено» не означает, что ключ отсутствует. Администратор проверит права и собственное хранилище модуля. При подтверждённом отсутствии используйте действующий ключ и «Подключить и сохранить ключ»; не создавайте новый ключ без необходимости.
Если соединение или отправка не подтверждены.
Проверьте доступ 1С к сайту, действительность ключа и правильность номера поставщика. Передайте администратору понятное сообщение и время ошибки без самого ключа. Сохранённую неподтверждённую отправку не удаляйте ради повторного запуска.
Если изменён выбор товаров или настройки.
Остановите автообновление и дождитесь прежней операции. Сохраните нужные настройки, заново проверьте товары и включите расписание. Новые товары сначала синхронизируются вручную; история уже принятых отправок сохраняется.
Исключение товара из выбора останавливает его последующие обновления из 1С. Само по себе оно не снимает товар с продажи на сайте и не удаляет прежние заказы. Остановку продаж согласуйте отдельно в кабинете.
Если обработка заказа или ответ о резерве не подтверждены.
Передайте ответственному за обмен номер заявки сайта, номер созданного документа 1С, время и понятное сообщение об ошибке. Проверьте склад, полный резерв и действующее соглашение. Не передавайте ключ подключения.
Сначала сверяется прежний заказ и сохранённый результат. Повторное получение или отправка ответа не должны создавать второй резерв. Не очищайте собственные журналы модуля и не удаляйте документы ради нового запуска. Для вашей базы приём заказа и подтверждение резерва проверяются отдельно от готовности и физической отгрузки.
Если обновляется сама 1С или модуль.
Сначала остановите автообмен, дождитесь текущей операции и сделайте резервную копию. Администратор проверяет совместимость и применяет обновление расширения. После нового сеанса загрузите настройки, проверьте сохранённый доступ и выбор, затем отдельно включите автообновление и подтвердите новый приём на сайте.
Возможности и ограничения этой версии
Файл для самостоятельной установки
Доступен .cfe версии 0.9.0 для УТ 11.5.22.67. Файл совпадает с проверенным расширением; ключи и данные тестовой базы в него не входят.
Ручная передача товаров
В тестовой копии подтверждены передача карточки, двух фотографий, цены и свободного остатка. Совместимость вашей базы проверяется отдельно.
Сохранение ключа
Подтверждены запись, чтение и наличие сохранённого доступа в новом сеансе 1С.
Цена и свободный остаток по расписанию
В тестовой 1С подтверждено несколько последовательных обновлений примерно раз в 5 минут, без ручного запуска. При подключении вашей базы расписание проверяется отдельно.
Описательные данные карточек
Интервал раз в 2 дня (172800 секунд) запланирован; автоматическое обновление пока выключено.
Приём заказа сайта и подтверждение резерва
В тестовой УТ 11.5.22.67 собственное задание приняло одну имитацию заявки, провело один заказ на 1 единицу и подтвердило резерв сайту. Повторные естественные циклы сохранили один документ и один резерв.
Готовность, отгрузка и физическое поступление
В этом испытании не выполнялись. Документ поступления на сайте создан по подтверждению резерва; он не доказывает физическое получение товара на реальном складе фулфилмента.
Реквизиты ЭДО в кабинете поставщика
Идентификатор получателя берётся из настроек администратора и доступен для копирования. Подключение оператора и обмен документами проверяются отдельно от модуля.
Для «Управления торговлей 11.5.22.67»: скачайте расширение выше и передайте администратору 1С. После установки подключите свой номер и ключ, выберите товары, выполните первую синхронизацию и отдельно включите расписание.
Цены и свободные остатки выбранных товаров обновляются примерно раз в пять минут. Модуль также получает заявки сайта и подтверждает резерв. Автоматическое обновление описаний раз в два дня в этом выпуске выключено.
После одобрения выпустите ключ в кабинете и сохраните его на сервере своей системы.
Проверьте доступ через health. Передавайте карточки через products, а подтверждённые остатки по каждому складу — через stocks. Для products — до 500 строк и 2 МБ; для stocks — до 1 000 строк и 1 МБ. Это разные запросы и ограничения.
Для заказов настройте получение reservations и ответ о фактическом резерве. Результаты загрузки и причины ошибок видны в журнале кабинета.
Скачайте шаблон ниже и заполните JSON, CSV или XML реальными данными. Сохраните стабильные ID товаров и складов, цену, количество и время обновления.
В кабинете выберите файл в блоке «JSON, CSV или XML» и нажмите «Проверить и загрузить». Максимум — 5 МБ и 5 000 товаров.
Прочитайте, сколько строк принято и отклонено. Исправьте указанные поля и загрузите те же ID повторно. Заявки на резерв обрабатываются отдельно в кабинете или через API.
Разместите JSON, CSV или XML по прямому HTTPS-адресу. Это должен быть файл с данными, а не страница входа или предпросмотра.
В кабинете откройте «Фид, SFTP и email» → «Фид по HTTPS». Укажите ссылку, формат, интервал 5, 15, 30 или 60 минут и, при необходимости, Bearer-токен источника.
Нажмите «Сохранить», затем «Проверить источник». Сверьте результат в «Последних проверках» и время последней успешной загрузки. Сохранение источника задаёт расписание; фактический запуск обеспечивает работающий сервис обмена. Сверьте несколько последовательных успешных загрузок, а не только включённую настройку.
Обновляйте содержимое и время подтверждения остатков в самом файле. Повтор старого файла не подтверждает свежесть товара. Интервалы 30 и 60 минут сами по себе не обеспечивают обновление остатков раз в 15 минут: для такого каталога отдельно согласуйте и подключите частый канал остатков. Заявки и ответы на резерв настраиваются отдельно через API или кабинет.
SFTP — файл на вашем сервере
Подготовьте сервер, порт, пользователя, точный путь к JSON, CSV или XML и пароль либо SSH-ключ. Передавайте доступ только к нужному файлу.
В блоке SFTP кабинета укажите эти настройки, формат и интервал 5, 15, 30 или 60 минут. Нажмите «Сохранить».
Перед первой загрузкой администрация «Бери товар» подтверждает отпечаток ключа SFTP-сервера, сверенный с его владельцем. Затем нажмите «Проверить источник» и сверяйте результат и время последнего успешного обновления.
Замена ключа сервера требует повторного подтверждения. Ошибка доступа показывается в журнале и не удаляет ранее принятый каталог. После ошибки следующая автоматическая попытка выполняется по сохранённому интервалу; доступна и ручная проверка. Интервалы 30 и 60 минут не заменяют требуемый частый канал остатков. Чтение SFTP-файла не отправляет заказы: подключите API заявок или назначьте сотрудника для кабинета.
Email — после подключения домена
В кабинете в блоке «Файлы по email» нажмите «Создать адрес импорта». Используйте только показанный персональный адрес своей организации.
Проверьте состояние почтового канала: приём начинается после настройки входящего домена администрацией сервиса. Само создание адреса ещё не включает доставку писем.
При действующем канале отправьте одно вложение JSON, CSV или XML до 5 МБ. Архивы и ссылки в тексте письма не обрабатываются.
Проверьте время приёма и результат в кабинете. Если подтверждения нет, не считайте остатки обновлёнными. Получение письма зависит от настроенного почтового канала; сайт не гарантирует интервал поступления вложений. Заказы и ответы на резерв обрабатываются отдельно через API или кабинет.
Все способы сохраняют товары в один каталог поставщика. Выберите основной способ и обновляйте прежние ID: не создавайте дубли при смене канала. Передача каталога и получение заказов — отдельные процессы. HTTPS, SFTP, email и загрузка файла сами по себе не подтверждают резерв в вашей учётной системе.
02
Обязательные данные товара
Поле
Что передавать
Требование
externalId, sku
Уникальный ID и артикул
Не менять после публикации
name, category
Название и категория
Название обязательно; категория нужна для подготовки карточки
barcodes
Один или несколько штрихкодов
Уникальные и действующие
price, currency
Закупочная цена и валюта
RUB для первого запуска
availableQuantity
Доступно для резервирования
Целое число от 0 до 10 000 000; ноль тоже передаётся
warehouseId
Склад поставщика
Стабильный ID
images
Прямые HTTPS-ссылки
С правом использования
updatedAt, status
Время изменения и состояние
ISO 8601; active / inactive
packageLengthCm, packageWidthCm, packageHeightCm
Размеры упаковки в сантиметрах
Все три больше нуля для полной загрузки
weightKg, packageWeightKg, packageCount
Предоставленный вес в килограммах; отдельно известный вес брутто и число упаковок
weightKg сам по себе не подтверждает брутто; расширение 1С сохраняет отдельно предоставленный packageWeightKg
description, brand, country, characteristics
Описание, бренд, страна и именованные характеристики
Передавайте фактические данные; обязательность характеристик зависит от предмета площадки
tnved
Код ТН ВЭД изготовителя или поставщика
Передавайте вместе с товаром, если код известен: строка из 10 или 14 цифр с сохранением ведущих нулей. Допустимость и обязательность проверяются отдельно для выбранной категории каждой площадки.
Приём строки не означает допуск товара к селлеру. Неполные данные сохраняются для доработки без ИИ-запросов. Для расширения 1С УТ 11.5 с source: one_c_ut_11_5 отсутствие категории, штрихкодов, фотографий, упаковочных данных, характеристик или ТН ВЭД не блокирует приём. Подсказки возвращаются отдельно от ошибок и доступны поставщику в кабинете, в «Последних проверках», под «Что дозаполнить». Переданные значения проверяются по формату и безопасности. HTTPS-ссылка ещё не доказывает доступность фото; категория и обязательные характеристики каждой площадки проверяются отдельно. В CSV поле characteristics передаётся как JSON-объект внутри ячейки.
Проверьте, заполнен ли ТН ВЭД в карточках товаров вашей 1С. Для некоторых категорий маркетплейсы требуют этот код. После заполнения повторите обмен — данные обновятся в существующих карточках. При загрузке файла передавайте код вместе с тем же ID товара.
Остатки учитываются отдельно для каждой пары товара и склада. Передавайте время подтверждения остатка в updatedAt для каждого склада, даже если количество не изменилось. Повтор той же версии с тем же количеством безопасен, но не продлевает срок актуальности; другое количество с той же датой отклоняется. Обновление одного склада не подтверждает остатки остальных.
В карточке товара описание и цена обновляются независимо от остатков. Если одна часть переданной строки устарела, сохраняется её более новая версия; принятая часть и причины пропуска отражаются в результате импорта.
POST/api/supplier/v1/products
Передать от 1 до 500 карточек товаров в одном запросе.
POST/api/supplier/v1/stocks
Передать до 1 000 остатков. Пустой список подтверждает доступность обмена, но не обновляет актуальность товаров.
GET/api/supplier/v1/health
Проверить состояние обмена, число товаров и время последнего обновления.
GET/api/supplier/v1/reservations?status=pending
Получить новые запросы на резервирование только для своего каталога.
PATCH/api/supplier/v1/reservations
Подтвердить резерв с собственным номером или отклонить его; после подтверждения отдельно сообщить готовность и отгрузку.
Доступ: только HTTPS и Bearer-ключ из кабинета одобренного поставщика. Ключ передаётся в заголовке, не в адресе. Загрузка товаров сохраняет их в каталоге. Для проверки связи без настоящего заказа используйте отдельный пробный обмен ниже.
Доступ и первый запрос
После одобрения заявки откройте карточку ключа и нажмите «Создать ключ». Сохраните полный ключ: позже кабинет показывает только его маску.
Базовый адрес — HTTPS-адрес сайта, где открыт кабинет. Добавьте к нему путь запроса из инструкции. Все приведённые ниже адреса относительные, для этого же сайта.
Передавайте заголовок Authorization: Bearer ВАШ_API_КЛЮЧ; для JSON добавляйте Content-Type: application/json. Каждый ключ даёт доступ только к своему поставщику.
Выполните GET /api/supplier/v1/health. Успешный ответ подтверждает доступ, а состояние каталога находится в status. Он не доказывает обработку заказов вашей системой.
При замене или отзыве ключа старый перестаёт работать. Обновите ключ в своей системе и повторите пробный обмен. Не вставляйте его в URL, клиентский JavaScript, скриншоты и общие журналы. API использует Bearer-ключ; готовый модуль для конкретной учётной системы поставщик настраивает на своей стороне.
Описание можно импортировать в совместимый инструмент для работы с API. Даты, изображения, ID товаров и ответные токены в примерах вымышлены: замените их фактическими значениями. Запросы загрузки на рабочем сайте сохраняют данные.
Карточки товаров: запрос, поля и результат
POST /api/supplier/v1/products: от 1 до 500 строк, до 2 МБ. Поддерживается объект products или массив строк.
Постоянный ID и артикул, строки до 100 знаков. Не меняйте ID при повторной загрузке и не используйте заново для другого товара.
name / category
Название до 300 знаков обязательно. Категория до 200 знаков нужна для подготовки карточки.
price / currency
Закупочная цена в рублях, больше 0 и не более 100 000 000; валюта RUB. Пример: 1250.50.
availableQuantity / warehouseId
Точное целое количество от 0 до 10 000 000 и постоянный ID склада до 100 знаков.
updatedAt / status
Дата и время с часовым поясом; active либо inactive. Время более чем на 5 минут в будущем отклоняется.
barcodes / images
Списки переданных поставщиком штрихкодов и фотографий. Штрихкоды — 8–14 цифр; фото — HTTPS-ссылки. Дополнительные вложенные сведения сохраняются в карточке товара.
description / brand / country / characteristics
Фактическое описание, бренд, страна и объект именованных характеристик.
Размеры упаковки в см, предоставленный поставщиком вес в кг и число упаковок. Само поле weightKg не подтверждает, что вес является брутто.
Обязательные для приёма строки поля: externalId, sku, name, price, currency, availableQuantity, warehouseId, updatedAt, status. Отсутствующие категория, фото и характеристики могут сохраняться для доработки. Это не подтверждение готовности к продаже.
Передавайте вместе с товаром все имеющиеся сведения: состав, комплектацию, варианты, подробные характеристики, документы, файлы и реквизиты сертификатов и деклараций. Можно добавлять свои поля и вложенные JSON-объекты. Они сохраняются внутри той же карточки товара и используются для сопоставления после выбора категории. Эти дополнительные поля не обязательны; отсутствующие значения не нужно придумывать. В повторном запросе пропущенное дополнительное поле сохраняет прежнее значение, а переданные объект, список или null заменяют это поле целиком. Ключ доступа передавайте только в заголовке запроса.
Всегда читайте result.accepted, result.rejected и result.issues. HTTP 200 возможен при частичной загрузке. Если ни одна строка не принята, возвращается 422. В ошибках указаны номер строки, поле и пояснение; нумерация начинается с 2 для совместимости с файлами, где первая строка — заголовки.
Сохраните результат, исправьте отклонённые строки и отправьте их снова. Повтор неизменённой версии может быть отмечен как пропуск: он не создаёт новый товар и не подтверждает свежесть старых данных. Отсутствие товара в очередной загрузке не удаляет его.
Пакет расширения 1С:Управление торговлей 11.5
Для расширения передавайте объект с source: "one_c_ut_11_5" и массивом products. Сервер сохраняет предоставленные данные неполной карточки; недостающие сведения возвращаются в result.warnings для доработки. Без этого значения действует общий импорт, описанный выше. Принадлежность поставщику определяется ключом, а не полем supplierId в запросе.
Категория, штрихкоды, фотографии, размеры упаковки, вес, характеристики и ТН ВЭД не обязательны для приёма. Если они есть в 1С, передайте их вместе с карточкой; отсутствующие значения не нужно придумывать. Конечные нулевая цена и нулевой остаток допустимы для этого источника. Предоставленные значения проверяются по формату и безопасности: ссылки на фотографии должны быть HTTPS и не содержать логин или пароль. Проверка ссылок не означает, что фотографии скачаны или доступны.
Перед публикацией нужен положительный вес товара для расчёта логистики. Если вес отсутствует, карточка всё равно принимается, а поставщик получает подсказку о заполнении веса; публикация пока недоступна.
Платформа сначала сопоставляет категорию, затем определяет её обязательные характеристики для каждой площадки. В кабинете, в «Последних проверках», откройте «Текущие карточки: что дозаполнить»: там указаны название, артикул и конкретные недостающие данные. После заполнения в своей системе и следующего обмена текущая подсказка обновится; история прежнего приёма сохранится отдельно.
Используйте фактические данные 1С. Если известен вес брутто упаковки, передайте packageWeightKg; он может заполнить отсутствующий weightKg. Обычный weightKg сохраняется как предоставленный вес, без выдуманного назначения. Дополнительные размеры и вес упаковки фулфилмента не добавляются. Нулевой остаток допустим. Все строки с повторяющимся стабильным ID внутри пакета отклоняются, даже если одна из них ошибочна.
Для этого источника первая запись имеет номер 1. Причины и подсказки сохраняют исходные номера строк. После обмена поставщик видит их в кабинете, в таблице «Последние проверки»: ошибки — отдельно, сведения для доработки — в «Что дозаполнить». Подсказки не блокируют приём. HTTP 200 означает, что принята хотя бы одна строка; 422 — ни одной. Исправьте отклонённые строки и повторите их с теми же ID. Принятие ещё не означает допуск к продаже: требования каждой площадки проверяются отдельно.
Файлы используют те же поля: JSON — массив или объект products; CSV — заголовки полей и разделитель запятая, точка с запятой или табуляция; XML — корень products, элементы product. В CSV списки можно разделять знаком |, а характеристики передаются JSON-объектом с экранированием кавычек. Сохраняйте штрихкоды и артикулы как текст, чтобы не потерять ведущие нули.
Остатки и изменение цены
POST /api/supplier/v1/stocks: до 1 000 строк, до 1 МБ. Сначала передайте карточку товара через products.
Один товар на двух складах — две строки с разными warehouseId. Передавайте ноль явно. Пустой массив stocks: [] допустим, но не обновляет время подтверждения ни одного товара.
Дата относится к конкретному складу. То же время с другим количеством — конфликт; то же время и то же количество не продлевают актуальность. Передавайте новую дату только после проверки текущего остатка, даже если число не изменилось. Старое обновление не заменяет более новое.
Цену, описание и другие сведения обновляйте полной карточкой через products. Карточка и остатки учитываются независимо: новая цена может сохраниться, а устаревший остаток из той же строки — быть пропущен. Результат отражает причины пропуска.
Заказы: получение и подтверждение резерва
Через кабинет: сотрудник проверяет наличие, резервирует товар в своей системе и указывает номер резерва либо отклоняет заявку. Через API: те же действия выполняет ваша интеграция; к отказу можно добавить пояснение. Для обработанных через API заявок повторное ручное подтверждение не требуется.
GET /api/supplier/v1/reservations?status=pending&limit=200 — получить ожидающие ответа заявки прежнего формата, без закреплённого физического склада. По умолчанию до 100, максимум 200 записей. Без status возвращаются разные состояния.
Для заявок, закреплённых за физическим складом, используйте GET /api/supplier/v1/reservations?schemaVersion=2&warehouseId=warehouse-1001&status=pending&limit=200. Указывайте тот же точный ID склада, с которым передаёте его остатки. Название города не заменяет ID склада.
В ответе каждой заявки проверьте supplierWarehouseId до создания резерва в своей системе. Передавайте schemaVersion: 2 и тот же warehouseId также в каждом подтверждении, отказе, сообщении о готовности и отгрузке. Заявка другого склада отклоняется без изменения её состояния.
Прежний запрос без номера склада не получает эти заявки и не может их подтвердить. Сохранённые заявки прежнего формата не переносятся на выбранный склад автоматически. Для модуля 1С поддержка этого формата должна быть проверена в совместимой версии расширения перед его установкой.
id — наш ID заявки; externalProductId — ваш ID товара; sku — артикул; quantity — количество для резерва. purchasePriceKopecks передаётся в копейках, в отличие от цены карточки в рублях. deadlineAt — крайний срок ответа.
Специалист поставщика настраивает опрос на стороне своей системы; в качестве примера — раз в 10–15 секунд. Согласуйте интервал и пропускную способность для своего подключения. Завершайте резерв и ответ до deadlineAt; срок заявки — две минуты. Такой опрос на стороне поставщика не включается автоматически при создании ключа.
Сохраняйте соответствие нашего ID и номера резерва у себя. Повторное получение той же заявки должно находить существующий резерв, не создавать второй. Один заказ может содержать несколько заявок на разные позиции.
Подтверждайте только фактически зарезервированное полное количество. Если выполнить заявку нельзя, отправьте отказ с пояснением. Менять количество в ответе нельзя.
При потере ответа повторите то же решение для того же ID. При конфликте перечитайте статус и разберите причину, не создавая новый резерв автоматически.
PATCH /api/supplier/v1/reservations, до 20 000 байт:
Для подтверждения обязателен непустой externalReservationId до 200 знаков. Необязательное message сохраняется до 500 знаков. Повтор уже принятого решения возвращает сохранённую запись; изменить завершённое решение нельзя.
После подтверждения для назначенного фулфилмента создаётся ожидаемый акт приёмки по этой заявке. Подтверждение резерва ещё не означает, что товар доставлен или принят: приёмку отмечает склад. Номер резерва показывается в акте для сверки. Одинаковые номера разных заявок не объединяют их в одну поставку.
Статус
Значение
pending
Ожидает резервирования и ответа до deadlineAt.
confirmed
Поставщик подтвердил резерв с собственным номером.
rejected
Поставщик отказал.
expired
Срок ответа истёк. Позднее подтверждение отклоняется.
Куда передать товар
В ответах для конкретного склада (schemaVersion=2 и точный warehouseId) API показывает fulfillmentDestination: ID, название и адрес фулфилмента, куда поставщик передаёт товар. Поля назначения и этапов отгрузки есть только в этом формате. Прежний ответ без пары версии и склада содержит состояние резерва без этих полей. Адрес закрепляется при создании заявки и сохраняется для неё; дальнейшее изменение настроек склада не меняет адрес этой заявки.
Назначенный склад для передачи товара
{
"fulfillmentDestination": {
"id": "40000000-0000-4000-8000-000000000001",
"name": "Пример фулфилмента",
"address": "Тестовый город, Складская улица, дом 1"
},
"fulfillmentDestinationIssue": null
}
Используйте fulfillmentDestination.address для передачи товара назначенному фулфилменту. Это адрес склада фулфилмента, а не пункт приёмки маркетплейса. Запросы готовности и отгрузки не содержат нового адреса: назначение определяет «Бери товар». Контакты, график приёмки и другие отсутствующие данные не подставляются автоматически.
Если fulfillmentDestination равен null, не оформляйте автоматическую отгрузку. Причина находится в fulfillmentDestinationIssue; обратитесь в «Бери товар» для проверки этой заявки.
Причина
Что делать
not_assigned
Для заявки не был назначен фулфилмент. Попросите «Бери товар» проверить, куда передавать товар.
ambiguous
Для заявки найдено несколько назначений. Попросите «Бери товар» определить единственный склад.
destination_incomplete
В сохранённом назначении не хватает названия или адреса. Передача требует уточнения у «Бери товар».
snapshot_missing
В старой заявке не сохранён адрес передачи. Нужна проверка «Бери товар»; сегодняшние настройки не заменяют адрес старой заявки.
Готовность и отгрузка после подтверждения резерва
Получение заявки вашей системой не подтверждает резерв. После фактического резервирования и сохранённого status: confirmed сообщайте этапы поставки отдельными запросами на тот же адрес PATCH /api/supplier/v1/reservations. Для готовности и отгрузки обязательны schemaVersion: 2 и тот же warehouseId; формат без склада эти действия не принимает. Примеры ниже относятся к складу warehouse-1001 и к уже подтверждённой заявке этого склада.
Готовность зарезервированного товара
{
"schemaVersion": 2,
"warehouseId": "warehouse-1001",
"reservationId": "20000000-0000-4000-8000-000000000001",
"shipmentStatus": "ready",
"message": "Товар готов к передаче"
}
Порядок: подтверждённый резерв → shipmentStatus: ready → shipmentStatus: shipped. При ready номер отгрузки не передаётся. Для новой shipped обязателен непустой externalShipmentId до 200 знаков, полное сохранённое fulfillmentDestination и отсутствие fulfillmentDestinationIssue. Отгрузка без предыдущей готовности, неподтверждённый резерв, обратный переход или отсутствие полного назначения отклоняются с 409.
Не смешивайте в одном запросе status и shipmentStatus либо номера резерва и отгрузки. Необязательное message этапа поставки после удаления пробелов по краям — до 500 знаков. Повторяйте тот же этап с тем же номером и сообщением: идентичный повтор безопасен, изменённый даёт 409. Сервер сохраняет отдельные readyAt и shippedAt; статус резерва остаётся confirmed.
Если отгрузка уже была сохранена, точный повтор прежнего номера и сообщения возвращает её сохранённое состояние даже для старой заявки без полного адреса. Такой повтор не разрешает новую отгрузку и не создаёт второй документ.
Для продолжения поставок читайте GET /api/supplier/v1/reservations?schemaVersion=2&warehouseId=warehouse-1001&status=confirmed и проверяйте shipmentStatus: null, ready или shipped. Параметр status относится к резерву, поэтому status=ready не выбирает готовые отгрузки. Отметка shipped сообщает об отгрузке поставщиком; фактическую приёмку отдельно подтверждает склад.
Ответ содержит максимум 200 записей без курсора продолжения. Обработайте полученные ожидающие заявки и запросите список снова. Если такой объём накапливается постоянно, заранее согласуйте пропускную способность интеграции, чтобы укладываться в срок резерва.
Пробный обмен без настоящего заказа
Проверка показывает получение пробной заявки и ответ вашей системы с текущим ключом. Она не резервирует товар, не списывает деньги и не публикует каталог. Сначала специалист подключает два запроса ниже, затем сотрудник запускает проверку в блоке «Получение заказов» кабинета.
GET /api/supplier/v1/connection-test с тем же Bearer-ключом получает пробную заявку и отмечает факт её получения:
До expiresAt получите пробную заявку и отправьте подтверждение: на оба действия даётся десять минут с запуска проверки. Из GET возьмите ID и ответный токен. Повторный GET активного теста возвращает тот же токен. Если активного теста нет, ответ — {"ok":true,"test":null}.
PATCH /api/supplier/v1/connection-test подтверждает получение. Подставьте фактические значения из GET, а не пример из документации:
В кабинете результат появится автоматически. Если срок истёк, исправьте настройки и запустите новую проверку. Новый тест или замена ключа отменяет предыдущую проверку. Повтор подтверждения пройденного теста безопасен при том же действующем ключе.
«Пробный обмен прошёл» подтверждает связь, но не проверяет фактическое резервирование в вашей системе. Проверка предназначена для подготовки подключения и не добавляет обязательного действия к уже работающему обмену.
Ошибки API и повторные запросы
Ответ
Действие
200
Прочитайте тело ответа. При загрузке часть строк может быть отклонена: изучите result и issues.
400
Исправьте JSON, количество строк или обязательные поля; причина находится в message.
401
Проверьте Bearer-заголовок, действующий ключ и одобрение заявки. Не повторяйте бесконечно запрос с отозванным ключом.
409
Прочитайте message. Возможны конфликт резерва, неверный этап поставки, изменённый повтор, отсутствие назначения фулфилмента, истёкший/заменённый пробный тест или обслуживание каталога. Получите актуальное состояние.
413
Разделите пакет, учитывая число строк и размер JSON в байтах.
422
Ни одна строка не принята. Исправьте причины в issues и отправьте исправленный пакет.
503 / другая серверная ошибка
Сохраните очередь и повторите с увеличивающейся паузой. Для резервов учитывайте deadlineAt.
Нет ответа
Операция могла сохраниться. Повторяйте те же ID и данные, не создавайте второй товар или резерв.
При временной ошибке сохраняйте ту же заявку и прежний номер фактического резерва. После потери ответа прочитайте текущее состояние с той же версией и складом, затем при необходимости повторите прежний ответ. Не создавайте новый резерв ради повторной отправки. В журнале своей интеграции сохраняйте время, путь запроса, ID заявки или пакета и результат. Ключ и ответный токен проверки в журнал не записывайте. Если принятый товар ещё не виден селлерам, проверьте подготовку карточки и свежесть остатков, не загружайте его под новым ID.
Перед началом работы с заказами
Карточки имеют стабильные ID; ошибки строк видны и исправляются.
Нулевой остаток доходит до сайта; каждый склад обновляется отдельно в пределах регламента.
Пробный обмен прошёл через вашу систему с рабочим ключом.
Ваша система создаёт резерв один раз, возвращает его номер и отказывает при нехватке.
После подтверждённого резерва готовность и отгрузка передаются отдельно, в правильном порядке; повтор не создаёт вторую отгрузку.
Назначен сотрудник, который заметит сбой интеграции и разберёт заявки в кабинете.
Проверены подготовка и допуск товаров. Проверка связи не заменяет проверку каталога.
04
Обязательный регламент актуальности
Остатки
Обновление до 15 минут; обнуление сразу.
Резерв
Подтверждение или отказ не более 2 минут.
Цены и карточки
До вступления изменения в силу.
Сбой
Уведомление сразу после обнаружения.
Изменение API
Не менее чем за 10 рабочих дней.
Контроль
Техническая проверка и журнал обновлений.
Остатки проверяются отдельно по каждому товару и складу. Возраст данных считается по более раннему из updatedAt поставщика и времени приёма этой версии сайтом. Повтор прежней версии, пустой список stocks и обновление другого товара или склада не продлевают актуальность этих остатков. Для обычных каналов возраст более 15 минут даёт предупреждение, а данные старше 30 минут не считаются актуальными. Для источника 1С действует отдельный срок: по умолчанию 600 секунд; текущее значение возвращает health в limits.oneCStockMaxAgeSeconds. Эти сроки относятся к возрасту данных, а не к частоте загрузки каталога. Неизвестные и просроченные остатки не используются как подтверждение новой доступности товара. После приёма актуальных данных их пригодность проверяется заново. Проверка на сайте не подтверждает изменение остатков на внешней площадке; ранее принятые заявки этим не отменяются.
05
Когда данные не принимаются
• отсутствует обязательное поле или стабильный ID;
• цена отрицательная или валюта неизвестна;
• остаток не является целым неотрицательным числом;
• фото недоступно по HTTPS или нет права использования;
• время изменения старше ранее принятой версии;
• данные переданы с отозванным или недействительным ключом.