Etsy functional scope - IN PROGRESS

General overview of the marketplace

Fairly straightforward marketplace. Simple RESTful API with JSONs using OAuth authentication. Sync communication, providing the option for Creating / Updating Listings / Products, Stock & Price updates, Getting Sales, Updating Shipping, Cancelling Sales.

Flows to be used

• Update Listings • Update Offers (Stock & Price) • Deactivating Listings • Taxonomy | • | • |

Authentication - specifics

Etsy uses application key and secret to make different calls. For our purpose we will need to OAuth on every seller ID where we pass different scopes (parts of the API we want to use) to the given account which than leads to an agreement from the user for our Application. This will result in getting the needed token and access to perform the operations we need. The whole procedure can be fully automated following a "get token" button in the Hemisphere Accounts section

• Fill in client id
• Call Etsy with key, secret and client id. Provide all scopes needed
• Receive acceptance URL and redirect client to relevant page (providing a callback page as well)
• Receive the final bits of the information to call with and create the token

Product flows - specifics

Being a crafts marketplace makes Etsy "unique listings" site which makes it more similar to eBay. As of 2017 they have introduced a different way of managing products. If the new method is used this makes the listings incompatible with the old calls. We will use only the new methods in our application.

Specification on Etsy is that Taxonomy attributes still seem to not be fully required on listings. There are required fields of course but not connected with the taxonomy unless a "category" or "taxonomy" id is passed. We will require to have a category ID as this is to be enforced by Etsy in the next months/year. This means we will need to pull down the Taxonomy for all categories so we know what Attributes are available and what values are applicable

IMPORTANT: Etsy is charging by listing and by what it seems updates increasing quantity too. Every listing can be "active" up to 4 months at a time after which it needs to be renewed which will incur fees.

Danail Deltchev (Unlicensed) - TODO: Pinpoint exact methods for differences between Single and Variation Listing information exchange. Get a better understanding on Etsy Listing fees to scope the best methods of managing the Listings reducing fees as much as possible.

1. Product Creation -
   1. Single -
   2. Variation
2. Product update -
   1. Single -
   2. Variation
3. Stock updates -
4. Price updates -
5. Zero quantity updates -
6. Delist / Deactivate / End / Remove -
7. Any other -

Orders flows - specifics

1. Get orders -
2. Ship orders -
3. Cancel orders -
4. Refund orders -
5. Any other -

Other - specifics

Outstanding questions