feat(wxapi): 新增小程序推广员相关接口

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterAddPromoterRequest.cs

@@ -0,0 +1,65 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/addpromoter 接口的请求。</para>
+    /// </summary>
+    public class PromoterAddPromoterRequest : PublisherStatSettlementRequest, IInferable<PromoterAddPromoterRequest, PromoterAddPromoterResponse>
+    {
+        public static class Types
+        {
+            public class Promoter
+            {
+                /// <summary>
+                /// 获取或设置推广员的 OpenId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("openid")]
+                [System.Text.Json.Serialization.JsonPropertyName("openid")]
+                public string OpenId { get; set; } = string.Empty;
+
+                /// <summary>
+                /// 获取或设置角色 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("role_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+                public int RoleId { get; set; }
+
+                /// <summary>
+                /// 获取或设置门店 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("retail_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+                public string? RetailId { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员参数。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("extra_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+                public string? ExtraInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员名称。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("name")]
+                [System.Text.Json.Serialization.JsonPropertyName("name")]
+                public string? Name { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员手机号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("phone")]
+                [System.Text.Json.Serialization.JsonPropertyName("phone")]
+                public string? PhoneNumber { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置推广员列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("promoter_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("promoter_list")]
+        public IList<Types.Promoter> PromoterList { get; set; } = new List<Types.Promoter>();
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterAddPromoterResponse.cs

@@ -0,0 +1,91 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/addpromoter 接口的响应。</para>
+    /// </summary>
+    public class PromoterAddPromoterResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Result
+            {
+                /// <summary>
+                /// 获取或设置推广员的 OpenId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("openid")]
+                [System.Text.Json.Serialization.JsonPropertyName("openid")]
+                public string OpenId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置角色 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("role_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+                public int RoleId { get; set; }
+
+                /// <summary>
+                /// 获取或设置门店 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("retail_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+                public string? RetailId { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员参数。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("extra_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+                public string? ExtraInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员名称。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("name")]
+                [System.Text.Json.Serialization.JsonPropertyName("name")]
+                public string? Name { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员手机号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("phone")]
+                [System.Text.Json.Serialization.JsonPropertyName("phone")]
+                public string? PhoneNumber { get; set; }
+
+                /// <summary>
+                /// 获取或设置错误码。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("errcode")]
+                [System.Text.Json.Serialization.JsonPropertyName("errcode")]
+                public int ErrorCode { get; set; }
+
+                /// <summary>
+                /// 获取或设置错误信息。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("errmsg")]
+                [System.Text.Json.Serialization.JsonPropertyName("errmsg")]
+                public string? ErrorMessage { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置结果列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_list")]
+        public Types.Result[] ResultList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_cnt")]
+        public int TotalCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置失败的数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_cnt")]
+        public int FailedCount { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterAddRoleRequest.cs

@@ -0,0 +1,22 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/addrole 接口的请求。</para>
+    /// </summary>
+    public class PromoterAddRoleRequest : PublisherStatSettlementRequest, IInferable<PromoterAddRoleRequest, PromoterAddRoleResponse>
+    {
+        /// <summary>
+        /// 获取或设置角色名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("name")]
+        [System.Text.Json.Serialization.JsonPropertyName("name")]
+        public string Name { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置角色描述。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("desc")]
+        [System.Text.Json.Serialization.JsonPropertyName("desc")]
+        public string? Description { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterAddRoleResponse.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/addrole 接口的响应。</para>
+    /// </summary>
+    public class PromoterAddRoleResponse : WechatApiResponse
+    {
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int RoleId { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("name")]
+        [System.Text.Json.Serialization.JsonPropertyName("name")]
+        public string Name { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置角色描述。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("desc")]
+        [System.Text.Json.Serialization.JsonPropertyName("desc")]
+        public string Description { get; set; } = default!;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetInvitationMaterialRequest.cs

@@ -0,0 +1,22 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getinvitationmaterial 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetInvitationMaterialRequest : PublisherStatSettlementRequest, IInferable<PromoterGetInvitationMaterialRequest, PromoterGetInvitationMaterialResponse>
+    {
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int RoleId { get; set; }
+
+        /// <summary>
+        /// 获取或设置邀请方式。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("invitation_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("invitation_type")]
+        public int? InvitationType { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetInvitationMaterialResponse.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getinvitationmaterial 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetInvitationMaterialResponse : WechatApiResponse
+    {
+        /// <summary>
+        /// 获取或设置短链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("tag")]
+        [System.Text.Json.Serialization.JsonPropertyName("tag")]
+        public string? TagUrl { get; set; }
+
+        /// <summary>
+        /// 获取或设置经 Base64 编码的海报数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("poster")]
+        [System.Text.Json.Serialization.JsonPropertyName("poster")]
+        public string? EndcodingPosterData { get; set; }
+
+        /// <summary>
+        /// 获取或设置经 Base64 编码的二维码数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("qrcode")]
+        [System.Text.Json.Serialization.JsonPropertyName("qrcode")]
+        public string? EncodingQrcodeData { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetMessageClickDataRequest.cs

@@ -0,0 +1,51 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getmsgclickdata 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetMessageClickDataRequest : PublisherStatSettlementRequest, IInferable<PromoterGetMessageClickDataRequest, PromoterGetMessageClickDataResponse>
+    {
+        /// <summary>
+        /// 获取或设置数据统计维度。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("dimonsion")]
+        [System.Text.Json.Serialization.JsonPropertyName("dimonsion")]
+        public int Dimension { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_type")]
+        public int? MessageType { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_id")]
+        public string? MessageId { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息发送日期（格式：yyyy-MM-dd）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("send_date")]
+        [System.Text.Json.Serialization.JsonPropertyName("send_date")]
+        public string? SendDateString { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息发送开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("begin_send_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("begin_send_time")]
+        public long? BeginSendTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息发送结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_send_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_send_time")]
+        public long? EndSendTimestamp { get; set; }
+
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetMessageClickDataResponse.cs

@@ -0,0 +1,56 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getmsgclickdata 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetMessageClickDataResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Data
+            {
+                /// <summary>
+                /// 获取或设置消息类型。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("msg_type")]
+                [System.Text.Json.Serialization.JsonPropertyName("msg_type")]
+                public int? MessageType { get; set; }
+
+                /// <summary>
+                /// 获取或设置消息 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("msg_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("msg_id")]
+                public string? MessageId { get; set; }
+
+                /// <summary>
+                /// 获取或设置消息发送时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("send_time")]
+                [System.Text.Json.Serialization.JsonPropertyName("send_time")]
+                public long? SendTimestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置点击量 UV。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("click_uv")]
+                [System.Text.Json.Serialization.JsonPropertyName("click_uv")]
+                public int ClickUV { get; set; }
+
+                /// <summary>
+                /// 获取或设置点击量 PV。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("click_pv")]
+                [System.Text.Json.Serialization.JsonPropertyName("click_pv")]
+                public int ClickPV { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置统计数据列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("data_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("data_list")]
+        public Types.Data[] DataList { get; set; } = default!;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetMessageRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getmsg 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetMessageRequest : PublisherStatSettlementRequest, IInferable<PromoterGetMessageRequest, PromoterGetMessageResponse>
+    {
+        /// <summary>
+        /// 获取或设置消息 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_id")]
+        public string MessageId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetMessageResponse.cs

@@ -0,0 +1,119 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getmsg 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetMessageResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Failure
+            {
+                /// <summary>
+                /// 获取或设置推广员 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("id")]
+                [System.Text.Json.Serialization.JsonPropertyName("id")]
+                public string PromoterId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置错误码。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("errcode")]
+                [System.Text.Json.Serialization.JsonPropertyName("errcode")]
+                public int ErrorCode { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置发送总数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("send_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("send_cnt")]
+        public int SendCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置发送比例（单位：百分数）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("percent")]
+        [System.Text.Json.Serialization.JsonPropertyName("percent")]
+        public int SendPercent { get; set; }
+
+        /// <summary>
+        /// 获取或设置发送失败数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_cnt")]
+        public int FailedCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置失败信息列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_info")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_info")]
+        public Types.Failure[]? FailureList { get; set; }
+
+        /// <summary>
+        /// 获取或设置失败信息文件下载链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_info_url")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_info_url")]
+        public string? FailureInfoUrl { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_type")]
+        public int MessageType { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息内容 JSON 字符串。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("content")]
+        [System.Text.Json.Serialization.JsonPropertyName("content")]
+        public string ContentJson { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置小程序 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("appid")]
+        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+        public string? AppId { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序跳转路径。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("path")]
+        [System.Text.Json.Serialization.JsonPropertyName("path")]
+        public string? PagePath { get; set; }
+
+        /// <summary>
+        /// 获取或设置下发类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("list_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("list_type")]
+        public int ListType { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int[]? RoleIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置门店 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("retail_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+        public string[]? RetailIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("id")]
+        [System.Text.Json.Serialization.JsonPropertyName("id")]
+        public string[]? PromoterIdList { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetOrderRequest.cs

@@ -0,0 +1,67 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getorder 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetOrderRequest : PublisherStatSettlementRequest, IInferable<PromoterGetOrderRequest, PromoterGetOrderResponse>
+    {
+        /// <summary>
+        /// 获取或设置推广员的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string PromoterOpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置微信商户号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("mch_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("mch_id")]
+        public string? MerchantId { get; set; }
+
+        /// <summary>
+        /// 获取或设置商户订单号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("out_trade_no")]
+        [System.Text.Json.Serialization.JsonPropertyName("out_trade_no")]
+        public string? OutTradeNumber { get; set; }
+
+        /// <summary>
+        /// 获取或设置微信支付订单号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("trade_no")]
+        [System.Text.Json.Serialization.JsonPropertyName("trade_no")]
+        public string? TransactionId { get; set; }
+
+        /// <summary>
+        /// 获取或设置订单状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("status")]
+        [System.Text.Json.Serialization.JsonPropertyName("status")]
+        public int? Status { get; set; }
+
+        /// <summary>
+        /// 获取或设置订单支付日期字符串（格式：yyyyMMdd）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("date")]
+        [System.Text.Json.Serialization.JsonPropertyName("date")]
+        public string? DateString { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页起始 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_id")]
+        public string? StartId { get; set; }
+
+        /// <summary>
+        /// 获取或设置是否返回 UnionID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("need_unionid")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.NumericalBooleanConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("need_unionid")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalBooleanConverter))]
+        public bool? IsReturnUnionId { get; set; }
+
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetOrderResponse.cs

@@ -0,0 +1,84 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getorder 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetOrderResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Order : PromoterGetRelationResponse.Types.Relation
+            {
+                /// <summary>
+                /// 获取或设置微信商户号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("mch_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("mch_id")]
+                public string MerchantId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置商户订单号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("out_trade_no")]
+                [System.Text.Json.Serialization.JsonPropertyName("out_trade_no")]
+                public string OutTradeNumber { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置微信支付订单号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("trade_no")]
+                [System.Text.Json.Serialization.JsonPropertyName("trade_no")]
+                public string TransactionId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置订单状态。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("status")]
+                [System.Text.Json.Serialization.JsonPropertyName("status")]
+                public int Status { get; set; }
+
+                /// <summary>
+                /// 获取或设置支付金额（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("paid_amount")]
+                [System.Text.Json.Serialization.JsonPropertyName("paid_amount")]
+                public int PaidAmount { get; set; }
+
+                /// <summary>
+                /// 获取或设置支付时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("paid_time")]
+                [System.Text.Json.Serialization.JsonPropertyName("paid_time")]
+                public long PaidTimestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置退款时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("refunded_time")]
+                [System.Text.Json.Serialization.JsonPropertyName("refunded_time")]
+                public long? RefundedTimestamp { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置订单列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("order_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("order_list")]
+        public Types.Order[] OrderList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_cnt")]
+        public int TotalCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置下一页分页起始 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_id")]
+        public string? NextStartId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetPromoterRequest.cs

@@ -0,0 +1,73 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getpromoter 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetPromoterRequest : PublisherStatSettlementRequest, IInferable<PromoterGetPromoterRequest, PromoterGetPromoterResponse>
+    {
+        /// <summary>
+        /// 获取或设置推广员的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string? OpenId { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int? RoleId { get; set; }
+
+        /// <summary>
+        /// 获取或设置门店 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("retail_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+        public string? RetailId { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员授权状态变更开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("begin_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("begin_time")]
+        public long? BeginTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员授权状态变更结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+        public long? EndTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员授权状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("auth_status")]
+        [System.Text.Json.Serialization.JsonPropertyName("auth_status")]
+        public int? AuthStatus { get; set; }
+
+        /// <summary>
+        /// 获取或设置商家声明状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("decl_status")]
+        [System.Text.Json.Serialization.JsonPropertyName("decl_status")]
+        public int? DeclareStatus { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页起始 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_id")]
+        public string? StartId { get; set; }
+
+        /// <summary>
+        /// 获取或设置是否返回 UnionID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("need_unionid")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.NumericalBooleanConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("need_unionid")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalBooleanConverter))]
+        public bool? IsReturnUnionId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetPromoterResponse.cs

@@ -0,0 +1,105 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getpromoter 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetPromoterResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Promoter
+            {
+                /// <summary>
+                /// 获取或设置推广员 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("id")]
+                [System.Text.Json.Serialization.JsonPropertyName("id")]
+                public string PromoterId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置推广员的 OpenId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("openid")]
+                [System.Text.Json.Serialization.JsonPropertyName("openid")]
+                public string OpenId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置角色 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("role_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+                public int RoleId { get; set; }
+
+                /// <summary>
+                /// 获取或设置门店 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("retail_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+                public string? RetailId { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员参数。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("extra_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+                public string? ExtraInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员名称。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("name")]
+                [System.Text.Json.Serialization.JsonPropertyName("name")]
+                public string? Name { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员手机号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("phone")]
+                [System.Text.Json.Serialization.JsonPropertyName("phone")]
+                public string? PhoneNumber { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员授权状态。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("auth_status")]
+                [System.Text.Json.Serialization.JsonPropertyName("auth_status")]
+                public int AuthStatus { get; set; }
+
+                /// <summary>
+                /// 获取或设置商家声明状态。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("decl_status")]
+                [System.Text.Json.Serialization.JsonPropertyName("decl_status")]
+                public int DeclareStatus { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员授权状态变更时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("update_time")]
+                [System.Text.Json.Serialization.JsonPropertyName("update_time")]
+                public long UpdateTimestamp { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置推广员列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("promoter_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("promoter_list")]
+        public Types.Promoter[] PromoterList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_cnt")]
+        public int TotalCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置失败的数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("fail_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("fail_cnt")]
+        public int FailedCount { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetRelationRequest.cs

@@ -0,0 +1,60 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getrelation 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetRelationRequest : PublisherStatSettlementRequest, IInferable<PromoterGetRelationRequest, PromoterGetRelationResponse>
+    {
+        /// <summary>
+        /// 获取或设置推广员的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string PromoterOpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置触达场景值。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("scene")]
+        [System.Text.Json.Serialization.JsonPropertyName("scene")]
+        public int? Scene { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序页面路径。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("path")]
+        [System.Text.Json.Serialization.JsonPropertyName("path")]
+        public string? PagePath { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("begin_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("begin_time")]
+        public long? BeginTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置触达结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+        public long? EndTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页起始 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_id")]
+        public string? StartId { get; set; }
+
+        /// <summary>
+        /// 获取或设置是否返回 UnionID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("need_unionid")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.NumericalBooleanConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("need_unionid")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalBooleanConverter))]
+        public bool? IsReturnUnionId { get; set; }
+
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetRelationResponse.cs

@@ -0,0 +1,98 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getrelation 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetRelationResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Relation
+            {
+                /// <summary>
+                /// 获取或设置推广员的 OpenId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("promoter_openid")]
+                [System.Text.Json.Serialization.JsonPropertyName("promoter_openid")]
+                public string PromoterOpenId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置角色 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("role_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+                public int RoleId { get; set; }
+
+                /// <summary>
+                /// 获取或设置门店 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("retail_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+                public string? RetailId { get; set; }
+
+                /// <summary>
+                /// 获取或设置推广员参数。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("extra_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+                public string? ExtraInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置触达用户的 OpenId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("openid")]
+                [System.Text.Json.Serialization.JsonPropertyName("openid")]
+                public string UserOpenId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置触达场景值。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("scene")]
+                [System.Text.Json.Serialization.JsonPropertyName("scene")]
+                public int Scene { get; set; }
+
+                /// <summary>
+                /// 获取或设置小程序页面路径。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("path")]
+                [System.Text.Json.Serialization.JsonPropertyName("path")]
+                public string PagePath { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置触达时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("create_time")]
+                [System.Text.Json.Serialization.JsonPropertyName("create_time")]
+                public long CreateTimestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置分享素材的自定义参数。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("share_extra_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("share_extra_info")]
+                public string? ShareExtraInfo { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置触达效果数据列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("relation_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("relation_list")]
+        public Types.Relation[] RelationList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_cnt")]
+        public int TotalCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置下一页分页起始 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_id")]
+        public string? NextStartId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetRoleRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getrole 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetRoleRequest : PublisherStatSettlementRequest, IInferable<PromoterGetRoleRequest, PromoterGetRoleResponse>
+    {
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int? RoleId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetRoleResponse.cs

@@ -0,0 +1,49 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getrole 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetRoleResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Role
+            {
+                /// <summary>
+                /// 获取或设置角色 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("role_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+                public int RoleId { get; set; }
+
+                /// <summary>
+                /// 获取或设置角色名称。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("name")]
+                [System.Text.Json.Serialization.JsonPropertyName("name")]
+                public string Name { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置角色描述。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("desc")]
+                [System.Text.Json.Serialization.JsonPropertyName("desc")]
+                public string Description { get; set; } = default!;
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置角色列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_list")]
+        public Types.Role[] RoleList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_cnt")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_cnt")]
+        public int TotalCount { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetShareMaterialRequest.cs

@@ -0,0 +1,50 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getsharematerial 接口的请求。</para>
+    /// </summary>
+    public class PromoterGetShareMaterialRequest : PublisherStatSettlementRequest, IInferable<PromoterGetShareMaterialRequest, PromoterGetShareMaterialResponse>
+    {
+        /// <summary>
+        /// 获取或设置小程序页面名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("title")]
+        [System.Text.Json.Serialization.JsonPropertyName("title")]
+        public string? PageTitle { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序页面路径。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("path")]
+        [System.Text.Json.Serialization.JsonPropertyName("path")]
+        public string PagePath { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置推广员的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string OpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置自定义参数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("extra_info")]
+        [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+        public string? ExtraInfo { get; set; }
+
+        /// <summary>
+        /// 获取或设置分享类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("share_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("share_type")]
+        public int? ShareType { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("env_version")]
+        [System.Text.Json.Serialization.JsonPropertyName("env_version")]
+        public string? EnvironmentVersion { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterGetShareMaterialResponse.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/getsharematerial 接口的响应。</para>
+    /// </summary>
+    public class PromoterGetShareMaterialResponse : WechatApiResponse
+    {
+        /// <summary>
+        /// 获取或设置短链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("tag")]
+        [System.Text.Json.Serialization.JsonPropertyName("tag")]
+        public string? TagUrl { get; set; }
+
+        /// <summary>
+        /// 获取或设置带参链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("share_path")]
+        [System.Text.Json.Serialization.JsonPropertyName("share_path")]
+        public string? SharePath { get; set; }
+
+        /// <summary>
+        /// 获取或设置经 Base64 编码的二维码数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("qrcode")]
+        [System.Text.Json.Serialization.JsonPropertyName("qrcode")]
+        public string? EncodingQrcodeData { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterSendMessageRequest.cs

@@ -0,0 +1,66 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/sendmsg 接口的请求。</para>
+    /// </summary>
+    public class PromoterSendMessageRequest : PublisherStatSettlementRequest, IInferable<PromoterSendMessageRequest, PromoterSendMessageResponse>
+    {
+        /// <summary>
+        /// 获取或设置消息类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_type")]
+        public int MessageType { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息内容 JSON 字符串。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("content")]
+        [System.Text.Json.Serialization.JsonPropertyName("content")]
+        public string ContentJson { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置小程序 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("appid")]
+        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+        public string? AppId { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序跳转路径。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("path")]
+        [System.Text.Json.Serialization.JsonPropertyName("path")]
+        public string? PagePath { get; set; }
+
+        /// <summary>
+        /// 获取或设置下发类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("list_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("list_type")]
+        public int ListType { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public IList<int>? RoleIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置门店 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("retail_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+        public IList<string>? RetailIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("id")]
+        [System.Text.Json.Serialization.JsonPropertyName("id")]
+        public IList<string>? PromoterIdList { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterSendMessageResponse.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/sendmsg 接口的响应。</para>
+    /// </summary>
+    public class PromoterSendMessageResponse : WechatApiResponse
+    {
+        /// <summary>
+        /// 获取或设置消息 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_id")]
+        public string MessageId { get; set; } = default!;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterSingleSendMessageRequest.cs

@@ -0,0 +1,52 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/singlesendmsg 接口的请求。</para>
+    /// </summary>
+    public class PromoterSingleSendMessageRequest : PublisherStatSettlementRequest, IInferable<PromoterSingleSendMessageRequest, PromoterSingleSendMessageResponse>
+    {
+        /// <summary>
+        /// 获取或设置消息类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("msg_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("msg_type")]
+        public int MessageType { get; set; }
+
+        /// <summary>
+        /// 获取或设置消息内容 JSON 字符串。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("content")]
+        [System.Text.Json.Serialization.JsonPropertyName("content")]
+        public string ContentJson { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置小程序 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("appid")]
+        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+        public string? AppId { get; set; }
+
+        /// <summary>
+        /// 获取或设置小程序跳转路径。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("path")]
+        [System.Text.Json.Serialization.JsonPropertyName("path")]
+        public string? PagePath { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员 ID。与字段 <see cref="OpenId"/> 二选一。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("id")]
+        [System.Text.Json.Serialization.JsonPropertyName("id")]
+        public string? PromoterId { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员的 OpenId。与字段 <see cref="PromoterId"/> 二选一。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string? OpenId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterSingleSendMessageResponse.cs

@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/singlesendmsg 接口的响应。</para>
+    /// </summary>
+    public class PromoterSingleSendMessageResponse : WechatApiResponse
+    {
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterUpdatePromoterRequest.cs

@@ -0,0 +1,57 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/updatepromoter 接口的请求。</para>
+    /// </summary>
+    public class PromoterUpdatePromoterRequest : PublisherStatSettlementRequest, IInferable<PromoterUpdatePromoterRequest, PromoterUpdatePromoterResponse>
+    {
+        /// <summary>
+        /// 获取或设置推广员 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("id")]
+        [System.Text.Json.Serialization.JsonPropertyName("id")]
+        public string PromoterId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int? RoleId { get; set; }
+
+        /// <summary>
+        /// 获取或设置门店 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("retail_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("retail_id")]
+        public string? RetailId { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员参数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("extra_info")]
+        [System.Text.Json.Serialization.JsonPropertyName("extra_info")]
+        public string? ExtraInfo { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("name")]
+        [System.Text.Json.Serialization.JsonPropertyName("name")]
+        public string? Name { get; set; }
+
+        /// <summary>
+        /// 获取或设置推广员手机号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("phone")]
+        [System.Text.Json.Serialization.JsonPropertyName("phone")]
+        public string? PhoneNumber { get; set; }
+
+        /// <summary>
+        /// 获取或设置商家声明状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("decl_status")]
+        [System.Text.Json.Serialization.JsonPropertyName("decl_status")]
+        public int? DeclareStatus { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterUpdatePromoterResponse.cs

@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/updatepromoter 接口的响应。</para>
+    /// </summary>
+    public class PromoterUpdatePromoterResponse : WechatApiResponse
+    {
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterUpdateRoleRequest.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/updaterole 接口的请求。</para>
+    /// </summary>
+    public class PromoterUpdateRoleRequest : PublisherStatSettlementRequest, IInferable<PromoterUpdateRoleRequest, PromoterUpdateRoleResponse>
+    {
+        /// <summary>
+        /// 获取或设置角色 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("role_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("role_id")]
+        public int RoleId { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("name")]
+        [System.Text.Json.Serialization.JsonPropertyName("name")]
+        public string? Name { get; set; }
+
+        /// <summary>
+        /// 获取或设置角色描述。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("desc")]
+        [System.Text.Json.Serialization.JsonPropertyName("desc")]
+        public string? Description { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Promoter/PromoterUpdateRoleResponse.cs

@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /promoter/updaterole 接口的响应。</para>
+    /// </summary>
+    public class PromoterUpdateRoleResponse : WechatApiResponse
+    {
+    }
+}