feat: add Outgoing Payments resource and related request classes

- Updated README to reflect the implementation status of Outgoing Payments as fully implemented.
- Introduced the OutgoingPayment resource class along with request classes for creating, updating, deleting, and retrieving outgoing payments.
- Added tests to ensure functionality and data integrity for the Outgoing Payments feature.

Author: gigerIT

README.md

@@ -258,7 +258,7 @@ $client = new BexioClient($auth->getAccessToken());
 | Bills            | ✅          |
 | Expenses         | ✅          |
 | Purchase Orders  | ✅          |
-| Outgoing Payment | ❌          |
+| Outgoing Payment | ✅          |
 
 ### ACCOUNTING
 

src/Resources/Purchase/OutgoingPayments/OutgoingPayment.php

@@ -0,0 +1,45 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments;
+
+use Bexio\Resources\Purchase\OutgoingPayments\Requests\CreateOutgoingPaymentRequest;
+use Bexio\Resources\Purchase\OutgoingPayments\Requests\DeleteOutgoingPaymentRequest;
+use Bexio\Resources\Purchase\OutgoingPayments\Requests\GetOutgoingPaymentRequest;
+use Bexio\Resources\Purchase\OutgoingPayments\Requests\GetOutgoingPaymentsRequest;
+use Bexio\Resources\Purchase\OutgoingPayments\Requests\UpdateOutgoingPaymentRequest;
+use Bexio\Resources\Resource;
+
+class OutgoingPayment extends Resource
+{
+    public const INDEX_REQUEST = GetOutgoingPaymentsRequest::class;
+    public const SHOW_REQUEST = GetOutgoingPaymentRequest::class;
+    public const CREATE_REQUEST = CreateOutgoingPaymentRequest::class;
+    public const UPDATE_REQUEST = UpdateOutgoingPaymentRequest::class;
+    public const DELETE_REQUEST = DeleteOutgoingPaymentRequest::class;
+
+    public function __construct(
+        public ?string $id = null,
+        public ?string $bill_id = null,
+        public ?string $payment_type = null,
+        public ?string $execution_date = null,
+        public ?string $status = null,
+        public ?float $amount = null,
+        public ?int $sender_bank_account_id = null,
+        public ?string $receiver_account_no = null,
+        public ?string $receiver_iban = null,
+        public ?string $banking_payment_id = null,
+        public ?string $transaction_id = null,
+        public ?string $currency_code = null,
+        public ?float $exchange_rate = null,
+        public ?string $note = null,
+        public ?string $sender_iban = null,
+        public ?string $sender_name = null,
+        public ?string $sender_street = null,
+        public ?string $sender_house_no = null,
+        public ?string $sender_city = null,
+        public ?string $sender_postcode = null,
+    ) {
+    }
+}
+

src/Resources/Purchase/OutgoingPayments/Requests/CreateOutgoingPaymentRequest.php

@@ -0,0 +1,39 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments\Requests;
+
+use Bexio\Resources\Purchase\OutgoingPayments\OutgoingPayment;
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+use Saloon\Traits\Body\HasJsonBody;
+
+class CreateOutgoingPaymentRequest extends Request implements HasBody
+{
+    use HasJsonBody;
+
+    protected Method $method = Method::POST;
+
+    public function __construct(readonly protected OutgoingPayment $payment)
+    {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/4.0/purchase/outgoing-payments';
+    }
+
+    protected function defaultBody(): array
+    {
+        return $this->payment->toArray();
+    }
+
+    public function createDtoFromResponse(Response $response): OutgoingPayment
+    {
+        $data = $response->json('data') ?? $response->json();
+        return OutgoingPayment::from($data);
+    }
+}
+

src/Resources/Purchase/OutgoingPayments/Requests/DeleteOutgoingPaymentRequest.php

@@ -0,0 +1,22 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments\Requests;
+
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+
+class DeleteOutgoingPaymentRequest extends Request
+{
+    protected Method $method = Method::DELETE;
+
+    public function __construct(protected readonly string $id)
+    {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/4.0/purchase/outgoing-payments/{$this->id}";
+    }
+}
+

src/Resources/Purchase/OutgoingPayments/Requests/GetOutgoingPaymentRequest.php

