Shopee Marketplace Connector changelog
All notable changes to Shopee Marketplace Connector (kv_shopee) are documented here.
The format follows Keep a Changelog and the project uses Semantic Versioning.
[Unreleased]
Section titled “[Unreleased]”[1.0.0] - 2026-11-07
Section titled “[1.0.0] - 2026-11-07”- Initial release on the shared Marketplace Hub, for the Shopee Open Platform v2 API.
- Connection page: partner ID and partner key (encrypted, test and live), API host (global, China mainland, Brazil), sandbox host, shop, handover method and package size; “Test connection”.
- Shop authorization: the open.shopee.com/auth link (legacy signed auth_partner link as an option), redirect URL with a signed state valid for one hour, manual code fallback, access tokens renewed in the background (refresh token rotation under a database lock), one token set per shop.
- Items: category tree, attribute tree, brand and limits of the category, image upload,
add_item; stock and price by item SKU (search_item,update_stock,update_price), whole numbers for regions without decimals, currency per shop region. - Orders: windows of at most 15 days with a cursor,
get_order_detailwith optional fields, unpaid and pending orders wait, status follows Shopee. - Fulfilment:
get_shipping_parameterandship_order(pick-up, drop-off, non-integrated with the seller’s tracking number), tracking number read back, cancellation with a reason (also partial). - Returns list with approval of refund-only requests.
- Push (webhook) endpoint with the documented signature check and an empty 2xx answer.
- Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export.
- Multi-Vendor: owner mode or one shop per vendor; a vendor maps and lists only its own products and cannot run the shared job queue.
- A listing job that stops half way (rate limit, timeout) never creates an item twice: every item is saved right after Shopee created it and looked up by item SKU before it is created.