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

---
 .../sales-invoices/create-sales-invoice.php   | 51 +++++++++++++++++++
 .../sales-invoices/delete-sales-invoice.php   | 25 +++++++++
 .../sales-invoices/list-sales-invoices.php    | 28 ++++++++++
 .../sales-invoices/update-sales-invoice.php   | 40 +++++++++++++++
 4 files changed, 144 insertions(+)
 create mode 100644 examples/sales-invoices/create-sales-invoice.php
 create mode 100644 examples/sales-invoices/delete-sales-invoice.php
 create mode 100644 examples/sales-invoices/list-sales-invoices.php
 create mode 100644 examples/sales-invoices/update-sales-invoice.php

diff --git a/examples/sales-invoices/create-sales-invoice.php b/examples/sales-invoices/create-sales-invoice.php
new file mode 100644
index 000000000..ffdc52159
--- /dev/null
+++ b/examples/sales-invoices/create-sales-invoice.php
@@ -0,0 +1,51 @@
+<?php
+
+use Mollie\Api\Types\PaymentTerm;
+use Mollie\Api\Types\SalesInvoiceStatus;
+
+/*
+ * Create a sales invoice using the Mollie API.
+ */
+
+try {
+    /*
+     * Initialize the Mollie API library with your API key or OAuth access token.
+     */
+    require "../initialize.php";
+
+    /*
+     * Create a sales invoice
+     */
+    $salesInvoice = $mollie->salesInvoices->create([
+        'currency' => 'EUR',
+        'status' => SalesInvoiceStatus::DRAFT,
+        'vatScheme' => 'standard',
+        'vatMode' => 'inclusive',
+        'paymentTerm' => PaymentTerm::DAYS_30,
+        'recipientIdentifier' => 'XXXXX',
+        'recipient' => [
+            'type' => 'consumer',
+            'email' => 'darth@vader.deathstar',
+            'streetAndNumber' => 'Sample Street 12b',
+            'postalCode' => '2000 AA',
+            'city' => 'Amsterdam',
+            'country' => 'NL',
+            'locale' => 'nl_NL'
+        ],
+        'lines' => [
+            [
+                'description' => 'Monthly subscription fee',
+                'quantity' => 1,
+                'vatRate' => '21',
+                'unitPrice' => [
+                    'currency' => 'EUR',
+                    'value' => '10.00'  // Corrected the format from '10,00' to '10.00' to match typical API expectations
+                ]
+            ]
+        ]
+    ]);
+
+    echo "<p>New sales invoice created with ID: " . htmlspecialchars($salesInvoice->id) . "</p>";
+} catch (\Mollie\Api\Exceptions\ApiException $e) {
+    echo "API call failed: " . htmlspecialchars($e->getMessage());
+}
diff --git a/examples/sales-invoices/delete-sales-invoice.php b/examples/sales-invoices/delete-sales-invoice.php
new file mode 100644
index 000000000..3b154b802
--- /dev/null
+++ b/examples/sales-invoices/delete-sales-invoice.php
@@ -0,0 +1,25 @@
+<?php
+/*
+ * Delete a sales invoice using the Mollie API.
+ */
+
+try {
+    /*
+     * Initialize the Mollie API library with your API key or OAuth access token.
+     */
+    require "../initialize.php";
+
+    /*
+     * Assume we have an invoice ID 'inv_xxx' that we wish to delete.
+     */
+    $invoiceId = 'invoice_xxx';
+
+    /*
+     * Delete the sales invoice
+     */
+    $mollie->salesInvoices->delete($invoiceId);
+
+    echo "<p>Sales invoice deleted with ID: " . htmlspecialchars($invoiceId) . "</p>";
+} catch (\Mollie\Api\Exceptions\ApiException $e) {
+    echo "API call failed: " . htmlspecialchars($e->getMessage());
+}
diff --git a/examples/sales-invoices/list-sales-invoices.php b/examples/sales-invoices/list-sales-invoices.php
new file mode 100644
index 000000000..49d6d3611
--- /dev/null
+++ b/examples/sales-invoices/list-sales-invoices.php
@@ -0,0 +1,28 @@
+<?php
+/*
+ * List sales invoices using the Mollie API.
+ */
+
+try {
+    /*
+     * Initialize the Mollie API library with your API key or OAuth access token.
+     */
+    require "../initialize.php";
+
+    /*
+     * List the most recent sales invoices
+     *
+     * See: https://docs.mollie.com/reference/v2/sales-invoices-api/list-sales-invoices
+     */
+    echo '<ul>';
+    $salesInvoices = $mollie->salesInvoices->page();
+    foreach ($salesInvoices as $invoice) {
+        echo '<li><b>Invoice ' . htmlspecialchars($invoice->id) . ':</b> (' . htmlspecialchars($invoice->issuedAt) . ')';
+        echo '<br>Status: <b>' . htmlspecialchars($invoice->status) . '</b>';
+        echo '<br>Total Amount: <b>' . htmlspecialchars($invoice->amount->currency) . ' ' . htmlspecialchars($invoice->amount->value) . '</b>';
+        echo '</li>';
+    }
+    echo '</ul>';
+} catch (\Mollie\Api\Exceptions\ApiException $e) {
+    echo "API call failed: " . htmlspecialchars($e->getMessage());
+}
diff --git a/examples/sales-invoices/update-sales-invoice.php b/examples/sales-invoices/update-sales-invoice.php
new file mode 100644
index 000000000..2442be423
--- /dev/null
+++ b/examples/sales-invoices/update-sales-invoice.php
@@ -0,0 +1,40 @@
+<?php
+/*
+ * Update a sales invoice using the Mollie API.
+ */
+
+try {
+    /*
+     * Initialize the Mollie API library with your API key or OAuth access token.
+     */
+    require "../initialize.php";
+
+    /*
+     * Assume we have an invoice ID 'inv_xxx' that we wish to update.
+     */
+    $invoiceId = 'invoice_xxx';
+
+    /*
+     * Update the sales invoice
+     */
+    $updatedInvoice = $mollie->salesInvoices->update($invoiceId, [
+        'status' => \Mollie\Api\Types\SalesInvoiceStatus::PAID,
+        'recipientIdentifier' => 'XXXXX',
+        'lines' => [
+            [
+                'id' => 'line_001',
+                'description' => 'Updated subscription fee',
+                'quantity' => 2,
+                'vatRate' => '21',
+                'unitPrice' => [
+                    'currency' => 'EUR',
+                    'value' => '15.00'
+                ]
+            ]
+        ]
+    ]);
+
+    echo "<p>Sales invoice updated with ID: " . htmlspecialchars($updatedInvoice->id) . "</p>";
+} catch (\Mollie\Api\Exceptions\ApiException $e) {
+    echo "API call failed: " . htmlspecialchars($e->getMessage());
+}