Просмотр заказов интернет-магазина InSales по API: обработка только для чтения (open-source)

Назначение обработки

Эту обработку можно использовать в разных целях. Например:

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

Обработка бесплатная: она читает заказы InSales через API (программный интерфейс магазина) и показывает их в форме 1С: по полям и исходным ответом магазина.

Что это

Один файл .epf, внешняя обработка. Конфигурацию она не меняет, прикладных данных (документов, справочников, регистров) в базу не пишет, в магазин ничего не отправляет, обращается только к магазину и пароль ключа не хранит. Свои настройки держит в хранилище общих настроек.

Рисунок 1. Общий вид: настройки свёрнуты, внизу состав выделенного заказа

Для начала

Ключ доступа создаётся в кабинете магазина, в разделе для разработчиков, пункт «Ключи доступа». У ключа два значения: идентификатор и пароль.

Обработку можно открыть через «Файл», «Открыть». Если в базе есть механизм дополнительных обработок, удобнее подключить её через «Дополнительные отчёты и обработки»: сведения для регистрации в обработке заполнены. Безопасный режим при подключении не включайте: в нём платформа запрещает исходящие соединения, и до магазина обработка не достучится.

Настройки лежат в сворачиваемой группе «Настройки подключения и отбора». При первом запуске разворачиваем её щелчком по заголовку, заполняем «Адрес магазина», «Идентификатор ключа» и «Пароль ключа», при медленной связи увеличиваем «Таймаут, с». Потом нажимаем «Проверить связь». Обработка делает один запрос и пишет в поле «Результат проверки» код ответа и его смысл обычными словами. При ошибке там будет объяснение: неверный ключ, нехватка прав, неверный адрес магазина, превышен лимит запросов или магазин не ответил вовремя.

Рисунок 2. Настройки развёрнуты, проверка связи вернула код 200

Что видно по заказу

Команда «Загрузить заказы» читает заказы за период постранично. Размер страницы задаёт поле «Заказов на странице», а «Не больше страниц» ограничивает обход. Загрузку можно остановить командой «Прервать», полученные заказы останутся в списке.

В списке видны номер на сайте, идентификатор, даты создания и изменения, покупатель, сумма, признак оплаты, статус выполнения, служба доставки, стоимость доставки и число строк.

Под списком шесть вкладок по выделенному заказу. На вкладке «Состав» видны артикул, наименование, штрихкод, количество, цена, сумма и скидка. «Покупатель» содержит фамилию, имя, телефон, почту, ИНН (идентификационный номер налогоплательщика), КПП (код причины постановки на учёт) и адрес доставки. Служба, её машинный код, пункт выдачи, стоимость, дата и описание собраны на вкладке «Доставка», а состояние оплаты, описание платежа, дата оплаты, итог по заказу и скидка на вкладке «Оплата и скидки». Произвольные поля заказа попадают в «Дополнительные поля» парами имени и значения. Весь JSON (текстовый формат, в котором магазин отдаёт данные) по заказу, с отступами, лежит на вкладке «Сырой ответ».

Характеристики обработка показывает: на вкладке «Состав» в колонке «Ключ сопоставления (товар / вариант)» стоит пара product_id / variant_id. У двух фасадов одной модели разного цвета первое число совпадает, а второе у каждого своё.

Рисунок 3. Вкладка «Состав»: варианты одного товара различаются вторым числом ключа

Рисунок 4. Вкладка «Доставка» по заказу с курьерской доставкой

Рисунок 5. Вкладка «Оплата и скидки» по тому же заказу

Рисунок 6. Вкладка «Сырой ответ», в ответе видно поле delivery_title

Протокол запросов

Каждое обращение к магазину попадает в таблицу «Протокол запросов». В ней колонки «Момент», «Метод», «Путь», «Код», «Длительность, мс», «Остаток лимита», «Попытка» и «Комментарий». Остаток лимита обработка берёт из заголовка API-Usage-Limit в ответе магазина.

Когда загрузка идёт медленно или обрывается, смотрим сюда. В колонке «Путь» виден точный адрес запроса вместе с параметрами отбора, поэтому ошибку в границе периода легко заметить.

Рисунок 7. Протокол запросов, в пути виден параметр updated_since

Период

Магазин отбирает заказы по дате изменения и принимает только нижнюю границу, поэтому в запрос уходит одно поле «Изменены с». Верхнюю границу из поля «Изменены по» обработка применяет сама к уже полученным заказам, и подсказка под периодом напоминает об этом.

Выгрузка и настройки

Команда «Выгрузить» собирает табличный документ со списком заказов и составом выделенного заказа. «Сохранить ответ» записывает ответ магазина по выделенному заказу в файл, который можно использовать для последующего анализа.

До следующего открытия обработка запоминает адрес магазина, идентификатор ключа, «Таймаут, с», «Заказов на странице» и «Не больше страниц». Даты периода не запоминаются, а пароль ключа приходится вводить каждый раз. Чтобы перенести настройки на другое рабочее место, есть «Сохранить настройки» и «Загрузить настройки». Пароль в файл настроек тоже не попадает.

Рисунок 8. Список заказов, выгруженный в табличный документ

Ограничения и возможные проблемы

В клиент-серверном режиме запросы к магазину выполняет сервер 1С, поэтому доступ в интернет и прокси нужны на сервере.

Открыть внешнюю обработку из файла может пользователь с правом интерактивного открытия внешних обработок. В типовых базах оно обычно есть только у администратора.

Если обработку подключили в безопасном режиме, связи с магазином не будет.

В заказах есть персональные данные покупателей. Обработка показывает их и по команде пользователя выгружает. За дальнейшую судьбу выгруженных данных отвечает тот, кто их выгрузил.

Проверено на

Платформа 8.5.1.1343. На каждой базе прогоняли один сценарий: проверка связи с верным и неверным ключом, неверный адрес, загрузка за период, заказ с характеристиками, карточка заказа, выгрузка, сохранение ответа и файлы настроек.

В пустой базе нет прикладных объектов, так что от конфигурации обработка не зависит.

Не проверялось:

• веб-клиент;
• 1С:Фреш;
• минимальный релиз платформы (на других версиях не запускали);

История версий

1.0 от 15.09.2026, первая публикация.

Исходный код и ошибки

Исходники открыты под лицензией MIT (лицензия Массачусетского технологического института).

Репозиторий: https://github.com/ooooo777/1c-insales-api-viewer

Об ошибках пишите в комментариях к публикации или в issues репозитория.