Skip to content
This repository has been archived by the owner on Aug 14, 2020. It is now read-only.

walmartlabs/partnerapi_sdk_dotnet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


NOTICE:

This repository has been archived and is not supported.

No Maintenance Intended


Walmart Partner API SDK for .NET


The Walmart Partner API SDK for .NET allows you to build applications that easily integrates with the Walmart Marketplace API

This is a .NET SDK (written in C#) containing convenience libraries and examples of their usage for e-commerce merchants to conduct business on Walmart's marketplace platform.

Walmart's marketplace provides several secure HTTP REST end-points for merchants to submit their items for listing on Walmart's marketplace - Walmart.com. There are also secure HTTP REST end-points for updating prices and inventories, and retrieve order and update their status.

This .NET package demonstrates how to invoke the HTTP REST end-points using C#. It does not include examples in other programming languages such as Java, Perl, Python and PHP which also can be used to invoke the same HTTP REST end-points. The package consists of a zip file containing a .Net Standard 1.3 Library and .Net Core 2.0 (or .NET Framework v4.6) project.

In order to invoke secure HTTP REST end-points, your company must be a registered seller on Walmart.com marketplace. Registration will provide you with a consumer ID and a private key to make secure calls.

Or you can use the "mock" end-points to get an idea of how the real end-points work. This can help you to start and test your integration even before you complete your registration.

Target Frameworks

  • .NET Framework 4.6
  • .NET Standard 1.3

Sample Application

You can find documentation here.

Docker Image for Sample Application

This repository provides a Dockerfile to build an image for sample application. Before you start, make sure Docker is installed and running (instructions).

This project supply Dockerfile to build a Docker image with Sample application. To build it on your local machine run

docker build -t <image-name> .

The following command starts a container

docker run -it -v <folder-with-creds>:/app/settings <image-name>

Example:

Check out the source code of this repo in any folder, for example /Users/test/WalmartMarketplaceClient, then execute

cd /Users/test/WalmartMarketplaceClient/
docker build -t partnerapi-app .

You need to place your API creds as "credentials.json" file in the folder /Users/test/WalmartMarketplaceClient/settings. You can read more about this file here

Execute the following command to start Sample application

docker run -v $(pwd)/settings:/app/settings -it partnerapi-app 

Code Snippets

You can find list of examples here

Usage

Installation

This package is distributed as a source code, you need to manually build it and link library from your project. NuGet repository will be available soon, stay tuned!

Build

To build dotnet build Source/

To run tests:

Unit & Integration tests - scripts/run_mp_fast_tests.cmd

E2E tests - scripts/run_mp_e2e_tests.cmd

API Coverage

Object Operation V2/V3 SDK Class -> Method Tests V2/V3
Feeds Get all feed statuses Yes/Yes FeedEndpoint.GetAllFeedStatuses No / No
Get a feedItems status Yes/Yes FeedEndpoint.GetFeedStatus Yes/Yes
Get a feed status Yes/Yes FeedEndpoint.GetFeedStatus Yes/Yes
Items Get all items Yes/Yes ItemEndpoint.GetAllItems Yes/Yes
Get an item Yes/Yes ItemEndpoint.GetItem Yes/Yes
Retire an item Yes/Yes ItemEndpoint.RetireItem Yes/Yes
Bulk create/update items Yes/Yes ItemEndpoint.BulkItemsUpdate Yes/Yes
Prices Update a price Yes/Yes PriceEndpoint.UpdatePrice Yes/Yes
Update bulk prices Yes/Yes PriceEndpoint.UpdateBulkPrices Yes/Yes
Set up CPA SKU Opt-in/Opt-out NA/Yes PriceEndpoint.OptInOutBulkCpaSku NA/No
Set up CPA SKU All NA/Yes PriceEndpoint.SetupAllCpaSku NA/No
Promotions Update Bulk Promotional Prices Yes/Yes PromotionEndpoint.UpdatePromotionPricesInBulk Yes/Yes
Promotional Prices NA/Yes PromotionEndpoint.GetPromotionPrice NA/Yes
Update a Promotional Price NA/Yes Promotion.Endpoint.UpdatePromotionPrice NA/Yes
Orders Get all released orders Yes/Yes OrderEndpoint.GetAllReleasedOrders No / No
Get all orders Yes/Yes OrderEndpoint.GetAllOrders No/No
Get an order Yes/Yes OrderEndpoint.GetOrderById No/No
Acknowledge purchase order Yes/Yes OrderEndpoint.AckOrder No/No
Cancel order lines Yes/Yes OrderEndpoint.CancelOrderLines No/No
Refund order lines Yes/Yes OrderEndpoint.RefundOrderLines No/No
Shipping notification/updates Yes/Yes OrderEndpoint.ShippingUpdates No/No
Inventory Get inventory for an item Yes/NA Inventory.GetInventory Yes/NA
Update inventory for an item Yes/NA Inventory.UpdateInventory Yes/NA
Bulk update inventory Yes/Yes Inventory.UpdateBulkInventory Yes/Yes

Disclaimer

This software is distributed free of cost.

  • Walmart assumes no responsibility for its support
  • Copyright (c) 2018 Walmart Corporation