Workflows

Catalog & inventory

Manage products, photos, wholesale counts, and collections.

Find a product

Use a search to locate the exact SKU, then read the product and its current revision. Product lists are zero-based and return up to 25 records per page.

finoctl wholesale products list --page 0
finoctl wholesale products resolve "Example Hat"
finoctl wholesale products get "$SKU"

Create or edit products

A create file needs an explicit uppercase SKU, name, price in cents, availability, and the stock policy. Include stock when count_stock is true. The following file illustrates the format for a new product.

{
  "sku": "EXAMPLE-HAT",
  "name": "Example Hat",
  "price_cents": 1100,
  "hats_only_price_cents": 1100,
  "full_set_price_cents": 1500,
  "availability": "available_now",
  "count_stock": false,
  "item_type": "product"
}

For an edit, include only the fields you want to change. The CLI reads the current product and includes its revision in the preview. See Input files for accepted fields. Manage storefront listing in the dashboard.

finoctl wholesale products create --file new-product.json --out create-preview.json
finoctl wholesale products update "$SKU" --file changes.json --out edit-preview.json

Use archive, restore, or delete with an exact SKU and a fresh --out file. Delete is a retirement that retains the SKU and historical order references.

Manage photos

The first photo in the saved gallery is the cover. Upload a PNG, JPEG, or WebP up to 8 MiB. The upload preview records the file digest for verification at apply time. For reordering, put each current image key once in a JSON array. For removal, use the exact saved photo key from the list.

finoctl wholesale products images list "$SKU"
finoctl wholesale products images upload "$SKU" hat.png --out upload-preview.json
finoctl wholesale products images reorder "$SKU" --file image-keys.json --out order-photos.json
finoctl wholesale products images remove "$SKU" "$PHOTO_KEY" --out remove-photo.json

Adjust stock and collections

set previews the exact catalog stock count and enables counting. add previews a positive increment against an existing counted baseline. These commands address wholesale catalog stock. Warehouse fulfillment and Shopify inventory have separate records.

Use collections list to get exact collection names. Use an empty collection name in collections assign to remove an assignment.

finoctl wholesale inventory set "$SKU" 120 --out stock-preview.json
finoctl wholesale inventory add "$SKU" 12 --out addition-preview.json
finoctl wholesale collections list
finoctl wholesale collections assign "$COLLECTION" "$SKU" --out collection-preview.json

Apply and verify

Review the preview, apply with its checksum, then re-read the product, stock, or gallery that changed.

finoctl wholesale apply edit-preview.json --confirm "$CHECKSUM"
finoctl wholesale products get "$SKU"

A stale revision requires a fresh read and a new reviewed preview. A lost apply response calls for reconciliation using the saved operation ID.