3.0.0 General Release 2022-06-24

Changes

• Corrected the query for getListingsByShop where duplicate listings are returned across pages when created timestamp is identical across multiple listings. #510

3.0.0 General Release 2022-06-21

Changes

• Fixed issue with the shipping profile on getListing endpoint giving the incorrect shipping profile. (#403)
• If the shipping profile has no name in the get listings endpoints, the name will autofill with "Custom Shipping Profile (#{listingid})

Added

• In the getListingInventory and other property value endpoints now will return a new additional array called value_pairs to match the value_id with the value strings. This is additive and should not introduce a breaking change. (#507 )
  NOTE: Be sure to remove value_pairs from the inventory data set when you attempt to update inventory. This array is only for output/readability purposes.

3.0.0 General Release 2022-06-17

Changes

• Fixed issue with the shipping profile id not being correct on listings. #403
• Fixed getShopByOwnerUserId to return shops that are not active when the requester is the owner. #504

3.0.0 General Release 2022-06-14

Changes

• Fixed issue where some listings would not update when taxonomy_id is included and included inventory variation pricing. #459

3.0.0 General Release 2022-06-13

Added

• Created a new endpoint: updateShopReceipt to allow apps to pass in was_shipped and was_paid to change the status on the receipts. See Documentation here https://developers.etsy.com/documentation/reference#operation/updateShopReceipt. This is to begin addressing #10

3.0.0 General Release 2022-06-08

Changes

• Added user avatar url as image_url_75x75 to the getUser endpoint.
• Added buyer_coupon_discount and shop_coupon_discount to transaction object in getShopReceipt... and getShopReceiptTransaction... endpoints. #475

3.0.0 General Release 2022-06-06

Last year, Etsy implemented a policy that states that listings should no longer have an independent quantity or price and instead use the newer and more robust inventory handling system. We will be releasing an update to the Open API V3 to ensure the standards of the system are kept and reduce potential inconsistencies in the listing data.

Changes to expect

1. The create Draft Listing endpoint will shift from storing the quantity and price in the listing record to automatically creating the inventory record. This is not a breaking change and you will not have to make any changes to your current processes for calling this endpoint.
2. The update Listing endpoint will no longer update quantity or price on listings that were never converted to inventory records. For the time being, the endpoint will not return with an error if you pass in quantity and price. It will simply ignore those parameters to ensure that we are not breaking your existing process. However, after this update you will have to call update Listing Inventory in order to update the price or quantity. It is likely that you are already utilizing this endpoint and therefore will not be affected by this change, but please verify to eliminate any issues.

3.0.0 General Release 2022-06-03

Changes

• Added "max_values_allowed" to getPropertiesByBuyerTaxonomyId and getPropertiesByTaxonomyId endpoints to resolve issue #494

New

• Created new endpoint getShopPaymentAccountLedgerEntry to fetch a single ledger entry. #302

3.0.0 General Release 2022-06-02

Changes

• Added alt_text support to listing images: uploadListingImage, getListingImages, getListingImagesDeprecated. You can now post alt_text to your listing images and receive the alt_text back when fetching listing images. #227
• Added refunds to receipt endpoints: getShopReceipt, getShopReceipts #302
• Added payment_adjustments with payment_adjustment_items to the endpoints getShopPaymentAccountLedgerEntries, getShopPaymentAccountLedgerEntryPayments, getShopPaymentByReceiptId, getPayments #302

3.0.0 General Release 2022-05-24

Added

1. New endpoint for checking token scopes: tokenScopes . See #477 . Note that this is a POST endpoint.