Gecko [ www.garmin.alinaous.com ]

Name	Size	Permission
OrderProductRemover.php	8.45 KB	-rw----r--
OrderRefundCalculator.php	11.1 KB	-rw----r--
OrderRefundSummary.php	3.96 KB	-rw----r--
OrderRefundUpdater.php	3.89 KB	-rw----r--
OrderSlipCreator.php	12.83 KB	-rw----r--
VoucherGenerator.php	5.31 KB	-rw----r--

Code Editor : OrderRefundCalculator.php

<?php
/**
 * Copyright since 2007 PrestaShop SA and Contributors
 * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
 *
 * NOTICE OF LICENSE
 *
 * This source file is subject to the Open Software License (OSL 3.0)
 * that is bundled with this package in the file LICENSE.md.
 * It is also available through the world-wide-web at this URL:
 * https://opensource.org/licenses/OSL-3.0
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@prestashop.com so we can send you a copy immediately.
 *
 * DISCLAIMER
 *
 * Do not edit or add to this file if you wish to upgrade PrestaShop to newer
 * versions in the future. If you wish to customize PrestaShop for your
 * needs please refer to https://devdocs.prestashop.com/ for more information.
 *
 * @author    PrestaShop SA and Contributors <contact@prestashop.com>
 * @copyright Since 2007 PrestaShop SA and Contributors
 * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
 */

namespace PrestaShop\PrestaShop\Adapter\Order\Refund;

use Address;
use Carrier;
use Currency;
use Customer;
use Customization;
use Group;
use Order;
use OrderDetail;
use OrderSlip;
use PrestaShop\Decimal\Number;
use PrestaShop\PrestaShop\Core\Domain\Order\Exception\InvalidCancelProductException;
use PrestaShop\PrestaShop\Core\Domain\Order\ValueObject\OrderDetailRefund;
use PrestaShop\PrestaShop\Core\Domain\Order\VoucherRefundType;
use PrestaShop\PrestaShop\Core\Localization\CLDR\ComputingPrecision;
use PrestaShopDatabaseException;
use PrestaShopException;
use TaxCalculator;
use Tools;

/**
 * Performs all computation for a refund on an Order, returns a OrderRefundDetail
 * object which contains all the refund detail.
 */
