registerForSalesInvoiceId

Author: sandervanhooft

src/Api/SalesInvoices/Payments/RegisterSalesInvoicePaymentRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sandorian\Moneybird\Api\SalesInvoices\Payments;
+
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Traits\Body\HasJsonBody;
+use Sandorian\Moneybird\Api\Support\BaseJsonPostRequest;
+
+class RegisterSalesInvoicePaymentRequest extends BaseJsonPostRequest implements HasBody
+{
+    use HasJsonBody;
+
+    public function __construct(
+        protected readonly string $salesInvoiceId,
+        protected readonly array $data,
+    ) {
+        //
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return 'sales_invoices/'.$this->salesInvoiceId.'/payments';
+    }
+
+    public function defaultBody(): array
+    {
+        return ['payment' => $this->data];
+    }
+}

src/Api/SalesInvoices/Payments/SalesInvoicePayment.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sandorian\Moneybird\Api\SalesInvoices\Payments;
+
+use Sandorian\Moneybird\Api\Support\BaseDto;
+
+class SalesInvoicePayment extends BaseDto
+{
+    public string $id;
+    public string $administration_id;
+    public string $invoice_id;
+    public string $payment_date;
+    public string $price;
+    public string $price_base;
+    public string $payment_method;
+    public string $created_at;
+    public string $updated_at;
+
+    public static function createFromResponseData(array $data): static
+    {
+        $instance = new static();
+        foreach ($data as $key => $value) {
+            if (property_exists($instance, $key)) {
+                $instance->{$key} = $value;
+            }
+        }
+        return $instance;
+    }
+}

src/Api/SalesInvoices/Payments/SalesInvoicePaymentsEndpoint.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sandorian\Moneybird\Api\SalesInvoices\Payments;
+
+use Sandorian\Moneybird\Api\Support\BaseEndpoint;
+
+class SalesInvoicePaymentsEndpoint extends BaseEndpoint
+{
+    public function registerForSalesInvoiceId(string $salesInvoiceId, array $data): SalesInvoicePayment
+    {
+        $request = new RegisterSalesInvoicePaymentRequest($salesInvoiceId, $data);
+        $response = $this->client->send($request);
+
+        return SalesInvoicePayment::createFromResponseData($response->json());
+    }
+}

src/Api/SalesInvoices/SalesInvoicesEndpoint.php

@@ -5,6 +5,7 @@
 namespace Sandorian\Moneybird\Api\SalesInvoices;
 
 use Saloon\PaginationPlugin\Paginator;
+use Sandorian\Moneybird\Api\SalesInvoices\Payments\SalesInvoicePaymentsEndpoint;
 use Sandorian\Moneybird\Api\Support\BaseEndpoint;
 
 class SalesInvoicesEndpoint extends BaseEndpoint
@@ -48,4 +49,9 @@ public function paginate(): Paginator
 
         return $this->client->paginate($request);
     }
+
+    public function payments(): SalesInvoicePaymentsEndpoint
+    {
+        return new SalesInvoicePaymentsEndpoint($this->client);
+    }
 }

tests/Api/SalesInvoices/Payments/SalesInvoicePaymentResponseStub.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sandorian\Moneybird\Tests\Api\SalesInvoices\Payments;
+
+class SalesInvoicePaymentResponseStub
+{
+    public static function get(): array
+    {
+        return [
+            'id' => '446241800938587779',
+            'administration_id' => '123456789',
+            'invoice_id' => '446241800938587778',
+            'payment_date' => '2025-02-24',
+            'price' => '129.95',
+            'price_base' => '129.95',
+            'payment_method' => 'credit_card',
+            'created_at' => '2025-02-24T21:56:09Z',
+            'updated_at' => '2025-02-24T21:56:09Z',
+        ];
+    }
+}

tests/Api/SalesInvoices/Payments/SalesInvoicePaymentsEndpointTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sandorian\Moneybird\Tests\Api\SalesInvoices\Payments;
+
+use Saloon\Http\Faking\MockResponse;
+use Sandorian\Moneybird\Api\SalesInvoices\Payments\RegisterSalesInvoicePaymentRequest;
+use Sandorian\Moneybird\Api\SalesInvoices\Payments\SalesInvoicePayment;
+use Sandorian\Moneybird\Tests\Api\BaseTestCase;
+
+class SalesInvoicePaymentsEndpointTest extends BaseTestCase
+{
+    public function testRegisterPaymentForSalesInvoice(): void
+    {
+        $moneybird = $this->getMoneybirdClientWithMocks([
+            RegisterSalesInvoicePaymentRequest::class => MockResponse::make(SalesInvoicePaymentResponseStub::get(), 201),
+        ]);
+
+        $payment = $moneybird->salesInvoices()->payments()->registerForSalesInvoiceId('446241800938587778', [
+            'payment_date' => '2025-02-24',
+            'price' => '129.95',
+            'payment_method' => 'credit_card',
+        ]);
+
+        $this->assertInstanceOf(SalesInvoicePayment::class, $payment);
+        $this->assertEquals('446241800938587779', $payment->id);
+        $this->assertEquals('446241800938587778', $payment->invoice_id);
+        $this->assertEquals('2025-02-24', $payment->payment_date);
+        $this->assertEquals('129.95', $payment->price);
+        $this->assertEquals('credit_card', $payment->payment_method);
+    }
+}