libredte\lib\Core\Package\Billing\Component\Document\Worker\Normalizer\Helper\Utils

Complexity

Total Complexity

6

Size/Duplication

Total Lines	55
Duplicated Lines	0 %

Test Coverage

Coverage

90.91%

Importance

Changes	1
Bugs	0	Features	0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	calcularNetoIVA()	0	13	3
A	round()	0	8	3

<?php

declare(strict_types=1);

/**
 * LibreDTE: Biblioteca PHP (Núcleo).
 * Copyright (C) LibreDTE <https://www.libredte.cl>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la Licencia Pública General Affero de GNU publicada por
 * la Fundación para el Software Libre, ya sea la versión 3 de la Licencia, o
 * (a su elección) cualquier versión posterior de la misma.
 *
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la Licencia Pública
 * General Affero de GNU para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la Licencia Pública General Affero de
 * GNU junto a este programa.
 *
 * En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
 */

namespace libredte\lib\Core\Package\Billing\Component\Document\Worker\Normalizer\Helper;

/**
 * Utilidades que pueden ser usadas en diferentes procesos de normalización y
 * son independientes del resto del documento.
 */
class Utils
{
    /**
     * Redondea valores asociados a un tipo de moneda.
     *
     * Si los valores son en pesos chilenos se redondea sin decimales. Si los
     * valores están en otro tipo de moneda se mantienen los decimales, por
     * defecto se mantienen 4 decimales.
     *
     * @param int|float $amount Valor que se desea redondear.
     * @param string|null|false $currency La moneda en la que está el valor.
     * @param int $decimals Cantidad de decimales a mantener cuando la moneda
     * no es peso chileno.
     * @return int|float Valor redondeado según la moneda y decimales a usar.
     */
    public static function round(
        int|float $amount,
        string|null|false $currency = null,
        int $decimals = 4
    ): int|float {
        return (!$currency || $currency === 'PESO CL')
            ? (int) round($amount)
            : (float) round($amount, $decimals)
        ;
    }

    /**
     * Obtiene el monto neto y el IVA de ese neto a partir de un monto total.
     *
     * NOTE: El IVA obtenido puede no ser el NETO * (TASA / 100). Se calcula el
     * monto neto y luego se obtiene el IVA haciendo la resta entre el total y
     * el neto. Hay casos de borde que generan problemas como:
     *
     *   - BRUTO:   680 => NETO:   571 e IVA:   108 => TOTAL:   679
     *   - BRUTO: 86710 => NETO: 72866 e IVA: 13845 => TOTAL: 86711
     *
     * Estos casos son "normales", pues por aproximaciones "no da".
     *
     * @param int $total Total que representa el monto neto más el IVA.
     * @param int|float|false $tasa Tasa del IVA o `false` si no corresponde.
     * @return array Arreglo con el neto y el IVA en índices 0 y 1.
     */
    public static function calcularNetoIVA($total, int|float|false $tasa): array
    {
        // Si no existe tasa es porque no hay Neto ni IVA (doc exento).
        if ($tasa === 0 || $tasa === false) {
            return [0, 0];
        }

        // Obtener el neto e IVA a partir del total.
        $neto = round($total / (1 + ($tasa / 100)));
        $iva = $total - $neto;

        // Entregar el neto e IVA.
        return [$neto, $iva];
    }
}