3.0.0 General Release 2022-03-28

Changes

• Added "score" option to the sort_on input to address #178
• Fix was added to address issues with the V2 implementation of min/max delivery days requirements

3.0.0 General Release 2022-03-28

Changes

• Added was_delivered boolean to getShopReceipts endpoint as a filter.

3.0.0-general-release-2022-03-25

Changed

1. Added 401 Bad Request response to Shipping Destinations create and update endpoints for blocked countries (RU and BY currently).
2. Fixed an issue with item dimensions being required when shipping profile is calculated.
3. Fixed issue with updateListing not returning personalization_instructions that were just passed in.

3.0.0 General Release 2022-03-18

Changed

1. Updated documentation to reflect the 401 Unauthorized potential return on OAuth scoped endpoints.
2. Fixed #402 where shop sections endpoints would error when section names are blank
3. Added a fix for errors when attempting to activate listings that were set to "Inactive" but were also past their expiration date.

3.0.0 General Release 2022-03-15

Changed

• Fixed bug with personalization_instructions returning as null or previous value when updating listing (#296)
• Modified returned error code on uploadListingImage when there is a conflict in the rank numbering. It now returns a 409 error with string instead of a 500 server error.
• Fixed issue with updateListing and getListing where item dimensions were showing 0 or null when they should not have.
• Fixed issue with shipping_profile_id returning null or wrong id.
• Created new routes for getListingImage and getListingImages endpoints & changed original endpoints to deprecated #405 and #356.
• Modified Review resource to be locked to integer from 1 to 5. Previously it was just a non-negative number which made documentation show that it could be >= 0.

3.0.0-general-release-2022-03-02

Changed

• Allowed updateListing to accept someone_else for who_made when listing already has a production partner added (#365 )
• Fixed updateListingInventory so that variant images are not lost when updating inventory (#200 )
• Fixed getShopShippingProfile to return shipping profile name properly (#347 )
• Fixed issue where Pattern channel is removed from listings when listings are updated via the OpenAPI
• Allowed getShopReceipt to return canceled listing (#160 )
• Allowed updateListing endpoint to null out values for item dimensions and item weight and their respective units when the shipping profile used is fixed.
• Fixed updateListing endpoint to return a different message when listings aren't able to be activated for reasons other than listing configuration issues.
• Various documentation updates
• Added domestic_handling_fee and international_handling_fee to the shipping profile endpoints.

3.0.0-general-release-2022-01-28

Added

• getBuyerTaxonomyNodes Docs
• getBuyerTaxonomyNodeProperties Docs

Changed

• Added sort_on and sort_order input parameters to findAllActiveListingsByShop Docs
• Modified listing_type to return as string per the docs versus as an integer
• Modified shipping profile_type to return as string per the docs versus as an integer.

3.0.0-general-release-2022-01-14

Added

• Basic shipping profile added to the listing resource object
• Shop object now includes is_etsy_payments_onboarded. This will replace is_direct_checkout_onboarded in the future.
• Added transaction_id back into the Review resources.
• Added image_ids to updateListing endpoint. Images will overwrite current array if passed, in order that they appear in the list of image ids.

Changed

• Removed requirement of additional taxonomy data when taxonomy_id is passed in updateListing endpoint.
• Set createDraftListing to allow should_auto_renew to be set to true on creation.
• Allow user to create digital listings with createDraftListing endpoint.
• Fixed updateListing endpoint to not set all listings to physical by default.
• Fixed receipt transaction to include personalization when value_id is null
• updateListing and updateListingInventory now allows quantity to be set individually, even when total across all variants adds up to more than 999.
• getListingsByShop now allows searching by all state values: active, inactive, sold_out, draft, removed, expired, edit
• added shipping method, shipping profile and upgrade info to transaction object.
• Added order status to receipt endpoints.
• getShopPaymentAccountLedgerEntries now includes origin_reference_type
• updateListing no longer requires a file attachment on digital listings update.
• updateListingInventory now allows property_values to be an empty array.
• Listing endpoints now include skus as a simple array of values for listing owner only.
• Fixed the count value in shops and listings list endpoints to return the correct value.
• Fixed issue with should_auto_renew on updateListing to show correct value on response.
• Changed createDraftListing and updateListing endpoints to adjust the minimum and maximum price values based on conversion to shop currency.
• Fixed createDraftListing endpoint so that image_ids do store.
• Removed email_r permission requirement from receipts endpoints

Removed

• Removed support for channels in the createDraftListing and updateListing endpoints.

3.0.0-general-release-2021-09-29

Added

• Added new getShopProductionPartners endpoint for fetching Production Partners created in the Shop Manager.

Changed

• createDraftListing and updateListing now allow addition of production_partner_ids
• personalization_is_required, personalization_char_count_max and personalization_instructions added to createDraftListing and updateListing endpoints.
• Receipt and transaction endpoints now include the buyer's selected variations.
• Receipt and transaction endpoints now include the buyer's personalization entry as part of the variations data
• Fixed error in updateListing when only should_auto_renew is passed.
• Added transaction_id back into the getReviewsByShop endpoint.
• updateListingInventory endpoint now allows empty property_values array for non-variant listings
• getShopPaymentAccountLedgerEntries now returns origin_reference_type data point
• Receipt endpoints now include status field.
• getShop endpoint now includes is_etsy_payments_onboarded data point
• Receipt endpoints now include basic buyer shipping selection: shipping_method, expected_ship_date and actual_ship_date.

Removed

• channels has been removed as a valid input for createDraftListing and updateListing endpoints.

3.0.0-general-release-2021-07-28

Etsy's Open API v3 is now in General Release! 🎉

7/28/21

Changed

• getAllListingFiles does not throw a 404 for a non-existent or invalid listing ID

• Update deleteListingFile returns a value description

• getListingsByListingIds now Implement Shop, User and Images associations

• lists of shipping profiles Include calculated shipping profiles

• a product can be assigned a calculated shipping profile

• updateListingProperty bug fixed (returned a 500 when only value id or values is passed)

• rate limits have been included in v3 endpoints

• listing property update - allows to submit values or value_ids only in the request

• updateListing has now 'is_supply' request parameter in

• listings are now returning taxonomy_id

• getListingInventory now returns an array of ids for the properties

• should_auto_renew value bug fixed in the lIsting update method

• Endpoints moved into beta

  • updateListingProperty