Backend: implement Etsy shop OAuth connection and listing sync foundation
A working diagnosis of this problem and the sequence that actually resolves it, written from the operational side rather than the marketing side.
Reported context: ## Goal Implement Etsy shop connection and listing import foundation so PrintHub can create shops and seed product records from Etsy. ## Dependencies - Wait for #2 backend scaffold. - Wait for #6 auth/current-user contract. - Needs #5 Cosmos repository foundation for persistent shop/product records, or an agreed fake repository for early vertical slice. ## Scope Backend Etsy OAuth and listing sync foundation. Do not
What is actually going on
Localisation failures come from machine-translating titles without adapting measurement units, tax labels, or cultural buying cues.
Cross-channel sync breaks when the source of truth is ambiguous — two systems both writing inventory produce oversells.
The sequence that works
Pull the exact rejection reason code from the marketplace API rather than the dashboard summary, since the two frequently differ.
Rebuild titles against the marketplace style guide: character limits, capitalisation rules, prohibited claims, and required attributes.
Localise rather than translate: convert units, adapt the guarantee wording to local consumer law expectations, and rewrite the first three bullet points for local buying motivation.
Establish a single inventory source of truth and make every other channel read-only against it.
Set a daily reconciliation report that flags any SKU where channel quantities diverge by more than one unit.
Where people lose time
Resubmitting the same listing repeatedly after rejection without changing the flagged attribute — repeated rejections escalate account risk.
Using the same title across every marketplace. Each has different ranking behaviour and style enforcement.
Verify before you trust it
Run the checks above against your own data instead of adopting them at face value. The failure modes are specific enough that a single afternoon of measurement will either confirm this diagnosis or rule it out — both outcomes are useful, and guessing is not.
Cross-Border Listing Localizer
A ready-to-use package for exactly this workflow — $27.55, delivered immediately.
Sold via Gumroad, which acts as merchant of record and handles payment and applicable taxes. All sales are final; see the return policy before purchase.