docs
/
AI skills

List a product on a sales channel

Put a product on Google Shopping, Facebook, TikTok, Amazon or another connected sales channel. Check the channel is connected, preview exactly what would be sent, fix what the channel would reject, and publish only after a yes.

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 transform gives the real one.