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

Исходную продажу не следует переписывать так, будто возвращённого товара в ней никогда не было. Возврат — отдельное событие со своей датой и статусом, но с явной ссылкой на оригинал. Тогда можно объяснить остаток заказа, восстановить цепочку при повторной выгрузке и отличить корректировку цены от реального возврата товара.

Четыре контура должны сойтись по одним строкам

КонтурЧто сверитьПризнак ошибки
Заказline_item_id, количество, скидкаВозвращена вся строка вместо одной единицы
Фискальный документсвязь с расчётом, предмет, ставка, итогСоздана неподходящая коррекция или потеряна исходная ставка
Учётдокумент-основание, проводка, периодНовая запись не ссылается на реализацию
Платёжrefund ID, amount, currency, statusДокумент проведён, а деньги ещё не возвращены

Не принимайте наличие объекта refund за доказательство движения денег. Shopify прямо отмечает, что запись возврата может существовать без завершённой денежной транзакции; нужно отдельно смотреть связанные transactions. Аналогично внутренний статус «документ создан» не равен «банк подтвердил возврат».

В строке возврата сохраняют исходные основания

refund_line = {
  "sale_document_id": "sale_demo_1042",
  "original_line_id": "line_7",
  "quantity": 1,
  "gross_amount": "2490.00",
  "discount_share": "310.00",
  "tax_snapshot": "from-original-line",
  "payment_refund_id": "rf_demo_81"
}

Цена и налоговые реквизиты берутся из подтверждённой исходной строки, а не из текущего каталога. За время между продажей и возвратом карточка товара могла изменить цену, ставку, название или комплектность. Если система хранит только product_id и заново читает каталог, исторический документ становится невоспроизводимым.

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

Тип документа определяет не название кнопки

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

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

Сверка отделяет документ от выплаты

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

  1. Оформить возврат одной единицы из строки с несколькими товарами и общей скидкой.
  2. Повторить тот же запрос с тем же ключом идемпотентности и убедиться, что дубля нет.
  3. Сравнить сумму заказа, фискального документа, учётной операции и подтверждённой выплаты.
  4. Отменить или отклонить платёжный refund и проверить, что документ не притворяется оплаченным.
  5. Сформировать выгрузку повторно и получить те же ссылки на исходные строки.

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

Проверенные источники