Начните не с пересоздания документа, а с одной конкретной продажи. Зафиксируйте номер исходного заказа, чек или иной первичный документ, возвращаемую позицию, количество, цену, скидку, налог и фактическую сумму денег. Частичный возврат ломается, когда хотя бы один контур считает не те строки: магазин возвращает одну единицу, кассовый слой корректирует весь товар, а бухгалтерская выгрузка получает только общую сумму.
Исходную продажу не следует переписывать так, будто возвращённого товара в ней никогда не было. Возврат — отдельное событие со своей датой и статусом, но с явной ссылкой на оригинал. Тогда можно объяснить остаток заказа, восстановить цепочку при повторной выгрузке и отличить корректировку цены от реального возврата товара.
Четыре контура должны сойтись по одним строкам
| Контур | Что сверить | Признак ошибки |
|---|---|---|
| Заказ | 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 и их статусы. Ожидаемые временные состояния — например, документ проведён, банк обрабатывает — не должны сразу считаться расхождением; для них задают срок и переход в очередь ручной проверки.
- Оформить возврат одной единицы из строки с несколькими товарами и общей скидкой.
- Повторить тот же запрос с тем же ключом идемпотентности и убедиться, что дубля нет.
- Сравнить сумму заказа, фискального документа, учётной операции и подтверждённой выплаты.
- Отменить или отклонить платёжный refund и проверить, что документ не притворяется оплаченным.
- Сформировать выгрузку повторно и получить те же ссылки на исходные строки.
Для разбора достаточно обезличенного комплекта: исходная строка продажи, payload возврата, сохранённый документ, фискальный ответ и платёжные transactions. Не присылайте данные карты и персональные сведения покупателя. По пяти записям видно, где возникло расхождение: в количестве, распределении суммы, выборе типа документа или подтверждении денег.