Usage
Listing products
Section titled “Listing products”- Listings tab: enter a product ID (the Etsy SKU defaults to the product code) or pick a category and click Add all products of this category. Untick Stock or Price to stop pushing that value for a product; a per-product markup overrides the rules.
- Sync now (or wait for cron). Each new product becomes an Etsy draft with title (cleaned to the characters Etsy allows, at most 140), plain-text description, price, quantity, SKU, images, tags from the meta keywords (at most 13, 20 characters each) and mapped properties.
- The list shows each product’s state: Not listed yet, Waiting for Etsy, Listed on Etsy, or the error Etsy returned (for example a missing shipping profile). Fix the cause and click Retry.
- A product with stock 0 cannot be created on Etsy (Etsy needs a quantity of at least 1). For an existing listing quantity 0 is sent and Etsy decides how the listing is shown.
A product already on Etsy with the same SKU is linked, not created again. If Etsy saved a draft but the answer was lost (timeout), the next run finds that draft and links it.
Orders
Section titled “Orders”Paid receipts are imported on every sync and, with webhooks, within moments. The Orders tab lists each Etsy receipt with its Etsy status, the CS-Cart order and any import error (for example a SKU that is not mapped). A failed receipt is tried again every hour; after fixing the cause click Retry on its row. If Etsy refused a tracking number, Send tracking again sends it once more. The order notes name the Etsy receipt, its sale date in your shop time zone, the payment method, the total and tax collected by Etsy, the buyer’s note, gift message and personalization.
When the receipt changes on Etsy (shipped, cancelled, refunded) the CS-Cart order status follows your status mapping. Cancelling and refunding are done on etsy.com.
Tracking
Section titled “Tracking”Create a shipment with a tracking number on the CS-Cart order (Orders > order > Shipments). At the next sync the tracking number goes to Etsy with the matching Etsy carrier (or “other”). Etsy then e-mails the buyer; the add-on never sends the same tracking number twice.
Log and jobs
Section titled “Log and jobs”The Log tab shows every step with Etsy’s answer (secrets masked) and exports CSV. The Jobs tab shows the queue with Retry and Remove.