feat(wxapi): 新增微信小店代用户发起售后接口

This commit is contained in:
Fu Diwei
2025-05-06 15:37:12 +08:00
parent 782b564546
commit aaf00eaecd
6 changed files with 137 additions and 1 deletions

View File

@@ -10,6 +10,29 @@ namespace SKIT.FlurlHttpClient.Wechat.Api
public static class WechatApiClientExecuteChannelsExtensions
{
#region ECAftersale
/// <summary>
/// <para>异步调用 [POST] /channels/ec/aftersale/genaftersaleorder 接口。</para>
/// <para>
/// REF: <br/>
/// <![CDATA[ https://developers.weixin.qq.com/doc/store/shop/API/aftersale/genaftersaleorder.html ]]>
/// </para>
/// </summary>
/// <param name="client"></param>
/// <param name="request"></param>
/// <param name="cancellationToken"></param>
/// <returns></returns>
public static async Task<Models.ChannelsECAftersaleGenerateAftersaleOrderResponse> ExecuteChannelsECAftersaleGenerateAftersaleOrderAsync(this WechatApiClient client, Models.ChannelsECAftersaleGenerateAftersaleOrderRequest 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", "aftersale", "genaftersaleorder")
.SetQueryParam("access_token", request.AccessToken);
return await client.SendFlurlRequestAsJsonAsync<Models.ChannelsECAftersaleGenerateAftersaleOrderResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
}
/// <summary>
/// <para>异步调用 [POST] /channels/ec/aftersale/getaftersalelist 接口。</para>
/// <para>

View File

@@ -0,0 +1,82 @@
namespace SKIT.FlurlHttpClient.Wechat.Api.Models
{
/// <summary>
/// <para>表示 [POST] /channels/ec/aftersale/genaftersaleorder 接口的请求。</para>
/// </summary>
public class ChannelsECAftersaleGenerateAftersaleOrderRequest : WechatApiRequest, IInferable<ChannelsECAftersaleGenerateAftersaleOrderRequest, ChannelsECAftersaleGenerateAftersaleOrderResponse>
{
/// <summary>
/// 获取或设置请求唯一 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("request_id")]
[System.Text.Json.Serialization.JsonPropertyName("request_id")]
public string RequestId { get; set; } = string.Empty;
/// <summary>
/// 获取或设置订单 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("order_id")]
[System.Text.Json.Serialization.JsonPropertyName("order_id")]
public string OrderId { get; set; } = string.Empty;
/// <summary>
/// 获取或设置商品 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("product_id")]
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.TextualNumberConverter))]
[System.Text.Json.Serialization.JsonPropertyName("product_id")]
[System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString | System.Text.Json.Serialization.JsonNumberHandling.WriteAsString)]
public long ProductId { get; set; }
/// <summary>
/// 获取或设置 SKU ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("sku_id")]
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.TextualNumberConverter))]
[System.Text.Json.Serialization.JsonPropertyName("sku_id")]
[System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString | System.Text.Json.Serialization.JsonNumberHandling.WriteAsString)]
public long SKUId { get; set; }
/// <summary>
/// 获取或设置发起售后数量。
/// </summary>
[Newtonsoft.Json.JsonProperty("count")]
[System.Text.Json.Serialization.JsonPropertyName("count")]
public int Count { get; set; }
/// <summary>
/// 获取或设置售后退款金额(单位:分)。
/// </summary>
[Newtonsoft.Json.JsonProperty("amount")]
[System.Text.Json.Serialization.JsonPropertyName("amount")]
public int Amount { get; set; }
/// <summary>
/// 获取或设置售后原因。
/// </summary>
[Newtonsoft.Json.JsonProperty("reason")]
[System.Text.Json.Serialization.JsonPropertyName("reason")]
public string Reason { get; set; } = string.Empty;
/// <summary>
/// 获取或设置售后类型。
/// </summary>
[Newtonsoft.Json.JsonProperty("type")]
[System.Text.Json.Serialization.JsonPropertyName("type")]
public string Type { get; set; } = string.Empty;
/// <summary>
/// 获取或设置退货地址 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("address_id")]
[System.Text.Json.Serialization.JsonPropertyName("address_id")]
public long? AddressId { get; set; }
/// <summary>
/// 获取或设置补充说明。
/// </summary>
[Newtonsoft.Json.JsonProperty("desc")]
[System.Text.Json.Serialization.JsonPropertyName("desc")]
public string? Description { get; set; }
}
}

View File

@@ -0,0 +1,16 @@
namespace SKIT.FlurlHttpClient.Wechat.Api.Models
{
/// <summary>
/// <para>表示 [POST] /channels/ec/aftersale/genaftersaleorder 接口的响应。</para>
/// </summary>
public class ChannelsECAftersaleGenerateAftersaleOrderResponse : WechatApiResponse
{
/// <summary>
/// 获取或设置售后单 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("after_sale_order_id")]
[System.Text.Json.Serialization.JsonPropertyName("after_sale_order_id")]
[System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalStringReadOnlyConverter))]
public string AftersaleOrderId { get; set; } = default!;
}
}

View File

@@ -360,7 +360,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Api.Models
public string? UnionId { get; set; }
/// <summary>
/// 获取或设置退款原因。
/// 获取或设置售后原因。
/// </summary>
[Newtonsoft.Json.JsonProperty("reason")]
[System.Text.Json.Serialization.JsonPropertyName("reason")]

View File

@@ -0,0 +1,10 @@
{
"request_id": "111222",
"order_id": "37123432487943243",
"product_id": "2346783",
"sku_id": "23643824",
"count": 1,
"amount": 100,
"reason": "双方协商一致退款",
"type": "REFUND"
}

View File

@@ -0,0 +1,5 @@
{
"errcode": 0,
"errmsg": "ok",
"after_sale_order_id": "2082648273412"
}