class OrderRefundCalculator
{
    /**
     * @param Order $order
     * @param array $orderDetailRefunds
     * @param Number $shippingRefund
     * @param int $voucherRefundType
     * @param Number|null $chosenVoucherAmount
     *
     * @return OrderRefundSummary
     *
     * @throws InvalidCancelProductException
     * @throws PrestaShopDatabaseException
     * @throws PrestaShopException
     */
    public function computeOrderRefund(
        Order $order,
        array $orderDetailRefunds,
        Number $shippingRefund,
        int $voucherRefundType,
        ?Number $chosenVoucherAmount
    ): OrderRefundSummary {
        $isTaxIncluded = $this->isTaxIncludedInOrder($order);
        $precision = $this->getPrecision($order);

$orderDetailList = $this->getOrderDetailList($orderDetailRefunds);
        $productRefunds = $this->flattenCheckedProductRefunds(
            $orderDetailRefunds,
            $isTaxIncluded,
            $orderDetailList,
            $precision
        );

$numberZero = new Number('0');

$refundedAmount = $numberZero;
        foreach ($productRefunds as $orderDetailId => $productRefund) {
            $refundedAmount = $refundedAmount->plus(new Number((string) $productRefund['amount']));
        }

$voucherChosen = false;
        $voucherAmount = $numberZero;
        if ($voucherRefundType === VoucherRefundType::PRODUCT_PRICES_EXCLUDING_VOUCHER_REFUND) {
            $voucherAmount = new Number((string) $order->total_discounts);
            $refundedAmount = $refundedAmount->minus($voucherAmount);
        } elseif ($voucherRefundType === VoucherRefundType::SPECIFIC_AMOUNT_REFUND) {
            $voucherChosen = true;
            $refundedAmount = $voucherAmount = $chosenVoucherAmount;
        }

$shippingCostAmount = $shippingRefund ?? $numberZero;
        if ($shippingCostAmount->isPositive()) {
            $shippingMaxRefund = new Number(
                $isTaxIncluded ?
                    (string) $order->total_shipping_tax_incl :
                    (string) $order->total_shipping_tax_excl
            );

$shippingSlipResume = OrderSlip::getShippingSlipResume($order->id);
            $shippingSlipTotalTaxIncl = new Number((string) ($shippingSlipResume['total_shipping_tax_incl'] ?? 0));
            $shippingMaxRefund = $shippingMaxRefund->minus($shippingSlipTotalTaxIncl);

if ($shippingCostAmount->isGreaterThan($shippingMaxRefund)) {
                $shippingCostAmount = $shippingMaxRefund;
            }
            // Previously taxes were computed but then some values are mixed with and without taxes
            // They all should be in the same state since OrderRefundSummary contains $isTaxIncluded
            $refundedAmount = $refundedAmount->plus($shippingCostAmount);
        }

// Something has to be refunded (check refunds count instead of the sum in case a voucher is implied)
        if (count($productRefunds) <= 0 && $refundedAmount->isLowerOrEqualThanZero()) {
            throw new InvalidCancelProductException(InvalidCancelProductException::NO_REFUNDS);
        }

return new OrderRefundSummary(
            $orderDetailList,
            $productRefunds,
            (float) (string) $refundedAmount,
            (float) (string) $shippingCostAmount,
            (float) (string) $voucherAmount,
            $voucherChosen,
            $isTaxIncluded,
            $precision
        );
    }

/**
     * @param array $orderDetailRefunds
     *
     * @return OrderDetail[]
     *
     * @throws PrestaShopDatabaseException
     * @throws PrestaShopException
     */
    private function getOrderDetailList(array $orderDetailRefunds)
    {
        $orderDetailList = [];
        /** @var OrderDetailRefund $orderDetailRefund */
        foreach ($orderDetailRefunds as $orderDetailRefund) {
            $orderDetailList[$orderDetailRefund->getOrderDetailId()] = new OrderDetail($orderDetailRefund->getOrderDetailId());
        }

return $orderDetailList;
    }

/**
     * @param array $orderDetailRefunds
     * @param bool $isTaxIncluded
     * @param array $orderDetails
     * @param TaxCalculator $taxCalculator
     * @param int $precision
     *
     * @return array
     *
     * @throws InvalidCancelProductException
     */
    private function flattenCheckedProductRefunds(
        array $orderDetailRefunds,
        bool $isTaxIncluded,
        array $orderDetails,
        int $precision
    ) {
        $productRefunds = [];
        /** @var OrderDetailRefund $orderDetailRefund */
        foreach ($orderDetailRefunds as $orderDetailRefund) {
            $orderDetailId = $orderDetailRefund->getOrderDetailId();
            /** @var OrderDetail $orderDetail */
            $orderDetail = $orderDetails[$orderDetailId];
            $quantity = $orderDetailRefund->getProductQuantity();
            if ($orderDetail->id_customization) {
                $customization = new Customization($orderDetail->id_customization);
                $quantityLeft = (int) $customization->quantity - (int) $customization->quantity_refunded - $customization->quantity_returned;
            } else {
                $quantityLeft = (int) $orderDetail->product_quantity - (int) $orderDetail->product_quantity_refunded - (int) $orderDetail->product_quantity_return;
            }
            if ($quantity > $quantityLeft) {
                throw new InvalidCancelProductException(InvalidCancelProductException::QUANTITY_TOO_HIGH, $quantityLeft);
            }

$productRefunds[$orderDetailId] = [
                'quantity' => $quantity,
                'id_order_detail' => $orderDetailId,
            ];

// Compute max refund by product (based on quantity left and already refunded amount)
            $productUnitPrice = $isTaxIncluded ? (float) $orderDetail->unit_price_tax_incl : (float) $orderDetail->unit_price_tax_excl;
            $productMaxRefund = (int) $quantity * $productUnitPrice;

// If refunded amount is null it means the whole product is refunded (used for standard refund, and return product)
            if (null === $orderDetailRefund->getRefundedAmount()) {
                $productRefundAmount = (float) (string) $productMaxRefund;
            } else {
                $productRefundAmount = (float) (string) $orderDetailRefund->getRefundedAmount() <= $productMaxRefund ?
                    (float) (string) $orderDetailRefund->getRefundedAmount() : $productMaxRefund;
            }

$productRefunds[$orderDetailId]['amount'] = $productRefundAmount;
            $productRefunds[$orderDetailId]['unit_price'] =
                $productRefunds[$orderDetailId]['amount'] / $productRefunds[$orderDetailId]['quantity'];

// We get the tax calculator from the OrderDetail which will make it use the tax rate at the moment the order was placed
            $taxCalculator = $orderDetail->getTaxCalculator();

// Add data for OrderDetail updates, it's important to round because too many decimals will fail in Validate::isPrice
            if ($isTaxIncluded) {
                $productRefunds[$orderDetailId]['total_refunded_tax_incl'] = Tools::ps_round($productRefundAmount, $precision);
                $productRefunds[$orderDetailId]['total_refunded_tax_excl'] = Tools::ps_round($taxCalculator->removeTaxes($productRefundAmount), $precision);
            } else {
                $productRefunds[$orderDetailId]['total_refunded_tax_excl'] = Tools::ps_round($productRefundAmount, $precision);
                $productRefunds[$orderDetailId]['total_refunded_tax_incl'] = Tools::ps_round($taxCalculator->addTaxes($productRefundAmount), $precision);
            }

// Add missing fields
            $productRefunds[$orderDetailId]['unit_price_tax_excl'] = (float) $orderDetail->unit_price_tax_excl;
            $productRefunds[$orderDetailId]['unit_price_tax_incl'] = (float) $orderDetail->unit_price_tax_incl;
            $productRefunds[$orderDetailId]['total_price_tax_excl'] = (float) $orderDetail->unit_price_tax_excl * $productRefunds[$orderDetailId]['quantity'];
            $productRefunds[$orderDetailId]['total_price_tax_incl'] = (float) $orderDetail->unit_price_tax_incl * $productRefunds[$orderDetailId]['quantity'];
        }

return $productRefunds;
    }

/**
     * @param Order $order
     *
     * @return bool
     */
    private function isTaxIncludedInOrder(Order $order): bool
    {
        $customer = new Customer($order->id_customer);

$taxCalculationMethod = Group::getPriceDisplayMethod((int) $customer->id_default_group);

return $taxCalculationMethod === PS_TAX_INC;
    }

/**
     * @param Order $order
     *
     * @return TaxCalculator
     *
     * @throws PrestaShopException
     */
    private function getCarrierTaxCalculatorFromOrder(Order $order): TaxCalculator
    {
        $carrier = new Carrier((int) $order->id_carrier);
        // @todo: define if we use invoice or delivery address, or we use configuration PS_TAX_ADDRESS_TYPE
        $address = Address::initialize($order->id_address_delivery, false);

return $carrier->getTaxCalculator($address);
    }

/**
     * @param Order $order
     *
     * @return int
     */
    private function getPrecision(Order $order): int
    {
        $currency = new Currency($order->id_currency);
        $computingPrecision = new ComputingPrecision();

return $computingPrecision->getPrecision($currency->precision);
    }
}

${this.title}

Code Editor : OrderRefundCalculator.php