Creating Listings using the Listings API

[TechyChap]

I'm trying to create a listing using the listings API and so far I have created a couple of simple classes for the attributes and am using those to generate the putlistingitem

 ParameterPutListingItem myListing = new ParameterPutListingItem()
            {
                sellerId = "A3W3NOJVUUSUGG",
                marketplaceIds = new string[] { MarketPlace.UnitedKingdom.ID },
                sku = SKU,
                listingsItemPutRequest = new ListingsItemPutRequest()
                {
                    ProductType = "LUGGAGE",
                    Requirements = Requirements.LISTING_PRODUCT_ONLY,

                    //Example from https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide
                    Attributes = new List<Attribute>() {
                        new Attribute()
                        {
                            key = "condition_type",
                            items = new List<AttributeItem>()
                            {
                                new AttributeItem()
                                {
                                    value = "new_new",
                                    marketplace_id = MarketPlace.UnitedKingdom.ID
                                }
                            }
                        },
                        new Attribute()
                        {
                            key = "item_name",
                            items = new List<AttributeItem>()
                            {
                                new AttributeItem()
                                {
                                    value = "AmazonBasics 16\" Underseat Spinner Carry-On",
                                    language_tag = "en_US",
                                    marketplace_id = MarketPlace.UnitedKingdom.ID
                                }
                            }
                        }
                    }
                }
            };

        var response = amazonConnection.ListingsItem.PutListingsItem(myListing);

But I'm getting an error from the API that suggests I'm missing attributes and product type.

Wonder if anyone else has successfully posted a listing?

FikaAmazonAPI.AmazonSpApiSDK.Models.Exceptions.AmazonInvalidInputException: 'Invalid request body: [object has missing required properties (["attributes","productType"])]'

[TechyChap]

Found a bug, the ListingItemsPutRequest needs to be in lowercase.

public class ListingsItemPutRequest
    {
        public string productType { get; set; }

        public Requirements requirements { get; set; }

        public Object attributes { get; set; }
    }

[TechyChap]

Will try to do a PR once I've got this working. But getting a new issue with my payload

"errors": [
{
"message": "Invalid request body: [instance type (array) does not match any allowed primitive type (allowed: ["object"]), instance type (integer) does not match any allowed primitive type (allowed: ["string"]), instance value (1) not found in enum (possible values: ["LISTING","LISTING_PRODUCT_ONLY","LISTING_OFFER_ONLY"])]",
"code": "InvalidInput"
}
]

[TechyChap]

Fixed the 2 issues with the library. #134 Now to work out how to send the attributes....

[abuzuhri]

I will do test for this before approve it

[abuzuhri]

Can you share working example for put

[TechyChap]

So far I've got as far as making something that's well formed but I'm getting an "internal error" posting to the sandbox. Not sure if it is just a case of populating more of the attributes?

    public class Attributes
    {
        public List<AttributeItem> condition_type { get; set; }
        public List<AttributeItem> item_name { get; set; }
    }
    
    public class AttributeItem
    {
        public string value { get; set; }

        public string language_tag { get; set; }

        public string marketplace_id { get; set; }

        // todo: Work out a generic way of doing this
        // don't serialize null properties
        public bool ShouldSerializelanguage_tag()
        {
            return (language_tag != null);
        }
    }

ParameterPutListingItem myListing = new ParameterPutListingItem()
            {
                sellerId = "A3W3NOJVUUSUGG",
                marketplaceIds = new string[] { MarketPlace.UnitedKingdom.ID },
                sku = SKU,
                listingsItemPutRequest = new ListingsItemPutRequest()
                {
                    productType = "LUGGAGE",
                    requirements = Requirements.LISTING_PRODUCT_ONLY,

                    //Example from https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide
                    attributes = new Attributes()
                        {
                            condition_type = new List<AttributeItem>() {
                                new AttributeItem()
                                {
                                    value = "new_new",
                                    marketplace_id = MarketPlace.UnitedKingdom.ID
                                }
                            },
                            item_name = new List<AttributeItem>()
                            {
                                new AttributeItem()
                                {
                                    value = "AmazonBasics 16\" Underseat Spinner Carry-On",
                                    language_tag = "en_US",
                                    marketplace_id = MarketPlace.UnitedKingdom.ID
                                }
                            }
                        }
                    }
            };

        var response = amazonConnection.ListingsItem.PutListingsItem(myListing);

