Publishing to a channel sends the product to an outside marketplace. The listing is public and the channel reviews it. Always preview first. Publish only when the person says so.
Ask first
- Which product(s) and which channel.
- Preview only, or publish? If they didn't say, preview and stop.
Steps
1. Sales Channels: is the channel connected?
GET /storefront/sync/partners lists the channels this business has connected. If the one asked for is not there, stop. Say it isn't connected and open the connections screen (find_app "sales channels"). Don't try to connect it yourself.
Hands on: the channel id (google, facebook, tiktok, amazon, …).
2. Products: the product
Find the product (sf_product) and read it in full: title, description, price, SKU, images, category, variants, stock.
Hands on: the product sk and its data.
3. Preview: what the channel would receive
These two calls are read-only. Nothing is sent.
POST /sales-channel/mappings/validate/{channel}with the product data reports what the channel would reject (missing fields, wrong category, …).POST /sales-channel/mappings/transform/{channel}with the product data returns the listing exactly as it would be sent.
Show the person the listing and every problem found. If something is missing (an image, a category, a brand), offer to fix it on the product, then run the preview again.
Check: validate reports no problems.
4. Stop: ask before publishing
Say what will be published, where, and that it becomes public. Wait for a clear yes.
5. Publish (only after the yes)
POST /storefront/sync/{channel}/{productId} publishes one product. POST /storefront/sync/all/{productId} publishes to every connected channel. Use that one only if they asked for all.
Check: GET /storefront/sync/products/{channel} lists the product. Open it on its own screen (/product?openId=<sk>, sync tab) so the person sees its status.
Don'ts
- Don't publish to a channel nobody named, and don't publish on a preview request.
- Don't build the listing by hand when
transformgives the real one.