From be3dbe7d17bf67b3ac7a224f58dd372ca9a139a8 Mon Sep 17 00:00:00 2001
From: Krishan Koenig <krishan.koenig@googlemail.com>
Date: Tue, 10 Dec 2024 14:00:14 +0100
Subject: [PATCH] wip

---
 src/Endpoints/SalesInvoiceEndpoint.php   | 123 +++++++++++++++++
 src/MollieApiClient.php                  |   9 ++
 src/Resources/SalesInvoice.php           | 167 +++++++++++++++++++++++
 src/Resources/SalesInvoiceCollection.php |  22 +++
 src/Types/SalesInvoiceStatus.php         |  21 +++
 5 files changed, 342 insertions(+)
 create mode 100644 src/Endpoints/SalesInvoiceEndpoint.php
 create mode 100644 src/Resources/SalesInvoice.php
 create mode 100644 src/Resources/SalesInvoiceCollection.php
 create mode 100644 src/Types/SalesInvoiceStatus.php

diff --git a/src/Endpoints/SalesInvoiceEndpoint.php b/src/Endpoints/SalesInvoiceEndpoint.php
new file mode 100644
index 00000000..9be1aded
--- /dev/null
+++ b/src/Endpoints/SalesInvoiceEndpoint.php
@@ -0,0 +1,123 @@
+<?php
+
+namespace Mollie\Api\Endpoints;
+
+use Mollie\Api\Exceptions\ApiException;
+use Mollie\Api\Resources\LazyCollection;
+use Mollie\Api\Resources\SalesInvoice;
+use Mollie\Api\Resources\SalesInvoiceCollection;
+
+class SalesInvoiceEndpoint extends CollectionEndpointAbstract
+{
+    protected $resourcePath = "sales-invoices";
+
+    /**
+     * @var string
+     */
+    public const RESOURCE_ID_PREFIX = 'invoice_';
+
+    /**
+     * @return SalesInvoice
+     */
+    protected function getResourceObject(): SalesInvoice
+    {
+        return new SalesInvoice($this->client);
+    }
+
+    /**
+     * Get the collection object that is used by this API endpoint. Every API endpoint uses one type of collection object.
+     *
+     * @param int $count
+     * @param \stdClass $_links
+     *
+     * @return SalesInvoiceCollection
+     */
+    protected function getResourceCollectionObject($count, $_links): SalesInvoiceCollection
+    {
+        return new SalesInvoiceCollection($this->client, $count, $_links);
+    }
+
+    /**
+     * Creates a payment in Mollie.
+     *
+     * @param array $data An array containing details on the payment.
+     * @param array $filters
+     *
+     * @return SalesInvoice
+     * @throws ApiException
+     */
+    public function create(array $data = []): SalesInvoice
+    {
+        return $this->rest_create($data, []);
+    }
+
+    /**
+     * Update the given Payment.
+     *
+     * Will throw a ApiException if the payment id is invalid or the resource cannot be found.
+     *
+     * @param string $salesInvoiceId
+     *
+     * @param array $data
+     * @return SalesInvoice
+     * @throws ApiException
+     */
+    public function update($salesInvoiceId, array $data = []): SalesInvoice
+    {
+        if (empty($salesInvoiceId) || strpos($salesInvoiceId, self::RESOURCE_ID_PREFIX) !== 0) {
+            throw new ApiException("Invalid sales invoice ID: '{$salesInvoiceId}'. A sales invoice ID should start with '" . self::RESOURCE_ID_PREFIX . "'.");
+        }
+
+        return parent::rest_update($salesInvoiceId, $data);
+    }
+
+    /**
+     * @param string $salesInvoiceId
+     * @param array $parameters
+     * @return SalesInvoice
+     * @throws ApiException
+     */
+    public function get($salesInvoiceId, array $parameters = []): SalesInvoice
+    {
+        if (empty($salesInvoiceId) || strpos($salesInvoiceId, self::RESOURCE_ID_PREFIX) !== 0) {
+            throw new ApiException("Invalid sales invoice ID: '{$salesInvoiceId}'. A sales invoice ID should start with '" . self::RESOURCE_ID_PREFIX . "'.");
+        }
+
+        return parent::rest_read($salesInvoiceId, $parameters);
+    }
+
+    /**
+     * @param string $salesInvoiceId
+     *
+     * @param array $data
+     * @throws ApiException
+     */
+    public function delete($salesInvoiceId, array $data = []): void
+    {
+        $this->rest_delete($salesInvoiceId, $data);
+    }
+
+    /**
+     * @param string $from The first payment ID you want to include in your list.
+     * @param int $limit
+     *
+     * @return SalesInvoiceCollection
+     * @throws ApiException
+     */
+    public function page($from = null, $limit = null)
+    {
+        return $this->rest_list($from, $limit, []);
+    }
+
+    /**
+     * @param string $from The first resource ID you want to include in your list.
+     * @param int $limit
+     * @param bool $iterateBackwards Set to true for reverse order iteration (default is false).
+     *
+     * @return LazyCollection
+     */
+    public function iterator(?string $from = null, ?int $limit = null, bool $iterateBackwards = false): LazyCollection
+    {
+        return $this->rest_iterator($from, $limit, [], $iterateBackwards);
+    }
+}
diff --git a/src/MollieApiClient.php b/src/MollieApiClient.php
index 6ae63f25..04b02d74 100644
--- a/src/MollieApiClient.php
+++ b/src/MollieApiClient.php
@@ -32,6 +32,7 @@
 use Mollie\Api\Endpoints\ProfileEndpoint;
 use Mollie\Api\Endpoints\ProfileMethodEndpoint;
 use Mollie\Api\Endpoints\RefundEndpoint;
