{"id":13748844,"url":"https://github.com/abuzuhri/Amazon-SP-API-CSharp","last_synced_at":"2025-05-09T11:31:35.986Z","repository":{"id":37924550,"uuid":"400249201","full_name":"abuzuhri/Amazon-SP-API-CSharp","owner":"abuzuhri","description":".Net C# library for the new Amazon Selling Partner API","archived":false,"fork":false,"pushed_at":"2025-04-22T16:55:07.000Z","size":17407,"stargazers_count":229,"open_issues_count":90,"forks_count":205,"subscribers_count":24,"default_branch":"main","last_synced_at":"2025-04-22T16:58:10.763Z","etag":null,"topics":["amazon","amazon-sp-api","amazon-spapi-sp-api","amazon-web-services","csharp","mws-api","mws-mws-sdk","selling-partner-api","selling-partner-api-sdk"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abuzuhri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-26T17:16:56.000Z","updated_at":"2025-04-22T16:55:00.000Z","dependencies_parsed_at":"2022-07-12T17:03:29.071Z","dependency_job_id":"9fd6541e-c263-410e-b4b8-ecac44c47a37","html_url":"https://github.com/abuzuhri/Amazon-SP-API-CSharp","commit_stats":{"total_commits":658,"total_committers":53,"mean_commits":"12.415094339622641","dds":"0.41033434650455924","last_synced_commit":"c08414967de50f2ad6cbfdde34e25d0f9ac5c152"},"previous_names":[],"tags_count":168,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abuzuhri%2FAmazon-SP-API-CSharp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abuzuhri%2FAmazon-SP-API-CSharp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abuzuhri%2FAmazon-SP-API-CSharp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abuzuhri%2FAmazon-SP-API-CSharp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abuzuhri","download_url":"https://codeload.github.com/abuzuhri/Amazon-SP-API-CSharp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253240350,"owners_count":21876593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon","amazon-sp-api","amazon-spapi-sp-api","amazon-web-services","csharp","mws-api","mws-mws-sdk","selling-partner-api","selling-partner-api-sdk"],"created_at":"2024-08-03T07:00:50.762Z","updated_at":"2025-05-09T11:31:30.966Z","avatar_url":"https://github.com/abuzuhri.png","language":"C#","readme":"# ☕Amazon Selling Partner API C# 🚀 [![.NET](https://github.com/abuzuhri/Amazon-SP-API-CSharp/actions/workflows/dotnet.yml/badge.svg)](https://github.com/abuzuhri/Amazon-SP-API-CSharp/actions/workflows/dotnet.yml) [![NuGet](https://img.shields.io/nuget/v/CSharpAmazonSpAPI.svg)](https://www.nuget.org/packages/CSharpAmazonSpAPI/) [![Gitter Chat](https://badges.gitter.im/bitwarden/Lobby.svg)](https://gitter.im/Amazon-SP-API-CSharp/community)\n\n\nThis is an API Binding in .Net C# for the new Amazon Selling Partner API.\n\nThis library is based on the output of [swagger-codegen](https://app.swaggerhub.com/home) with the [OpenAPI files provided by Amazon (Models)](https://github.com/amzn/selling-partner-api-models/tree/main/models) and has been modified by the contributors.\n\nThe purpose of this package is to have an easy way of getting started with the Amazon Selling Partner API using C#, you can watch this 📷 [Youtube](https://www.youtube.com/watch?v=1gZJBCoMr70) 📣 video for easy start your project\n\n---\n### Requirements\n- [AWSSDK.SecurityToken](https://www.nuget.org/packages/AWSSDK.SecurityToken/)\n- [AWSSDK.SQS](https://www.nuget.org/packages/AWSSDK.SQS/)\n- [Microsoft.CSharp](https://www.nuget.org/packages/Microsoft.CSharp/)\n- [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json/)\n- [RestSharp](https://www.nuget.org/packages/RestSharp/)\n- [System.ComponentModel.Annotations](https://www.nuget.org/packages/System.ComponentModel.Annotations/)\n- [System.Reflection](https://www.nuget.org/packages/System.Reflection/)\n\n\n---\n## Installation [![NuGet](https://img.shields.io/nuget/v/CSharpAmazonSpAPI.svg)](https://www.nuget.org/packages/CSharpAmazonSpAPI/)\n\n```powershell\nInstall-Package CSharpAmazonSpAPI\n```\n\n---\n### Tasks\n#### Seller\n\n- [x] [OrdersV0](https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-reference)\n- [x] [Reports](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference)\n- [x] [FinancesV0](https://developer-docs.amazon.com/sp-api/docs/finances-api-reference)\n- [x] [Feeds](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference) [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide) [feedType](https://developer-docs.amazon.com/sp-api/docs/feed-type-values)\n- [x] [ListingsItems](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide)\n- [x] [Restrictions](https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-use-case-guide)\n- [x] [ProductTypes](https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api-v2020-09-01-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/product-type-api-use-case-guide)\n- [x] [Uploads](https://developer-docs.amazon.com/sp-api/docs/uploads-api-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/uploads-api-use-case-guide)\n- [x] [shipmentInvoicingV0](https://developer-docs.amazon.com/sp-api/docs/shipment-invoicing-api-v0-reference)\n- [x] [Shippings](https://developer-docs.amazon.com/sp-api/docs/shipping-api-v1-reference)\n- [x] [CatalogItemsV0](https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v0-reference)\n- [x] [CatalogItemsV20220401](https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-reference)\n- [x] [FBAInventory](https://developer-docs.amazon.com/sp-api/docs/fbainventory-api-v1-reference)\n- [x] [FBASmallAndLight](https://developer-docs.amazon.com/sp-api/docs/fbasmallandlight-api-v1-reference)\n- [x] [FBAInboundEligibility](https://developer-docs.amazon.com/sp-api/docs/fbainboundeligibility-api-v1-reference)\n- [x] [FulFillmentInbound](https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-api-v0-reference)\n- [x] [FulFillmentOutbound](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-reference)\n- [x] [MerchantFulFillment](https://developer-docs.amazon.com/sp-api/docs/merchant-fulfillment-api-v0-reference)\n- [x] [Messaging](https://developer-docs.amazon.com/sp-api/docs/messaging-api-v1-reference)\n- [x] [Notifications](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide)\n- [x] [ProductFeesV0](https://developer-docs.amazon.com/sp-api/docs/product-fees-api-v0-reference)\n- [x] [ProductPricingV0](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v0-reference)\n- [x] [Sales](https://developer-docs.amazon.com/sp-api/docs/sales-api-v1-reference)\n- [x] [Sellers](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference)\n- [ ] [Services](https://developer-docs.amazon.com/sp-api/docs/services-api-v1-reference)\n- [x] [Solicitations](https://developer-docs.amazon.com/sp-api/docs/solicitations-api-v1-reference)\n- [x] [Token](https://developer-docs.amazon.com/sp-api/docs/tokens-api-v2021-03-01-reference)  [Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/tokens-api-use-case-guide)\n- [x] [Authorization](https://developer-docs.amazon.com/sp-api/docs/authorization-api-v1-reference)\n- [x] [Easy Ship](https://developer-docs.amazon.com/sp-api/docs/easy-ship-api-v2022-03-23-reference)\n- [ ] [A+ Content](https://developer-docs.amazon.com/sp-api/docs/selling-partner-api-for-a-content-management)\n- [ ] [Replenishment](https://developer-docs.amazon.com/sp-api/docs/replenishment-api-v2022-11-07-reference)\n\n\n#### Vendor \n\n- [ ] [VendorDirectFulfillmentInventoryV1](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-inventory-api-v1-reference)\n- [x] [VendorDirectFulfillmentOrdersV1](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-orders-api-v1-reference)\n- [ ] [VendorDirectFulfillmentPaymentsV1](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-payments-api-v1-reference)\n- [ ] [VendorDirectFulfillmentShippingV1](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-shipping-api-v1-reference)\n- [ ] [VendorDirectFulfillmentTransactionsV1](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-transactions-api-v1-reference)\n- [x] [VendorOrders](https://developer-docs.amazon.com/sp-api/docs/vendor-orders-api-v1-reference)\n- [ ] [vendorInvoices](https://developer-docs.amazon.com/sp-api/docs/vendor-invoices-api-v1-reference)\n- [ ] [VendorShipments](https://developer-docs.amazon.com/sp-api/docs/vendor-shipments-api-v1-reference)\n- [ ] [VendorTransactionStatus](https://developer-docs.amazon.com/sp-api/docs/vendor-transaction-status-api-v1-reference)\n\n\n\n---\n## Keys\nTo get all keys needed you need to follow this step [Creating and configuring IAM policies and entities](https://developer-docs.amazon.com/sp-api/docs/creating-and-configuring-iam-policies-and-entities) and then you need to [Registering your Application](https://developer-docs.amazon.com/sp-api/docs/registering-your-application) then [Authorizing Selling Partner API applications\n](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications#step-1-request-a-login-with-amazon-access-token)\n\n\n| Name | Description |\n| --- | --- |\n| Marketplace | Marketplace region [List of Marketplaces](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)|\n| ClientId | Your amazon app id |\n| ClientSecret | Your amazon app secret |\n| RefreshToken | Check how to get [RefreshToken](https://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/developer-guide/SellingPartnerApiDeveloperGuide.md#Self-authorization) |\n\n\nFor more information about keys please check [New Amazon doc for create keys Developer ](https://developer-docs.amazon.com/sp-api/docs/creating-and-configuring-iam-policies-and-entities) , If you are not registered as developer please [Register](https://developer.amazonservices.com/) to be able to create application. \n\n---\n## Usage\n\n\u003e ### Please be aware there has been a change to the _Orders.GetOrderAddress()_ method please reference the new sample code for more details.\n\n### Configuration\nYou can configure a connection like so please see [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/Program.cs) for the relevant code file.\n```CSharp\nAmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()\n{\n     ClientId = \"amzn1.application-XXX-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     ClientSecret = \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     RefreshToken= \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     MarketPlace = MarketPlace.UnitedArabEmirates, //MarketPlace.GetMarketPlaceByID(\"A2VIGQ35RCS4UG\") \n});\n\nor \n\nAmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()\n{\n     ClientId = \"amzn1.application-XXX-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     ClientSecret = \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     RefreshToken= \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     MarketPlaceID = \"A2VIGQ35RCS4UG\"\n});\n\n```\n\n### Configuration using a proxy\nPlease see [here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/Program.cs) for the relevant code file.\n\u003e```csharp\n\u003eAmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()\n\u003e{\n\u003e     ClientId = \"amzn1.application-XXX-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n\u003e     ClientSecret = \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n\u003e     RefreshToken= \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n\u003e     MarketPlaceID = \"A2VIGQ35RCS4UG\",\n\u003e     ProxyAddress = \"http(s)://xxx.xxx.xxx.xxx:xxxx\",\n\u003e});\n\u003e```\n\u003e\u003e * Assign your proxy address to the ProxyAddress Property and you'll be able to use a proxy account. \n\u003e\u003e\n\u003e\u003e ***This is not required and will operate normally without the ProxyAddress being set.***\n\n### Order List, For more orders sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/ReportsSample.cs).\n```CSharp\nParameterOrderList serachOrderList = new ParameterOrderList();\nserachOrderList.CreatedAfter = DateTime.UtcNow.AddMinutes(-600000);\nserachOrderList.OrderStatuses = new List\u003cOrderStatuses\u003e();\nserachOrderList.OrderStatuses.Add(OrderStatuses.Canceled);\nvar orders = amazonConnection.Orders.GetOrders(serachOrderList);\n\n```\n\n\n### Order List with parameter\n```CSharp\nParameterOrderList serachOrderList = new ParameterOrderList();\nserachOrderList.CreatedAfter = DateTime.UtcNow.AddHours(-24);\nserachOrderList.OrderStatuses = new List\u003cOrderStatuses\u003e();\nserachOrderList.OrderStatuses.Add(OrderStatuses.Unshipped);\nserachOrderList.MarketplaceIds = new List\u003cstring\u003e { MarketPlace.UnitedArabEmirates.ID };\n\nvar orders = amazonConnection.Orders.GetOrders(serachOrderList);\n\n```\n\n\n### Order List with parameter including PII data Simple\n```CSharp\nvar parameterOrderList = new ParameterOrderList\n        {\n            CreatedAfter = DateTime.UtcNow.AddHours(-24),\n            OrderStatuses = new List\u003cOrderStatuses\u003e { OrderStatuses.Unshipped },\n            MarketplaceIds = new List\u003cstring\u003e { MarketPlace.UnitedArabEmirates.ID },\n            IsNeedRestrictedDataToken = true\n        };\n\nvar orders = _amazonConnection.Orders.GetOrders(parameterOrderList);\n\n```\n\n### Order List with parameter including PII data Advance (if you want to get specific data Elements object only)\n```CSharp\nvar parameterOrderList = new ParameterOrderList\n        {\n            CreatedAfter = DateTime.UtcNow.AddHours(-24),\n            OrderStatuses = new List\u003cOrderStatuses\u003e { OrderStatuses.Unshipped },\n            MarketplaceIds = new List\u003cstring\u003e { MarketPlace.UnitedArabEmirates.ID },\n            IsNeedRestrictedDataToken = true,\n            RestrictedDataTokenRequest = new CreateRestrictedDataTokenRequest\n            {\n                restrictedResources = new List\u003cRestrictedResource\u003e\n                {\n                    new RestrictedResource\n                    {\n                        method = Method.GET.ToString(),\n                        path = ApiUrls.OrdersApiUrls.Orders,\n                        dataElements = new List\u003cstring\u003e { \"buyerInfo\", \"shippingAddress\" }\n                    }\n                }\n            }\n        };\n\nvar orders = _amazonConnection.Orders.GetOrders(parameterOrderList);\n\n```\n\n### Order List data from Sandbox\n```CSharp\nAmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()\n{\n     ClientId = \"amzn1.application-XXX-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     ClientSecret = \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     RefreshToken= \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n     Environment=Environments.Sandbox\n});\n\nvar orders = amazonConnection.Orders.GetOrders\n(\n     new FikaAmazonAPI.Parameter.Order.ParameterOrderList\n     {\n         TestCase = Constants.TestCase200\n     }\n);\n```\n\n### Report List, For more report sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/OrdersSample.cs).\n```CSharp\nvar parameters = new ParameterReportList();\nparameters.pageSize = 100;\nparameters.reportTypes = new List\u003cReportTypes\u003e();\nparameters.reportTypes.Add(ReportTypes.GET_AFN_INVENTORY_DATA);\nparameters.marketplaceIds = new List\u003cstring\u003e();\nparameters.marketplaceIds.Add(MarketPlace.UnitedArabEmirates.ID);\nvar reports=amazonConnection.Reports.GetReports(parameters);\n```\n\n### Custom Report\n```CSharp\nvar parameters = new ParameterCreateReportSpecification();\nparameters.reportType = ReportTypes.GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_GENERAL;\nparameters.dataStartTime = DateTime.UtcNow.AddDays(-30);\nparameters.dataEndTime = DateTime.UtcNow.AddDays(-10);\nparameters.marketplaceIds = new MarketplaceIds();\nparameters.marketplaceIds.Add(MarketPlace.UnitedArabEmirates.ID);\nparameters.reportOptions = new AmazonSpApiSDK.Models.Reports.ReportOptions();\n\nvar report= amazonConnection.Reports.CreateReport(parameters);\n```\n\n### Get Report with PII\n\n```Csharp\n\n//use this method automatically know if the report are RDT or not\nvar data2 = amazonConnection.Reports.CreateReportAndDownloadFile(ReportTypes.GET_EASYSHIP_DOCUMENTS, startDate, null, null);\n\n// OR USE this method to get the document and pass parameter isRestrictedReport = true in case the report will return  PII data\n\nvar data = amazonConnection.Reports.GetReportDocument(\"50039018869997\",true);\n```\n\n\n### Report Manager 🚀🧑‍🚀✨\nEasy way to get the report you need and convert the file return from amazon to class or list, this feature only ready for some reports as its will take much times to finish for  [All report type](https://github.com/amzn/selling-partner-api-docs/blob/main/references/reports-api/reporttype-values.md)  .... \n```CSharp\nReportManager reportManager = new ReportManager(amazonConnection);\nvar products = reportManager.GetProducts(); //GET_MERCHANT_LISTINGS_ALL_DATA\nvar inventoryAging = reportManager.GetInventoryAging(); //GET_FBA_INVENTORY_AGED_DATA\nvar ordersByDate = reportManager.GetOrdersByOrderDate(90); //GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL\nvar ordersByLastUpdate = reportManager.GetOrdersByLastUpdate(90); //GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_GENERAL\nvar settlementOrder = reportManager.GetSettlementOrder(90); //GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2\nvar returnMFNOrder = reportManager.GetReturnMFNOrder(90); //GET_FLAT_FILE_RETURNS_DATA_BY_RETURN_DATE\nvar returnFBAOrder = reportManager.GetReturnFBAOrder(90); //GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA\nvar reimbursementsOrder = reportManager.GetReimbursementsOrder(180); //GET_FBA_REIMBURSEMENTS_DATA\nvar feedbacks = reportManager.GetFeedbackFromDays(180); //GET_SELLER_FEEDBACK_DATA\nvar LedgerDetails = reportManager.GetLedgerDetailAsync(10); //GET_LEDGER_DETAIL_VIEW_DATA\nvar UnsuppressedInventory = reportManager.GetUnsuppressedInventoryDataAsync().ConfigureAwait(false).GetAwaiter().GetResult(); //GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA\n```\n\n\n### Report GET_MERCHANT_LISTINGS_ALL_DATA sample\n```CSharp\nvar parameters = new ParameterCreateReportSpecification();\nparameters.reportType = ReportTypes.GET_MERCHANT_LISTINGS_ALL_DATA;\n\nparameters.marketplaceIds = new MarketplaceIds();\nparameters.marketplaceIds.Add(MarketPlace.UnitedArabEmirates.ID);\n\nparameters.reportOptions = new FikaAmazonAPI.AmazonSpApiSDK.Models.Reports.ReportOptions();\n\nvar reportId = amazonConnection.Reports.CreateReport(parameters);\nvar filePath = string.Empty;\nstring ReportDocumentId = string.Empty;\n\nwhile (string.IsNullOrEmpty(ReportDocumentId))\n{\n    Thread.Sleep(1000 * 60);\n    var reportData = amazonConnection.Reports.GetReport(reportId);\n    if (!string.IsNullOrEmpty(reportData.ReportDocumentId))\n    {\n        filePath = amazonConnection.Reports.GetReportFile(reportData.ReportDocumentId);\n        break;\n    }\n}\n\n//filePath for report\n```\n\n### Product GetCatalogItem Version 2022-04-01\n```CSharp\nvar data = await amazonConnection.CatalogItem.GetCatalogItem202204Async(\n    new Parameter.CatalogItems.ParameterGetCatalogItem\n            {\n                ASIN = \"B00JK2YANC\",\n                includedData = new[] { IncludedData.attributes, \n                                       IncludedData.salesRanks,\n                                       IncludedData.summaries, \n                                       IncludedData.productTypes, \n                                       IncludedData.relationships, \n                                       IncludedData.dimensions, \n                                       IncludedData.identifiers, \n                                       IncludedData.images }\n            });\n```\n\n### Product SearchCatalogItems Version 2022-04-01\n```CSharp\nvar data = await amazonConnection.CatalogItem.SearchCatalogItems202204Async(\n    new Parameter.CatalogItems.ParameterSearchCatalogItems202204\n            {\n                keywords = new[] { \"vitamin c\" },\n                includedData = new[] { IncludedData.attributes, \n                                       IncludedData.salesRanks,\n                                       IncludedData.summaries, \n                                       IncludedData.productTypes, \n                                       IncludedData.relationships, \n                                       IncludedData.dimensions, \n                                       IncludedData.identifiers, \n                                       IncludedData.images }\n            });\n```\n\n\n\n### Product Pricing, For more Pricing sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/ProductPricingSample.cs).\n```CSharp\n\nvar data = amazonConnection.ProductPricing.GetPricing(\n    new Parameter.ProductPricing.ParameterGetPricing()\n    {\n        MarketplaceId = MarketPlace.UnitedArabEmirates.ID,\n        Asins = new string[] { \"B00CZC5F0G\" }\n    });\n\n```\n\n### Product Competitive Price\n```CSharp\n\nvar data = amazonConnection.ProductPricing.GetCompetitivePricing(\n    new Parameter.ProductPricing.ParameterGetCompetitivePricing()\n    {\n        MarketplaceId = MarketPlace.UnitedArabEmirates.ID,\n        Asins = new string[] { \"B00CZC5F0G\" },\n    });\n```\n\n### GetFeaturedOfferExpectedPriceBatch\n```CSharp\n\n var priceDemo = new ProductPricingSample(amazonConnection);\n await priceDemo.GetFeaturedOfferExpectedPriceBatch();\n```\n\n\n### Notifications Create Destination, For more Notifications sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/NotificationsSample.cs).\n```CSharp\n\n//EventBridge\nvar data = amazonConnection.Notification.CreateDestination(\n    new Notifications.CreateDestinationRequest()\n    {\n        Name = \"CompanyName\",\n        ResourceSpecification = new Notifications.DestinationResourceSpecification()\n        {\n            EventBridge = new Notifications.EventBridgeResourceSpecification(\"us-east-2\", \"999999999\")\n        }\n    });\n\n//SQS\nvar dataSqs = amazonConnection.Notification.CreateDestination(\n    new Notifications.CreateDestinationRequest()\n    {\n        Name = \"CompanyName_AE\",\n        ResourceSpecification = new Notifications.DestinationResourceSpecification\n        {\n            Sqs = new Notifications.SqsResource(\"arn:aws:sqs:us-east-2:9999999999999:NAME\")\n        }\n    });\n```\n\n### Notifications Create Subscription, For more Notifications sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/NotificationsSample.cs).\n```CSharp\n\n//SQS\nvar result = amazonConnection.Notification.CreateSubscription(\n    new ParameterCreateSubscription()\n    {\n        destinationId = \"xxxxxxxxxxxxxxx\", // take this from CreateDestination or GetDestinations response \n        notificationType = NotificationType.ANY_OFFER_CHANGED, // or B2B_ANY_OFFER_CHANGED for B2B prices\n        payloadVersion = \"1.0\"\n    });\n```\n\n### Notifications read messages\n```CSharp\n\nvar SQS_URL = \"https://sqs.us-east-2.amazonaws.com/9999999999999/IUSER_SQS\";\nParameterMessageReceiver param = new ParameterMessageReceiver(\n                    Environment.GetEnvironmentVariable(\"AccessKey\"), \n                    Environment.GetEnvironmentVariable(\"SecretKey\"), \n                    SQS_URL, Amazon.RegionEndpoint.USEast2);\n\nCustomMessageReceiver messageReceiver = new CustomMessageReceiver();\n\n\namazonConnection.Notification.StartReceivingNotificationMessages(param, messageReceiver);\npublic class CustomMessageReceiver : IMessageReceiver\n{\n     public void ErrorCatch(Exception ex)\n     {\n         //Your code here\n     }\n\n     public void NewMessageRevicedTriger(NotificationMessageResponce message)\n     {\n         //Your Code here\n     }\n}\n\n```\n\n### Feed Submit\nHere full sample for submit feed to change price and generate XML and get final report for result same as in [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).\nNotes: not all [feed type](https://github.com/amzn/selling-partner-api-docs/blob/main/references/feeds-api/feedtype-values.md) finished as it's big work and effort but all classes are partial for easy change and you can generate XML outside and use our library to get data, now we support only submit existing product, change quantity and change price , I list most of XSD here Source\\FikaAmazonAPI\\ConstructFeed\\xsd its will help you easy generate class and add it in your app to generate final feed xml.\n\n#### Feed Submit for change price , For more Feed sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/FeedsSample.cs).\n```CSharp\nConstructFeedService createDocument = new ConstructFeedService(\"{SellerID}\", \"1.02\");\n\nvar list = new List\u003cPriceMessage\u003e();\nlist.Add(new PriceMessage()\n{\n    SKU = \"8201031206122...\",\n    StandardPrice = new StandardPrice()\n    {\n        currency = amazonConnection.GetCurrentMarketplace.CurrencyCode.ToString(),\n        Value = (201.0522M).ToString(\"0.00\")\n    }\n});\ncreateDocument.AddPriceMessage(list);\n\nvar xml = createDocument.GetXML();\n\nvar feedID = amazonConnection.Feed.SubmitFeed(xml, FeedType.POST_PRODUCT_PRICING_DATA);\n\nThread.Sleep(1000*30);\n\nvar feedOutput=amazonConnection.Feed.GetFeed(feedID);\n\nvar outPut=amazonConnection.Feed.GetFeedDocument(feedOutput.ResultFeedDocumentId);\n\nvar reportOutpit = outPut.Url;\n\nvar processingReport = amazonConnection.Feed.GetFeedDocumentProcessingReport(outPut.Url);\n\n```\n\n\n#### Feed Submit for change Quantity\n```CSharp\nConstructFeedService createDocument = new ConstructFeedService(\"{SellerID}\", \"1.02\");\n\nvar list = new List\u003cInventoryMessage\u003e();\nlist.Add(new InventoryMessage()\n  {\n    SKU = \"82010312061.22...\",\n    Quantity = 2,\n    FulfillmentLatency = \"11\",\n });\n\ncreateDocument.AddInventoryMessage(list);\n\nvar xml = createDocument.GetXML();\n\nvar feedID = amazonConnection.Feed.SubmitFeed(xml, FeedType.POST_INVENTORY_AVAILABILITY_DATA);\n\nThread.Sleep(1000*30);\n\nvar feedOutput=amazonConnection.Feed.GetFeed(feedID);\n\nvar outPut=amazonConnection.Feed.GetFeedDocument(feedOutput.ResultFeedDocumentId);\n\nvar reportOutpit = outPut.Url;\n\nvar processingReport = amazonConnection.Feed.GetFeedDocumentProcessingReport(outPut.Url);\n\n```\n\n#### Feed Submit for change ProdcutImage\n```CSharp\npublic void SubmitFeedProductImage()\n{\n    ConstructFeedService createDocument = new ConstructFeedService(\"A3J37AJU4O9RHK\", \"1.02\");\n    var list = new List\u003cProductImageMessage\u003e();\n    list.Add(new ProductImageMessage()\n    {\n\tSKU = \"8201031206122...\",\n\tImageLocation = \"http://xxxx.com/1.jpeg\",\n\tImageType = ImageType.Main\n    }) ;\n    createDocument.AddProductImageMessage(list);\n    var xml = createDocument.GetXML();\n\n    var feedID = amazonConnection.Feed.SubmitFeed(xml, FeedType.POST_PRODUCT_IMAGE_DATA);\n\n}\n```\n\n#### Feed Submit for change FULFILLMENT DATA (add tracking number for shipment)\n```CSharp\n\nConstructFeedService createDocument = new ConstructFeedService(\"{sellerId}\", \"1.02\");\n\nvar list = new List\u003cOrderFulfillmentMessage\u003e();\nlist.Add(new OrderFulfillmentMessage()\n    {\n       AmazonOrderID = \"{orderId}\",\n       FulfillmentDate = DateTime.Now.ToString(\"yyyy-MM-dd'T'HH:mm:ss.fffK\"),\n       FulfillmentData = new FulfillmentData()\n          {\n              CarrierName = \"Correos Express\",\n              ShippingMethod = \"ePaq\",\n              ShipperTrackingNumber = \"{trackingNumber}\"\n           }\n    });\n    createDocument.AddOrderFulfillmentMessage(list);\n\n    var xml = createDocument.GetXML();\n\n    var feedID = amazonConnection.Feed.SubmitFeed(xml, FeedType.POST_ORDER_FULFILLMENT_DATA);\n\n```\n\n\n#### Feed Submit for change Order Adjustments\n```CSharp\npublic void SubmitFeedOrderAdjustment()\n{\n            ConstructFeedService createDocument = new ConstructFeedService(\"A3J37AJU4O9RHK\", \"1.02\");\n            var list = new List\u003cOrderAdjustmentMessage\u003e();\n            list.Add(new OrderAdjustmentMessage()\n            {\n                AmazonOrderID = \"AMZ1234567890123\",\n                ActionType = AdjustmentActionType.Refund,\n                AdjustedItem = new List\u003cAdjustedItem\u003e() {\n                   new AdjustedItem() {\n                       AmazonOrderItemCode = \"52986411826454\",\n                       AdjustmentReason = AdjustmentReason.CustomerCancel,\n                       DirectPaymentAdjustments = new List\u003cDirectPaymentAdjustments\u003e()\n                           {\n                               new DirectPaymentAdjustments()\n                               {\n                                   Component = new List\u003cDirectPaymentAdjustmentsComponent\u003e()\n                                   {\n                                       new DirectPaymentAdjustmentsComponent() {\n                                            DirectPaymentType = \"Credit Card Refund\",\n                                            Amount = new CurrencyAmount() {\n                                                Value = 10.50M,\n                                                currency = amazonConnection.GetCurrentMarketplace.CurrencyCode\n                                            }\n                                       }\n                                   }\n                               }\n                           }\n                       }\n                }\n            });\n            createDocument.AddOrderAdjustmentMessage(list);\n            var xml = createDocument.GetXML();\n\n            var feedID = amazonConnection.Feed.SubmitFeed(xml, FeedType.POST_PAYMENT_ADJUSTMENT_DATA);\n}\n```\n \n---\n## Usage Plans and Rate Limits in the Selling Partner API\n\nPlease read this doc to get all information about this limitation\nhttps://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/usage-plans-rate-limits/Usage-Plans-and-Rate-Limits.md\n\nwe calc waiting time by read x-amzn-RateLimit-Limit header \n\n`int sleepTime = (int)((1 / header[\"x-amzn-RateLimit-Limit\"] ) * 1000);`\n\nYou can also disable libary from handelling limitaion by set IsActiveLimitRate=false in AmazonCredential\n```CSharp\nvar amazonConnection = new AmazonConnection(new AmazonCredential()\n{\n      .\n      .\n      IsActiveLimitRate=false\n});\n```\n\n---\n\n## Enable debug mode\nYou can also enable log for all http request and response you can set IsDebugMode=true in AmazonCredential\n```CSharp\nvar amazonConnection = new AmazonConnection(new AmazonCredential()\n{\n      .\n      .\n      IsDebugMode = true\n});\n```\n\n---\n\n## Get restrictions before try to add new lists\n\n```CSharp\nvar result = amazonConnection.Restrictions.GetListingsRestrictions(\n    new Parameter.Restrictions.ParameterGetListingsRestrictions\n            {\n                asin = \"AAAAAAAAAA\",\n                sellerId = \"AXXXXXXXXXXXX\"\n            });\n```\n---\n## Create shipment operation from MerchantFulfillment\n\n```CSharp\nShipmentRequestDetails shipmentRequestDetails = new ShipmentRequestDetails()\n{\n    AmazonOrderId = \"999-9999-999999\",\n    ItemList = new ItemList()\n    {\n        new FikaAmazonAPI.AmazonSpApiSDK.Models.MerchantFulfillment.Item()\n        {\n\t\tOrderItemId = \"52986411826454\",\n            Quantity = 1\n        }\n\n    },\n    ShipFromAddress = new Address()\n    {\n        AddressLine1 = \"300 St\",\n        City = \"City\",\n        PostalCode = \"48123\",\n        Email = \"[mail@yahoo.com](mailto:mail@yahoo.com)\",\n        Phone = \"999999999\",\n        StateOrProvinceCode = \"MI\",\n        CountryCode = \"US\",\n        Name = \"FirstName LastName\"\n    },\n    PackageDimensions = new PackageDimensions()\n    {\n        Height = 10,\n        Width = 10,\n        Length = 10,\n        Unit = UnitOfLength.Inches\n    },\n    Weight = new Weight()\n    {\n        Value = 10,\n        Unit = UnitOfWeight.Oz\n    },\n    ShippingServiceOptions = new ShippingServiceOptions()\n    {\n        DeliveryExperience = DeliveryExperienceType.NoTracking,\n        CarrierWillPickUp = false,\n        CarrierWillPickUpOption = CarrierWillPickUpOption.ShipperWillDropOff\n    }\n};\n\nvar shipmentRequest = new CreateShipmentRequest(\n\t\t\tshipmentRequestDetails, \n\t\t\tshippingServiceId: \"UPS_PTP_2ND_DAY_AIR\", \n\t\t\tshippingServiceOfferId: \"WHgxtyn6qjGGaC\");\n\n var shipmentResponse = amazonConnection.MerchantFulfillment.CreateShipment(shipmentRequest);\n```\n\n## ProductTypes SearchDefinitions\n\n```CSharp\nvar list = amazonConnection.ProductType.SearchDefinitionsProductTypes(\n  new Parameter.ProductTypes.SearchDefinitionsProductTypesParameter()\n   {\n    keywords = new List\u003cstring\u003e { String.Empty },\n   });\n```\n\n## ProductTypes GetDefinitions\n\n```CSharp\nvar def = amazonConnection.ProductType.GetDefinitionsProductType(\n   new Parameter.ProductTypes.GetDefinitionsProductTypeParameter()\n    {\n     productType = \"PRODUCT\",\n     requirements = RequirementsEnum.LISTING,\n     locale = AmazonSpApiSDK.Models.ProductTypes.LocaleEnum.en_US\n     });\n```\n\n---\n## Sales Performance Sample\n\n```CSharp\n     DateTime queryStart = DateTime.UtcNow.AddDays(-11).Date;\n     DateTime queryEnd = DateTime.UtcNow;\n     var parameters = new ParameterGetOrderMetrics();\n     parameters.marketplaceIds = new MarketplaceIds();\n     parameters.marketplaceIds.Add(MarketPlace.UnitedArabEmirates.ID);\n     parameters.interval = queryStart.ToString(\"yyyy-MM-ddTHH:mm:ss\", CultureInfo.InvariantCulture) + \"Z--\" + queryEnd.ToString(\"yyyy-MM-ddTHH:mm:ss\", CultureInfo.InvariantCulture) + \"Z\";\n     parameters.granularity = Constants.GranularityEnum.Day;\n     parameters.firstDayOfWeek = Constants.FirstDayOfWeek.monday;\n\n     var sales = amazonConnection.Sales.GetOrderMetrics(parameters);\n```\n---\n## Q \u0026 A\n\nIf you have questions, please ask in GitHub discussions \n\n[![discussions](https://img.shields.io/badge/github-discussions-brightgreen?style=for-the-badge\u0026logo=github)](https://github.com/abuzuhri/Amazon-SP-API-CSharp/discussions)\n\n---\n## ToDo\n\n- Improve documentation\n\n---\n### Useful links\n##### [Selling Partner API](https://developer-docs.amazon.com/sp-api)\n##### [Amazon MWS to SP-API Migration Guide](https://developer-docs.amazon.com/sp-api/docs/amazon-mws-to-sp-api-migration-guide#mapping-apis-from-amazon-mws-to-the-selling-partner-api)\n##### [SP-API models](https://developer-docs.amazon.com/sp-api/page/sp-api-models)\n##### [Using Postman for Selling Partner API models](https://developer-docs.amazon.com/sp-api/page/sp-api-models)\n##### [Test Project with pure C# code](https://github.com/abuzuhri/Amazon-SP-API-CSharp/tree/main/Others/PureCodeSampleForTest)\n##### [Sample Code](https://github.com/abuzuhri/Amazon-SP-API-CSharp/tree/main/Source/FikaAmazonAPI.SampleCode)\n##### [Creating And Configuring AWS](https://developer-docs.amazon.com/sp-api/docs/creating-and-configuring-iam-policies-and-entities)\n\n---\n## Contributing\n\n1. Fork it (https://github.com/abuzuhri/Amazon-SP-API-CSharp/fork)\n2. Clone it (`git clone https://github.com/{YOUR_USERNAME}/Amazon-SP-API-CSharp`)\n3. Create your feature branch (`git checkout -b your_branch_name`)\n4. Commit your changes (`git commit -m 'Description of a commit'`)\n5. Push to the branch (`git push origin your_branch_name`)\n6. Create a new Pull Request\n\n---\n## Notes\n\nIf you are looking for a complete Feedback solution, you might want to consider giving [Soon.se](https://www.soon.se) a shot.\n\n---\n## Support \u0026 Consultation\n\nWe offer consultation on everything SP-API related. Book your meeting here:\n\n[![Book Meeting](https://img.shields.io/badge/meeting-book%20now-blue?style=for-the-badge)](https://calendly.com/tareq-abuzuhri/)\n\n---\n## Thanks\n\nThanks go out to everybody who worked on this package.\n\n","funding_links":[],"categories":["Docs"],"sub_categories":["Library"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabuzuhri%2FAmazon-SP-API-CSharp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabuzuhri%2FAmazon-SP-API-CSharp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabuzuhri%2FAmazon-SP-API-CSharp/lists"}