Процессинг: Возврат

Редактировал(а) Татьяна Брыкова 2025/09/03 09:46
Тип настройкиНазвание настройкиОписание настройки
ПартнерскаяLoyalty.Processing.Refund.ChequeReferenceByNumberOnlyНастройка определения чека покупки при возврате. Если она включена - то при возврате чек покупки определяется только по номеру, который передан в ссылке. Если выключена - с учётом ещё даты и терминала.
ПартнерскаяLoyalty.Processing.Refund.NoneChequeReference.NegativeBonusDelayedВключение/отключение алгоритм отложенных отрицательных баллов при возврате без ссылки на чек покупки. При значениях 1, y или Y дата и время отрицательных порций баллов коррекции будет определяться датой и временем чека возврата покупки и сроков действия, заданных параметрами правил начисления. При прочих значениях, а также при отсутствии настройки дата начала действия отрицательных баллов коррекции совпадает с датой/временем процессинга чека возврата, независимо от сроков действия, указанных в применившихся правила. Значение по умолчанию ПУСТО.
ПартнерскаяLoyalty.Processing.Avoid.PaidByBonusNegativeBalance Настройка, запрещающая оплачивать баллами покупку, если активный баланс отрицательный. Бывают случаи, когда отрицательные баллы ещё не погашены (не отработал ночной джоб). Например, делается покупка, потом быстро возврат, в результате образовались непогашенные баллы, но активный баланс нулевой, потом делается покупка с оплатой баллами. Поскольку баллы не погашены, то можно произвести оплату баллами. Во избежание таких случаев, необходимо включить данную настройку, то есть установить её в значение 1, y или Y, при прочих значениях, в том числе и пустом – настройка выключена. 
ПартнерскаяLoyalty.Processing.Refund.Checking.Purchase.ChequeБлокировка регистрации чеков возврата без ссылки на чек покупки через алгоритм ручных чеков. При значениях настройки 1, y или Y регистрация чеков возврата запрещена, при прочих значениях и при отсутствии настройки – разрешена. Значение по умолчанию Y.
ПартнерскаяLoyalty.Processing.Refund.Bonus.ModeНастройка "Оплачено баллами при возврате". Возможные значения: POS, PROPORTIONAL, BONUS FIRST, BONUS LAST. Указывается откуда берется значение оплаты баллами для алгоритма возврата без ссылки на чек покупки. Примечание: сейчас действуют только значение POS (т.е. значение берется из тега PaidByBonus). 
ПартнерскаяLoyalty.Processing.Return.WriteoffOrderНастройка "Порядок сортировки списанных баллов при возврате". Допустимые значения: FIFO, LIFO, FEFO, LEFO Значение по умолчанию: FIFO. В текущей версии не используется. 
ПартнерскаяLoyalty.Processing.Return.PaymentPriorityНастройка "Порядок сортировки". Относится к возвращаемым баллам, наличным деньгам и т.п. Значение указывается через точку с запятой (;). Означает в какой очерёдности будут использоваться возвращаемые оплаты, в виде начисления бонусов, денег, переводов на карту и т.п. 
ПартнерскаяLoyalty.Processing.Return.BonusAggregationInAnswerАгрегация бонусов в ответе по чеку возврата. Если настройка 0, то в ответе чека возврата по ChargedBonus будут выводиться все положительные баллы; по ChargeStatusBonus - все положительные статусные баллы, а в WriteoffBonus будут выводиться все отрицательные баллы; в WriteoffStatusBonus - отрицательные статусные баллы. Если настройка 1, то в ответе чека возврата по ChargedBonus будет выводиться сумма баллов дебета; по ChargedStatusBonus - сумма статусных баллов дебета, а в WriteoffBonus будет выводиться сумма баллов кредита; в WriteoffStatusBonus - сумма статусных баллов кредита. Если настройка не заполнена или значение отличается от 0 и 1, то считается, что её значение равно 0. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.RateНастройка "Коэффициент возврата оплаченных баллов". Значение, на которое умножаются баллы, которые рассчитались системой как необходимые для возврата. Используется только при возврате без ссылки на чек покупки. Допустимые значения – положительные десятичные числа. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.ValidityPeriodНастройка "Период действия возвращаемых бонусных баллов", в случае, если тип даты окончания действия подразумевает установку периода действия баллов. Указывается в днях. Относится к баллам, которыми был оплачен чек при покупке. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.ExpirationDateCalculationTypeНастройка "Тип даты окончания действия для возвращаемых бонусных баллов". Допустимые значения:  2, 3. Значение по умолчанию: нет. Если значение данной настройки равно 2, то в качестве даты окончания действия возвращаемых баллов берётся дата окончания действия бонусных баллов как дата прописанная непосредственно в чеке, по которому производится возврат, к этой дате добавляется суммарное количество дней, указанных в настройках: Loyalty.Processing.Refund.Bonus.InactivePeriod и Loyalty.Processing.Refund.Bonus.ValidityPeriod. Если значение данной настройки равно 3, то дата окончания действия возвращаемых бонусных баллов берётся из значения настройки Loyalty.Processing.Refund.Bonus.ExpirationDate. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.ExpirationDateНастройка, устанавливающая дату окончания скорректированных баллов, которые возвращаются на карту, поскольку чек покупки был оплачен бонусами. Допустимые значения в диапазоне от 1 января 2000 года до 1 января 3000 года. Формат ввода: [год][месяц][день], цифрами без пробелов. Системная настройка учитывается, если настройка Processing.Refund.Bonus.ExpirationDateCalculationType имеет значение 3. Если текущая настройка введена не в правильном формате, то, по умолчанию, используется значение 1 января 3000 года. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.InactivePeriodНастройка "Период неактивности возвращаемых баллов". Количество дней, на которые следует продлить дату начала действия относительно даты чека возврата. Относится к баллам, которыми был оплачен чек при покупке. 
ПартнерскаяLoyalty.Processing.Refund.NegativeBonusDelayedНастройка, включающая\отключающая алгоритм отложенных отрицательных баллов при возврате со ссылкой на чек покупки. Если настройка включена, то дата и время отрицательных баллов будет определяться датой и временем чека покупки и параметра отложенности действия баллов по правилу начисления, с которыми связаны корректирующие отрицательные баллы. Если настройка отключена, то датой начала действия отрицательного балла будет дата и время проведения чека возврата. Настройка включена, если установлена в значение 1, y или Y. 
ПартнерскаяLoyalty.Processing.Refund.ChequeReference.StatusBonus.RateНастройка "Коэффициент возврата оплаченных статусных баллов". Значение, на которое умножаются статусные баллы, которые рассчитались системой как необходимые для возврата. Используется только при возврате со ссылкой на чек покупки. Допустимые значения – положительные десятичные числа.  При необходимости её значение можно поменять. Следует обратить внимание, что в эту настройку записывается число, если настройка пуста, или заполнена какими-то знаками, не отвечающие числовому значению, то коэффициент будет равен нулю, и бонусные баллы не будут возвращаться на карту лояльности. Также следует обратить внимание, что в качестве десятичного разделителя должна использоваться точка. 
ПартнерскаяLoyalty.Processing.Refund.ChequeReference.Bonus.RateНастройка "Коэффициент возврата оплаченных баллов". Значение, на которое умножаются баллы, которые рассчитались системой как необходимые для возврата. Используется только при возврате со ссылкой на чек покупки. Допустимые значения – положительные десятичные числа. Следует обратить внимание, что в эту настройку записывается число, если настройка пуста, или заполнена какими-то знаками, не отвечающие числовому значению, то коэффициент будет равен нулю, и бонусные баллы не будут возвращаться на карту лояльности. Также следует обратить внимание, что в качестве десятичного разделителя должна использоваться точка. 
ПартнерскаяLoyalty.Processing.Refund.PositionReferenceНастройка, включающая алгоритм возврата со ссылкой на позицию чека. При таком возврате в чеке возврата, номера возвращаемых позиций должны совпадать с номерами аналогичных позиций чека покупки. Настройка включена, если установлена в значения 1, y или Y. Дополнительно необходимо разрешить возврат со ссылкой для нужных партнёров. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.AlgorithmRefund.RefChequeНастройка, в которой указан номер алгоритма возврата в случае установленного по умолчанию алгоритма возврата без ссылки на чек покупки. Используется при нежёстком значении системной настройки Loyalty.Processing.Refund.Bonus.Algorithm.NonFlexible.  В текущей версии допустимые значения 0 и 2. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.CampaignНастройка "Кампания возврата бонусов". В настройку записывается идентификатор кампании, посредством которой будут возвращаться баллы, если покупка предусматривала оплату баллами. Следует обязательно указывать действующую кампанию в системе. Лучше всего завести отельную, постояннодействующую кампанию и использовать её только для данного случая. Настройка учитывается при возврате без ссылки на чек покупки. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.AlgorithmRefundНастройка "Выбор алгоритма возврата".  Значения: 0 – Возврат простым вычитанием; 2 – Возврат баллов при помощи составления дифференциального чека. Возврат простым вычитанием не подразумевает ссылки на чек, по которому осуществляется возврат. В данном случае возможен возврат не проданных ранее товаров. Значение 2 подразумевает обязательную связь с чеком, по которому будет производиться возврат. Ссылка на чек покупки подразумевает передачу с POS-терминала: номера чека, кода терминала, кода магазина, кода партнёра, даты чека покупки. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.Algorithm.NonFlexibleНастройка, регламентирующая закрепление алгоритма возврата. Если значение 1 – то алгоритм жёсткий, только такой, какой установлен в системной настройке Loyalty.Processing.Refund.Bonus.AlgorithmRefund. При других значениях допустимо использование иного алгоритма возврата. То есть, если по какой-то причине используется алгоритм со ссылкой, но чек покупки не предъявлен, в случае нежёсткой настройки возможна обработка чека без ссылки. Какой именно алгоритм будет использоваться в нежёстком случае, определяется настройкой: Loyalty.Processing.Refund.Bonus.AlgorithmRefund.RefCheque 
ПартнерскаяLoyalty.Processing.Refund.Bonus.CorrectionTypeТип коррекции баллов начисления при возврате. Если значение настройки равно 0, то при возврате разрешены любые коррекции баллов начисления. Если значение равно 1, то при коррекции баллов не будут начислены положительные баллы, более чем было начислено в первоначальном чеке покупки по конкретному правилу. Если значение равно 2, то при коррекции баллов начисления не будут начислены отрицательные баллы, уменьшающие начисленные при покупке баллы. Если значение равно 3, то запрещены все коррекции баллов начисления по конкретному правилу, как увеличивающие начисления, так и уменьшающие начисления. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.StartDateНастройка "Дата начала действия возвращаемых бонусных баллов". Допустимые значения в диапазоне от 1 января 2000 года до 1 января 3000 года. Формат ввода: [год][месяц][день], цифрами без пробелов. Применимость настройки зависит от значения системной настройки: Loyalty.Processing.Refund.Bonus.StartDateCalculationType, если данная настройка имеет значение 3, то в системе учитывается значение текущей настройки. Если текущая настройка введена не в правильном формате, то, по умолчанию, используется значение 1 января 2000 года. 
ПартнерскаяLoyalty.Processing.Refund.Bonus.StartDateCalculationTypeНастройка "Тип даты начала действия для возвращаемых бонусных баллов". Допустимые значения:  1, 2, 3. Значение по умолчанию: 1. Если значение данной настройки равно 1, то в качестве даты начала действия возвращаемых баллов берётся дата, указанная в чеке, по которому производится возврат (текущая дата и время возврата). Если значение данной настройки равно 2, то к дате чека добавляется количество дней, указанных в настройке: Loyalty.Processing.Refund.Bonus.InactivePeriod.  Если значение данной настройки равно 3, то дата начала действия возвращаемых бонусных баллов берётся из значения настройки Loyalty.Processing.Refund.Bonus.StartDate. Относится к баллам, которыми был оплачен чек при покупке. 
Партнерская Loyalty.Processing.Refund.Idempotence.TurnOn
 		Включение функционала ответа на повторный запрос возврата, результатом из первичного успешного запроса. При значениях 1, y или Y -  функциональность включена, при прочих значениях, а также при выключенной настройке – выключена.
