Назначение документа. Руководство описывает ежедневные операции оператора обмена: загрузку заказов из интернет-магазина на платформе InSales в 1С:Управление нашей фирмой (далее — УНФ) и контроль их статусов. Первоначальную настройку интеграции выполняет администратор.
Задачи оператора: – загружать заказы покупателей из магазина в УНФ; – проверять, что заказы загружены и получили статус; – сообщать администратору о пропущенных заказах и ошибках доступа.
Что выполняет администратор (оператору эти данные доступны только для просмотра): подключение магазина и ключ API, сопоставление товаров, контрагентов, складов, цен и служб доставки, расписание обмена, ограничения выгрузки остатков.
Документ содержит только те операции, которые доступны оператору. Полное описание настройки приведено в документе Руководство_пользователя_АПИМост_InSales.md.
Требования
- Учётная запись 1С с профилем «Оператор обмена InSales»: роль расширения «Выполнение обмена с маркетплейсом InSales» и типовой профиль на просмотр продаж. Профиль назначает администратор.
- В меню отображается раздел «АПИМост». Если раздел отсутствует, обратитесь к администратору.
Условные обозначения
- Текст в кавычках — надпись в интерфейсе программы: наименование команды, поля или флажка.
- Подпись «Рисунок» — иллюстрация к шагу. Снимки экрана сделаны под пользователем с правами оператора обмена.
Оглавление
- Права и возможности оператора
- Вход и раздел «АПИМост»
- Загрузка заказов из магазина
- Просмотр заказов и их статусов
- Просмотр сопоставления товаров (только чтение)
- Автоматическая загрузка по расписанию
- Действия в нештатных ситуациях – Глоссарий
1. Права и возможности оператора
| Действие | Доступ оператора |
|---|---|
| Просмотр раздела «АПИМост» и его списков | Разрешено |
| Загрузка заказов из магазина командой «Загрузить заказы» | Разрешено |
| Просмотр загруженных заказов и их статусов | Разрешено |
| Сопоставление товаров, склады, настройки учётной записи | Только просмотр |
| Изменение настроек, ключа API, сопоставлений, расписания | Выполняет администратор |
| Создание и изменение записей в списках интеграции | Не разрешено |
Почему прав оператора достаточно. При загрузке документы «Заказ покупателя» создаются программно, в привилегированном режиме, поэтому расширенные права на запись оператору не требуются. Задача оператора — запустить загрузку и проверить результат.
2. Вход и раздел «АПИМост»
Войдите в УНФ под своей учётной записью и выберите в меню раздел «АПИМост».
Рисунок 1. Раздел «АПИМост» и его команды (пользователь «Оператор InSales»).
Раздел содержит три команды:
- «Учетные записи маркетплейсов» — карточка подключения к магазину. Из неё запускается загрузка заказов; настройки карточки доступны только для чтения.
- «Заказы покупателей с сайта» — список загруженных заказов для контроля результата обмена.
- «Статусы публикации товаров InSales (АПМ)» — таблица сопоставления товаров, доступная оператору только для просмотра.
3. Загрузка заказов из магазина
Загрузка заказов — основная операция оператора обмена.
- Откройте «АПИМост» – «Учетные записи маркетплейсов» и выберите свою учётную запись; её наименование имеет вид «<Организация> (<магазин>)».
- Перейдите на вкладку «Заказы».
- В блоке отбора задайте период «Изменённые в период с … по …»; доступен быстрый выбор периода.
- Нажмите «Обновить» — будет получен список новых и изменённых заказов магазина.
- Выделите нужные строки и нажмите «Загрузить заказы».
Рисунок 2. Вкладка «Заказы»: фильтр периода, кнопка «Обновить» и кнопка «Загрузить заказы».
Важно. Карточка учётной записи открывается только для чтения: изменять настройки нельзя, но команда «Загрузить заказы» оператору доступна.
Если товар заказа не сопоставлен. При включённом режиме «Не загружать заказ, если номенклатура не найдена» заказ с несопоставленным товаром пропускается, а в панели «Сообщения» выводится наименование этого товара. Такой заказ загружается только после того, как администратор выполнит сопоставление товара (см. раздел 7).
4. Просмотр заказов и их статусов
Результат загрузки проверяется двумя способами:
- в списке «АПИМост» – «Заказы покупателей с сайта» — общий перечень загруженных заказов;
- на вкладке «Заказы» учётной записи — по колонке «Статус заказа».
Рисунок 3. Список загруженных заказов с колонкой «Статус заказа».
Статусы переносятся из магазина автоматически и соответствуют следующим значениям:
| Статус в магазине (InSales) | Статус в 1С |
|---|---|
new, accepted |
Ожидает сборки |
approved |
Готов к отгрузке |
dispatched, shipped |
Доставляется |
delivered |
Доставлен |
returning, returned |
Возвращён |
declined, cancelled |
Отменён |
Статусы обновляются при загрузке заказов, а если настроен автоматический обмен — также по расписанию. Документ заказа при этом не пересоздаётся: изменяется только статус.
5. Просмотр сопоставления товаров (только чтение)
Команда «Статусы публикации товаров InSales (АПМ)» открывает таблицу соответствия товаров магазина номенклатуре 1С. Оператор видит, какие товары сопоставлены — от этого зависит, загрузится ли заказ, — но изменять таблицу не может: команды «Создать» и «Записать» недоступны.
Рисунок 4. Список сопоставления товаров открыт на просмотр: кнопки «Создать» нет.
Если в колонке «Учётная запись» выводится «<Объект не найден>». Данные при этом не повреждены: сообщение означает, что администратору требуется донастроить доступ по организации (вид доступа «Организации»). На перечень товаров это не влияет. Сообщите администратору (см. раздел 7).
6. Автоматическая загрузка по расписанию
Администратор может включить автоматический обмен по расписанию. В этом режиме заказы загружаются, а статусы обновляются без участия оператора; одновременно в магазин передаются остатки и цены.
Задача оператора в этом случае — периодически проверять результат обмена (раздел 4). Загрузка вручную (раздел 3) требуется, если заказы нужны в 1С немедленно или автоматический обмен отключён.
7. Действия в нештатных ситуациях
| Ситуация | Действие |
|---|---|
| Раздел «АПИМост» отсутствует в меню | Обратитесь к администратору: не назначены роли доступа. |
| Учётная запись не открывается либо при открытии выводится ошибка | Сообщите администратору: требуется настроить вид доступа «Организации». |
| В колонке «Учётная запись» выводится «<Объект не найден>» | Та же причина: администратору нужно донастроить доступ по организации. |
| Заказ не загрузился, в сообщениях указано, что товар не сопоставлен | Сообщите администратору о несопоставленном товаре, после сопоставления повторите загрузку. |
| Команда «Загрузить заказы» недоступна | Обратитесь к администратору: требуется проверить назначенные права. |
| Загрузка не выполняется, выводится сообщение «Магазин … не активирован» | Сообщите администратору: требуется ввести лицензионный ключ в форме «Маркетплейс InSales», на вкладке «Лицензия». Ключ высылается после покупки на Инфостарт. |
| Требуется изменить настройку, ключ API, сопоставление или расписание | Эти действия выполняет администратор; оператору данные доступны только для просмотра. |
| Статус заказа не обновился | Статусы обновляются при загрузке и по расписанию. Повторите загрузку или дождитесь планового обмена. |
Глоссарий
- Учётная запись маркетплейса — карточка подключения к магазину InSales. Для оператора это точка запуска загрузки заказов; настройки доступны только для просмотра.
- Загрузка заказов — перенос заказов покупателей из магазина в 1С командой «Загрузить заказы».
- Статус заказа — состояние заказа, перенесённое из магазина: «Ожидает сборки», «Доставляется» и другие.
- Сопоставление товаров — соответствие товара магазина номенклатуре 1С. Выполняется администратором; без сопоставления заказ с этим товаром не загружается.
- Автоматический обмен — загрузка и выгрузка данных по расписанию без участия оператора.
Руководство оператора обмена для расширения «АПИМост» (интеграция 1С:УНФ с InSales). Редакция документа от 31.07.2026, соответствует версии расширения 1.0.