add restrictions

Author: abuzuhri

README.md

@@ -34,6 +34,8 @@ Install-Package CSharpAmazonSpAPI
 - [x] [FinancesV0](https://github.com/amzn/selling-partner-api-docs/blob/main/references/finances-api/financesV0.md)
 - [x] [Feeds](https://github.com/amzn/selling-partner-api-docs/blob/main/references/feeds-api/feeds_2021-06-30.md) for [feedType](https://github.com/amzn/selling-partner-api-docs/blob/main/references/feeds-api/feedtype-values.md) for step to call feed read [doc](https://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/use-case-guides/feeds-api-use-case-guide/feeds-api-use-case-guide_2021-06-30.md)
 - [x] [ListingsItems](https://github.com/amzn/selling-partner-api-docs/blob/main/references/listings-items-api/listingsItems_2021-08-01.md)
+- [x] [Restrictions](https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-reference)
+- [ ] [ProductTypes](https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api-v2020-09-01-reference)
 - [x] [Uploads](https://github.com/amzn/selling-partner-api-docs/blob/main/references/uploads-api/uploads_2020-11-01.md)
 - [x] [shipmentInvoicingV0](https://github.com/amzn/selling-partner-api-docs/blob/main/references/shipment-invoicing-api/shipmentInvoicingV0.md)
 - [x] [Shippings](https://github.com/amzn/selling-partner-api-docs/blob/main/references/shipping-api/shipping.md)
@@ -385,6 +387,17 @@ var amazonConnection = new AmazonConnection(new AmazonCredential()
 
 ---
 
+## Get restrictions before try to add new lists
+
+```CSharp
+var result = amazonConnection.Restrictions.GetListingsRestrictions(
+    new Parameter.Restrictions.ParameterGetListingsRestrictions
+            {
+                asin = "AAAAAAAAAA",
+                sellerId = "AXXXXXXXXXXXX"
+            });
+```
+---
 ## Create shipment operation from MerchantFulfillment
 
 ```CSharp

Source/FikaAmazonAPI.SampleCode/Program.cs

@@ -33,6 +33,13 @@ static async Task Main(string[] args)
                 MarketPlace = MarketPlace.GetMarketPlaceByID(config.GetSection("FikaAmazonAPI:MarketPlaceID").Value),
                 IsActiveLimitRate = true
             });
+
+            var result = amazonConnection.Restrictions.GetListingsRestrictions(new Parameter.Restrictions.ParameterGetListingsRestrictions
+            {
+                asin = "B07GY3J99B",
+                sellerId = "A3J37AJU4O9RHK"
+            });
+
             var SKU = "693749790020";
             var sellerId = "A3J37AJU4O9RHK";
 

Source/FikaAmazonAPI/AmazonConnection.cs

@@ -22,6 +22,7 @@ public class AmazonConnection
         public FbaSmallandLightService FbaSmallandLight => this._FbaSmallandLight ?? throw _NoCredentials;
         public FeedService Feed => this._Feed ?? throw _NoCredentials;
         public ListingsItemService ListingsItem => this._ListingsItem ?? throw _NoCredentials;
+        public RestrictionService Restrictions => this._Restrictions ?? throw _NoCredentials;
         public MerchantFulfillmentService MerchantFulfillment => this._MerchantFulfillment ?? throw _NoCredentials;
         public MessagingService Messaging => this._Messaging ?? throw _NoCredentials;
         public NotificationService Notification => this._Notification ?? throw _NoCredentials;
@@ -54,6 +55,7 @@ public class AmazonConnection
         private FbaSmallandLightService _FbaSmallandLight { get; set; }
         private FeedService _Feed { get; set; }
         private ListingsItemService _ListingsItem { get; set; }
+        private RestrictionService _Restrictions { get; set; }
         private MerchantFulfillmentService _MerchantFulfillment { get; set; }
         private MessagingService _Messaging { get; set; }
         private NotificationService _Notification { get; set; }
@@ -107,6 +109,7 @@ private void Init(AmazonCredential Credentials)
             this._AplusContent = new AplusContentService(this.Credentials);
             this._Feed = new FeedService(this.Credentials);
             this._ListingsItem = new ListingsItemService(this.Credentials);
+            this._Restrictions = new RestrictionService(this.Credentials);
             this._MerchantFulfillment = new MerchantFulfillmentService(this.Credentials);
             this._Messaging = new MessagingService(this.Credentials);
             this._Notification = new NotificationService(this.Credentials);

Source/FikaAmazonAPI/AmazonSpApiSDK/Models/Restrictions/ConditionType.cs

@@ -0,0 +1,59 @@
+namespace FikaAmazonAPI.AmazonSpApiSDK.Models.Restrictions
+{
+    public enum ConditionType
+    {
+        /// <summary>
+        /// New
+        /// </summary>
+        new_new,
+        /// <summary>
+        /// New - Open Box.
+        /// </summary>
+        new_open_box,
+        /// <summary>
+        /// New - OEM.
+        /// </summary>
+        new_oem,
+        /// <summary>
+        /// Refurbished
+        /// </summary>
+        refurbished_refurbished,
+        /// <summary>
+        /// Used - Like New.
+        /// </summary>
+        used_like_new,
+        /// <summary>
+        /// Used - Very Good.
+        /// </summary>
+        used_very_good,
+        /// <summary>
+        /// Used - Good.
+        /// </summary>
+        used_good,
+        /// <summary>
+        /// Used - Acceptable.
+        /// </summary>
+        used_acceptable,
+        /// <summary>
+        /// Collectible - Like New.
+        /// </summary>
+        collectible_like_new,
+        /// <summary>
+        /// Collectible - Very Good.
+        /// </summary>
+        collectible_very_good,
+        /// <summary>
+        /// Collectible - Good.
+        /// </summary>
+        collectible_good,
+        /// <summary>
+        /// Collectible - Acceptable.
+        /// </summary>
+        collectible_acceptable,
+        /// <summary>
+        /// Club
+        /// </summary>
+        club_club
+
+    }
+}

Source/FikaAmazonAPI/AmazonSpApiSDK/Models/Restrictions/Link.cs

@@ -0,0 +1,73 @@
+using Newtonsoft.Json;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace FikaAmazonAPI.AmazonSpApiSDK.Models.Restrictions
+{
+
+    /// <summary>
+    /// A link to resources related to a listing restriction.
+    /// </summary>
+    [DataContract]
+    public class Link
+    {
+        /// <summary>
+        /// The URI of the related resource.
+        /// </summary>
+        /// <value>The URI of the related resource.</value>
+        [DataMember(Name = "resource", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "resource")]
+        public string Resource { get; set; }
+
+        /// <summary>
+        /// The HTTP verb used to interact with the related resource.
+        /// </summary>
+        /// <value>The HTTP verb used to interact with the related resource.</value>
+        [DataMember(Name = "verb", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "verb")]
+        public string Verb { get; set; }
+
+        /// <summary>
+        /// The title of the related resource.
+        /// </summary>
+        /// <value>The title of the related resource.</value>
+        [DataMember(Name = "title", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "title")]
+        public string Title { get; set; }
+
+        /// <summary>
+        /// The media type of the related resource.
+        /// </summary>
+        /// <value>The media type of the related resource.</value>
+        [DataMember(Name = "type", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "type")]
+        public string Type { get; set; }
+
+
+        /// <summary>
+        /// Get the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append("class Link {\n");
+            sb.Append("  Resource: ").Append(Resource).Append("\n");
+            sb.Append("  Verb: ").Append(Verb).Append("\n");
+            sb.Append("  Title: ").Append(Title).Append("\n");
+            sb.Append("  Type: ").Append(Type).Append("\n");
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// Get the JSON string presentation of the object
+        /// </summary>
+        /// <returns>JSON string presentation of the object</returns>
+        public string ToJson()
+        {
+            return JsonConvert.SerializeObject(this, Formatting.Indented);
+        }
+
+    }
+}

Source/FikaAmazonAPI/AmazonSpApiSDK/Models/Restrictions/Reason.cs

@@ -0,0 +1,65 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace FikaAmazonAPI.AmazonSpApiSDK.Models.Restrictions
+{
+
+    /// <summary>
+    /// A reason for the restriction, including path forward links that may allow Selling Partners to remove the restriction, if available.
+    /// </summary>
+    [DataContract]
+    public class Reason
+    {
+        /// <summary>
+        /// A message describing the reason for the restriction.
+        /// </summary>
+        /// <value>A message describing the reason for the restriction.</value>
+        [DataMember(Name = "message", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "message")]
+        public string Message { get; set; }
+
+        /// <summary>
+        /// A code indicating why the listing is restricted.
+        /// </summary>
+        /// <value>A code indicating why the listing is restricted.</value>
+        [DataMember(Name = "reasonCode", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "reasonCode")]
+        public string ReasonCode { get; set; }
+
+        /// <summary>
+        /// A list of path forward links that may allow Selling Partners to remove the restriction.
+        /// </summary>
+        /// <value>A list of path forward links that may allow Selling Partners to remove the restriction.</value>
+        [DataMember(Name = "links", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "links")]
+        public List<Link> Links { get; set; }
+
+
+        /// <summary>
+        /// Get the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append("class Reason {\n");
+            sb.Append("  Message: ").Append(Message).Append("\n");
+            sb.Append("  ReasonCode: ").Append(ReasonCode).Append("\n");
+            sb.Append("  Links: ").Append(Links).Append("\n");
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// Get the JSON string presentation of the object
+        /// </summary>
+        /// <returns>JSON string presentation of the object</returns>
+        public string ToJson()
+        {
+            return JsonConvert.SerializeObject(this, Formatting.Indented);
+        }
+
+    }
+}

Source/FikaAmazonAPI/AmazonSpApiSDK/Models/Restrictions/Restriction.cs

@@ -0,0 +1,65 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace FikaAmazonAPI.AmazonSpApiSDK.Models.Restrictions
+{
+
+    /// <summary>
+    /// A listing restriction, optionally qualified by a condition, with a list of reasons for the restriction.
+    /// </summary>
+    [DataContract]
+    public class Restriction
+    {
+        /// <summary>
+        /// A marketplace identifier. Identifies the Amazon marketplace where the restriction is enforced.
+        /// </summary>
+        /// <value>A marketplace identifier. Identifies the Amazon marketplace where the restriction is enforced.</value>
+        [DataMember(Name = "marketplaceId", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "marketplaceId")]
+        public string MarketplaceId { get; set; }
+
+        /// <summary>
+        /// The condition that applies to the restriction.
+        /// </summary>
+        /// <value>The condition that applies to the restriction.</value>
+        [DataMember(Name = "conditionType", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "conditionType")]
+        public string ConditionType { get; set; }
+
+        /// <summary>
+        /// A list of reasons for the restriction.
+        /// </summary>
+        /// <value>A list of reasons for the restriction.</value>
+        [DataMember(Name = "reasons", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "reasons")]
+        public List<Reason> Reasons { get; set; }
+
+
+        /// <summary>
+        /// Get the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append("class Restriction {\n");
+            sb.Append("  MarketplaceId: ").Append(MarketplaceId).Append("\n");
+            sb.Append("  ConditionType: ").Append(ConditionType).Append("\n");
+            sb.Append("  Reasons: ").Append(Reasons).Append("\n");
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// Get the JSON string presentation of the object
+        /// </summary>
+        /// <returns>JSON string presentation of the object</returns>
+        public string ToJson()
+        {
+            return JsonConvert.SerializeObject(this, Formatting.Indented);
+        }
+
+    }
+}

Source/FikaAmazonAPI/AmazonSpApiSDK/Models/Restrictions/RestrictionList.cs

@@ -0,0 +1,46 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace FikaAmazonAPI.AmazonSpApiSDK.Models.Restrictions
+{
+
+    /// <summary>
+    /// A list of restrictions for the specified Amazon catalog item.
+    /// </summary>
+    [DataContract]
+    public class RestrictionList
+    {
+        /// <summary>
+        /// Gets or Sets Restrictions
+        /// </summary>
+        [DataMember(Name = "restrictions", EmitDefaultValue = false)]
+        [JsonProperty(PropertyName = "restrictions")]
+        public List<Restriction> Restrictions { get; set; }
+
+
+        /// <summary>
+        /// Get the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append("class RestrictionList {\n");
+            sb.Append("  Restrictions: ").Append(Restrictions).Append("\n");
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// Get the JSON string presentation of the object
+        /// </summary>
+        /// <returns>JSON string presentation of the object</returns>
+        public string ToJson()
+        {
+            return JsonConvert.SerializeObject(this, Formatting.Indented);
+        }
+
+    }
+}