1. Сначала определите, какой у вас каталогнаверх
Первый запуск зависит не от размера магазина, а от того, где уже есть товары. Выберите свой случай:
Товары есть в 1С, сайт пустой
Привязка не нужна. Настройте каталог, сначала проверьте небольшую группу, затем выгружайте товары из 1С в OpenCart.
Товары есть на сайте, в 1С их нет
Загрузите товары из OpenCart в 1С. Обработка создаст номенклатуру и свяжет созданные позиции с товарами сайта.
Товары уже есть и в 1С, и на сайте
Сначала выполните первичную привязку. Это самый важный случай: без привязки одинаковый товар может быть воспринят как новая позиция.
Если товары есть в обеих системах: не начинайте с кнопки "Выгрузить товары" или "Полный обмен". Сначала перейдите к разделу "Связать существующие товары" ниже.
Для первого запуска используйте "Только проверка". Обработка выполнит проверку выбранной операции и покажет результат в журнале, но не изменит товары, цены, остатки, связи или документы.
2. Подготовьте подключениенаверх
- Установите и включите модуль на сайте.В панели администратора OpenCart откройте настройки модуля, включите его, создайте API-токен и при необходимости ограничьте доступ IP-адресом компьютера или сервера 1С.
- Откройте обработку Live 1C Exchange в 1С.На вкладке подключения укажите адрес API сайта и тот же токен. Адрес обычно выглядит так:
https://ваш-сайт.ru/index.php?route=extension/module/live_1c_exchange/api. - Разрешите обработке доступ к сайту.Если обработка просит разрешение на интернет-ресурс, нажмите и подтвердите адрес. При смене протокола, домена или порта разрешение нужно выдать заново.
- Нажмите "Проверить соединение".Если всё работает, сохраните настройки. Если нет - проверьте адрес API, токен, HTTPS и разрешённый IP.
API-токен - это пароль для обмена. Не публикуйте его и не присылайте в обычной переписке.
3. Если товары уже есть в 1С и OpenCart - сначала свяжите ихнаверх
Связь товара означает, что модуль запоминает: конкретная номенклатура в 1С и конкретный товар OpenCart - это одна и та же позиция.
Для первого поиска одинаковых товаров обработка сравнивает выбранное поле в 1С с выбранным полем OpenCart. После успешной привязки модуль сохраняет постоянную пару и дальше работает по ней. Поэтому SKU или Model не обязаны оставаться неизменными навсегда.
Что такое "Поле связи в 1С"
Это поле, значение которого обработка использует, чтобы один раз найти соответствующий товар на сайте. Можно выбрать Артикул, Код, Наименование, Полное наименование, обычный реквизит номенклатуры или дополнительный реквизит.
Отдельно выбирается "Поле связи OpenCart". В списке будут поля товара сайта, подходящие для поиска: например SKU, Model, название и другие доступные текстовые поля.
Важно: названия двух полей могут быть разными. Нужно, чтобы в них находилось одно и то же уникальное значение. Например, если Артикул 1С на сайте когда-то записывали в Model, выбирайте Артикул - Model.
Что выбрать: SKU, Model или другое поле
| Вариант | Когда использовать |
|---|---|
| Артикул 1С - SKU OpenCart | Рекомендуемый стандартный вариант. Используйте, если артикулы заполнены в обеих системах, совпадают и у разных товаров не повторяются. Эта пара выбрана в обработке по умолчанию. |
| Код 1С - Model OpenCart | Используйте, если при старом обмене или ручном заполнении именно код 1С сохранялся в Model товара OpenCart. |
| Артикул 1С - Model OpenCart | Подходит, если артикул фактически хранится на сайте в Model, а поле SKU используется для другого значения или пустое. |
| Доп. реквизит 1С - SKU / Model / другое поле | Хороший вариант, если в обеих системах уже есть специальный общий идентификатор товара. |
| Наименование - название | Используйте осторожно. Названия легко меняются, могут отличаться пробелами или написанием, а у нескольких товаров могут совпадать. |
Как понять, какое поле выбрать
- Откройте один и тот же товар в 1С и OpenCart.Посмотрите Артикул и Код в 1С, затем SKU и Model на сайте.
- Найдите одинаковое значение.Например, в 1С Артикул =
ABC-123, а на сайте SKU =ABC-123. Значит выбирайте "Артикул - SKU". - Проверьте несколько товаров.Одного совпадения недостаточно. Убедитесь хотя бы на 10-20 разных позициях, что выбранная схема используется одинаково.
- Проверьте уникальность.Одно значение должно обозначать один товар. Если один и тот же SKU или Model стоит у нескольких товаров, такое поле нельзя безопасно использовать для массовой привязки.
Как выполнить первичную привязку
- Выберите "Поле связи в 1С" и "Поле связи OpenCart".Не ориентируйтесь только на названия полей - ориентируйтесь на реальные одинаковые значения.
- Включите "Только проверка".Обработка покажет, какие товары сможет связать, но ничего не изменит.
- Нажмите "Связать существующие товары".Посмотрите журнал и количество найденных, пропущенных и ошибочных позиций.
- Исправьте неоднозначности.Если по одному значению найдено несколько товаров, не используйте принудительную привязку наугад. Исправьте повторяющиеся значения или выберите другое поле.
- Выключите "Только проверка" и повторите привязку.Теперь модуль сохранит постоянные связи для найденных пар.
- Только после этого запускайте цены, остатки и карточки товаров.Для первого рабочего теста лучше взять небольшую группу товаров.
Что происходит после привязки
OpenCart сохраняет у себя соответствие между внешним идентификатором номенклатуры 1С и product_id товара сайта. Проще говоря, модуль уже знает, какой товар сайта относится к какой позиции 1С.
При последующих обменах не нужно снова искать товар по SKU или Model. Поле связи требуется главным образом для первоначального сопоставления и повторной привязки, если связь была удалена.
Что делать с товарами, которые не удалось связать
| Ситуация | Что делать |
|---|---|
| Товар есть и в 1С, и на сайте, но совпадение не найдено | Проверьте выбранные поля. Возможно, артикул хранится в Model вместо SKU, отличается формат значения или нужное поле пустое. |
| По значению найдено несколько товаров | Исправьте дубли в поле связи или используйте более точное поле. Автоматически выбирать один из нескольких товаров небезопасно. |
| Товар есть только в 1С | После завершения привязки существующих позиций его можно создать в OpenCart обычной выгрузкой товаров. |
| Товар есть только в OpenCart | Можно оставить его локальным на сайте или загрузить в 1С, создать номенклатуру и затем получить постоянную связь. |
Если часть товаров пропущена: посмотрите журнал. Он покажет, если у товаров не заполнено выбранное поле связи. Например, при варианте "Артикул - SKU" товар без артикула в 1С связать автоматически нельзя.
До окончания первичной привязки не включайте действия для отсутствующих товаров. Несвязанный товар, который физически уже есть на сайте, модуль ещё не может считать той же самой позицией из 1С.
4. Передайте новые товары из 1С на сайтнаверх
Этот сценарий подходит для пустого сайта или после того, как существующие товары уже связаны.
- Выберите товары.На вкладке "Отбор товаров" можно оставить весь каталог или ограничить выгрузку. Например, чтобы сначала проверить одну папку, выберите "Категория (группа)" и нужную группу номенклатуры. При необходимости можно включить и её подгруппы.
- Настройте основные данные.Укажите вид цены, склад, статус и другие значения, которые нужны вашему магазину.
- Настройте поля карточки.В "Соответствии полей" можно указать, откуда брать название, описание, SEO URL и мета-поля. Отдельно настраиваются атрибуты, языки и изображения.
- Настройте валюту и акции, если они используются.Дополнительные возможности включайте только если соответствующий плагин установлен и настроен.
- Сначала включите "Только проверка".Для первого теста выберите небольшую группу товаров. В журнале будет видно, что обработка собирается сделать, но на сайте ничего не изменится.
- Выключите проверку и повторите выгрузку.После этого откройте несколько карточек на сайте и проверьте название, категории, цену, количество, изображения и нужные характеристики.
- Отдельно передайте цены и остатки.Кнопки и позволяют обновлять их без повторной передачи всей карточки товара.
Отбор действует не только на карточки товаров. Если вы выбрали одну группу для теста, тот же отбор используется при привязке, передаче цен и остатков.
Полный обмен используйте после проверки. Не включайте действие для отсутствующих товаров, если текущий отбор содержит только часть каталога.
5. Загрузите товары из OpenCart в 1Снаверх
Этот сценарий нужен, если магазин уже наполнен товарами, а в 1С соответствующей номенклатуры ещё нет или её нужно дополнить товарами сайта.
- Если одинаковые товары уже есть в 1С - сначала выполните привязку.Не создавайте вторую номенклатуру для товара, который уже существует. Используйте раздел "Связать существующие товары" выше.
- Откройте вкладку "Загрузка товаров".При необходимости ограничьте загрузку категориями OpenCart. ID категории можно увидеть в адресе её страницы в админке:
category_id=.... - Выберите, включать ли подкатегории.Если нужна целая ветка каталога - включите подкатегории; если только одна точная категория - отключите.
- Выберите, какие данные нужно загрузить.Можно перенести основные данные товара, а при необходимости также дополнительные данные и изображения, если соответствующие настройки включены.
- Сначала включите "Только проверка".Начните с небольшой категории. Обработка покажет в журнале, какие товары будут созданы или обновлены в 1С, но пока ничего не изменит.
- Выключите "Только проверка" и загрузите товары.Для отсутствующих в 1С товаров обработка создаст номенклатуру, а для уже найденных обновит данные в соответствии с настройками.
- Проверьте результат в 1С.Откройте несколько карточек и проверьте название, артикул, код, группу и другие нужные данные.
Главное правило: цены и другие данные между системами надёжно передаются для уже связанных товаров. Если товар пропускается, сначала проверьте его связь.
6. Цены и остаткинаверх
Из 1С на сайт
Выберите нужный вид цены и нажмите . Для количества используйте . Эти операции можно запускать отдельно от карточек товаров.
С сайта в 1С
На вкладке загрузки товаров выберите вид цены в 1С и нажмите . Обработка загружает цену только для товаров, связь которых с номенклатурой 1С уже известна. Несвязанные товары пропускаются и отмечаются в журнале.
Если цена не загружается, сначала не меняйте настройки цены - проверьте, связан ли сам товар.
7. Получите заказы и отправьте статусынаверх
- Откройте вкладку "Заказы".Укажите дату начала и статусы OpenCart, которые нужно получать. Для первого теста выберите свежий тестовый заказ.
- Сначала включите "Только проверка".Посмотрите журнал и убедитесь, что заказ читается корректно. Документ в 1С в этом режиме не создаётся и не изменяется.
- Выключите "Только проверка" и выполните рабочую загрузку.Откройте созданный или обновлённый документ в 1С и проверьте покупателя, товары, сумму, доставку и оплату.
- Настройте обратную передачу статусов.Укажите, какой статус документа в 1С соответствует какому статусу OpenCart. После изменения состояния заказа используйте .
Загруженный заказ также получает свою постоянную связь. Поэтому повторная загрузка того же заказа предназначена для обновления, а не для создания нового документа.
Как передавать изменения заказа из 1С
Менеджер может изменить товары, количество, цены, скидки и доставку в загруженном заказе 1С и передать эти изменения в магазин.
- Включите обновление на вкладке «Заказы».Отметьте «Обновлять содержимое заказов на сайте из 1С», выберите «Номенклатуру доставки» и сохраните настройки. По умолчанию обновление выключено.
- Измените и запишите документ 1С.Если добавляете товары, сначала убедитесь, что они связаны с магазином.
- Проверьте и отправьте изменения.Сначала включите «Только проверка» и нажмите . Если ошибок нет, выключите проверку и повторите команду. Изменения также передаются при полном обмене и выгрузке статусов, в том числе по расписанию.
Скидки: все скидки 1С отражаются в конечной цене товара. Прежние скидки и сборы магазина заменяются суммами документа.
Доставка: добавьте в документ строку с выбранной номенклатурой доставки и её стоимостью. Без такой строки доставка в магазине станет нулевой. При загрузке заказа услуга доставки автоматически не создаётся.
Заказ обновляется при следующем обмене после записи документа. При первом включении проверьте содержимое ранее загруженных заказов: оно тоже может быть передано в магазин.
8. Когда включать автообменнаверх
Включайте автоматический обмен только после того, как вручную успешно проверили нужные вам операции: товары, цены, остатки, один заказ и передачу статуса.
| Что делать | Пример частоты |
|---|---|
| Получать новые заказы | Каждые 2-5 минут |
| Передавать статусы и изменения заказов | Около 5 минут |
| Передавать остатки и цены | Каждые 15-30 минут |
| Полный каталог | По необходимости; обычно значительно реже |
Обновление содержимого заказов выполняется вместе с операцией выгрузки статусов, если включена настройка на вкладке «Заказы». Для обычной 1С автоматический запуск можно организовать средствами обработки, 1С или планировщиком Windows. В 1С:Фреш используется серверный запуск дополнительной обработки.
Характеристики и варианты товаровнаверх
Одна позиция номенклатуры создаёт одну карточку товара. Её характеристики передаются как варианты выбора в опции «Характеристика». Поддерживаются индивидуальные характеристики и общие характеристики вида номенклатуры. Для общих характеристик обработка определяет варианты конкретного товара по записям штрихкодов и активным складским движениям. Несколько штрихкодов одного варианта не создают повторов.
Общий справочник цветов не назначается целиком каждому товару. Вариант с нулевым остатком сохраняется, если для него есть штрихкод или активные складские движения, включая движения прошлых периодов. Количество передаётся отдельно по выбранным складам. Если связь товара с общим вариантом нигде не зарегистрирована, обработка не сможет определить её автоматически.
Какая кнопка нужнанаверх
| Кнопка | Когда использовать |
|---|---|
| Проверить соединение | После ввода или изменения адреса API, токена или настроек доступа. |
| Связать существующие товары | Когда один и тот же ассортимент уже есть и в 1С, и в OpenCart. Первый раз запускайте с "Только проверка". |
| Выгрузить товары | Чтобы создать новые товары на сайте или обновить уже связанные карточки из 1С. |
| Загрузить товары из OpenCart | Чтобы создать или обновить номенклатуру в 1С по товарам сайта. |
| Выгрузить остатки / цены | Когда нужно передать на сайт только количество или стоимость из 1С. |
| Загрузить цены из OpenCart | Когда базовые цены сайта нужно перенести в выбранный вид цен 1С. |
| Загрузить заказы | Чтобы получить заказы OpenCart в 1С. |
| Выгрузить статусы заказов | Чтобы передать изменение состояния заказа из 1С обратно на сайт; при включённой настройке также обновляется его содержимое. |
| Обновить заказы на сайте | Чтобы передать из 1С состав, количество, цены с учётом всех скидок и доставку связанных заказов. Требует включённой настройки на вкладке «Заказы». |
| Полный обмен | После первоначальной настройки и тестов. Не используйте первым действием для уже работающего каталога. |
"Только проверка" - это безопасный пробный запуск. Используйте его перед первой привязкой, первой выгрузкой, загрузкой товаров и заказов. После проверки отключите режим и повторите ту же операцию.
Если что-то пошло не такнаверх
- Соединение не устанавливается
- Сверьте адрес API и токен. Проверьте HTTPS, разрешение обработки на доступ к сайту и ограничение по IP в OpenCart.
- Не понимаю, что выбрать: SKU или Model
- Откройте одинаковый товар в обеих системах и найдите поле с одинаковым уникальным значением. Если Артикул 1С равен SKU - выбирайте Артикул - SKU. Если Артикул равен Model - выбирайте Артикул - Model. Не выбирайте поле только потому, что у него "правильное" название.
- Связано слишком мало товаров
- Проверьте журнал. Он покажет, если у части товаров пустое выбранное поле связи. Также проверьте, действительно ли значения совпадают. Частые причины: пустые значения, старые артикулы, SKU хранится в Model или значения записаны по-разному.
- При проверке найдено несколько товаров
- Не включайте принудительную привязку без проверки. Найдите повторяющееся значение и исправьте его либо выберите другое поле связи.
- После привязки изменили SKU или Model
- Если постоянная связь уже сохранена, обычный обмен продолжает использовать её. Повторная привязка нужна только если связь была удалена или товар заменён другим.
- Товар не появился на сайте
- Откройте журнал. Проверьте отбор товаров, обязательные данные, режим "Только проверка" и наличие ошибок конкретной позиции.
- Создались дубли товаров
- Остановите массовую выгрузку. Если товары уже существовали в обеих системах, сначала восстановите правильные связи и только после этого продолжайте обмен.
- Цена или остаток пропускаются
- Сначала проверьте, связан ли товар. Цены и остатки привязываются к конкретной позиции через сохранённую связь.
- Не загрузились заказы
- Проверьте дату начала и выбранные статусы. Для теста создайте новый заказ на сайте и повторите операцию.
- Нужна помощь
- Обратитесь в поддержку и приложите журнал операции, пример товара или заказа и время запуска. API-токен присылать не нужно.
Сообщения и ошибки в журнале
Найдите сообщение или код из журнала в нужной группе. Ниже приведены частые ошибки модуля и обработки: что они означают и как их исправить. Если перед кодом указан товар или заказ, начните с проверки этой позиции.
Подключение и доступ к сайту
| Сообщение в журнале | Что означает и что делать |
|---|---|
MODULE_DISABLED | Модуль выключен. Включите его в настройках OpenCart и сохраните настройки. |
API_TOKEN_NOT_CONFIGURED | На сайте не задан токен. Заполните API-токен в модуле и укажите тот же токен в обработке. |
UNAUTHORIZED | Токен не передан или не совпадает. Сверьте токены сайта и обработки; если они совпадают, попросите администратора проверить передачу заголовка авторизации. |
IP_NOT_ALLOWED | Сайт не разрешает запросы с этого IP. Добавьте в разрешённые адреса внешний IP компьютера или сервера, с которого 1С выполняет обмен. |
HTTPS_REQUIRED | Модуль требует защищённое соединение. Используйте адрес API с https://; если он уже указан, попросите администратора проверить HTTPS на сайте. |
MISSING_METHOD / UNKNOWN_METHOD | Операция не указана или отсутствует в модуле. Проверьте адрес API, обновите модуль и обработку до совместимых версий. При работе в API-консоли проверьте выбранный метод. |
INVALID_JSON / INVALID_JSON_OBJECT | Сайт получил запрос в неверном формате. Если используете API-консоль, проверьте тело запроса; при обычном обмене передайте журнал в поддержку. |
| «API вернул ответ не в формате JSON…» | Вместо ответа API пришла страница сайта, ошибка сервера или пустой ответ. Сверьте адрес API и попросите администратора проверить ответ сайта и журнал ошибок PHP. |
| HTTP 404 | По указанному адресу API не найден. Проверьте домен, папку установки магазина и адрес API; убедитесь, что файлы модуля установлены. |
| HTTP 500 / 502 / 503 / 504, ошибка соединения или ожидания ответа | Сайт недоступен, не завершил запрос вовремя или вернул серверную ошибку. Перед повторным запуском проверьте результат операции в журнале. Если ошибка повторяется, передайте администратору время запроса и сообщение. |
Настройки обработки и данные 1С
| Сообщение в журнале | Что означает и что делать |
|---|---|
| «Не указан адрес API OpenCart» / «Не указан API-токен» | Не заполнено подключение. Укажите адрес API и токен на вкладке «Настройки» и сохраните их. |
| «Не подтверждена передача данных в OpenCart…» / «Передача данных во внешний сервис не подтверждена пользователем» | Не включено подтверждение передачи данных. Откройте настройки обработки и подтвердите передачу данных в магазин. |
| «Размер пакета должен быть от 1 до 500» | Размер пакета указан неверно. Задайте число от 1 до 500 на вкладке «Настройки». |
| «Для загрузки цен выберите вид цены» | Не выбран вид цены, в который нужно загрузить цены сайта. Выберите его перед запуском загрузки. |
| «Выбранный вид документа отсутствует в конфигурации…» / «Этот вид документа не разрешён обработкой» | Выбран неподходящий документ заказа. Проверьте профиль конфигурации и выберите доступный вид документа на вкладке «Настройки». |
| «Строка отбора…» | В указанной строке отбора не заполнено значение, выбран неподходящий вид сравнения или не найдена папка. Откройте «Отбор товаров» и исправьте строку по тексту сообщения. |
| «Контрагент… не найден (режим проверки не создаёт данные)» / «Партнёр/контрагент… не найден…» | В режиме «Только проверка» обработка не создаёт покупателя. Проверьте данные заказа: при рабочей загрузке отсутствующий покупатель может быть создан. |
| «В заказе не найдено ни одной номенклатуры; пустой документ не создан» | Ни одну товарную строку не удалось сопоставить с номенклатурой 1С. Проверьте предыдущие сообщения по товарам и их связи. |
| «Не найдена валюта заказа OpenCart…» / «Не удалось определить буквенный код валюты документа» | Валюта отсутствует в 1С или не заполнен её код. Проверьте справочник валют и валюту документа. |
Товары, связи, цены и остатки
| Сообщение в журнале | Что означает и что делать |
|---|---|
PRODUCT_MATCH_NOT_FOUND | Товар для привязки не найден. Проверьте выбранную пару полей связи и точное совпадение артикула, SKU или Model. |
AMBIGUOUS_PRODUCT_MATCH | На сайте несколько товаров с одинаковым значением поля связи. Устраните дубли или выберите другое уникальное поле. |
EXTERNAL_ID_ALREADY_BOUND / PRODUCT_ALREADY_BOUND_TO_OTHER_EXTERNAL_ID | Один из товаров уже связан с другой карточкой. Проверьте обе карточки и исправьте ошибочную связь перед повторной привязкой. |
PRODUCT_BINDING_MISMATCH / AMBIGUOUS_PRODUCT_BINDING | Пара товаров не соответствует сохранённой связи либо у товара несколько связей. Проверьте привязки в модуле; если причина неясна, передайте пример в поддержку. |
PRODUCT_NOT_FOUND / PRODUCT_NOT_FOUND_FOR_UPDATE / PRODUCT_NOT_FOUND_FOR_DISABLE | Модуль не нашёл связанный товар для операции. Сначала свяжите существующий товар или выгрузите его карточку из 1С, затем повторите цены и остатки. |
| «Привязка пропущена: не заполнено поле…» | У товара пустой артикул, код или другое выбранное поле связи. Заполните поле или выберите подходящую схему привязки. Это сообщение о пропуске, а не об ошибке соединения. |
MISSING_EXTERNAL_ID | Не передан постоянный идентификатор объекта 1С. При работе через API-консоль проверьте данные запроса; при обычном обмене передайте журнал и пример объекта в поддержку. |
MISSING_NAME / MISSING_NAMES / MISSING_NAME_DEFAULT_LANGUAGE | Не передано название, в том числе на основном языке магазина. Проверьте наименование в 1С, соответствие полей и настройки языков. |
OPTION_NOT_FOUND / OPTION_VALUE_NOT_FOUND / PRODUCT_OPTION_VALUE_NOT_FOUND | Не найдена опция, её значение или вариант у конкретного товара. Проверьте характеристики и выгрузите опции вместе с карточкой товара перед ценами и остатками вариантов. |
PARENT_CATEGORY_NOT_FOUND / CATEGORY_PARENT_CYCLE | Не найдена родительская категория или обнаружена замкнутая цепочка категорий. Проверьте структуру групп в 1С и выгрузите родительские группы. |
ATTRIBUTE_GROUP_NOT_FOUND | Для атрибута не найдена его группа. Повторите выгрузку атрибутов вместе с группами; если ошибка сохраняется, проверьте их настройки. |
MISSING_PRICE / MISSING_STOCK_DATA | В запросе отсутствует цена или данные остатка. Проверьте настройки вида цены и склада; при обычном обмене передайте ошибочный запрос в поддержку. |
MISSING_SPECIAL_PRICE / MISSING_DISCOUNT_PRICE / MISSING_OPTION_VALUE_PRICE | Не передана цена акции, скидки или ценовая надбавка варианта. Проверьте соответствующие настройки и значения цен в передаваемых данных. |
Обновление заказов из 1С
| Сообщение в журнале | Что означает и что делать |
|---|---|
ORDER_NOT_FOUND | Заказ с указанным номером отсутствует в магазине. Проверьте заказ на сайте и подключение к нужному магазину. |
ORDER_DOCUMENT_LINK_MISMATCH | Заказ магазина связан с другим документом 1С. Проверьте исходный документ и связь заказа; не переносите метку заказа вручную. |
ORDER_PRODUCT_NOT_LINKED / ORDER_CHARACTERISTIC_NOT_LINKED | Не найден связанный товар или точный вариант. Свяжите и выгрузите товары и характеристики документа, затем повторите обновление. |
ORDER_CHARACTERISTIC_REQUIRED / ORDER_REQUIRED_OPTION_MISSING | У товара не выбрана необходимая характеристика или обязательная опция. Проверьте вариант товара в документе и его настройки на сайте. |
AMBIGUOUS_ORDER_PRODUCT_OPTIONS | В заказе есть одинаковые товары с разными опциями, и модуль не может однозначно сопоставить строки. Уточните характеристики; если используются сложные наборы опций, передайте пример в поддержку. |
ORDER_CURRENCY_MISMATCH | Валюты документа и заказа магазина различаются. Для обновления они должны совпадать; проверьте валюту и суммы документа. |
ORDER_TOTAL_MISMATCH / «Сумма документа не совпадает с товарами, скидками, доставкой и НДС…» | Итог не соответствует суммам строк. Пересчитайте документ, проверьте скидки, доставку и НДС. |
INVALID_ORDER_PRODUCT / «OpenCart требует положительное целое количество товара» | В строке отсутствуют обязательные данные или указано недопустимое количество. Выберите товар, проверьте сумму и задайте целое количество больше нуля. |
INVALID_ORDER_PRODUCTS / «Нельзя передать на сайт заказ без товарных строк» | Нет товарных строк либо превышен лимит в 500 строк. Проверьте состав документа; строка услуги доставки не заменяет товарную строку. |
INVALID_ORDER_AMOUNT / «В строке заказа недопустимая сумма» / «В строке заказа отрицательная сумма НДС» / «Сумма НДС превышает сумму строки» | Суммы или НДС недопустимы. Проверьте расчёт цен, скидок и налогов: отрицательные суммы для обновления не поддерживаются. |
INVALID_ORDER_CURRENCY_RATE | В заказе магазина сохранён недопустимый курс валюты. Попросите администратора проверить валюту и курс этого заказа. |
ORDER_CONTENT_REQUIRES_INNODB | Для обновления не подготовлены таблицы базы сайта. Передайте администратору список таблиц из сообщения: они должны существовать и использовать InnoDB. Подготовка выполняется после резервного копирования базы. |
ORDER_SPECIAL_ITEMS_NOT_SUPPORTED | В заказе есть подарочный сертификат как позиция, подписка или зарегистрированный возврат. Для таких заказов обновление состава из 1С не поддерживается. |
ORDER_STATUS_RESTORE_FAILED | При редактировании не удалось восстановить статус заказа. Перед повторным запуском попросите администратора проверить заказ, журнал и установленные дополнения. |
| «Не удалось обновить содержимое заказов… Подробности в журнале» | Это итоговое сообщение об ошибках в отдельных заказах. Найдите выше в журнале номер заказа и конкретную причину, исправьте её и повторите обмен. |
Изображения товаров
| Сообщение в журнале | Что означает и что делать |
|---|---|
«Файл изображения не найден…» / IMAGE_FILE_NOT_FOUND | Файл отсутствует по указанному пути в 1С или на сайте. Проверьте путь и доступность файла на том компьютере или сервере, где выполняется операция. |
IMAGE_TOO_LARGE / IMAGE_TOO_LARGE_AFTER_REENCODE / IMAGE_DIMENSIONS_TOO_LARGE | Превышен допустимый размер файла или изображения. Уменьшите вес файла и разрешение либо согласуйте лимиты с администратором сайта. |
UNSUPPORTED_IMAGE_EXTENSION / UNSUPPORTED_IMAGE_TYPE / IMAGE_EXTENSION_MISMATCH | Формат не поддерживается или расширение не соответствует содержимому. Пересохраните изображение в разрешённом формате; простого переименования файла недостаточно. |
INVALID_IMAGE_BASE64 / INVALID_IMAGE_DIMENSIONS | Данные изображения повреждены или файл не распознан. Откройте исходный файл, пересохраните его и повторите загрузку. |
INVALID_IMAGE_PATH / INVALID_IMAGE_UPLOAD_PATH | Указан недопустимый путь изображения. Проверьте настройки пути и имени файла; при обычной выгрузке передайте пример в поддержку. |
IMAGE_ALREADY_EXISTS | Файл с таким именем уже существует, а замена не разрешена. Используйте другое имя или проверьте режим замены изображения. |
IMAGE_WRITE_FAILED / IMAGE_DIRECTORY_CREATE_FAILED / IMAGE_TEMP_FILE_FAILED | Сайт не смог записать файл или создать папку. Попросите администратора проверить свободное место и права записи. |
IMAGE_STORAGE_QUOTA_EXCEEDED / IMAGE_MEMORY_LIMIT | Достигнут лимит хранилища изображений или памяти для обработки. Уменьшите изображения либо попросите администратора проверить лимиты. |
IMAGE_STORAGE_BUSY | Хранилище занято другой операцией. Дождитесь её завершения и повторите загрузку. |
Размер пакета, частота запросов и полный обмен
| Сообщение в журнале | Что означает и что делать |
|---|---|
REQUEST_TOO_LARGE / TOO_MANY_ITEMS_IN_BATCH | Запрос слишком большой или содержит слишком много объектов. Уменьшите размер пакета в обработке; для изображений также уменьшите размер файлов. |
RATE_LIMIT_EXCEEDED | Превышен лимит запросов за минуту. Подождите минуту, проверьте параллельные запуски и интервалы расписания; при необходимости согласуйте лимит с администратором. |
REQUEST_IN_PROGRESS | Запрос с этим идентификатором ещё не завершён либо его результат не сохранён. Дождитесь окончания обмена и проверьте журнал; при повторяющейся ошибке обратитесь в поддержку. |
REQUEST_ID_CONFLICT | Один идентификатор запроса использован для разных данных. В API-консоли задайте новый идентификатор; при обычном обмене передайте журнал в поддержку. |
EXCHANGE_SESSION_NOT_ACTIVE / MISSING_EXCHANGE_SESSION_ID | Сессия полного обмена уже завершена, прервана или не указана. Проверьте журнал предыдущего запуска и начните новый полный обмен. |
ENTITY_NOT_IN_EXCHANGE_SESSION | Передаётся тип данных, который не был включён в эту сессию. При ручных запросах проверьте состав полного обмена; при обычном запуске передайте журнал в поддержку. |
EXCHANGE_ITEMS_COUNT_MISMATCH / MISSING_EXCHANGE_EXPECTED_ITEMS | Не совпало или не передано контрольное количество объектов. Завершение обмена остановлено. Проверьте ошибки пакетов и повторите полный обмен после исправления; не запускайте действия для отсутствующих товаров отдельно. |
Если сообщения нет в списке, сохраните журнал, время операции и пример проблемного товара или заказа для поддержки. API-токен передавать не нужно.