Клиент обратился из-за заказов, которые не удавалось выполнить
К нам обратился владелец интернет-магазина обуви на OpenCart 3. Магазин получал из BAS остатки и розничные цены, а оформленные заказы передавал в учётную систему. В карточке покупатель выбирал размер. В BAS каждому размеру соответствовало отдельное торговое предложение со своим остатком, а у части моделей — и со своей ценой.
Менеджеры заметили два расхождения. Покупатели заказывали размеры, которых уже не было на складе, тогда как некоторые доступные размеры магазин показывал отсутствующими. Кроме того, после выбора размера цена в корзине могла оказаться значительно выше ожидаемой.
Почему возникло подозрение
Журнал обмена при этом сообщал об успешном завершении сеансов. Файлы приходили регулярно, поэтому владелец сначала предположил задержку обновления. Однако жалобы повторялись после следующих синхронизаций.
На время расследования
На время расследования согласовали ручную проверку наличия и цены затронутых размеров перед подтверждением покупки. Спорные заказы выделили для отдельного разбора. Массово обнулять каталог, менять исторические суммы заказов или возвращать магазин к старой базе мы не стали. Сначала требовалось установить, на каком участке обмена искажаются данные.
Сопоставили конкретные заказы, размеры и выгрузку BAS
Мы начали с заказов, по которым менеджеры уже подтвердили расхождение. Зафиксировали модель, артикул, выбранный размер, количество, цену, время оформления и состояние заказа. Затем сопоставили эти сведения с предложениями BAS, складскими операциями и резервами. Текущий остаток не принимали за доказательство того, каким он был в момент покупки.
Расхождение количества
У одной модели размер 42 показывался на сайте с количеством 3, хотя в проверяемой выгрузке BAS для того же предложения уже был передан ноль. Размер 43 этой модели также сохранял устаревшее количество. Для проверки важен был не только момент завершения обмена: мы связали исходные значения с конкретным полученным пакетом и результатом его обработки.
Расхождение цены
Отдельно разобрали цену. База товара в OpenCart составляла 1 540 грн. В BAS окончательная розничная цена выбранного размера была 1 690 грн, но корзина показывала 3 230 грн. Сравнили стоимость одной и той же товарной позиции, без доставки и прочих начислений к заказу. Проверили валюту, единицу продажи, налоговый режим, группу покупателя и действующие ценовые правила. Для этой модели скидки и специальные цены не объясняли разницу.
Проверили исходные данные и доставку файла
Состав обмена
В магазине работал модуль CommerceML с пользовательской PHP-доработкой. В установленной конфигурации предложения, их цены и количества приходили через offers.xml. Мы проверили состав именно этого обмена: отдельные файлы цен или остатков не перезаписывали исследованные значения после его завершения.
Для размеров использовалась связка идентификатора модели и характеристики BAS. Название «Размер» и значение «42» сами по себе не определяли товар: одинаковый размер встречался у разных моделей.
Сведения внутри XML
В сохранённом XML нашли проблемные предложения. Размеру 42 соответствовало количество 0, размеру 43 — актуальное значение, а цена 1 690 грн относилась к нужному варианту и согласованному розничному типу цены. Дополнительно сверили смысл количества: BAS рассчитывала доступный к продаже запас по двум согласованным складам с учётом резервов. Повторно складывать все физические остатки или ещё раз вычитать уже учтённые резервы на сайте не требовалось.
Приём и обработка файла
Затем сопоставили отправленный и полученный файл, сведения о сеансе и записи обработчика. XML разбирался полностью; проблемные предложения присутствовали в принятом пакете. В исследованном сеансе не обнаружили обрыва передачи, ошибки разбора или конкурирующего импорта, который объяснял бы расхождение.
На копии нашли две ошибки в одном обработчике
Подготовили изолированную копию с той же версией модуля и доработок. Для воспроизведения использовали сохранённый XML. Обратный обмен с рабочей BAS, письма покупателям и другие действия с реальными заказами отключили.
В магазине размеры были стандартными опциями OpenCart 3. Общее количество карточки находилось в product, а количества конкретных размеров — в product_option_value. Названия здесь указаны без префикса таблиц, который задавался при установке магазина.
Количество попадало в общую карточку
При обработке предложения PHP-код находил родительский товар по общей части внешнего идентификатора. Количество записывалось в карточку, но не доходило до строки нужного размера. Когда приходили несколько предложений одной модели, родительское количество могло последовательно перезаписываться значениями разных размеров. Оно не являлось согласованным итогом по модели.
Это объяснило поведение магазина. У размера 42 сохранялись прежние 3 единицы, хотя в XML уже был ноль. У других карточек ошибочное общее количество могло ограничивать покупку размеров, у которых собственный остаток оставался положительным. Мы сопоставили изменения в базе с поведением карточки, корзины и оформления заказа.
Полная цена становилась надбавкой
Вторая ошибка находилась в записи цены. BAS передавала полную стоимость размера, а обработчик сохранял её как положительную надбавку стандартной опции. Корзина складывала базу товара и эту надбавку:
1 540 + 1 690 = 3 230 грн.
Для проверенной модели без активных скидок и специальных цен правильная разница составляла:
1 690 − 1 540 = 150 грн; итог — 1 540 + 150 = 1 690 грн.

