Enhance Fortnox component with new actions and properties (#19208)

* Enhance Fortnox component with new actions and properties

- Added new actions: `listAccounts`, `listFinancialYears`, `listSupplierInvoices`, `getSupplierInvoice`, `listArticles`, `listCustomers`, `listInvoices`, `listSuppliers`, and `sendInvoice`.
- Introduced a new property for `supplierInvoiceNumber` in the Fortnox app.
- Updated existing actions to version 0.0.2 and incremented the package version to 0.2.0 in package.json.
- Improved request headers for better API compatibility.

This update expands the functionality of the Fortnox component, allowing users to manage and retrieve various financial records more effectively.

* Update components/fortnox/actions/list-invoices/list-invoices.mjs

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Add new properties to list-customers action in Fortnox component

- Introduced `gln`, `glndelivery`, `lastmodified`, and `sortby` properties to enhance customer data handling.
- This update improves the functionality and flexibility of the list-customers action.

* Refactor Fortnox actions for improved clarity and functionality

- Removed the `booked` property from the `create-invoice-payment` action.
- Updated descriptions in the `list-supplier-invoices` action to clarify invoice filtering options, correcting grammatical errors for better readability.

These changes enhance the usability and accuracy of the Fortnox component.

* Update components/fortnox/actions/list-supplier-invoices/list-supplier-invoices.mjs

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Add terms of delivery and payment to Fortnox component

- Introduced `termsOfDeliveries` and `termsOfPayments` properties in the Fortnox app for invoice handling.
- Added corresponding methods to fetch delivery and payment terms asynchronously.
- Updated `create-invoice` action to utilize the new properties.

This enhancement improves the invoice creation process by allowing users to specify terms of delivery and payment more effectively.

* Update due date description in create-invoice action and remove dueDate property from create-invoice-payment action

- Enhanced the description for the due date in the create-invoice action to specify the required format (YYYY-MM-DD).
- Removed the dueDate property from the create-invoice-payment action to streamline the payment process.

These changes improve clarity and usability in the Fortnox component.

* Remove terms of delivery and payment from Fortnox component

- Eliminated `termsOfDeliveries` and `termsOfPayments` properties from the Fortnox app and the create-invoice action to streamline the invoice creation process.
- Updated the create-invoice action to reflect these changes, ensuring a more focused and simplified interface.

This refactor enhances the clarity and usability of the Fortnox component.

* Refactor create-invoice-payment action in Fortnox component

- Removed unnecessary properties: `customerNumber`, `invoiceTotal`, and `modeOfPayment` from the create-invoice-payment action to simplify the payment process.
- Updated the action's payload structure to reflect these changes, enhancing clarity and usability.

This refactor streamlines the invoice payment process within the Fortnox component.

* Update payment date format description in create-invoice-payment action

- Changed the description of the paymentDate property to specify the required format as YYYY-MM-DD, enhancing clarity for users.

This update improves the usability of the Fortnox component by providing clear formatting instructions.

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: luancazarine

components/fortnox/actions/create-article/create-article.mjs

@@ -4,7 +4,7 @@ export default {
   key: "fortnox-create-article",
   name: "Create Article",
   description: "Creates a new article in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Articles/operation/1_create_3).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/fortnox/actions/create-customer/create-customer.mjs

@@ -4,7 +4,7 @@ export default {
   key: "fortnox-create-customer",
   name: "Create Customer",
   description: "Creates a new customer in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Customers/operation/create_16).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/fortnox/actions/create-invoice-payment/create-invoice-payment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "fortnox-create-invoice-payment",
   name: "Create Invoice Payment",
   description: "Creates a new invoice payment in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_InvoicePayments/operation/create_22).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -25,41 +25,10 @@ export default {
       description: "The amount of the payment",
       optional: true,
     },
-    booked: {
-      type: "boolean",
-      label: "Booked",
-      description: "Whether the payment is booked",
-      optional: true,
-    },
-    customerNumber: {
-      propDefinition: [
-        fortnox,
-        "customerNumber",
-      ],
-      optional: true,
-    },
-    dueDate: {
-      type: "string",
-      label: "Due Date",
-      description: "The due date of the invoice",
-      optional: true,
-    },
     paymentDate: {
       type: "string",
       label: "Payment Date",
-      description: "The date of the payment",
-      optional: true,
-    },
-    invoiceTotal: {
-      type: "string",
-      label: "Invoice Total",
-      description: "The total of the invoice",
-      optional: true,
-    },
-    modeOfPayment: {
-      type: "string",
-      label: "Mode of Payment",
-      description: "The mode of payment",
+      description: "The date of the payment. **Format YYYY-MM-DD**",
       optional: true,
     },
     voucherNumber: {
@@ -78,13 +47,6 @@ export default {
           Amount: this.amount
             ? +this.amount
             : undefined,
-          Booked: this.booked,
-          InvoiceCustomerNumber: this.customerNumber,
-          InvoiceDueDate: this.dueDate,
-          InvoiceTotal: this.invoiceTotal
-            ? +this.invoiceTotal
-            : undefined,
-          ModeOfPayment: this.modeOfPayment,
           PaymentDate: this.paymentDate,
           VoucherNumber: this.voucherNumber,
         },

components/fortnox/actions/create-invoice/create-invoice.mjs

@@ -1,11 +1,11 @@
-import fortnox from "../../fortnox.app.mjs";
 import { parseObject } from "../../common/utils.mjs";
+import fortnox from "../../fortnox.app.mjs";
 
 export default {
   key: "fortnox-create-invoice",
   name: "Create Invoice",
   description: "Creates a new invoice in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Invoices/operation/create_23).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -53,7 +53,7 @@ export default {
     dueDate: {
       type: "string",
       label: "Due Date",
-      description: "The due date of the invoice",
+      description: "The due date of the invoice. **Format: YYYY-MM-DD**",
       optional: true,
     },
     invoiceRows: {
@@ -105,18 +105,6 @@ export default {
       description: "The freight of the invoice",
       optional: true,
     },
-    termsOfDelivery: {
-      type: "string",
-      label: "Terms of Delivery",
-      description: "The terms of delivery of the invoice",
-      optional: true,
-    },
-    termsOfPayment: {
-      type: "string",
-      label: "Terms of Payment",
-      description: "The terms of payment of the invoice",
-      optional: true,
-    },
   },
   async run({ $ }) {
     const response = await this.fortnox.createInvoice({
@@ -143,12 +131,10 @@ export default {
           Freight: this.freight
             ? +this.freight
             : undefined,
-          TermsOfDelivery: this.termsOfDelivery,
-          TermsOfPayment: this.termsOfPayment,
         },
       },
     });
-    $.export("$summary", `Successfully created invoice with ID \`${response.Invoice.InvoiceNumber}\``);
+    $.export("$summary", `Successfully created invoice with ID \`${response.Invoice.DocumentNumber}\``);
     return response;
   },
 };

components/fortnox/actions/get-supplier-invoice/get-supplier-invoice.mjs

@@ -0,0 +1,32 @@
+import app from "../../fortnox.app.mjs";
+
+export default {
+  key: "fortnox-get-supplier-invoice",
+  name: "Get Supplier Invoice",
+  description: "Retrieve a supplier invoice. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_SupplierInvoices/operation/get_39)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    supplierInvoiceNumber: {
+      propDefinition: [
+        app,
+        "supplierInvoiceNumber",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const { SupplierInvoice } = await this.app.getSupplierInvoice({
+      $,
+      supplierInvoiceNumber: this.supplierInvoiceNumber,
+    });
+
+    $.export("$summary", `Successfully retrieved supplier invoice with number ${this.supplierInvoiceNumber}`);
+    return SupplierInvoice;
+  },
+};

components/fortnox/actions/list-accounts/list-accounts.mjs

@@ -0,0 +1,27 @@
+import app from "../../fortnox.app.mjs";
+
+export default {
+  key: "fortnox-list-accounts",
+  name: "List Accounts",
+  description: "List all accounts in Fortnox. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Accounts/operation/list_2)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const { Accounts: accounts } = await this.app.listAccounts({
+      $,
+    });
+
+    $.export("$summary", `Successfully retrieved ${accounts.length} account${accounts.length === 1
+      ? ""
+      : "s"}`);
+    return accounts;
+  },
+};

