From 6a68c2d253e12f14c64b0b71e5fce38f5150c7e1 Mon Sep 17 00:00:00 2001
From: Fu Diwei <fudiwei@sina.com>
Date: Mon, 7 Apr 2025 19:49:01 +0800
Subject: [PATCH] =?UTF-8?q?feat(wxapi):=20=E6=96=B0=E5=A2=9E=E5=BE=AE?=
 =?UTF-8?q?=E4=BF=A1=E5=B0=8F=E5=BA=97=E7=A4=BC=E7=89=A9=E8=AE=A2=E5=8D=95?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=A4=87=E6=B3=A8=E4=BF=A1=E6=81=AF=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...echatApiClientExecuteChannelsExtensions.cs | 23 ++++++++++++++++++
 .../ChannelsECOrderPresentNoteAddRequest.cs   | 24 +++++++++++++++++++
 .../ChannelsECOrderPresentNoteAddResponse.cs  |  9 +++++++
 .../ChannelsECOrderPresentNoteAddRequest.json |  4 ++++
 4 files changed, 60 insertions(+)
 create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.cs
 create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddResponse.cs
 create mode 100644 test/SKIT.FlurlHttpClient.Wechat.Api.UnitTests/ModelSamples/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.json

diff --git a/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientExecuteChannelsExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientExecuteChannelsExtensions.cs
index 18be4af5..d7d40d71 100644
--- a/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientExecuteChannelsExtensions.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientExecuteChannelsExtensions.cs
@@ -3497,6 +3497,29 @@ namespace SKIT.FlurlHttpClient.Wechat.Api
             return await client.SendFlurlRequestAsJsonAsync<Models.ChannelsECOrderMerchantNotesUpdateResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
         }
 
+        /// <summary>
+        /// <para>异步调用 [POST] /channels/ec/order/presentnote/add 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developers.weixin.qq.com/doc/store/shop/API/order/present_note_add.html ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.ChannelsECOrderPresentNoteAddResponse> ExecuteChannelsECOrderPresentNoteAddAsync(this WechatApiClient client, Models.ChannelsECOrderPresentNoteAddRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Post, "channels", "ec", "order", "presentnote", "add")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.ChannelsECOrderPresentNoteAddResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// <para>异步调用 [POST] /channels/ec/order/sensitiveinfo/decode 接口。</para>
         /// <para>
diff --git a/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.cs
new file mode 100644
index 00000000..c37e1293
--- /dev/null
+++ b/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.cs
@@ -0,0 +1,24 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/order/presentnote/add 接口的请求。</para>
+    /// </summary>
+    public class ChannelsECOrderPresentNoteAddRequest : WechatApiRequest, IInferable<ChannelsECOrderPresentNoteAddRequest, ChannelsECOrderPresentNoteAddResponse>
+    {
+        /// <summary>
+        /// 获取或设置礼物订单 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("present_order_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("present_order_id")]
+        public string PresetOrderId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置礼物订单备注信息。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("notes")]
+        [System.Text.Json.Serialization.JsonPropertyName("notes")]
+        public string Notes { get; set; } = string.Empty;
+    }
+}
diff --git a/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddResponse.cs
new file mode 100644
index 00000000..259dac2a
--- /dev/null
+++ b/src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECOrder/ChannelsECOrderPresentNoteAddResponse.cs
@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/order/presentnote/add 接口的响应。</para>
+    /// </summary>
+    public class ChannelsECOrderPresentNoteAddResponse : WechatApiResponse
+    {
+    }
+}
diff --git a/test/SKIT.FlurlHttpClient.Wechat.Api.UnitTests/ModelSamples/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.json b/test/SKIT.FlurlHttpClient.Wechat.Api.UnitTests/ModelSamples/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.json
new file mode 100644
index 00000000..7b900fb4
--- /dev/null
+++ b/test/SKIT.FlurlHttpClient.Wechat.Api.UnitTests/ModelSamples/Channels/ECOrder/ChannelsECOrderPresentNoteAddRequest.json
@@ -0,0 +1,4 @@
+{
+    "present_order_id": "123456",
+    "notes": "微信小店"
+}