+use Mollie\Api\Endpoints\SalesInvoiceEndpoint;
 use Mollie\Api\Endpoints\SessionEndpoint;
 use Mollie\Api\Endpoints\SettlementCaptureEndpoint;
 use Mollie\Api\Endpoints\SettlementChargebackEndpoint;
@@ -122,6 +123,13 @@ class MollieApiClient
      */
     public $customerPayments;
 
+    /**
+     * RESTful Sales Invoice resource.
+     *
+     * @var SalesInvoiceEndpoint
+     */
+    public $salesInvoices;
+
     /**
      * RESTful Settlement resource.
      *
@@ -444,6 +452,7 @@ public function initializeEndpoints()
         $this->profileMethods = new ProfileMethodEndpoint($this);
         $this->profiles = new ProfileEndpoint($this);
         $this->refunds = new RefundEndpoint($this);
+        $this->salesInvoices = new SalesInvoiceEndpoint($this);
         $this->settlementCaptures = new SettlementCaptureEndpoint($this);
         $this->settlementChargebacks = new SettlementChargebackEndpoint($this);
         $this->settlementPayments = new SettlementPaymentEndpoint($this);
diff --git a/src/Resources/SalesInvoice.php b/src/Resources/SalesInvoice.php
new file mode 100644
index 00000000..432d0cde
--- /dev/null
+++ b/src/Resources/SalesInvoice.php
@@ -0,0 +1,167 @@
+<?php
+
+namespace Mollie\Api\Resources;
+
+use Mollie\Api\Types\SalesInvoiceStatus;
+
+class SalesInvoice extends BaseResource
+{
+    /**
+     * @var string
+     */
+    public $resource;
+
+    /**
+     * @var string
+     */
+    public $id;
+
+    /**
+     * @var string|null
+     */
+    public $profileId;
+
+    /**
+     * @var string|null
+     */
+    public $invoiceNumber;
+
+    /**
+     * @var string
+     */
+    public $currency;
+
+    /**
+     * @var string
+     */
+    public $status;
+
+    /**
+     * @var string
+     */
+    public $vatScheme;
+
+    /**
+     * @var string
+     */
+    public $vatMode;
+
+    /**
+     * @var string|null
+     */
+    public $memo;
+
+    /**
+     * @var string
+     */
+    public $paymentTerm;
+
+    /**
+     * @var object
+     */
+    public $paymentDetails;
+    /**
+     * @var object
+     */
+    public $emailDetails;
+
+    /**
+     * @var string
+     */
+    public $recipientIdentifier;
+
+    /**
+     * @var object
+     */
+    public $recipient;
+
+    /**
+     * @var array
+     */
+    public $lines;
+
+    /**
+     * @var string
+     */
+    public $webhookUrl;
+
+    /**
+     * @var object|null
+     */
+    public $discount;
+
+    /**
+     * @var object
+     */
+    public $amountDue;
+
+    /**
+     * @var object
+     */
+    public $subtotalAmount;
+
+    /**
+     * @var object
+     */
+    public $totalAmount;
+
+    /**
+     * @var object
+     */
+    public $totalVatAmount;
+
+    /**
+     * @var object
+     */
+    public $discountedSubtotalAmount;
+
+    /**
+     * @var string
+     */
+    public $createdAt;
+
+    /**
+     * @var string|null
+     */
+    public $issuedAt;
+
+    /**
+     * @var string|null
+     */
+    public $dueAt;
+
+    /**
+     * @var object
+     */
+    public $_links;
+
+    /**
+     * Returns whether the sales invoice is in draft status.
+     *
+     * @return bool
+     */
+    public function isDraft()
+    {
+        return $this->status === SalesInvoiceStatus::DRAFT;
+    }
+
+    /**
+     * Returns whether the sales invoice is issued.
+     *
+     * @return bool
+     */
+    public function isIssued()
+    {
+        return $this->status === SalesInvoiceStatus::ISSUED;
+    }
+
+    /**
+     * Returns whether the sales invoice is paid.
+     *
+     * @return bool
+     */
+    public function isPaid()
+    {
+        return $this->status === SalesInvoiceStatus::PAID;
+    }
+}
diff --git a/src/Resources/SalesInvoiceCollection.php b/src/Resources/SalesInvoiceCollection.php
new file mode 100644
index 00000000..6a76b995
--- /dev/null
+++ b/src/Resources/SalesInvoiceCollection.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace Mollie\Api\Resources;
+
+class SalesInvoiceCollection extends CursorCollection
+{
+    /**
+     * @return string
+     */
+    public function getCollectionResourceName()
+    {
+        return "sales_invoices";
+    }
+
+    /**
+     * @return BaseResource
+     */
+    protected function createResourceObject()
+    {
+        return new SalesInvoice($this->client);
+    }
+}
diff --git a/src/Types/SalesInvoiceStatus.php b/src/Types/SalesInvoiceStatus.php
new file mode 100644
index 00000000..02dc1369
--- /dev/null
+++ b/src/Types/SalesInvoiceStatus.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace Mollie\Api\Types;
+
+class SalesInvoiceStatus
+{
+    /**
+     * The sales invoice is in draft status and has not been sent or paid.
+     */
+    const DRAFT = 'draft';
+
+    /**
+     * The sales invoice has been issued to the customer but has not been paid yet.
+     */
+    const ISSUED = 'issued';
+
+    /**
+     * The sales invoice has been fully paid.
+     */
+    const PAID = 'paid';
+}