Sorsa

Repricer dashboard summary: total/active SKU counts, per-status breakdown, Buy Box wins and win %, items matching the Buy Box exactly, units actively repricing and the last update time. Call first for broad questions like 'how's the repricer doing?'.

What the user should reorder now. Per-SKU sales velocity vs stock on hand -> days of cover left, a suggested reorder quantity and its potential profit. Call for 'what should I restock?' or 'what's running low?'. lead_time_days = how long a resupply takes to land; cover_days = days of stock the reorder should provide. Requires a connected Amazon account.

List the user's recent Reverse Source scan jobs and their status. Call to find a job_id whose results to fetch.

Status and results of a Reverse Source scan started with start_reverse_source_scan. Returns progress % and, once complete, the cheapest Google Shopping source found per ASIN (retailer, price, link).

Whether the user has connected their own Google Sheet (a deployed Apps Script web app) that run_sheet_action can trigger. If not connected, tell them to add their web-app URL in Sorsa Settings. Never returns the URL.

Products found by the user's storefront monitors (tracking other sellers' Amazon storefronts), newest first. Call when the user asks what their storefront monitors have found; optionally filter to one store_id. Paginated — 'total' in the response is the full count, request further pages for more. per_page max 200 (keep small: rows are wide).

List the Amazon storefronts (competitor sellers) the user is monitoring. Call before adding one, or when the user asks which storefronts they track.

Summary stats for the user's storefront monitors (stores tracked, result counts). Call for an overview before drilling into get_store_results.

The curated Sorsa ungate brand list (~1300 brands), each with a representative ASIN that can be run through request_ungate_check. Use this to look up the ASIN for a brand the user names (e.g. "can you ungate me for Adidas?" -> find Adidas here -> request_ungate_check([that asin])), or to enumerate/batch brands. Pass `search` to filter by brand substring. Returns {count, brands:[{brand, asin}]}. `count` is the full list size even when `search`/`limit` narrows the returned rows.

Status + outcome of an ungate job. Status is queued | in_progress | completed | failed | expired; outcome (when set) is approved, already_approved, documents_required, not_accepting_applications, login_required or unknown. While status is 'queued' or 'in_progress', CALL THIS AGAIN after a short wait (e.g. 20-40s) — the job is processed by the user's extension serially. For 'documents_required' the response also includes Amazon's requirements text, a `suppliers` list for the brand/category, and `suggested_asins` (easier wins in the same brand). For 'login_required', tell the user to log into Seller Central and retry.

Suppliers (manufacturers / authorised distributors / wholesalers that issue proper invoices) for a brand or category, with how many Sorsa users confirmed each one got them ungated for that brand. Provide a brand and/or a category.

List the user's recent Wholesale Scanner jobs and their status. Call to find a job_id whose results to fetch.

Status and results of a Wholesale Scanner run. Returns progress % and, once complete, each supplier product matched to Amazon with sell price, profit and ROI.

Resolve a barcode (EAN/UPC, 8-14 digits) to an Amazon ASIN. Call when the user gives a barcode instead of an ASIN, then feed the returned ASIN into analyse_product.

Mark one of the user's notifications as checked (reviewed) or unchecked. Call after the user says they've dealt with an alert, or to un-mark one.

Queue an Amazon checkout on the user's own desktop Chrome (requires the Sorsa extension installed and signed in there). Call when the user says e.g. 'buy 3 of this' or 'replen this ASIN at up to £20'. mode 'review' (default) drives to Amazon's review page and STOPS — the user clicks Place Order themselves. mode 'auto' places the order, but only if the user has enabled Auto checkout in the extension popup AND the order total is within max_price × qty (max_price is required for auto). max_price is ALWAYS in GBP (£) per unit, whatever the marketplace — the server converts it to the local currency at the current rate, so '£20 max on amazon.de' just works. pace 'calm' (default) clicks at a relaxed human pace — use 'fast' only for time-sensitive deals. domain is the marketplace: GB, US, DE, FR, ES or IT. The job expires after 15 minutes if the user's desktop isn't online to claim it. Always tell the user what was queued and that their desktop Chrome will open it.

Request an ungate check for one or more gated ASINs. For each ASIN this confirms it's gated (via the eligibility check) and, if so, QUEUES a job that the user's Sorsa browser extension works through — it opens the Seller Central approval request in their own logged-in session and reports the outcome. Returns per-ASIN results, each one of: 'not_gated', 'already_approved', 'checking' (eligibility still resolving — re-call shortly), 'recent_attempt', 'queue_full', or 'queued' with a `job_id` (and the brand's auto-approval rate when known). Jobs run STRICTLY ONE AT A TIME, ~daily-capped, and carry over across days — so a long list is fine; it just drains serially. The user needs their Amazon (SP-API) connected AND the Sorsa extension installed and online. After queuing, poll get_ungate_status(job_id) after a short wait (jobs are processed serially, each can take tens of seconds to a few minutes). Tell the user if their extension is offline (the response includes `extension_online`).

Trigger a function on the user's OWN connected Google Sheet by POSTing to their deployed Apps Script web app. Call get_sheet_status first; if not connected, tell them to connect their sheet in Sorsa Settings. `action` is the name their script's doPost dispatches on (e.g. 'send_invoice', 'add_row'). `params` is a dict of values that action needs. The user's email is always sent automatically, so the script can target the right row/recipient. Only do what the user asked — don't invent actions or params. If you're not sure which action name or params the user's script expects, ASK them rather than guessing. Returns whatever the script returns.

Search Amazon by product title via Keepa and return the top matching ASINs with thumbnails. Call when the user names a product without an ASIN or barcode; present the candidates and let them pick before analysing. limit is 1-10.

Set the cost of goods (COG) for a SKU — the per-unit price the user paid. Feeds profit/ROI across the whole app and the repricer's floors. cost in the user's currency (e.g. £). Pass cost=0 or empty to clear it.

Start an A2A Finder scan: check a list of ASINs for profitable Amazon-to-Amazon flips across marketplaces (buy on one Amazon country, sell on another). Up to 100 ASINs. Optional `countries` = list of country codes to compare (e.g. ["UK","DE","FR"]); defaults to all. Uses the user's saved Keepa key if they've added one in settings; otherwise the shared scan key (which counts against their daily scan credits). Returns a job_id — poll get_a2a_finder_status(job_id) for results. Premium feature.

Start a Reverse Source scan: for each ASIN, search Google Shopping for a cheaper source than Amazon — i.e. where to buy the product to flip it. Up to 250 ASINs. Uses the user's saved Keepa key if they've added one in settings; otherwise the shared scan key (which counts against their daily scan credits). Returns a job_id — poll get_reverse_source_status(job_id) for results. Premium feature.

Start a Wholesale Scanner run against a supplier price list. Each item in `products` is a dict with 'title', 'price' (cost per unit), and 'ean' (barcode — needed to match, the default scan is EAN-based). Up to 500 items. Matches each product to Amazon and returns profit/ROI. Returns a job_id — poll get_wholesale_status(job_id) for results. Premium feature.