update c# SDK (.net core 3.1)

Author: Olman62

route4me-csharp-sdk/Route4MeSDKLibrary/QueryTypes/OrderFilterParameters.cs

@@ -51,5 +51,17 @@ public class FilterDetails : GenericParameters
         /// </summary>
         [DataMember(Name = "tracking_numbers")]
         public string[] TrackingNumbers { get; set; }
+
+        /// <summary>
+        /// Start of a time range to filter the orders.
+        /// </summary>
+        [DataMember(Name = "created_timestamp_start")]
+        public long? CreatedTimestampStart { get; set; }
+
+        /// <summary>
+        /// Start of a time range to filter the orders.
+        /// </summary>
+        [DataMember(Name = "created_timestamp_end")]
+        public long? CreatedTimestampEnd { get; set; }
     }
 }

route4me-csharp-sdk/Route4MeSDKLibrary/Utils.cs

@@ -828,5 +828,19 @@ public static int GetLocalTimeZone()
 
             return seconds;
         }
+
+        /// <summary>
+        /// Generate random string with a specified length from specified source string.
+        /// </summary>
+        /// <param name="length">Length of the generated random string</param>
+        /// <param name="sourceString">Source string. Default: 'ABCDEF0123456789'</param>
+        /// <returns></returns>
+        public static string GenerateRandomString(int length, string sourceString= "ABCDEF0123456789")
+        {
+            var random = new Random();
+
+            return new string(Enumerable.Repeat(sourceString, length)
+              .Select(s => s[random.Next(s.Length)]).ToArray());
+        }
     }
 }

route4me-csharp-sdk/Route4MeSDKLibrary/bin/Debug/netcoreapp3.1/Route4MeSDKLibrary.dll

@@ -4,15 +4,21 @@ namespace Route4MeSDK.Examples
 {
     public sealed partial class Route4MeExamples
     {
-        public void AddOrderWithTrackingNumber()
+        /// <summary>
+        /// The example demonstrates the process of creating an order with the specified tracking number and address stop type.
+        /// </summary>
+        public void AddOrderWithOrderType()
         {
             // Create the manager with the api key
             var route4Me = new Route4MeManager(ActualApiKey);
 
+            // Using of an existing tracking number raises error
+            var randomTrackingNumber = R4MeUtils.GenerateRandomString(8, "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
+
             var order = new Order()
             {
                 Address1 = "201 LAVACA ST APT 746, AUSTIN, TX, 78701, US",
-                TrackingNumber = "AA11ZZCC",
+                TrackingNumber = randomTrackingNumber,
                 AddressStopType = AddressStopType.PickUp.Description()
             };
 

route4me-csharp-sdk/Route4MeSDKLibrary/bin/Debug/netcoreapp3.1/Route4MeSDKLibrary.pdb

@@ -26,6 +26,19 @@ public void OptimizationByOrderTerritories()
                 VehicleId = ""
             };
 
+            var depots = new Address[1]
+            {
+                new Address()
+                {
+                    Alias = "HQ1",
+                    AddressString = "1010 N Florida ave, Tampa, FL",
+                    IsDepot = true,
+                    Latitude = 27.952941,
+                    Longitude = -82.459493,
+                    Time = 0
+                }
+            };
+
             var orderTerritories = new OrderTerritories()
             {
                 SplitTerritories = true,
@@ -45,7 +58,8 @@ public void OptimizationByOrderTerritories()
             {
                 Redirect = false,
                 OrderTerritories = orderTerritories,
-                Parameters = parameters
+                Parameters = parameters,
+                Depots = depots
             };
 
             // Run the query

route4me-csharp-sdk/Route4MeSDKTest/Examples/Orders/AddOrderWithTrackingNumber.cs renamed to route4me-csharp-sdk/Route4MeSDKTest/Examples/Orders/AddOrderWithOrderType.cs

@@ -1,7 +1,5 @@
-using Route4MeSDK.DataTypes;
-using Route4MeSDK.Examples;
+using Route4MeSDK.Examples;
 using System;
-using System.Collections.Generic;
 
 namespace Route4MeSDKTest
 {
@@ -15,7 +13,7 @@ static void Main(string[] args)
             // "api4" - execute all the examples related to the API 4 
             // "api5" - execute all the examples related to the API 5 
             // a method name - execute a specifed example method (e.g. "GetTeamMemberById")
-            string executeOption = "OptimizationByOrderTerritories";
+            string executeOption = "AddOrderWithOrderType";
             //object[] executeParams = new object[] { null };
             object[] executeParams = null;
 
@@ -416,9 +414,9 @@ static void Main(string[] args)
                 }
             }
 
-            System.Console.WriteLine("");
-            System.Console.WriteLine("Press any key");
-            System.Console.ReadKey();
+            Console.WriteLine("");
+            Console.WriteLine("Press any key");
+            Console.ReadKey();
         }
     }
 }