[TechyChap]

Tried using the ItemAttributes from the model. But that didn't help

[abuzuhri]

Try this code with last code in repo , i get error message for productType complaining about the value

            var SKU = "XXXXXXXXXX";
            var sellerId = "XXXXXXXXXXXX";

            ParameterPutListingItem myListing = new ParameterPutListingItem()
            {
                sellerId = sellerId,
                marketplaceIds = new string[] { MarketPlace.UnitedArabEmirates.ID },
                sku = SKU,
                listingsItemPutRequest = new ListingsItemPutRequest()
                {
                    productType = "LUGGAGE",
                    requirements = Requirements.LISTING,

                    //Example from https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide
                    attributes = new ParameterAttributes()
                    {
                        condition_type = new List<ParameterAttributeItem>() {
                                new ParameterAttributeItem()
                                {
                                    value = "new_new",
                                    marketplace_id = MarketPlace.UnitedArabEmirates.ID
                                }
                            },
                        item_name = new List<ParameterAttributeItem>()
                            {
                                new ParameterAttributeItem()
                                {
                                    value = "Thorne Research - Diabenil - Support for Maintaining Healthy Blood Sugar Levels - with Chromium, ALA, and Quercetin Phytosome - 90 Capsules - ",
                                    language_tag = "en_US",
                                    marketplace_id = MarketPlace.UnitedArabEmirates.ID
                                }
                            }
                    }
                }
            };

            var response = amazonConnection.ListingsItem.PutListingsItem(myListing);

[abuzuhri]

I suspect that the product type has to match your marketplace. Check https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api-v2020-09-01-reference#producttype for UnitedArabEmirates product types.

Search for productType not implemented now its look like i should add them to API

[abuzuhri]

Hello @TechyChap

Do you try to submit ?

[TechyChap]

I've only tried the sandbox so far and that's giving me a 500 error. If I'm asking my business contact for some real data so I can test on live without making a mess.

[TechyChap]

Just tried it with the live API. It is responding with a message that suggests that it is working correctly other than the data I am sending.

e.g. {"code":"90220","message":"'recommended_browse_nodes' is required but not supplied.","severity":"ERROR","attributeNames":["recommended_browse_nodes"]}

Also having studied the attributes in more detail, I think it would be best to have the ParameterAttributes and ParameterAttributeItem defined in a similar manner as both seem to have quite variable content depending on the product type and attribute.

That then allows you to create the data like this:

attributes = new ParameterAttributes()
                    {
                        { "condition_type", new List<ParameterAttributeItem>()
                            {
                                new ParameterAttributeItem() {
                                    { "value" , "new_new" },
                                    { "marketplace_id", MarketPlace.UnitedKingdom.ID }
                                }
                            }
                        },
                        { "item_name", new List<ParameterAttributeItem>()
                            {
                                new ParameterAttributeItem()
                                {
                                    { "value", "My New Amazon Product" },
                                    { "marketplace_id", MarketPlace.UnitedKingdom.ID },
                                    { "language_tag", "en_US" }
                                }
                            }
                        }
                    }

[TechyChap]

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Text;

//Based on namespace FikaAmazonAPI.AmazonSpApiSDK.Models.ListingsItems
namespace FikaAmazonAPI.Parameter.ListingsItems
{
        /// <summary>
        /// JSON object containing structured listings item attribute data keyed by attribute name.
        /// </summary>
        public partial class ParameterAttributes : Dictionary<String, List<ParameterAttributeItem>>, IEquatable<ParameterAttributes>, IValidatableObject
        {
            /// <summary>
            /// Initializes a new instance of the <see cref="ItemAttributes" /> class.
            /// </summary>
            [JsonConstructorAttribute]
            public ParameterAttributes() : base()
            {
            }

            /// <summary>
            /// Returns 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 ItemAttributes {\n");
                sb.Append("  ").Append(base.ToString().Replace("\n", "\n  ")).Append("\n");
                sb.Append("}\n");
                return sb.ToString();
            }