Восстановили соответствие между предложением BAS и размером
Собрали и проверили связь: внешний идентификатор предложения BAS — товар OpenCart — опция размера — конкретная строка product_option_value. Для подтверждения использовали артикулы, характеристики и принадлежность размера карточке.
Точное соответствие
Обработчик стал обращаться к строке варианта по этому соответствию. Совпадение названия размера не использовалось как замена внешнему идентификатору. Проверили также, что разные предложения не направляются в одну строку опции, а найденный размер действительно относится к нужному товару.
Неоднозначные записи
Неоднозначные соответствия и изменения идентификаторов BAS выделили для сверки. По ним не создавали автоматически новые опции и не записывали данные в похожий товар. После восстановления связей повторили импорт контрольных предложений и убедились, что обновляются именно их размеры.
Исправили количество размеров и родительской карточки
Ноль — значение
Для каждого сопоставленного размера импортёр начал применять переданное абсолютное доступное количество. Ноль обрабатывался как значение, а не как пустое поле. При этом отсутствие предложения в корректном пакете изменений не означало нулевой остаток.
Общее количество модели
Общее количество карточки пересчитали по доступным количествам её размеров. В затронутой группе размер был единственной складской опцией, поэтому такая сумма соответствовала структуре товаров. При частичном обновлении учитывали не только строки текущего файла, но и остальные действующие размеры модели.
Уменьшение родительского количества и количества выбранной опции отражало одну покупку на двух уровнях каталога. Мы не превращали эти изменения в два отдельных расхода для BAS. После исправления контрольный нулевой размер не проходил обычное оформление, а доступный размер уменьшался вместе с количеством родительской карточки в предусмотренный момент.

Пересчитали цены вариантов относительно актуальной базы
Для затронутых розничных моделей сохранили согласованный источник базовой цены и абсолютные цены предложений BAS. Перед записью рассчитывали разницу для каждого размера: положительную при цене выше базы, отрицательную — при цене ниже, нулевую — при совпадении. Для отрицательной разницы в поле опции записывалась её величина с префиксом «−», а не отрицательное число с повторным вычитанием.
Значения рассчитывали в одной валюте и на одной налоговой основе, с согласованным округлением. Результат проверяли по конечной стоимости позиции в корзине, а не только по полям базы.
Для исходного размера надбавка стала +150 грн, а стоимость — 1 690 грн. Затем на копии проверили изменение базы до 1 600 грн при неизменной абсолютной цене размера. Разница пересчиталась в +90 грн, итог сохранился:
1 600 + 90 = 1 690 грн.

Согласовали обновление остатков с заказами и резервами
После исправления записи количества оставался риск: новая выгрузка могла восстановить запас, который сайт уже уменьшил по заказу, ещё не учтённому в BAS. Поэтому мы проверили обратную передачу заказов и действовавший механизм локальных поправок к остатку. Этот механизм относился к доработке интеграции, а не к стандартной функции резервирования OpenCart.
Для строки заказа проследили связь с конкретным предложением BAS, количество и состояние обработки. Разделили три события: магазин принял заказ к исполнению, BAS получила документ, резерв этого документа отразился в выгружаемом доступном остатке. Это разные моменты.
Пока резерв не учтён в принятых остатках
До отражения заказа в принятом наборе остатков BAS локальное уменьшение продолжало учитываться. Само подтверждение получения документа не было основанием его снимать: файл мог быть сформирован до резервирования. При замене каталожного количества новым абсолютным значением учитывали только те локальные изменения, которых ещё не было в соответствующих данных BAS.
После принятия данных с этим резервом
После принятия остатков, уже учитывавших резерв, отдельная локальная поправка для него больше не применялась. Так один заказ не вычитался повторно. Если состояние заказа и набор складских данных нельзя было однозначно сопоставить, такой остаток оставляли на сверке, а не считали автоматически согласованным.

