How to avoid discount amount getting refunded during return

<MultiApi>
	<API Name="createOrder">
		<Input>
			<Order OrderNo="IBM_S01" EnterpriseCode="IBM_E" SellerOrganizationCode="IBM_E" DocumentType="0001" DraftOrderFlag="N">
				<OrderLines>
					<OrderLine OrderedQty="1" DeliveryMethod="SHP" FulfillmentType="IBM_F" PrimeLineNo="1" SubLineNo="1" ShipNode="IBM_N1">
						<LinePriceInfo IsPriceLocked="Y" UnitPrice="20" />
						<Item ItemID="IBM_I1" UnitOfMeasure="EACH" ProductClass="NEW" />
						<PersonInfoShipTo Country="US" />
					</OrderLine>
				</OrderLines>
				<PaymentMethods>
					<PaymentMethod CreditCardExpDate="2099-12-31" CreditCardNo="IBM_123456789" CreditCardType="VISA" DisplayCreditCardNo="6789" 
					FirstName="IBM_CUSTOMER" PaymentType="CREDIT_CARD">
						<PersonInfoBillTo Country="US" />
						<PaymentDetailsList>
							<PaymentDetails ChargeType="AUTHORIZATION" ProcessedAmount="0" RequestAmount="20" />
						</PaymentDetailsList>
					</PaymentMethod>
				</PaymentMethods>
				<PersonInfoBillTo Country="US" />
			</Order>
		</Input>
	</API>
</MultiApi>

<MultiApi>
	<API Name="processOrderPayments">
		<Input>
			<Order DocumentType="0001" EnterpriseCode="IBM_E" OrderNo="IBM_S01" />
		</Input>
	</API>
</MultiApi>

Once the initial authorization is done, let us apply a discount of $5 on the sales order.

<MultiApi>
	<API Name="changeOrder">
		<Input>
			<Order OrderNo="IBM_S01" EnterpriseCode="IBM_E" SellerOrganizationCode="IBM_E" DocumentType="0001" DraftOrderFlag="N">
				<HeaderCharges>
					<HeaderCharge ChargeAmount="5" ChargeCategory="CUSTOMER_APPEASEMENT" ChargeName="APPEASEMENT_DISCOUNT" />
				</HeaderCharges>
				<PersonInfoBillTo Country="US" />
			</Order>
		</Input>
	</API>
</MultiApi>

Let us do processOrderPayments so that reverse authorization of $5 happens on the order. We can then schedule and release order. We can then create and confirm shipment. We can also create invoice and settle the amount. The invoice will be created only for $15 (discounted amount) and not for $20 (original amount).

Now we have to create the return order. We can use the user exits such as YFSRecalculateHeaderTaxUE and YFSRecalculateLineTaxUE in order to calculate the amount of charges and taxes that is to be applied on the return order. Also, we have to create respective charge categories and charge names in the Reverse Logistics.

Charge Category for Sales Order:

Charge Category for Return Order:

While creating the return order, irrespective of whether we use user exits to find the necessary charge amounts or we pass the charge amounts manually, the input to the createOrder API should have the charges mentioned explicitly.

We shall create a return order by passing $5 as appeasement reversal charge so that it will nullify the discount applied on the sales order.

<MultiApi>
	<API Name="createOrder">
		<Input>
			<Order OrderNo="IBM_S01R1" EnterpriseCode="IBM_E" SellerOrganizationCode="IBM_E" DocumentType="0003" DraftOrderFlag="N" ProcessPaymentOnReturnOrder="N">
				<HeaderCharges>
					<HeaderCharge ChargeAmount="5" ChargeCategory="CUSTOMER_APPEASEMENT" ChargeName="APPEASEMENT_REVERSAL" />
				</HeaderCharges>
				<OrderLines>
					<OrderLine OrderedQty="1" ReturnReason="Test Return" ShipNode="IBM_N1" PrimeLineNo="1" SubLineNo="1">
						<DerivedFrom DocumentType="0001" EnterpriseCode="IBM_E" OrderNo="IBM_S01" PrimeLineNo="1" SubLineNo="1" />
					</OrderLine>
				</OrderLines>
				<PersonInfoBillTo Country="US" />
			</Order>
		</Input>
	</API>
</MultiApi>

Process the return order and initiate the refund. The refund will be created only for $15 (discounted amount) and not for $20 (original amount).

Hence we can avoid discount amount getting refunded during return.