Поиск по сайту

OpenCart показывал неверные остатки и цены: как мы исправили синхронизацию с BAS

BAS · OpenCart 3 · технический кейс
Обмен проходил, а остатки и цены расходились

Покупатели заказывали отсутствующие размеры и видели завышенную цену в корзине. Мы проследили путь одного предложения от BAS до заказа, нашли две ошибки в PHP-обработчике и проверили исправление на повторном обмене.

Остатки размеров
Цена в корзине
Обмен заказами
Расхождения до исправления
Размер 42
В BAS
0
ед.
В магазине
3
ед.
Цена выбранного размера
В BAS
1 690
грн
В магазине
3 230
грн
Файл поступал полностью. Ошибки возникали при записи данных в каталог.

От жалобы до результата
01 / Обращение клиента

Клиент обратился из-за заказов, которые не удавалось выполнить

К нам обратился владелец интернет-магазина обуви на OpenCart 3. Магазин получал из BAS остатки и розничные цены, а оформленные заказы передавал в учётную систему. В карточке покупатель выбирал размер. В BAS каждому размеру соответствовало отдельное торговое предложение со своим остатком, а у части моделей — и со своей ценой.

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

Почему возникло подозрение

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

На время расследования

На время расследования согласовали ручную проверку наличия и цены затронутых размеров перед подтверждением покупки. Спорные заказы выделили для отдельного разбора. Массово обнулять каталог, менять исторические суммы заказов или возвращать магазин к старой базе мы не стали. Сначала требовалось установить, на каком участке обмена искажаются данные.

02 / Контрольные расхождения

Сопоставили конкретные заказы, размеры и выгрузку BAS

Мы начали с заказов, по которым менеджеры уже подтвердили расхождение. Зафиксировали модель, артикул, выбранный размер, количество, цену, время оформления и состояние заказа. Затем сопоставили эти сведения с предложениями BAS, складскими операциями и резервами. Текущий остаток не принимали за доказательство того, каким он был в момент покупки.

А

Расхождение количества

У одной модели размер 42 показывался на сайте с количеством 3, хотя в проверяемой выгрузке BAS для того же предложения уже был передан ноль. Размер 43 этой модели также сохранял устаревшее количество. Для проверки важен был не только момент завершения обмена: мы связали исходные значения с конкретным полученным пакетом и результатом его обработки.

Б

Расхождение цены

Отдельно разобрали цену. База товара в OpenCart составляла 1 540 грн. В BAS окончательная розничная цена выбранного размера была 1 690 грн, но корзина показывала 3 230 грн. Сравнили стоимость одной и той же товарной позиции, без доставки и прочих начислений к заказу. Проверили валюту, единицу продажи, налоговый режим, группу покупателя и действующие ценовые правила. Для этой модели скидки и специальные цены не объясняли разницу.

03 / Путь исходных данных

Проверили исходные данные и доставку файла

Состав обмена

В магазине работал модуль CommerceML с пользовательской PHP-доработкой. В установленной конфигурации предложения, их цены и количества приходили через offers.xml. Мы проверили состав именно этого обмена: отдельные файлы цен или остатков не перезаписывали исследованные значения после его завершения.

Для размеров использовалась связка идентификатора модели и характеристики BAS. Название «Размер» и значение «42» сами по себе не определяли товар: одинаковый размер встречался у разных моделей.

Сведения внутри XML

В сохранённом XML нашли проблемные предложения. Размеру 42 соответствовало количество 0, размеру 43 — актуальное значение, а цена 1 690 грн относилась к нужному варианту и согласованному розничному типу цены. Дополнительно сверили смысл количества: BAS рассчитывала доступный к продаже запас по двум согласованным складам с учётом резервов. Повторно складывать все физические остатки или ещё раз вычитать уже учтённые резервы на сайте не требовалось.

Приём и обработка файла

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

04 / Причины сбоя

На копии нашли две ошибки в одном обработчике

Подготовили изолированную копию с той же версией модуля и доработок. Для воспроизведения использовали сохранённый XML. Обратный обмен с рабочей BAS, письма покупателям и другие действия с реальными заказами отключили.

В магазине размеры были стандартными опциями OpenCart 3. Общее количество карточки находилось в product, а количества конкретных размеров — в product_option_value. Названия здесь указаны без префикса таблиц, который задавался при установке магазина.

1

Количество попадало в общую карточку

При обработке предложения PHP-код находил родительский товар по общей части внешнего идентификатора. Количество записывалось в карточку, но не доходило до строки нужного размера. Когда приходили несколько предложений одной модели, родительское количество могло последовательно перезаписываться значениями разных размеров. Оно не являлось согласованным итогом по модели.

Это объяснило поведение магазина. У размера 42 сохранялись прежние 3 единицы, хотя в XML уже был ноль. У других карточек ошибочное общее количество могло ограничивать покупку размеров, у которых собственный остаток оставался положительным. Мы сопоставили изменения в базе с поведением карточки, корзины и оформления заказа.

2

Полная цена становилась надбавкой

