add InstalmentLink.RetrieveMany()

ProcuretAPI/ProcuretAPI.nuspec

@@ -2,7 +2,7 @@
 <package >
   <metadata>
     <id>ProcuretAPI</id>
-    <version>0.0.4</version>
+    <version>0.0.5</version>
     <title>Procuret API</title>
     <authors>[email protected]</authors>
     <owners>Procuret Operating Pty Ltd</owners>

ProcuretAPI/src/InstalmentLink.cs

@@ -2,6 +2,7 @@
 using System.Threading.Tasks;
 using System.Runtime.Serialization;
 using System.Net.Http;
+using System.Collections.Generic;
 
 
 namespace ProcuretAPI
@@ -16,20 +17,23 @@ public struct InstalmentLink
         public readonly Decimal InvoiceAmount;
         public readonly String InvoiceIdentifier;
         public readonly String InviteeEmail;
+        public readonly LinkOpen[] Opens;
 
         internal InstalmentLink(
             String publicId,
             EntityHeadline supplier,
             String inviteeEmail,
             Decimal invoiceAmount,
-            String invoiceIdentifier
+            String invoiceIdentifier,
+            LinkOpen[] linkOpens
         )
         {
             this.PublicId = publicId;
             this.Supplier = supplier;
             this.InviteeEmail = inviteeEmail;
             this.InvoiceAmount = invoiceAmount;
             this.InvoiceIdentifier = invoiceIdentifier;
+            this.Opens = linkOpens;
             return;
         }
 
@@ -78,12 +82,81 @@ Session session
                 decodePayload.supplier,
                 decodePayload.invitee_email,
                 Convert.ToDecimal(decodePayload.invoice_amount),
-                decodePayload.invoice_identifier
+                decodePayload.invoice_identifier,
+                decodePayload.opens
             );
 
             return link;
         }
 
+        public enum OrderBy
+        {
+            CREATED = 1
+        }
+
+        public static async Task<InstalmentLink[]> RetrieveMany(
+            Session session,
+            Int64? supplierId = null,
+            Int32 offset = 0,
+            Int32 limit = 20,
+            Order order = Order.ASCENDING,
+            InstalmentLink.OrderBy orderBy = InstalmentLink.OrderBy.CREATED,
+            String publicId = null
+        )
+        {
+
+            List<QueryParameter> parameters = new List<QueryParameter>();
+
+            parameters.Add(new QueryParameter(offset, "offset"));
+            parameters.Add(new QueryParameter(limit, "limit"));
+            parameters.Add(new QueryParameter(order));
+            parameters.Add(new QueryParameter(orderBy));
+
+            if (supplierId != null)
+            {
+                parameters.Add(
+                    new QueryParameter(supplierId ?? 0, "supplier_id")
+                );
+            }
+
+            if (publicId != null)
+            {
+                parameters.Add(
+                    new QueryParameter(publicId, "public_id")
+                );
+            }
+
+
+            String resultBody = await ApiRequest.Make(
+                path: InstalmentLink.path + "/list",
+                query: new QueryString(parameters),
+                session: session,
+                method: HttpMethod.Get
+            );
+
+            var decodePayload = ApiRequest.DecodeResponse<DecodeArrayPayload>(
+                resultBody
+            );
+
+            var resultList = new List<InstalmentLink>();
+
+            foreach (InstalmentLink.DecodePayload link in decodePayload)
+            {
+                resultList.Add(new InstalmentLink(
+                    link.public_id,
+                    link.supplier,
+                    link.invitee_email,
+                    Convert.ToDecimal(link.invoice_amount),
+                    link.invoice_identifier,
+                    link.opens
+                ));
+                continue;
+            }
+
+            return resultList.ToArray();
+
+        }
+
         [DataContract(Name="procuret_data", Namespace="")]
         internal struct CreatePayload
         {
@@ -115,8 +188,12 @@ String communicate
             }
         }
 
+
+        [CollectionDataContract(Name = "procuret_data", Namespace = "")]
+        internal class DecodeArrayPayload : List<DecodePayload> { }
+
         [DataContract(Name="procuret_data", Namespace="")]
-        internal struct DecodePayload
+        internal class DecodePayload
         {
             [DataMember]
             internal readonly String public_id;
@@ -133,8 +210,9 @@ internal struct DecodePayload
             [DataMember]
             internal readonly String invoice_identifier;
 
+            [DataMember]
+            internal readonly LinkOpen[] opens;
 
         }
-
     }
 }

ProcuretAPI/src/LinkOpen.cs

@@ -0,0 +1,12 @@
+using System;
+using System.Runtime.Serialization;
+
+namespace ProcuretAPI
+{
+    [DataContract(Name="procuret_data", Namespace="")]
+    public struct LinkOpen
+    {
+        public readonly Int32 Sequence;
+        public readonly String Created;
+    }
+}

ProcuretAPI/src/Order.cs

@@ -0,0 +1,9 @@
+using System;
+namespace ProcuretAPI
+{
+    public enum Order
+    {
+        ASCENDING = 1,
+        DESCENDING = 2
+    }
+}

ProcuretAPI/src/QueryParameter.cs

@@ -30,6 +30,38 @@ internal QueryParameter(Int16 value, String key)
         {
             this.key = key;
             this.value = value.ToString();
+            return;
+        }
+
+        internal QueryParameter(Int64 value, String key)
+        {
+            this.key = key;
+            this.value = value.ToString();
+            return;
+        }
+
+        internal QueryParameter(Order value)
+        {
+            this.key = "order";
+            if (value == Order.ASCENDING)
+            {
+                this.value = "ascending";
+            } else
+            {
+                this.value = "descending";
+            }
+            return;
+        }
+
+        internal QueryParameter(InstalmentLink.OrderBy value)
+        {
+            this.key = "order_by";
+            if (value == InstalmentLink.OrderBy.CREATED)
+            {
+                this.value = "created";
+                return;
+            }
+            throw new ApiRequestException();
         }
 
     }

ProcuretAPI/src/QueryString.cs

@@ -1,4 +1,6 @@
-using System;
+using System.Collections.Generic;
+using System;
+
 namespace ProcuretAPI
 {
     internal struct QueryString
@@ -39,6 +41,12 @@ internal QueryString(QueryParameter[] parameters)
             return;
         }
 
+        internal QueryString(List<QueryParameter> parameters)
+        {
+            this.parameters = parameters.ToArray();
+            return;
+        }
+
 
 
     }

ProcuretAPI_Tests/InstalmentLink.cs

@@ -7,7 +7,7 @@
 
 namespace ProcuretAPI_Tests
 {
-    public class CreateInstalmentLink: WithSession
+    public class ExerciseInstalmentLink : WithSession
     {
         [Fact]
         public async Task TestCreateInstalmentLink()
@@ -25,5 +25,30 @@ public async Task TestCreateInstalmentLink()
             return;
 
         }
+
+        [Fact]
+        public async Task TestListInstalmentLink()
+        {
+
+            InstalmentLink link = await InstalmentLink.Create(
+                supplierId: 4000,
+                customerEmail: "[email protected]",
+                invoiceIdentifier: "Test ID",
+                invoiceValue: Convert.ToDecimal("422.22"),
+                communication: CommunicationOption.NotifyCustomer,
+                session: this.Session
+            );
+
+            InstalmentLink[] links = await InstalmentLink.RetrieveMany(
+                supplierId: 4000,
+                limit: 2,
+                session: this.Session
+            );
+
+            Assert.True(links.Length > 0, "Actual length: " + links.Length.ToString());
+
+            return;
+
+        }
     }
 }