feat(tiktokshop): 新增创建履约起步价套餐接口

Author: fudiwei

docs/TikTokGlobalShop/Basic_ModelDefinition.md

@@ -85,6 +85,7 @@ Notes: The following catalog is consistent with the catalog structure of [TikTok
     -   Get Order Split Attributes: `FulfillmentGetOrderSplitAttributes`
     -   Split Orders: `FulfillmentSplitOrder`
     -   Get Eligible Shipping Service: `FulfillmentSearchOrderShippingServices`
+    -   Create First Mile Bundle: `FulfillmentCreateBundle`
     -   Create Packages: `FulfillmentCreatePackage`
     -   Search Package: `FulfillmentSearchPackages`
     -   Search Combinable Packages: `FulfillmentSearchCombinablePackages`

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Extensions/TikTokShopClientExecuteFulfillmentExtensions.cs

@@ -11,6 +11,30 @@ namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop
 
     public static class TikTokShopClientExecuteFulfillmentExtensions
     {
+        #region Bundle
+        /// <summary>
+        /// <para>异步调用 [POST] /fulfillment/{version}/bundles 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://partner.tiktokshop.com/docv2/page/669f4a4e762e2402ff17df5c ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.FulfillmentCreateBundleResponse> ExecuteFulfillmentCreateBundleAsync(this TikTokShopClient client, Models.FulfillmentCreateBundleRequest 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, "fulfillment", request.ApiVersion, "bundles");
+
+            return await client.SendFlurlRequesAsJsontAsync<Models.FulfillmentCreateBundleResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+        #endregion
+
         #region Orders
         /// <summary>
         /// <para>异步调用 [GET] /fulfillment/{version}/orders/split_attributes 接口。</para>

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/Fulfillment/Bundle/FulfillmentCreateBundleRequest.cs

@@ -0,0 +1,53 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /fulfillment/{version}/bundles 接口的请求。</para>
+    /// </summary>
+    public class FulfillmentCreateBundleRequest : TikTokShopRequest
+    {
+        /// <summary>
+        /// 获取或设置 API 版本号。
+        /// <para>默认值：202407</para>
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public override int ApiVersion { get; set; } = 202407;
+
+        /// <summary>
+        /// 获取或设置订单 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("order_ids")]
+        [System.Text.Json.Serialization.JsonPropertyName("order_ids")]
+        public IList<string> OrderIdList { get; set; } = new List<string>();
+
+        /// <summary>
+        /// 获取或设置交接方式。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("handover_method")]
+        [System.Text.Json.Serialization.JsonPropertyName("handover_method")]
+        public string HandoverMethod { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置运输服务商 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("shipping_provider_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("shipping_provider_id")]
+        public string? ShippingProviderId { get; set; }
+
+        /// <summary>
+        /// 获取或设置物流单号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("tracking_number")]
+        [System.Text.Json.Serialization.JsonPropertyName("tracking_number")]
+        public string? TrackingNumber { get; set; }
+
+        /// <summary>
+        /// 获取或设置电话号码后四位。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("phone_tail_number")]
+        [System.Text.Json.Serialization.JsonPropertyName("phone_tail_number")]
+        public string? PhoneTailNumber { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/Fulfillment/Bundle/FulfillmentCreateBundleResponse.cs

@@ -0,0 +1,75 @@
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /fulfillment/{version}/bundles 接口的响应。</para>
+    /// </summary>
+    public class FulfillmentCreateBundleResponse : TikTokShopResponse<FulfillmentCreateBundleResponse.Types.Data>
+    {
+        public static class Types
+        {
+            public class Data
+            {
+                public static class Types
+                {
+                    public class Error
+                    {
+                        public static class Types
+                        {
+                            public class Detail
+                            {
+                                /// <summary>
+                                /// 获取或设置订单 ID。
+                                /// </summary>
+                                [Newtonsoft.Json.JsonProperty("order_id")]
+                                [System.Text.Json.Serialization.JsonPropertyName("order_id")]
+                                public string OrderId { get; set; } = default!;
+                            }
+                        }
+
+                        /// <summary>
+                        /// 获取或设置错误码。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("code")]
+                        [System.Text.Json.Serialization.JsonPropertyName("code")]
+                        public int Code { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置错误信息。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("message")]
+                        [System.Text.Json.Serialization.JsonPropertyName("message")]
+                        public string Message { get; set; } = default!;
+
+                        /// <summary>
+                        /// 获取或设置详细信息。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("detail")]
+                        [System.Text.Json.Serialization.JsonPropertyName("detail")]
+                        public Types.Detail Detail { get; set; } = default!;
+                    }
+                }
+
+                /// <summary>
+                /// 获取或设置套餐 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("first_mile_bundle_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("first_mile_bundle_id")]
+                public string FirstMileBundleId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置运单链接。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("url")]
+                [System.Text.Json.Serialization.JsonPropertyName("url")]
+                public string Url { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置错误列表。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("errors")]
+                [System.Text.Json.Serialization.JsonPropertyName("errors")]
+                public Types.Error[]? ErrorList { get; set; } = default!;
+            }
+        }
+    }
+}

test/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.UnitTests/ModelSamples/_/Fulfillment/Bundle/FulfillmentCreateBundleRequest.json

@@ -0,0 +1,9 @@
+{
+    "handover_method": "PICKUP",
+    "order_ids": [
+        "578967030217083407"
+    ],
+    "phone_tail_number": "1234",
+    "shipping_provider_id": "7463353253533",
+    "tracking_number": "SF1244442424"
+}

test/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.UnitTests/ModelSamples/_/Fulfillment/Bundle/FulfillmentCreateBundleResponse.json

@@ -0,0 +1,18 @@
+{
+    "code": 0,
+    "data": {
+        "errors": [
+            {
+                "code": 10007014,
+                "detail": {
+                    "order_id": "578967030217083407"
+                },
+                "message": "invalid package id"
+            }
+        ],
+        "first_mile_bundle_id": "BA123444534",
+        "url": "https://open-fs-va.tiktokshop.com/doc_tts/object/28b05?skipCookie=true&timeStamp=1721272360&sign=ef63cd6"
+    },
+    "message": "Success",
+    "request_id": "202203070749000101890810281E8C70B7"
+}