3.0.0 General Release 2022-12-06

Changes

1. Added to updateListingProperty endpoint documentation to state that parenthesis characters are not allowed in the values strings.
2. Added min_created and max_created input parameters to getReviewsByShop and getReviewsByListing endpoints.
3. Added back the views field to the listing objects in the get and find listing endpoints. NOTE The views will only have a value for ACTIVE listings and the results are tabulated only once per day and only if the listing is active when it's tabulated.

New

1. Created new endpoint getListingsByShopReturnPolicy. This endpoint will fetch all listings with a given return_policy_id

3.0.0 General Release 2022-11-14

New

• createShopReturnPolicy Create a shop return policy.
• getShopReturnPolicies and getShopReturnPolicy to get a list of shop return policies or a single policy, respectively.
• deleteShopReturnPolicy Delete a specific shop return policy
• updateShopReturnPolicy Update a specific Shop Return Policy
• consolidateShopReturnPolicies Consolidated multiple policies into a single policy

Changed

• Added return_policy_id input parameter to updateListing to add a policy to a listing.
• Added return_policy_id input parameter to createDraftListing to add a policy to a listing when creating it.
• Fixed issue where shops with no credit card on file get an error about shipping profile when attempting to upload files to a digital listing. See #663
• Updated documentation in the listing video management to change the 0, 1, 2, 3 values to be "active", "inactive", "deleted" and "flagged" respectively. No code changes. Just documentation. See #661

3.0.0 General Release 2022-10-28

Changes

• Added a new input parameter (optional) to the getListingInventoryendpoint called show_deleted (true/false) to return deleted items. See #226

3.0.0 General Release 2022-10-27

New

1. New endpoint that you can call after a user authorizes your app called getMe. This will return the shop_id and user_id for the given authenticated user.

3.0.0 General Release 2022-10-21

Changes

• Added sort_on and sort_order options to the inputs for getShopReceipt endpoint. See #185
• Corrected documentation on createReceiptShipment endpoint to reflect Etsy shipping policies. See #589
• Fixing issue where the listing endpoints would return skus in when inventory is included, whether listing is owned by user or not. See #621
• Fixed issue where skus weren't returned in getListingsByListingIds when the user is the owner. See #621

3.0.0 General Release 2022-10-11

Changes

• Changed getUser endpoint to return data only when requesting user is the same as the requested user OR when the requesting user has a purchase relationship with the requested user. Otherwise it will return just the user_id.
• The getUser endpoint and the User association via "includes" parameter will now only return the following fields: first_name, last_name, primary_email, user_id and image_url_75x75

3.0.0 General Release 2022-09-23

Changes

• Rolled back the change to getShopByOwnerUserId endpoint to remove the scope.
• Fixed inventory error when a missing image causes the variation images to throw an error. See #602

3.0.0 General Release 2022-09-22

Added

Listing Video Management
See #279, #51, #152, #509

• Endpoints: getListingVideos and getListingVideo allows your app to get a list of videos for a listing or a video by video id.
• Endpoint: deleteListingVideo allow your app to delete a video by video id for a listing
• Endpoint: uploadListingVideo allows your app to upload a new listing video to a listing or associate an existing video by video id to a listing.

Changed

• The following endpoints now have Videos as a valid entry for "includes" input parameter: getListing, getListingsByShop, getListingsByListingIds. The endpoints that have allowed for "includes" now allow Videos as an option. If included, it will return a new videos array.

3.0.0 General Release 2022-09-21

Changes

• Adjusted the endpoint getShopByOwnerUserId to require the shops_r scope as it should have been all along.
• Fixed issue with made_to_order digital listings converting to physical when all file attachments are deleted. See #454

3.0.0 General Release 2022-09-20

Changes

• Fixed issue with digital made_to_order listings getting converted to instant download listings when updated. See #585