Работает в связке с уже имеющейся настройкой Loyalty.Processing.Refund.CheckUniquenessInTransactionLog.TurnOn
Если в значении 0, то идемпотентность выполняется по номеру, посу и дате,
если в значении 1, то по request_id.
ПартнерскаяLoyalty.Processing.Refund.Bonus.ProlongValidityPeriods.TurnOnВключение функциональности продления периодов действия баллов, сформированных как коррекция списания при возврате. При значениях 1, y или Y сроки начала действия начисляемых при возврате в кредит баллов копируются сроками начала действия порций, из которых было совершено гашение баллов списания при покупке. Сроки же окончания действия продлеваются на величину разницы между датой возврата и датой покупки. При прочих значениях, а также при отсутствии настройки, сроки действия баллов коррекции регулируются настройками: Loyalty.Processing.Refund.Bonus.SaveValidityPeriods.TurnOn, Loyalty.Processing.Refund.Bonus.ExpirationDateCalculationType и Loyalty.Processing.Refund.Bonus.StartDateCalculationType.
ПартнерскаяLoyalty.Processing.Refund.Bonus.SaveValidityPeriods.TurnOnВключение функциональности сохранения периодов действия баллов, сформированных как коррекция списания при возврате. При значениях 1, y или Y сроки действия начисляемых при возврате в кредит баллов копируются сроками действия порций, из которых было совершено гашение баллов списания при покупке. При прочих значениях, а также при отсутствии настройки, сроки действия баллов коррекции регулируются настройками: Loyalty.Processing.Refund.Bonus.ExpirationDateCalculationType и Loyalty.Processing.Refund.Bonus.StartDateCalculationType.
Партнерская Loyalty.Processing.ReturnNoCardНастройка включает функционал возврата без номера карты. При значениях: 1, y или Y – функциональность считается включенной. При прочих значениях, в том числе NULL или отсутствие настройки – выключенной.