            /// <summary>
            /// Returns 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);
            }

            /// <summary>
            /// Returns true if objects are equal
            /// </summary>
            /// <param name="input">Object to be compared</param>
            /// <returns>Boolean</returns>
            public override bool Equals(object input)
            {
                return this.Equals(input as ParameterAttributes);
            }

            /// <summary>
            /// Returns true if ItemAttributes instances are equal
            /// </summary>
            /// <param name="input">Instance of ItemAttributes to be compared</param>
            /// <returns>Boolean</returns>
            public bool Equals(ParameterAttributes input)
            {
                if (input == null)
                    return false;

                return base.Equals(input);
            }

            /// <summary>
            /// Gets the hash code
            /// </summary>
            /// <returns>Hash code</returns>
            public override int GetHashCode()
            {
                unchecked // Overflow is fine, just wrap
                {
                    int hashCode = base.GetHashCode();
                    return hashCode;
                }
            }

            /// <summary>
            /// To validate all properties of the instance
            /// </summary>
            /// <param name="validationContext">Validation context</param>
            /// <returns>Validation Result</returns>
            IEnumerable<System.ComponentModel.DataAnnotations.ValidationResult> IValidatableObject.Validate(ValidationContext validationContext)
            {
                yield break;
            }
        }
    }

[TechyChap]

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Text;

//Based on namespace FikaAmazonAPI.AmazonSpApiSDK.Models.ListingsItems
namespace FikaAmazonAPI.Parameter.ListingsItems
{
        /// <summary>
        /// JSON object containing structured listings item attribute data keyed by attribute name.
        /// </summary>
        public partial class ParameterAttributes : Dictionary<String, List<ParameterAttributeItem>>, IEquatable<ParameterAttributes>, IValidatableObject
        {
            /// <summary>
            /// Initializes a new instance of the <see cref="ItemAttributes" /> class.
            /// </summary>
            [JsonConstructorAttribute]
            public ParameterAttributes() : base()
            {
            }

            /// <summary>
            /// Returns 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 ItemAttributes {\n");
                sb.Append("  ").Append(base.ToString().Replace("\n", "\n  ")).Append("\n");
                sb.Append("}\n");
                return sb.ToString();
            }

            /// <summary>
            /// Returns 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);
            }

            /// <summary>
            /// Returns true if objects are equal
            /// </summary>
            /// <param name="input">Object to be compared</param>
            /// <returns>Boolean</returns>
            public override bool Equals(object input)
            {
                return this.Equals(input as ParameterAttributes);
            }

            /// <summary>
            /// Returns true if ItemAttributes instances are equal
            /// </summary>
            /// <param name="input">Instance of ItemAttributes to be compared</param>
            /// <returns>Boolean</returns>
            public bool Equals(ParameterAttributes input)
            {
                if (input == null)
                    return false;

                return base.Equals(input);
            }

            /// <summary>
            /// Gets the hash code
            /// </summary>
            /// <returns>Hash code</returns>
            public override int GetHashCode()
            {
                unchecked // Overflow is fine, just wrap
                {
                    int hashCode = base.GetHashCode();
                    return hashCode;
                }
            }

            /// <summary>
            /// To validate all properties of the instance
            /// </summary>
            /// <param name="validationContext">Validation context</param>
            /// <returns>Validation Result</returns>
            IEnumerable<System.ComponentModel.DataAnnotations.ValidationResult> IValidatableObject.Validate(ValidationContext validationContext)
            {
                yield break;
            }
        }
    }

[abuzuhri]

Is this exist in the model and I miss it ?

[TechyChap]

I copied it from the response. https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI/AmazonSpApiSDK/Models/ListingsItems/ItemAttributes.cs

[abuzuhri]

This file generated from model , and the strange this filed not exist in model , I will take look again to model

[abuzuhri]

I see you close the bug now ? its work ?

[abuzuhri]

Hello @TechyChap

Now API support ProductType

[TechyChap]

I spotted that and download this morning. Many thanks. Hope to use it this week.

[abuzuhri]

Please let me know if any things else needed