В изолированном контуре проследили последовательность «заказ — передача в BAS — резерв — следующий обмен», затем отмену и обновление доступного количества. Это подтвердило работу проверенных переходов. Периодический обмен при этом не превращался в мгновенный общий склад для всех каналов продаж; защиту от любых одновременных покупок последней пары мы результатом этого кейса не заявляли.
Разделили частичные, повторные и ошибочные пакеты
Частичные и полные данные
Корректная выгрузка изменений и повреждённый XML требовали разной обработки. Для пакета изменений обновлялись только переданные сведения. Отсутствующие в нём размеры сохраняли подтверждённые данные с учётом текущих заказов. Для полной выгрузки дополнительно проверяли её согласованный охват: отсутствие строки не считали признаком удаления без установленного правила обработки такого события.
Повреждённые и неполные данные
Повреждённый или незавершённый пакет не принимался как основание для обновления каталога. Проверка структуры предшествовала применению значений. Если файл был корректным, но отдельное предложение не проходило сопоставление, ошибку фиксировали у этой записи; данные не направлялись в соседний размер. Модель с неполным набором зависимых цен не считалась успешно обновлённой.
Повторная доставка пакета
Для повторных отправок различали повтор того же подтверждённого пакета и новое изменение. Идентификатор применённого пакета сохранялся, поэтому повторная доставка не запускала его складские изменения заново. Это было особенно важно, если после первого импорта сайт уже принял новый заказ: повтор файла не должен был вернуть прежнее количество.
Порядок применения
Отдельно проверили порядок обработки. Блокировка параллельных импортов защищала от одновременной записи, но сама по себе не доказывала свежесть данных. Последовательность определяли по сведениям обмена, а не по времени изменения файла на сервере. При недостоверном порядке пакет не применяли автоматически поверх более новых подтверждённых значений.
Проверили исправление на копии по исходным расхождениям
Исходные проблемные предложения
Контроль начали с тех же предложений, на которых воспроизвели ошибку. После полного импорта сопоставили внешний идентификатор, строку размера, количество, базу и надбавку. Затем проверили результат через карточку, корзину и оформление заказа.
Изменение остатка, цены и базы
Отдельным пакетом изменили остаток одного размера до нуля, цену другого и базовую цену модели. Проверили, что меняются нужные строки, общее количество учитывает остальные размеры, а их итоговые цены не искажаются при изменении базы.
Заказ, резерв и отмена
Обратный обмен проверяли отдельно от загрузки каталога: по выбранному размеру, строке заказа, резерву BAS и следующему набору остатков. Возврат количества при отмене сверили с теми переходами статусов, которые использовались в магазине.
Повтор и ошибки пакета
Проверки повторного и ошибочного пакетов не объединяли в один сценарий. Повтор не выполнял складские изменения заново; корректное частичное обновление не обнуляло отсутствующие строки; повреждённый файл не считался завершённой синхронизацией. После этого повторный штатный обмен подтвердил исправление исходных расхождений на контрольных товарах.

Перенесли исправления в рабочий магазин
Перед внедрением
Перед внедрением сохранили актуальные файлы, настройки, базу и соответствия предложений. Приостановили новые задания обмена и дождались завершения уже выполнявшихся сеансов, чтобы старый и исправленный обработчики не записывали данные одновременно.
Применение исправлений
В рабочий магазин перенесли изменения интеграции и подтверждённые связи вариантов. Базу с копии не загружали поверх действующей: за время работ появлялись новые заказы. Перед применением свежих данных BAS сверили незавершённую передачу заказов и локальные складские изменения, чтобы обновление каталога не отменило их учёт.
Проверка рабочего обмена
После возобновления обмена проверили выполнение исправленного обработчика и фактические значения в базе и на витрине. Вернулись к исходным размерам с нулевым и положительным количеством, проверили цену выбранного варианта и итог в корзине. Затем проследили следующий штатный сеанс.
Отдельно разобрали уже созданные спорные заказы
Сверка истории
После восстановления обмена вернулись к покупкам, затронутым расхождениями. Для каждой сверили размер, сумму, оплату, резерв и состояние исполнения. Историю складских операций сопоставляли с моментом оформления, а не только с новым количеством на сайте.
Решения по спорным покупкам
Заказы на отсутствовавшие размеры передали менеджерам для согласования исполнения с покупателями. По ошибочной цене отдельно установили, оставалась ли она только суммой заказа или по ней действительно прошла оплата. Автоматически считать каждый такой заказ финансовой потерей или состоявшимся списанием было нельзя.
Изменили контроль результата обмена
В журнале разделили получение файла, завершение обработки и фактическое применение данных. Для сеанса стали фиксировать сопоставленные предложения, отклонённые записи, причины ошибок и время последнего подтверждённого обновления. Сеанс с неприменёнными предложениями больше не представлялся как безусловно успешное обновление всего каталога.
Что получили в результате
Остаток проверенного размера
На сайте применён ноль из BAS. Размер с нулевым остатком не проходил обычное оформление.
Цена контрольного варианта
Полная цена перестала прибавляться к базе. Надбавка пересчитывалась при изменении базы.
Для исследованных товаров исходные данные BAS были правильными. Их искажал PHP-обработчик: количество попадало в родительскую карточку вместо конкретного размера, а полная цена предложения записывалась как надбавка.
Мы восстановили соответствия вариантов, исправили применение количества и пересчёт цен, согласовали обновление остатков с заказами и резервами. В контрольном случае размер с переданным нулевым количеством перестал проходить обычное оформление. Цена варианта стала 1 690 грн вместо ошибочных 3 230 грн и сохранилась после проверенного изменения базы.
Как состояние товара связано с сохранением карточки, перенаправлением или ответом 404.
Какие проблемы на пути к оформлению заказа стоит сопоставить с поведением покупателей.