Add GoodTaxes::getTaxesByCode() and update README file.

Author: digitv

README.md

@@ -275,7 +275,7 @@ $receipt = new \DigitSoft\Checkbox\Models\Receipts\SellReceipt(
             )
         ]
     ),
-    'admin@gmail.com', // кому надсилати чек на пошту
+    new \DigitSoft\Checkbox\Models\Receipts\Delivery(['admin@gmail.com']), // кому надсилати чек на пошту
     new \DigitSoft\Checkbox\Models\Receipts\Payments\Payments([
         new \DigitSoft\Checkbox\Models\Receipts\Payments\CardPaymentPayload( // безготівкова оплата
             40 * 100 // 40 грн
@@ -336,7 +336,7 @@ $receipt = new \DigitSoft\Checkbox\Models\Receipts\SellReceipt(
             )
         ]
     ),
-    'admin@example.com', // кому надсилати чек на пошту
+    new \DigitSoft\Checkbox\Models\Receipts\Delivery(['admin@gmail.com']), // кому надсилати чек на пошту
     new \DigitSoft\Checkbox\Models\Receipts\Payments\Payments([ // оплати
         new \DigitSoft\Checkbox\Models\Receipts\Payments\CardPaymentPayload( // безготівкова оплата
             400, // сума оплати 400 = 4 грн
@@ -372,7 +372,7 @@ $saleReceiptResult = $api->receipts()->createSell($receipt): \DigitSoft\Checkbox
 ```php
 $allTaxes = $api->taxes()->all();
 $tax = $allTaxes->getTaxByLabel('Акцизний збір');
-$goodTaxes = $allTaxes->getTaxesByLabel('ПДВ');
+$goodTaxes = $allTaxes->getTaxesByCode('1'); // ПДВ 20%
 $taxCodes = [];
 
 foreach ($goodTaxes->results as $goodTax) {
@@ -444,7 +444,7 @@ $receipt = new \DigitSoft\Checkbox\Models\Receipts\SellReceipt(
             )
         ]
     ),
-    'admin@gmail.com',
+    new \DigitSoft\Checkbox\Models\Receipts\Delivery(['admin@gmail.com']),
     new \DigitSoft\Checkbox\Models\Receipts\Payments\Payments([
         new \DigitSoft\Checkbox\Models\Receipts\Payments\CardPaymentPayload(
             4700
@@ -547,6 +547,7 @@ use DigitSoft\Checkbox\Models\Receipts\Goods\GoodModel;
 use DigitSoft\Checkbox\Models\Receipts\Goods\GoodItemModel;
 use DigitSoft\Checkbox\Models\Receipts\SellReceipt;
 use DigitSoft\Checkbox\Models\Receipts\ServiceReceipt;
+use DigitSoft\Checkbox\Models\Receipts\Delivery;
 
 use DigitSoft\Checkbox\Models\Receipts\Payments\Payments;
 use DigitSoft\Checkbox\Models\Receipts\Payments\CardPaymentPayload;

composer.json

@@ -3,7 +3,7 @@
     "description": "PHP SDK for integration with checkbox.ua API",
     "type": "library",
     "license": "MIT",
-    "version": "0.2.2",
+    "version": "0.2.3",
     "authors": [
         {
             "name": "Digit",

src/Models/Receipts/Taxes/GoodTaxes.php

@@ -24,6 +24,12 @@ public function __construct(array $taxes)
         }
     }
 
+    /**
+     * Retrieve one tax by `label`.
+     *
+     * @param  string $label
+     * @return \DigitSoft\Checkbox\Models\Receipts\Taxes\GoodTax|null
+     */
     public function getTaxByLabel(string $label): ?GoodTax
     {
         foreach ($this->results as $tax) {
@@ -35,6 +41,13 @@ public function getTaxByLabel(string $label): ?GoodTax
         return null;
     }
 
+    /**
+     * Retrieve taxes by `label`.
+     *
+     * @param  string $label
+     * @return \DigitSoft\Checkbox\Models\Receipts\Taxes\GoodTaxes|null
+     * @throws \Exception
+     */
     public function getTaxesByLabel(string $label): ?GoodTaxes
     {
         $taxesArr = [];
@@ -47,4 +60,35 @@ public function getTaxesByLabel(string $label): ?GoodTaxes
 
         return new GoodTaxes($taxesArr);
     }
+
+    /**
+     * Retrieve one tax by `code`.
+     *
+     * @param  string $code
+     * @return \DigitSoft\Checkbox\Models\Receipts\Taxes\GoodTax|null
+     */
+    public function getTaxByCode(string $code): ?GoodTax
+    {
+        foreach ($this->results as $tax) {
+            if ($tax->code === $code) {
+                return $tax;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Retrieve taxes by `code`.
+     *
+     * @param  string $code
+     * @return \DigitSoft\Checkbox\Models\Receipts\Taxes\GoodTaxes
+     * @throws \Exception
+     */
+    public function getTaxesByCode(string $code): GoodTaxes
+    {
+        $taxes = array_filter($this->results, fn (GoodTax $tax) => $tax->code === $code);
+
+        return new GoodTaxes(array_values($taxes));
+    }
 }