components/fortnox/actions/list-articles/list-articles.mjs

@@ -0,0 +1,109 @@
+import app from "../../fortnox.app.mjs";
+
+export default {
+  key: "fortnox-list-articles",
+  name: "List Articles",
+  description: "List all articles in Fortnox. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Articles/operation/list_4)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    filter: {
+      type: "string",
+      label: "Filter",
+      description: "Filter the articles by Active or Inactive",
+      options: [
+        "active",
+        "inactive",
+      ],
+      optional: true,
+    },
+    articlenumber: {
+      type: "string",
+      label: "Article Number",
+      description: "Filter by article number",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "Filter by description",
+      optional: true,
+    },
+    ean: {
+      type: "string",
+      label: "EAN",
+      description: "Filter by EAN",
+      optional: true,
+    },
+    suppliernumber: {
+      type: "string",
+      label: "Supplier Number",
+      description: "Filter by supplier number",
+      optional: true,
+    },
+    manufacturer: {
+      type: "string",
+      label: "Manufacturer",
+      description: "Filter by manufacturer",
+      optional: true,
+    },
+    manufacturerarticlenumber: {
+      type: "string",
+      label: "Manufacturer Article Number",
+      description: "Filter by manufacturer article number",
+      optional: true,
+    },
+    webshop: {
+      type: "string",
+      label: "Webshop",
+      description: "Filter by web shop",
+      optional: true,
+    },
+    lastmodified: {
+      type: "string",
+      label: "Last Modified",
+      description: "Filter by last modified date",
+      optional: true,
+    },
+    sortby: {
+      type: "string",
+      label: "Sort By",
+      description: "Sort the articles by the specified field",
+      optional: true,
+      options: [
+        "articlenumber",
+        "quantityinstock",
+        "reservedquantity",
+        "stockvalue",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const { Articles } = await this.app.listArticles({
+      $,
+      params: {
+        filter: this.filter,
+        articlenumber: this.articlenumber,
+        description: this.description,
+        ean: this.ean,
+        suppliernumber: this.suppliernumber,
+        manufacturer: this.manufacturer,
+        manufacturerarticlenumber: this.manufacturerarticlenumber,
+        webshop: this.webshop,
+        lastmodified: this.lastmodified,
+        sortby: this.sortby,
+      },
+    });
+
+    $.export("$summary", `Successfully retrieved ${Articles.length} article${Articles.length === 1
+      ? ""
+      : "s"}`);
+    return Articles;
+  },
+};