In Development Personal Access Only

Echoes of Idols: Inventory Sync

Developer Documentation & Project Requirements

Project Overview

The Echoes of Idols Internal Inventory Manager is a private, custom-built script designed exclusively for the Etsy shop "Echoes of Idols".

This tool is not a commercial application. It will never be made available to the public, and it does not allow external Etsy sellers to authenticate or use its features. Its sole purpose is to connect the shop owner's local SQLite inventory database to their personal Etsy storefront to reduce manual data entry.

Objective

Managing inventory and drafting listings for unique, one-off items requires significant manual data entry. This internal tool solves this by:

Pushing draft listing metadata from a local database to the Etsy UI.
Keeping local stock quantities synchronized with active Etsy listings.
Reducing administrative overhead so the owner can focus on crafting.

Technical Specs

Target Audience: 1 User (Echoes of Idols shop owner)
Integration: Etsy Open API v3 (RESTful JSON)
Authentication: OAuth 2.0 (Strictly tied to the owner's AppKey)
Hosting Environment: Local execution / Cloudflare Webhooks

Feature Scope (CRUD)

Because this is a Personal Access application, the feature set is strictly limited to managing a single shop's data:

Fetch Active Listings: Read-only access to compare local stock levels against storefront levels.
Draft Creation: Push text-based metadata (Title, Description, Price, Tags) to create a "Draft" listing. Final publishing and image uploads are reviewed manually in the Etsy Seller Dashboard.
Inventory Updates: Update the integer quantity of specific items when manufactured or sold locally.

Etsy Policy Compliance

This application is built in strict adherence to Etsy’s API Terms of Service and Seller Policies:

Handmade Policy: This tool does not facilitate dropshipping, mass production, or print-on-demand. It strictly manages the physical, artisan inventory belonging to "Echoes of Idols."
Data Privacy: No buyer Personally Identifiable Information (PII) is downloaded, stored, or processed. The tool only interacts with the /shops and /listings endpoints.