Вторая ошибка находилась в записи цены. BAS передавала полную стоимость размера, а обработчик сохранял её как положительную надбавку стандартной опции. Корзина складывала базу товара и эту надбавку:

1 540 + 1 690 = 3 230 грн.

Для проверенной модели без активных скидок и специальных цен правильная разница составляла:

1 690 − 1 540 = 150 грн; итог — 1 540 + 150 = 1 690 грн.

Две ошибки импорта BAS в OpenCart: количество записывалось в родительскую карточку, а полная цена — в надбавку размера
Обе ошибки возникали при применении корректно полученных данных BAS к структуре вариантов OpenCart.
05 / Связь предложений и размеров

Восстановили соответствие между предложением BAS и размером

Собрали и проверили связь: внешний идентификатор предложения BAS — товар OpenCart — опция размера — конкретная строка product_option_value. Для подтверждения использовали артикулы, характеристики и принадлежность размера карточке.

Предложение BASТовар OpenCartОпция размераСтрока варианта

Точное соответствие

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

Неоднозначные записи

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

06 / Применение количества

Исправили количество размеров и родительской карточки

Ноль — значение

Для каждого сопоставленного размера импортёр начал применять переданное абсолютное доступное количество. Ноль обрабатывался как значение, а не как пустое поле. При этом отсутствие предложения в корректном пакете изменений не означало нулевой остаток.

Общее количество модели

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

Уменьшение родительского количества и количества выбранной опции отражало одну покупку на двух уровнях каталога. Мы не превращали эти изменения в два отдельных расхода для BAS. После исправления контрольный нулевой размер не проходил обычное оформление, а доступный размер уменьшался вместе с количеством родительской карточки в предусмотренный момент.

Сверка размера 42: в BAS и XML ноль, в магазине до исправления три единицы, после исправления ноль
Контрольный размер 42: нулевое количество из выгрузки стало применяться к нужной строке размера.
07 / Цена варианта

Пересчитали цены вариантов относительно актуальной базы

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

Значения рассчитывали в одной валюте и на одной налоговой основе, с согласованным округлением. Результат проверяли по конечной стоимости позиции в корзине, а не только по полям базы.

Проверка при изменении базы

Для исходного размера надбавка стала +150 грн, а стоимость — 1 690 грн. Затем на копии проверили изменение базы до 1 600 грн при неизменной абсолютной цене размера. Разница пересчиталась в +90 грн, итог сохранился:

1 600 + 90 = 1 690 грн.

Расчёт цены размера: 3230 грн при ошибке, 1690 грн после исправления и после изменения базовой цены
После изменения базы надбавка пересчиталась с +150 до +90 грн. Полная цена выбранного размера осталась 1 690 грн.
08 / Заказы и склад

Согласовали обновление остатков с заказами и резервами

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

Для строки заказа проследили связь с конкретным предложением BAS, количество и состояние обработки. Разделили три события: магазин принял заказ к исполнению, BAS получила документ, резерв этого документа отразился в выгружаемом доступном остатке. Это разные моменты.

Пока резерв не учтён в принятых остатках

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

После принятия данных с этим резервом

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

Учёт заказа и резерва: локальная поправка снимается после принятия остатков BAS, уже учитывающих этот резерв
Подтверждение получения заказа и принятие остатков, уже учитывающих его резерв, — разные события.

В изолированном контуре проследили последовательность «заказ — передача в BAS — резерв — следующий обмен», затем отмену и обновление доступного количества. Это подтвердило работу проверенных переходов. Периодический обмен при этом не превращался в мгновенный общий склад для всех каналов продаж; защиту от любых одновременных покупок последней пары мы результатом этого кейса не заявляли.

09 / Устойчивость обмена

Разделили частичные, повторные и ошибочные пакеты

01

Частичные и полные данные

Корректная выгрузка изменений и повреждённый XML требовали разной обработки. Для пакета изменений обновлялись только переданные сведения. Отсутствующие в нём размеры сохраняли подтверждённые данные с учётом текущих заказов. Для полной выгрузки дополнительно проверяли её согласованный охват: отсутствие строки не считали признаком удаления без установленного правила обработки такого события.

02

Повреждённые и неполные данные

Повреждённый или незавершённый пакет не принимался как основание для обновления каталога. Проверка структуры предшествовала применению значений. Если файл был корректным, но отдельное предложение не проходило сопоставление, ошибку фиксировали у этой записи; данные не направлялись в соседний размер. Модель с неполным набором зависимых цен не считалась успешно обновлённой.

03

Повторная доставка пакета

Для повторных отправок различали повтор того же подтверждённого пакета и новое изменение. Идентификатор применённого пакета сохранялся, поэтому повторная доставка не запускала его складские изменения заново. Это было особенно важно, если после первого импорта сайт уже принял новый заказ: повтор файла не должен был вернуть прежнее количество.

04

Порядок применения

Отдельно проверили порядок обработки. Блокировка параллельных импортов защищала от одновременной записи, но сама по себе не доказывала свежесть данных. Последовательность определяли по сведениям обмена, а не по времени изменения файла на сервере. При недостоверном порядке пакет не применяли автоматически поверх более новых подтверждённых значений.