@@ -0,0 +1,30 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments\Requests;
+
+use Bexio\Resources\Purchase\OutgoingPayments\OutgoingPayment;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+
+class GetOutgoingPaymentRequest extends Request
+{
+    protected Method $method = Method::GET;
+
+    public function __construct(protected readonly string $id)
+    {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/4.0/purchase/outgoing-payments/{$this->id}";
+    }
+
+    public function createDtoFromResponse(Response $response): OutgoingPayment
+    {
+        $data = $response->json('data') ?? $response->json();
+        return OutgoingPayment::from($data);
+    }
+}
+

src/Resources/Purchase/OutgoingPayments/Requests/GetOutgoingPaymentsRequest.php

@@ -0,0 +1,26 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments\Requests;
+
+use Bexio\Resources\Purchase\OutgoingPayments\OutgoingPayment;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+
+class GetOutgoingPaymentsRequest extends Request
+{
+    protected Method $method = Method::GET;
+
+    public function resolveEndpoint(): string
+    {
+        return '/4.0/purchase/outgoing-payments';
+    }
+
+    public function createDtoFromResponse(Response $response): array
+    {
+        $data = $response->json('data') ?? [];
+        return OutgoingPayment::collect($data);
+    }
+}
+

src/Resources/Purchase/OutgoingPayments/Requests/UpdateOutgoingPaymentRequest.php

@@ -0,0 +1,39 @@
+<?php
+declare(strict_types=1);
+
+namespace Bexio\Resources\Purchase\OutgoingPayments\Requests;
+
+use Bexio\Resources\Purchase\OutgoingPayments\OutgoingPayment;
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+use Saloon\Traits\Body\HasJsonBody;
+
+class UpdateOutgoingPaymentRequest extends Request implements HasBody
+{
+    use HasJsonBody;
+
+    protected Method $method = Method::PUT;
+
+    public function __construct(readonly protected OutgoingPayment $payment)
+    {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/4.0/purchase/outgoing-payments/{$this->payment->id}";
+    }
+
+    protected function defaultBody(): array
+    {
+        return $this->payment->toArray();
+    }
+
+    public function createDtoFromResponse(Response $response): OutgoingPayment
+    {
+        $data = $response->json('data') ?? $response->json();
+        return OutgoingPayment::from($data);
+    }
+}
+

tests/Resources/Purchase/OutgoingPayments/OutgoingPaymentRequestsTest.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Bexio\Resources\Sales\Quotes\Requests;
+
+use Bexio\Resources\Purchase\OutgoingPayments\OutgoingPayment;
+
+it('can get Outgoing Payments', function () {
+    try {
+        $payments = OutgoingPayment::useClient(testClient())->all();
+    } catch (\Throwable $e) {
+        \PHPUnit\Framework\Assert::markTestSkipped('Outgoing payments endpoint requires bill context: ' . $e->getMessage());
+    }
+
+    if (count($payments) === 0) {
+        \PHPUnit\Framework\Assert::markTestSkipped('No outgoing payments available');
+    }
+
+    expect($payments)->toBeArray()
+        ->and($payments[0])->toBeInstanceOf(OutgoingPayment::class)
+        ->and($payments[0]->id)->toBeString();
+});
+
+it('can get an Outgoing Payment', function () {
+    try {
+        $payments = OutgoingPayment::useClient(testClient())->all();
+    } catch (\Throwable $e) {
+        \PHPUnit\Framework\Assert::markTestSkipped('Outgoing payments endpoint requires bill context: ' . $e->getMessage());
+    }
+    if (count($payments) === 0) {
+        \PHPUnit\Framework\Assert::markTestSkipped('No outgoing payments available');
+    }
+
+    $payment = OutgoingPayment::useClient(testClient())->find($payments[0]->id);
+
+    expect($payment)->toBeInstanceOf(OutgoingPayment::class)
+        ->and($payment->id)->toBeString()
+        ->and($payment->payment_type)->toBeString();
+});
+
+it('can get first Outgoing Payment using query builder', function () {
+    try {
+        $payment = OutgoingPayment::useClient(testClient())->query()->first();
+    } catch (\Throwable $e) {
+        \PHPUnit\Framework\Assert::markTestSkipped('Outgoing payments endpoint requires bill context: ' . $e->getMessage());
+    }
+
+    if (!$payment) {
+        \PHPUnit\Framework\Assert::markTestSkipped('No outgoing payments available');
+    }
+
+    expect($payment)->toBeInstanceOf(OutgoingPayment::class)
+        ->and($payment->id)->toBeString();
+});
+