From 71d364ac55851ac02554b6b65d34949ea4a29c6f Mon Sep 17 00:00:00 2001 From: Geo Kef Date: Sun, 20 Oct 2024 21:21:04 +0300 Subject: [PATCH] Update ExpensesClassification.php --- src/Models/ExpensesClassification.php | 125 ++++++++++++++++++++------ 1 file changed, 100 insertions(+), 25 deletions(-) diff --git a/src/Models/ExpensesClassification.php b/src/Models/ExpensesClassification.php index 3ffa168..58bc7a9 100644 --- a/src/Models/ExpensesClassification.php +++ b/src/Models/ExpensesClassification.php @@ -7,15 +7,16 @@ use Firebed\AadeMyData\Enums\VatCategory; use Firebed\AadeMyData\Enums\VatExemption; use Firebed\AadeMyData\Traits\HasFactory; +use InvalidArgumentException; /** - *

Ο τύπος ExpensesClassification αποτελεί τη βασική δομή του Χαρακτηρισμού Εξόδων και εμπεριέχεται είτε

- * + * Ο τύπος ExpensesClassification αποτελεί τη βασική δομή του Χαρακτηρισμού Εξόδων και εμπεριέχεται είτε + + * - σε κάθε γραμμή του παραστατικού ξεχωριστά (χαρακτηρισμός γραμμής) + * - στην περίληψη παραστατικού (άθροισμα χαρακτηρισμών ανά τύπο - κατηγορία) + * - στο αντικείμενο InvoiceExpensesClassification όταν οι χαρακτηρισμοί εσόδων υποβάλλονται ξεχωριστά μέσω της + * κλήσης SendExpensesClassification (βλ παράγραφος 4.3.3) + */ class ExpensesClassification extends Type { @@ -32,10 +33,10 @@ class ExpensesClassification extends Type ]; protected array $casts = [ - 'classificationType' => ExpenseClassificationType::class, + 'classificationType' => ExpenseClassificationType::class, 'classificationCategory' => ExpenseClassificationCategory::class, - 'vatCategory' => VatCategory::class, - 'vatExemptionCategory' => VatExemption::class, + 'vatCategory' => VatCategory::class, + 'vatExemptionCategory' => VatExemption::class, ]; /** @@ -50,10 +51,19 @@ public function getClassificationType(): ?ExpenseClassificationType * Το πεδίο classificationCategory χρησιμοποιείται μόνο για τους χαρακτηρισμούς * εξόδων Ε3, αλλιώς αγνοείται. * - * @param ExpenseClassificationType|string|null $classificationType Κωδικός Χαρακτηρισμού + * @param ExpenseClassificationType|string|null $classificationType Κωδικός Χαρακτηρισμού + * @throws InvalidArgumentException */ public function setClassificationType(ExpenseClassificationType|string|null $classificationType): static { + if (is_string($classificationType)) { + $classificationType = ExpenseClassificationType::tryFrom($classificationType); + + if (is_null($classificationType)) { + throw new InvalidArgumentException('Invalid classification type provided.'); + } + } + return $this->set('classificationType', $classificationType); } @@ -66,10 +76,19 @@ public function getClassificationCategory(): ?ExpenseClassificationCategory } /** - * @param ExpenseClassificationCategory|string|null $classificationCategory Κατηγορία Χαρακτηρισμού + * @param ExpenseClassificationCategory|string|null $classificationCategory Κατηγορία Χαρακτηρισμού + * @throws InvalidArgumentException */ public function setClassificationCategory(ExpenseClassificationCategory|string|null $classificationCategory): static { + if (is_string($classificationCategory)) { + $classificationCategory = ExpenseClassificationCategory::tryFrom($classificationCategory); + + if (is_null($classificationCategory)) { + throw new InvalidArgumentException('Invalid classification category provided.'); + } + } + return $this->set('classificationCategory', $classificationCategory); } @@ -87,25 +106,42 @@ public function getAmount(): ?float *
  • Δεκαδικά ψηφία = 2
    • * * - * @param float $amount Ποσό + * @param float $amount Ποσό + * @throws InvalidArgumentException */ public function setAmount(float $amount): static { + if ($amount < 0) { + throw new InvalidArgumentException('The amount cannot be negative.'); + } + + $amount = round($amount, 2); + return $this->set('amount', $amount); } + /** + * @param float|null $amount Το ποσό που θα προστεθεί + * @throws InvalidArgumentException + */ public function addAmount(?float $amount): static { if ($amount === null) { return $this; } - return $this->set('amount', $this->getAmount() + $amount); + if ($amount < 0) { + throw new InvalidArgumentException('The amount to add cannot be negative.'); + } + + $currentAmount = $this->getAmount() ?? 0.0; + + return $this->set('amount', round($currentAmount + $amount, 2)); } /** * @return float|null Ποσό ΦΠΑ - * @version 1.0.7 + */ public function getVatAmount(): ?float { @@ -113,28 +149,44 @@ public function getVatAmount(): ?float } /** - * Χρησιμοποιείτε μόνο για τους χαρακτηρισμούς εξόδων ΦΠΑ, διαφορετικά αγνοείται. - * - * @param float|null $vatAmount Ποσό ΦΠΑ (Ελάχιστη τιμή 0, δεκαδικά 2) - * @version 1.0.7 + + + * @param float|null $vatAmount Ποσό ΦΠΑ + * @throws InvalidArgumentException */ public function setVatAmount(?float $vatAmount): static { + if ($vatAmount !== null && $vatAmount < 0) { + throw new InvalidArgumentException('The VAT amount cannot be negative.'); + } + + $vatAmount = $vatAmount !== null ? round($vatAmount, 2) : null; + return $this->set('vatAmount', $vatAmount); } + /** + * @param float|null $amount Το ποσό ΦΠΑ που θα προστεθεί + * @throws InvalidArgumentException + */ public function addVatAmount(?float $amount): static { if ($amount === null) { return $this; } - return $this->set('vatAmount', $this->getVatAmount() + $amount); + if ($amount < 0) { + throw new InvalidArgumentException('The VAT amount to add cannot be negative.'); + } + + $currentVatAmount = $this->getVatAmount() ?? 0.0; + + return $this->set('vatAmount', round($currentVatAmount + $amount, 2)); } /** * @return VatCategory|null Κατηγορία ΦΠΑ - * @version 1.0.7 + */ public function getVatCategory(): ?VatCategory { @@ -145,16 +197,25 @@ public function getVatCategory(): ?VatCategory * Χρησιμοποιείτε μόνο για τους χαρακτηρισμούς εξόδων ΦΠΑ, διαφορετικά αγνοείται. * * @param VatCategory|int|null $vatCategory Κατηγορία ΦΠΑ - * @version 1.0.7 + * @version 1.0.9 + * @throws InvalidArgumentException */ public function setVatCategory(VatCategory|int|null $vatCategory): static { + if (is_int($vatCategory)) { + $vatCategory = VatCategory::tryFrom($vatCategory); + + if (is_null($vatCategory)) { + throw new InvalidArgumentException('Invalid VAT category provided.'); + } + } + return $this->set('vatCategory', $vatCategory); } /** * @return VatExemption|null Κατηγορία Εξαίρεσης ΦΠΑ - * @version 1.0.7 + * @version 1.0.9 */ public function getVatExemptionCategory(): ?VatExemption { @@ -166,9 +227,18 @@ public function getVatExemptionCategory(): ?VatExemption * * @param VatExemption|int|null $vatExemptionCategory Κατηγορία Εξαίρεσης ΦΠΑ * @version 1.0.7 + * @throws InvalidArgumentException */ public function setVatExemptionCategory(VatExemption|int|null $vatExemptionCategory): static { + if (is_int($vatExemptionCategory)) { + $vatExemptionCategory = VatExemption::tryFrom($vatExemptionCategory); + + if (is_null($vatExemptionCategory)) { + throw new InvalidArgumentException('Invalid VAT exemption category provided.'); + } + } + return $this->set('vatExemptionCategory', $vatExemptionCategory); } @@ -183,10 +253,15 @@ public function getId(): ?int /** * Το πεδίο id προσφέρεται για σειριακή αρίθμηση (1,2,3… κλπ) των χαρακτηρισμών εντός μιας γραμμής. * - * @param int $id Αύξων αριθμός Χαρακτηρισμού + * @param int $id Αύξων αριθμός Χαρακτηρισμού + * @throws InvalidArgumentException */ public function setId(int $id): static { + if ($id < 0) { + throw new InvalidArgumentException('The ID cannot be negative.'); + } + return $this->set('id', $id); } -} \ No newline at end of file +}