10 / Проверка исправления

Проверили исправление на копии по исходным расхождениям

Исходные проблемные предложения

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

Изменение остатка, цены и базы

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

Заказ, резерв и отмена

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

Повтор и ошибки пакета

Проверки повторного и ошибочного пакетов не объединяли в один сценарий. Повтор не выполнял складские изменения заново; корректное частичное обновление не обнуляло отсутствующие строки; повреждённый файл не считался завершённой синхронизацией. После этого повторный штатный обмен подтвердил исправление исходных расхождений на контрольных товарах.

Матрица проверок обмена: полный, частичный, повторный и повреждённый пакет, заказ с резервом и отмена
Матрица объединяет проверки, описанные в кейсе. Результаты относятся к контрольным товарам и исследованным сценариям.
11 / Рабочий магазин

Перенесли исправления в рабочий магазин

1

Перед внедрением

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

2

Применение исправлений

В рабочий магазин перенесли изменения интеграции и подтверждённые связи вариантов. Базу с копии не загружали поверх действующей: за время работ появлялись новые заказы. Перед применением свежих данных BAS сверили незавершённую передачу заказов и локальные складские изменения, чтобы обновление каталога не отменило их учёт.

3

Проверка рабочего обмена

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

12 / Ранее созданные покупки

Отдельно разобрали уже созданные спорные заказы

Сверка истории

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

Решения по спорным покупкам

Заказы на отсутствовавшие размеры передали менеджерам для согласования исполнения с покупателями. По ошибочной цене отдельно установили, оставалась ли она только суммой заказа или по ней действительно прошла оплата. Автоматически считать каждый такой заказ финансовой потерей или состоявшимся списанием было нельзя.

13 / Наблюдение за обменом

Изменили контроль результата обмена

Файл полученОбработка завершенаДанные применены

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

14 / Результат кейса

Что получили в результате

Остаток проверенного размера

3 → 0

На сайте применён ноль из BAS. Размер с нулевым остатком не проходил обычное оформление.

Цена контрольного варианта

3 230 → 1 690 грн

Полная цена перестала прибавляться к базе. Надбавка пересчитывалась при изменении базы.

Для исследованных товаров исходные данные BAS были правильными. Их искажал PHP-обработчик: количество попадало в родительскую карточку вместо конкретного размера, а полная цена предложения записывалась как надбавка.

Мы восстановили соответствия вариантов, исправили применение количества и пересчёт цен, согласовали обновление остатков с заказами и резервами. В контрольном случае размер с переданным нулевым количеством перестал проходить обычное оформление. Цена варианта стала 1 690 грн вместо ошибочных 3 230 грн и сохранилась после проверенного изменения базы.

По теме работы магазина
Товар закончился: что делать с его страницей →

Как состояние товара связано с сохранением карточки, перенаправлением или ответом 404.

Почему покупатели бросают корзину →

Какие проблемы на пути к оформлению заказа стоит сопоставить с поведением покупателей.

FAQ / Вопросы владельцев магазинов

Частые вопросы об обмене OpenCart и BAS

Почему обмен OpenCart с BAS завершается успешно, но остатки остаются неправильными?

Успешный приём XML не означает, что каждое торговое предложение записано в нужный вариант товара. Следует сверить идентификатор предложения BAS с конкретной опцией OpenCart, проверить данные, переданные в файле, и значения, сохранённые после импорта.

Почему размер всё ещё доступен для заказа, если BAS передала нулевой остаток?

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

Откуда появляется завышенная цена размера в корзине OpenCart?

В стандартных опциях OpenCart 3 поле цены варианта обычно означает надбавку или уменьшение относительно базовой цены товара. Если импортёр записывает туда полную розничную цену BAS с плюсом, корзина прибавляет её к цене товара повторно.

Что произойдёт, если BAS изменит базовую цену, но не передаст все размеры?

Старые надбавки могут перестать соответствовать полным ценам вариантов. При изменении базовой цены нужно согласованно пересчитать связанные опции по последним подтверждённым абсолютным ценам. Если этих данных нет, обновление нельзя применять как проверенное.

Как избежать повторного списания остатка при передаче заказа в BAS?

Нужно различать локальное списание OpenCart, получение заказа BAS и момент, когда его резерв уже учтён в выгружаемом доступном остатке. Локальную поправку нельзя снимать слишком рано или применять повторно после учёта резерва.

Можно ли повторно загрузить файл обмена, чтобы исправить остатки?

Повторная выгрузка не устранит ошибку, если PHP-обработчик по-прежнему сопоставляет размеры неправильно или некорректно рассчитывает цену. Сначала нужно подтвердить причину и исправить обработку, затем выполнить контролируемую синхронизацию и сверку.

Какие проверки обязательны после исправления обмена OpenCart и BAS?

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

Техническая помощь · VozniNet

BAS и магазин показывают разные остатки или цены?

Разберём путь данных от торгового предложения до корзины и заказа. Проверим сопоставление вариантов, применение цен и остатков, обработку повторных пакетов и связь с резервами.