3.0.0 General Release 2023-04-06

• Adds optional policy_additional parameter to the updateShop endpoint. This parameter should be used to update a shop's additional policy. Please note that the policy_additional parameter should only be set for shops located in the EU. Passing a value for this parameter for shops outside of the EU, will result in an error.

3.0.0 General Release 2023-03-16

• bug fix to correctly return Listing translations using the shop's default language instead of defaulting to english. This fix affects Listing translations from Shop's with settings that contained non-english language defaults with additional secondary english language support.
• added language override parameter to the getListing endpoint (https://openapi.etsy.com/v3/application/listings/{listing_id}) to support returning a Listing in an alternate supported language.

3.0.0 General Release 2023-01-10

Changes

• Fixed bug where listings returned the incorrect value for when_made.

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