[APP] implement new tool for sevdesk - findInvoice, getInvoice

components/sevdesk/actions/cancel-invoice/cancel-invoice.mjs

@@ -5,7 +5,7 @@ export default {
   key: "sevdesk-cancel-invoice",
   name: "Cancel Invoice",
   description: "Cancels an existing invoice in sevDesk. [See the documentation](https://api.sevdesk.de/#tag/Invoice/operation/cancelInvoice)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     sevdesk,

components/sevdesk/actions/create-contact/create-contact.mjs

@@ -5,7 +5,7 @@ export default {
   key: "sevdesk-create-contact",
   name: "Create Contact",
   description: "Create a new contact. [See the documentation](https://api.sevdesk.de/#tag/Contact/operation/createContact)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     sevdesk,

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

@@ -12,7 +12,7 @@ export default {
   key: "sevdesk-create-invoice",
   name: "Create Invoice",
   description: "Creates a new invoice with optional details like invoice date, due date, discount amount, and invoice items. [See the documentation](https://api.sevdesk.de/)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     sevdesk,

components/sevdesk/actions/get-invoice/get-invoice.mjs

@@ -0,0 +1,33 @@
+import app from "../../sevdesk.app.mjs";
+
+export default {
+  key: "sevdesk-get-invoice",
+  name: "Get Invoice",
+  description: "Find and retrieve a single invoice by its ID. [See the documentation](https://api.sevdesk.de/#tag/Invoice/operation/getInvoiceById)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    invoiceId: {
+      propDefinition: [
+        app,
+        "invoiceId",
+      ],
+      description: "ID of the invoice to retrieve",
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      invoiceId,
+    } = this;
+
+    const response = await app.getInvoice({
+      $,
+      invoiceId,
+    });
+
+    $.export("$summary", `Successfully retrieved invoice with ID ${invoiceId}`);
+    return response;
+  },
+};

components/sevdesk/actions/get-invoices/get-invoices.mjs

@@ -0,0 +1,122 @@
+import app from "../../sevdesk.app.mjs";
+
+export default {
+  key: "sevdesk-get-invoices",
+  name: "Get Invoices",
+  description: "Retrieve invoices with optional filtering by status, invoice number, date range, and contact. [See the documentation](https://api.sevdesk.de/#tag/Invoice/operation/getInvoices)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    status: {
+      type: "string",
+      label: "Status",
+      description: "Status of the invoices to filter by",
+      options: [
+        {
+          label: "Draft",
+          value: "100",
+        },
+        {
+          label: "Open",
+          value: "200",
+        },
+        {
+          label: "Paid",
+          value: "1000",
+        },
+      ],
+      optional: true,
+    },
+    invoiceNumber: {
+      type: "string",
+      label: "Invoice Number",
+      description: "Retrieve all invoices with this invoice number",
+      optional: true,
+    },
+    startDate: {
+      type: "string",
+      label: "Start Date",
+      description: "Retrieve all invoices with a date equal or higher (ISO 8601 format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)",
+      optional: true,
+    },
+    endDate: {
+      type: "string",
+      label: "End Date",
+      description: "Retrieve all invoices with a date equal or lower (ISO 8601 format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)",
+      optional: true,
+    },
+    contactId: {
+      propDefinition: [
+        app,
+        "contactId",
+      ],
+      optional: true,
+    },
+    limit: {
+      type: "integer",
+      label: "Limit",
+      description: "Maximum number of invoices to retrieve",
+      optional: true,
+      min: 1,
+      max: 999,
+    },
+  },
+  methods: {
+    convertDateToTimestamp(dateString) {
+      if (!dateString) return undefined;
+
+      const date = new Date(dateString);
+      if (isNaN(date.getTime())) {
+        throw new Error(`Invalid date format: ${dateString}. Please use ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)`);
+      }
+
+      return Math.floor(date.getTime() / 1000);
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      status,
+      invoiceNumber,
+      startDate,
+      endDate,
+      contactId,
+      limit,
+    } = this;
+
+    let startTimestamp, endTimestamp;
+
+    try {
+      startTimestamp = this.convertDateToTimestamp(startDate);
+      endTimestamp = this.convertDateToTimestamp(endDate);
+    } catch (error) {
+      throw new Error(`Date validation error: ${error.message}`);
+    }
+
+    if (startTimestamp && endTimestamp && startTimestamp > endTimestamp) {
+      throw new Error("Start date cannot be later than end date");
+    }
+
+    const response = await app.listInvoices({
+      $,
+      params: {
+        status,
+        invoiceNumber,
+        startDate: startTimestamp,
+        endDate: endTimestamp,
+        ...(contactId
+          ? {
+            "contact[id]": contactId,
+            "contact[objectName]": "Contact",
+          }
+          : {}
+        ),
+        limit,
+      },
+    });
+
+    $.export("$summary", `Successfully retrieved ${response.objects?.length || 0} invoice(s)`);
+    return response;
+  },
+};

components/sevdesk/actions/send-invoice-email/send-invoice-email.mjs

@@ -5,7 +5,7 @@ export default {
   key: "sevdesk-send-invoice-email",
   name: "Send Invoice Email",
   description: "Sends an invoice via email. [See the documentation](https://api.sevdesk.de/#tag/Invoice/operation/sendInvoiceViaEMail)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     sevdesk,

components/sevdesk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/sevdesk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Pipedream sevDesk Components",
   "main": "sevdesk.app.mjs",
   "keywords": [

components/sevdesk/sevdesk.app.mjs

@@ -159,6 +159,14 @@ export default {
         ...opts,
       });
     },
+    getInvoice({
+      invoiceId, ...opts
+    }) {
+      return this._makeRequest({
+        path: `/Invoice/${invoiceId}`,
+        ...opts,
+      });
+    },
     listOrders(opts = {}) {
       return this._makeRequest({
         path: "/Order",

components/sevdesk/sources/new-contact/new-contact.mjs

@@ -6,7 +6,7 @@ export default {
   key: "sevdesk-new-contact",
   name: "New Contact Created",
   description: "Emit new event when a contact is created in SevDesk.",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "source",
   dedupe: "unique",
   methods: {

components/sevdesk/sources/new-order/new-order.mjs

@@ -6,7 +6,7 @@ export default {
   key: "sevdesk-new-order",
   name: "New Order Created",
   description: "Emit new event for each new order created in SevDesk.",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "source",
   dedupe: "unique",
   methods: {

components/sevdesk/sources/new-voucher/new-voucher.mjs

@@ -6,7 +6,7 @@ export default {
   key: "sevdesk-new-voucher",
   name: "New Voucher Created",
   description: "Emit new event when a new voucher is created.",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "source",
   dedupe: "unique",
   methods: {