Merge pull request #14 from fiskaltrust/feature/4-add-cbReceiptLines-info

#4 add cbReceiptLines to howto 8 sample + typed object to the lib

Author: MaximilianFT

HOWTO_08_pay_sign_issue_csharp/Program.cs

@@ -89,6 +89,14 @@ static async Task Main(string[] args)
                         .SetCountry("AT") // Austria
                         .SetReceiptCase(ReceiptCase.PointOfSaleReceipt0x0001);
                     ReceiptRequest receiptRequest = new ReceiptRequest(receiptReference, receiptCaseBuilder, chargeItems, pResp.ftPayItems);
+                    receiptRequest.ftReceiptCaseData = new FtReceiptCaseData
+                    {
+                        cbReceiptLines = new string[]
+                        {
+                            "This is a test receipt.",
+                            "Thank you for your purchase!"
+                        }
+                    };
                     (ReceiptResponse? rResp, errorMsg) = await signRunner.Execute<ReceiptResponse>(async () =>
                     {
                         return await ftPosAPI.Sign.SignAsync(receiptRequest, signRunner.OperationID);

libPosSystemAPI/DTO/FtReceiptCaseData.cs

@@ -0,0 +1,27 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace fiskaltrust.DevKit.POSSystemAPI.lib.DTO
+{
+    /// <summary>
+    /// Optional additional data for the receipt case, passed as <c>ftReceiptCaseData</c> in a <see cref="ReceiptRequest"/>.
+    /// Known properties are defined as typed fields. Any additional properties can be placed in
+    /// <see cref="AdditionalProperties"/> and will be serialized as top-level JSON properties.
+    /// </summary>
+    public class FtReceiptCaseData
+    {
+        /// <summary>
+        /// Lines of text to be printed on the receipt additionally to the standard receipt content.
+        /// </summary>
+        [JsonPropertyName("cbReceiptLines")]
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
+        public string[]? cbReceiptLines { get; set; }
+
+        /// <summary>
+        /// Additional arbitrary properties that will be serialized as top-level JSON fields
+        /// alongside the known properties.
+        /// </summary>
+        [JsonExtensionData]
+        public Dictionary<string, object?>? AdditionalProperties { get; set; }
+    }
+}

libPosSystemAPI/DTO/ReceiptRequest.cs

@@ -75,6 +75,11 @@ public ReceiptRequest(string cbReceiptReference, ReceiptCaseBuilder buildableRec
         [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
         public string? cbPreviousReceiptReference { get; set; }
 
+        [JsonPropertyName("ftReceiptCaseData")]
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
+        public FtReceiptCaseData? ftReceiptCaseData { get; set; }
+
+
         public JsonContent ToJsonContent()
         {
             return JsonContent.Create(this, options: JsonConfiguration.DefaultOptions);
@@ -102,10 +107,6 @@ public JsonContent ToJsonContent()
         public Guid? ftPosSystemId { get; set; }
 
 
-        [JsonProperty("ftReceiptCaseData", DefaultValueHandling = DefaultValueHandling.Ignore)]
-        [JsonPropertyName("ftReceiptCaseData")]
-        [System.Text.Json.Serialization.JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
-        public object? ftReceiptCaseData { get; set; }
 
         [JsonProperty("ftQueueID", DefaultValueHandling = DefaultValueHandling.Ignore)]
         [JsonPropertyName("ftQueueID")]