Vendooly

List Amazon Ads profiles for this account

Read-only: elenco ad group Sponsored Brands (SB) — id, nome, stato (ENABLED|PAUSED|ARCHIVED), campagna di appartenenza. Filtra con campaign_id_filter.

LIVE: stato corrente delle campagne Sponsored Brands (SB) ESISTENTI (create da Amazon Ads console — Vendooly non crea ancora campagne SB nuove, serve brandEntityId/Brand Registry/asset creativi/moderazione, non implementato). Campi chiave: name, campaignId, state (ENABLED|PAUSED|ARCHIVED), daily_budget, costType (CPC|vCPM), bidding (placement/bidOptimization), brandEntityId. NON ritorna performance: per ACoS/spesa/vendite SB usa execute_sql su fact_campaign_daily (ad_product='SB').

LIVE: keyword Sponsored Brands (SB) con BID e stato ATTUALI — la lettura da fare prima di riofferire su SB. Filtra con campaign_id/ad_group_id. NON ritorna performance: per spesa/vendite/ACoS usa execute_sql su fact_keyword_daily. Elenco vuoto = quel brand non ha keyword SB (tipico se le campagne SB usano product targeting o non esistono): dillo, NON inventare keyword.

LIVE: product target Sponsored Brands (ASIN/categoria/brand) con BID e stato ATTUALI. Il target_id serve per ads_update_sb_target_bid. NON ritorna performance: usa execute_sql sul data-hub. Elenco vuoto = nessun target SB su questo profilo: dillo, NON inventare target.

Read-only: ad group Sponsored Display — id, nome, stato, campagna di appartenenza e defaultBid (l'offerta dell'ad group, la leva di ottimizzazione SD). Filtra con campaign_id_filter.

LIVE: campagne Sponsored Display (SD) ESISTENTI — name, campaignId, state (enabled|paused|archived), budget giornaliero, tactic (T00020 contestuale | T00030 audiences), costType (cpc|vcpm), bidOptimization. Vendooly non CREA campagne SD (servono audiences/creatives/Brand Registry): legge e aggiorna quelle già create da Amazon Ads console. NON ritorna performance: per ACoS/spesa SD usa execute_sql su fact_campaign_daily (ad_product='SD').

Read-only list of Sponsored Products ad groups (id, name, state, default bid)

READ-ONLY. Elenca i SEGMENTI DI PUBBLICO utilizzabili per i moltiplicatori di bid delle campagne Sponsored Products (audience bid adjustments, disponibili in IT/DE/FR/ES/UK). source: "amazon" (default: pubblici costruiti da Amazon, es. chi ha già comprato dal brand, chi ha cliccato o messo nel carrello, alta probabilità di acquisto), "amc" (pubblici creati in Amazon Marketing Cloud) o "all". search = filtro testuale opzionale. Ritorna audience_id, name, description, source. Gli audience_id vanno passati a ads_update_sp_audience_bidding; i segmenti già impostati su una campagna si leggono in ad…

LIVE: stato corrente delle campagne SP. Campi chiave per campagna: name, campaignId, state, targetingType (AUTO|MANUAL) e daily_budget = budget giornaliero NUMERICO nella valuta del marketplace (es. 50, 150). NON esiste un "bid" a livello campagna (i bid sono su keyword/target). Usa per VERIFICARE prima di agire o per avere nomi/ID. NON ritorna performance: per ACoS/spesa/ROAS/vendite/click usa execute_sql su fact_campaign_daily. Espone anche bidding_strategy e placement_adjustments = moltiplicatori % ATTUALI per placement (PLACEMENT_TOP | PLACEMENT_REST_OF_SEARCH | PLACEMENT_PRODUCT_PAGE | SI…

LIVE: keyword SP con bid e stato ATTUALI — per agire o verificare. NON ritorna performance: per spesa/vendite/ACoS o keyword che sprecano usa execute_sql su fact_keyword_daily.

List SP negative keywords

List SP negative product targets

READ-ONLY LIVE. Elenco SP completo di default (all_pages=true), con ASIN/SKU, stato, nomi e stati di campagna e gruppo. Filtri esatti. all_pages=false legge una pagina Amazon: continuare con next_token anche se vuota dopo i filtri ASIN/SKU. Per trovare tutti gli ASIN scoperti usare ads_catalog_coverage.

List SP targeting clauses — SIA i target MANUAL (ASIN/categoria) SIA i 4 gruppi AUTO che Amazon genera da solo nelle campagne AUTO. Ogni clause ritorna il suo targetId, lo state e (se impostato) il bid. Mappatura gruppi AUTO (expression.type → nome UI): QUERY_HIGH_REL_MATCHES=close-match, QUERY_BROAD_REL_MATCHES=loose-match, ASIN_SUBSTITUTE_RELATED=substitutes, ASIN_ACCESSORY_RELATED=complements. PER CAMBIARE IL BID DI UN GRUPPO AUTO: chiama questo tool con campaign_id → prendi il targetId del gruppo → ads_update_sp_target_bid(target_id, bid). NON usare ads_create_* sulle AUTO (i target esisto…

READ-ONLY, DETERMINISTICO. Performance Ads dal Data-Hub con numeri calcolati dal server, SEMPRE uguali a parità di dati: finestre FISSE di 7/14/30 giorni chiuse 3 giorni prima dell'ultimo dato (attribuzione Amazon ancora incompleta), ACoS/CTR/CVR/CPC/RPC/AOV dalle somme SQL, confronto con il periodo precedente, e per ogni riga una colonna action con la regola applicata: HOLD_DATA (pochi click: non toccare), HOLD_OK (ACoS ≤ target), HOLD_BAND (sopra target ma entro target × 1.2: tolleranza, non "in target"), BID_DOWN (ACoS sopra target: bid suggerito = ricavo/click × ACoS target, taglio max 25%…

READ-ONLY. Cross-references catalog days of cover (30d cached velocity) with active SP product ads: finds where you are paying for clicks on products close to stock-out. Use for "am I wasting ads budget?", "are ads pushing products that are running out?".

Aggiorna un ad group Sponsored Brands (SB) ESISTENTE (es. stato ENABLED|PAUSED). NON crea ad group nuovi.

Aggiorna una o PIÙ campagne Sponsored Brands (SB) ESISTENTI: budget giornaliero, stato (ENABLED|PAUSED) e OTTIMIZZAZIONE DELL'OFFERTA. Per ottimizzare senza tagliare volume NON strozzare il budget: usa i moltiplicatori per posizionamento con patches.bid_adjustments_by_placement=[{placement, percentage}] — placement (enum verificato): TOP_OF_SEARCH | DETAIL_PAGE | HOME | OTHER (alias comodi: top, detail_page, home, other); percentage = aumento % dell'offerta su quella posizione, SOLO valori positivi (0 o più): dal 15/6/2026 Amazon NON accetta più moltiplicatori SB negativi e il tool li rifiuta …

Aggiorna il BID di una o PIÙ keyword Sponsored Brands. È la leva per OTTIMIZZARE una campagna SB invece di spegnerla o strozzarne il budget. keyword_id si ottiene da ads_list_sb_keywords. SINGOLA: keyword_id + bid. BATCH (consigliato): items=[{keyword_id, bid}], MAX 25. Esito verificato per-id (read-after-write).

Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di una o PIÙ keyword Sponsored Brands. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25. Esito verificato per-id.

Aggiorna il BID di uno o PIÙ product target Sponsored Brands. Insieme a ads_update_sb_keyword_bid e ai moltiplicatori per posizionamento di ads_update_sb_campaign è il modo per OTTIMIZZARE SB (invece di limitarsi a spegnere o tagliare il budget). target_id da ads_list_sb_targets. SINGOLA: target_id + bid. BATCH: items=[{target_id, bid}], MAX 25. Esito verificato per-id.

Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di uno o PIÙ product target Sponsored Brands. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.

Aggiorna uno o PIÙ ad group Sponsored Display: BID (defaultBid) e/o stato (enabled|paused). Su SD il bid dell'ad group è la leva principale di ottimizzazione. SINGOLA: ad_group_id + bid/state. BATCH: items=[{ad_group_id, bid?, state?}], MAX 25. Esito verificato per-id.

Aggiorna una o PIÙ campagne Sponsored Display ESISTENTI: budget giornaliero e/o stato (enabled|paused). SINGOLA: campaign_id + daily_budget/state. BATCH: items=[{campaign_id, daily_budget?, state?}], MAX 25. Esito verificato per-id (read-after-write). NON crea campagne SD.

Update a SP ad group

Imposta i MOLTIPLICATORI PER SEGMENTO DI PUBBLICO di UNA campagna Sponsored Products (dynamicBidding.shopperCohortBidding): aggiunge o modifica (set=[{audience_id, percentage}]), toglie (remove=[audience_id]) o azzera tutto (clear_all=true). percentage = aumento % del bid, INTERO 0-900: i segmenti possono solo ALZARE il bid, mai abbassarlo. Si applica SOPRA il moltiplicatore di placement (es. bid 1€, Top of Search +50% = 1,50€, pubblico +100% = 3€). Massimo 10 segmenti per campagna. Il tool RILEGGE la campagna live, fonde le modifiche con i segmenti esistenti e rimanda INVARIATI i moltiplicato…

Aggiorna una o PIÙ campagne SP. SINGOLA: campaign_id + patches (patches.daily_budget numero → convertito nel payload v3 budget{budgetType:DAILY,budget}; patches.state ENABLED|PAUSED; patches.placement_bidding = MOLTIPLICATORI per placement [{placement, percentage 0-900}] con placement PLACEMENT_TOP|PLACEMENT_REST_OF_SEARCH|PLACEMENT_PRODUCT_PAGE|SITE_AMAZON_BUSINESS (alias top/rest_of_search/product_page/business); patches.bidding_strategy LEGACY_FOR_SALES|AUTO_FOR_SALES|MANUAL|RULE_BASED). Flusso placement: execute_sql su fact_campaign_placement_daily (performance per placement) → ads_list_sp…

Aggiorna il bid di una o PIÙ keyword SP. SINGOLA: keyword_id + bid. BATCH (consigliato per agire su molte keyword in una volta — meno chiamate, niente raffica): items=[{keyword_id, bid}], ogni keyword può avere un bid diverso, MAX 25 per chiamata. Esito verificato PER-ID (read-after-write).

Aggiorna lo stato (ENABLED/PAUSED) di una o PIÙ keyword SP. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25 per chiamata. Esito verificato PER-ID.

Mette in pausa o riattiva (ENABLED/PAUSED) uno o PIÙ product ad SP, cioè il singolo ASIN/SKU sponsorizzato dentro un ad group, senza toccare campagna o ad group. ad_id da ads_list_sp_product_ads. ARCHIVED non è ammesso (irreversibile). SINGOLA: ad_id + state. BATCH: items=[{ad_id, state}], MAX 25 per chiamata. Esito verificato PER-ID.

Aggiorna il bid di uno o PIÙ target SP (MANUAL ASIN/categoria o i 4 gruppi AUTO close/loose/substitutes/complements). Il target_id si ottiene da ads_list_sp_targets; è QUESTA (non ads_create_*) la via per modulare i bid dei gruppi auto su una campagna AUTO già esistente. SINGOLA: target_id + bid. BATCH (consigliato per molti target): items=[{target_id, bid}], ognuno con bid diverso, MAX 25. Esito verificato per-id.

Aggiorna lo stato (ENABLED/PAUSED) di uno o PIÙ target SP. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.

Titolo-SEO, passo 2 (SCRITTURA): applica un lotto del piano (solo SKU ready). Primo lotto dell'outpost max 2 SKU, poi max 50; prima di ogni lotto rilegge il precedente e si ferma se non risulta applicato. Ogni SKU viene riletto dal vivo: se la listing è cambiata dall'anteprima non si scrive. Salva il valore di prima nel registro per title_seo_rollback.

READ-ONLY. Copertura A+ Content del catalogo: quali ASIN hanno un documento A+ APPROVED (= visibile al cliente) e quali no, con i buchi ORDINATI per peso commerciale (unità vendute a 30 giorni) — quindi "quali pagine che vendono davvero sono senza A+". Segnala anche i documenti REJECTED (lavoro già fatto mai andato online, il recupero più rapido) e quelli in DRAFT/SUBMITTED. LIMITE DA DICHIARARE SEMPRE ALL'UTENTE: misura i documenti A+ DI QUESTO seller — un ASIN può mostrare l'A+ del brand owner e comparire comunque come scoperto; l'A+ è inoltre PER MARKETPLACE (IT/DE/FR/ES sono documenti dist…

Run catalog quality audit

Audit compliance/GPSR del catalogo (EU/IT). Per ogni SKU verifica gli attributi compliance REALI del suo product type (schema-aware): manufacturer, rtip_manufacturer_contact_information (contatto fabbricante), country_of_origin, safety_warning, safety_data_sheet_url e — dove il product type li prevede — i GPSR: gpsr_safety_attestation, gpsr_manufacturer_reference, dsa_responsible_party_address (responsabile EU). Incrocia gli ISSUE Amazon a tema compliance (Amazon dice cosa manca/è rifiutato). Ritorna gli SKU con gap, priorità (alta = issue ERROR Amazon o GPSR mancante), conteggi per attributo …

Audit all listings for Amazon title limit (75 chars, enforced from July/August 2026 — i titoli non conformi vengono RISCRITTI dall'IA di Amazon, solo i brand registrati hanno 14 giorni di review). Returns titles over the limit with excess character count + bullet/highlight counts per SKU, più la fascia at_risk (73–75 char, conformi ma senza margine). L'azione per un titolo troppo lungo è ACCORCIARLO (action=TRIM_TITLE): gli Item Highlights (attributo ufficiale title_differentiation, legacy item_highlights — l'audit li legge entrambi) NON rendono conforme un titolo lungo, e su molti marketplace…

Cancella offerte IN BLOCCO su un account, filtrando per canale di gestione. USA QUESTO, non delete_listing in ciclo, quando le offerte da eliminare sono più di qualche decina: delete_listing va SKU per SKU e sul rate limit di Amazon migliaia di SKU non finiscono mai, mentre qui si spediscono in feed da 20.000. Due fasi obbligatorie: (1) chiamalo SENZA plan_id → legge dal report Amazon quali SKU rientrano nel filtro e ritorna un piano con i conteggi (totale, quante FBA, quante FBM); MOSTRA quei numeri all'utente e aspetta il suo ok; (2) richiamalo con plan_id + confirm=true per inviare i feed. …

Assegna lo STESSO modello di spedizione (merchant_shipping_group) a molti SKU in una volta, con un feed JSON_LISTINGS_FEED (fino a 5.000 SKU per chiamata, un feed) invece di update_listing SKU per SKU. shipping_template = ID o nome come in Seller Central (elenco: get_product_types product_type="PRODUCT" → shipping_templates). Prima chiama con validate_only:true (valida la modifica su 3 SKU di prova, non scrive), mostra all'utente modello e numero di SKU, poi senza validate_only per inviare. Esito con check_feed_status(feed_id). NON crea né modifica i modelli (tariffe/zone/tempi si cambiano sol…

Bulk inventory updates

Bulk listing attribute updates (title, bullet_point, any patch). updates: [{sku, title?, bullets?: string[], patches?: [...], product_type?, validate_only?}]. product_type is optional: each SKU's product type is read from its listing (results[].product_type_used). Use when you need to update titles or bullets on multiple SKUs at once instead of calling update_listing one by one. Returns {total, ok, errors, results[]}. SAFETY: show preview and require confirm before sending.

Bulk price updates

ACTION. Annulla un piano inbound FBA v2024 non ancora spedito (torna VOIDED). Usalo per i ripensamenti su un piano creato per errore o non più necessario. Chiedi conferma esplicita all'utente prima di chiamare.

Stato di elaborazione di un feed (es. quelli restituiti da bulk_delete_listings). Amazon lavora i feed in modo asincrono: IN_QUEUE/IN_PROGRESS = ancora in corso, richiama fra un po'. Quando è DONE la risposta porta GIÀ l'esito letto: `summary` con quante righe Amazon ha processato/accettato/rifiutato, `errors_count` e `warnings_count`, e `issues_sample` con un campione delle righe problematiche (`issues_note` dice quante sono in tutto). Un warning NON è un errore: non riferirlo come tale. Riporta i numeri di `summary` all'utente — è l'unico modo di sapere com'è finita davvero una scrittura mas…

READ-ONLY. Gated products: BEFORE listing or buying stock, tells whether THIS seller account can sell each ASIN on the outpost's marketplace (or other marketplaces of the same region) in a given condition, using Amazon's Listings Restrictions API (getListingsRestrictions). Per ASIN: libero (no restriction) / serve_approvazione (APPROVAL_REQUIRED, with Amazon's approval_links to Seller Central) / non_idoneo (NOT_ELIGIBLE, no path to unlock) / asin_non_trovato (ASIN_NOT_FOUND on that marketplace). Results are GROUPED BY BRAND (brand read from the Amazon catalog, cached) with a verdict per brand …

ACTION. Conferma un'opzione del piano inbound FBA scelta dall'utente. kind:"packing" + packing_option_id = fissa l'imballo (poi servono le scatole: set_packing_information). kind:"placement" + placement_option_id = IMPEGNO VERO: le spedizioni vengono CREATE con lo split e le fee di quell'opzione (ritorna gli shipment_ids). Conferma SOLO dopo che l'utente ha visto fee e split e ha approvato esplicitamente. Trasporto/etichette si completano in Seller Central.

ACTION. Crea un PIANO di spedizione FBA ("Send to Amazon", Fulfillment Inbound v2024-03-20): SKU + quantità + indirizzo di ORIGINE (magazzino/fornitore del seller). È il PASSO 1 del flusso: il piano nasce come bozza modificabile, NON parte nessuna spedizione. SEQUENZA COMPLETA (guida l'utente passo-passo): 1) create_inbound_plan → 2) generate_inbound_options kind:"packing" → 3) confirm_inbound_option kind:"packing" → 4) set_packing_information (scatole) → 5) generate_inbound_options kind:"placement" (split + FEE da mostrare all'utente) → 6) confirm_inbound_option kind:"placement" = spedizioni …

Crea/sostituisce una listing (PUT). product_data accetta campi SEMPLICI auto-mappati nel formato attributi SP-API: title, brand, price, quantity, condition, ean/upc/gtin, description, bullets[]. Per agganciare un'offerta a un ASIN GIA' a catalogo usa requirements:"LISTING_OFFER_ONLY" + asin (NON servono title/brand: li fornisce il catalogo). Puoi anche passare attributes gia' strutturati. validate_only:true = dry-run (valida contro Amazon senza scrivere).

Delete a listing

Diagnose a sales drop: compares the last N days with the previous period, checks account health and returns likely causes plus suggested actions. Use for "why are my sales dropping?".

Esegue UNA query SQL di sola lettura sul data-hub storico dell'account (DuckDB, un file per org). È LA STRADA PRIMARIA per OGNI domanda di ANALYTICS, in particolare la PERFORMANCE Amazon Ads: ACoS, ROAS, spesa, click, impression, vendite/ordini per campagna o keyword, keyword che sprecano, campagne zombie, performance PER PLACEMENT — Top of Search / Rest of Search / Product Pages / Amazon Business (tabelle fact_campaign_daily, fact_keyword_daily, fact_campaign_placement_daily). Idem storico/trend/velocity/giorni-di-copertura/analisi incrociate. È anche la strada per il MARGINE REALE e il P&L: …

READ-ONLY. "Check FBA shipments and show me the discrepancies / what to recover": reads the inventory ledger (Receipts) which gives, per shipment, units received and the UNRECONCILED quantity that Amazon itself flags (potential loss), plus an estimated recoverable value (× listing price); and cross-references reimbursements ALREADY granted (lost/damaged/returns) so you do not claim what is already refunded. Use for "controlla le spedizioni FBA / unità mancanti / cosa recuperare / rimborsi FBA". Opening the reconciliation case is done in Seller Central (no public API). Note: uses async SP-API r…

READ-ONLY. "How many FBA units did I lose / got damaged, and how many were NOT reimbursed?" — the FBA lost & damaged balance per SKU (what ZoneWizard logistics, Igolai, Getida do). Reads the inventory ledger (Adjustments: lost M/5, found F/N, damaged E/6, other damage H/K/7/U, disposed D) and the reimbursements report (Lost_Warehouse, Damaged_Warehouse, CustomerReturn, reversals) and returns per SKU: units lost/found/damaged/disposed, units + amount already reimbursed, and amazon_open_units = the units Amazon ITSELF still marks unreconciled (= to claim) with event date, 60-day claim deadline, …

READ-ONLY. Problemi operativi rilevati OGNI GIORNO dal motore deterministico Vendooly sul Data-Hub (i numeri vengono dal motore dati, non dall'LLM). Regole: buybox_lost (Buy Box persa su ASIN che vendono), buybox_suppressed (Buy Box soppressa), stockout_risk (copertura reale FBA sotto soglia, merce in arrivo inclusa), ads_no_stock (product ad SP attiva su prodotti in esaurimento), negative_margin (SKU con netto negativo su 30g dal Settlement: fee+refund > incasso), listing_issue_99300 (bullet point soppressi da Amazon per claim promozionali/inviti al contatto/tempi di consegna: la listing spes…

READ-ONLY. Fiscal transactions file for the accountant (VAT/OSS support): one row per order item for sales (VENDITA), refunds (RIMBORSO), A-to-Z claims and chargebacks, with Amazon posted date, marketplace, order id, SKU, quantity, currency, ship-to country, B2B flag (Amazon Business order), net price, VAT (Amazon ChargeType *Tax, separate), shipping and gift wrap with their VAT, promotions, taxable base, VAT and implied rate. Source: SP-API Finances + Orders (no buyer name, address or email). Use when the user needs the VAT transactions / "report transazioni IVA" and the Amazon VAT Transactio…

ACTION (bozze non vincolanti). Genera E elenca in una sola chiamata le opzioni del piano inbound FBA: kind:"packing" = opzioni di imballo (packing groups); kind:"placement" = opzioni di DESTINAZIONE con split tra centri Amazon e FEE per opzione (inbound placement fee vs Amazon-optimized) — mostra SEMPRE fee e numero spedizioni di ogni opzione all'utente prima di confermare. Richiede il piano creato (create_inbound_plan); placement richiede packing confermato + scatole inviate (set_packing_information). Se esistono GIÀ opzioni per quel kind le ri-elenca SENZA rigenerarle (regenerate:true per fo…

Vendor Central OAuth link

READ-ONLY. Account Health of ONE seller account on ONE marketplace (outpost), read from Amazon's official seller performance report (GET_V2_SELLER_PERFORMANCE_REPORT, same data as Seller Central → Account Health): seller account status (NORMAL/AT_RISK/DEACTIVATED), Account Health Rating status (GREAT/WARNED — Amazon does NOT expose the 0-1000 numeric score via API), each metric with value %, Amazon target and verdict ok/attenzione/a_rischio (Order Defect Rate MFN and FBA with A-to-z claims/chargebacks/negative feedback, late shipment rate, pre-fulfillment cancel rate, valid tracking rate, on-t…

Read-only aggregated KPI summary across all accounts in the org (aggregates only, no customer data)

READ-ONLY. Dettaglio di UN documento A+ (stato, badge, ASIN associati, tipi di modulo). content_reference_key si prende da list_aplus_documents o audit_aplus_coverage. include_content=true restituisce anche i moduli completi. NB: i moduli A+ sono TIPIZZATI (STANDARD_TEXT, STANDARD_COMPARISON_TABLE, …), non HTML libero — un "HTML pronto" generato altrove va rimappato su questi tipi, non incollato.

READ-ONLY. BULK Buy Box / Featured Offer export for a LIST of ASINs (up to 100). Returns a clean table per ASIN: buy_box_price (all-in for the customer), lowest_price, offer_count, whether you win the Buy Box, FBA/FBM of the winner, and a reason when there is no Buy Box (suppressed / no offers). Use for "give me the Buy Box price for these ASINs" / export. Note: Amazon rate limits make long lists slow (~1 batch of 20 every 10s). For the Buy Box across your WHOLE OWN catalog, do NOT loop this — query the cached daily snapshot via execute_sql (table fact_buybox_snapshot), which the worker fills …

Live SP-API catalog item lookup

Get status/details of the selected Amazon seller account (outpost), including the Amazon Ads connection: ads.ads_status and, for Ads consents granted from 30/7/2026, ads.expires_at / ads.days_left (Amazon expires Ads consent 365 days after it is granted, then Ads stop working until the seller reconnects). If ads.warning is present, tell the user and point them to Marketplaces → Reconnect Ads.

Cockpit for a calendar month: for each outpost the month-to-date sales (VAT included, from the Vendooly data-hub), the month target, the end-of-month projection, Ads ACoS/TACoS, open findings (stock-outs, blocked listings, Ads on out-of-stock items) and a traffic light rosso/giallo/grigio/verde with reasons and the next action (rules 2026-10-15). Without cockpit_id uses the first active cockpit, or all visible outposts if none exists. include_health=true also reads Account Health live (one Amazon report per outpost: slower); without it health counts as UNKNOWN (yellow). Only ACTIVE marketplace…

READ-ONLY. Buy Box / Featured Offer price per ASIN (max 20 per Amazon call, auto-batched). Returns buy_box_price (listing) + buy_box_landed_price (incl. shipping), condition, whether you win the Buy Box, and source. Falls back to live offers when Amazon has no competitive price, so it returns far fewer nulls than the raw SP-API. Use for a few ASINs; for a long list use get_buybox_prices.

Get a built-in documentation topic by name (see list_context_topics).

Read-only aggregated KPI summary for this account (listing counts, 7d revenue total, issue count). Aggregates only, no customer data.

READ-ONLY. Amazon EPR (Extended Producer Responsibility) report for one seller outpost and one CLOSED calendar period, from SP-API GET_EPR_MONTHLY_REPORTS / GET_EPR_QUARTERLY_REPORTS / GET_EPR_ANNUAL_REPORTS (Product Listing role, sellers only). Returns a summary per ship-to country and EPR category/subcategory: units sold, total reported weight (kg) and material weights (paper, glass, aluminum, steel, plastic, wood, other) as calculated by Amazon, the exact period written in the file (report_period_start/end), data-quality flags (rows without weight, category or registration number) and the t…

READ-ONLY. Detailed physical FBA customer returns from GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA: SKU, ASIN, return date, quantity, original reason, detailed_disposition, status, fulfillment center and customer_comments. Use for damaged returns (DAMAGED_BY_FC/DAMAGED_BY_CARRIER), incompatibility (NOT_COMPATIBLE), product quality and return investigations. Separate from reimbursements/refunds and not available in the SQL data hub. Choose one outpost. Default last 30 calendar days UTC including today, or inclusive start_date/end_date (max 365 days per request). Async: IN_QUEUE/IN_PROGRESS is not…

FBA inventory summaries

Estimate Amazon fees (referral + FBA + variable closing) and net proceeds for a given selling price, via the official Amazon Product Fees API (getMyFeesEstimate). Pass asin OR sku, the price, currency and fulfillment_channel (FBA default, or FBM). Returns referral_fee, fba_fee, closing_fee, total_fees and net_proceeds (price minus Amazon fees, before your cost of goods). Use it for real margins: margin = net_proceeds - purchase cost. Read-only.

READ-ONLY. FBA orders as physically fulfilled by Amazon (report Amazon Fulfilled Shipments, GENERAL variant — no buyer PII): per order, the fulfillment-center-id each item shipped FROM and the derived ship-from country. Use when the user needs to know FROM WHICH COUNTRY an FBA order departed — typical case: choosing the correct VAT regime on manually issued invoices for marketplaces without Amazon automatic invoicing (amazon.ae, amazon.sa). ship_from_country is best-effort from the FC code; the authoritative datum is fulfillment_center_id. Async SP-API report: the first call may take ~30-60s.

READ-ONLY. Dettaglio di UN piano inbound FBA v2024 (stato, indirizzo origine, righe SKU con quantità/prep/label). Con operation_id (invece di inbound_plan_id) fa il polling di un'operazione asincrona pendente (create/generate/confirm) e ne ritorna stato + problemi. Per l'ELENCO dei piani usa get_inbound_plans.

READ-ONLY. List FBA inbound plans (new "Send to Amazon" workflow, Fulfillment Inbound v2024-03-20): inbound plan id, name, status (ACTIVE/SHIPPED/VOIDED), marketplaces, created/updated. This is the API that sees shipments created with the current Amazon flow (the legacy get_inbound_shipments v0 returns nothing for them). Use to list the seller's actual inbound plans/shipments and their status.

Fetch one listing (summaries, issues, offers, fulfillment availability). Pass include_data:["attributes"] for the full attribute set.

READ-ONLY. Issue Amazon di SKU SPECIFICI (una chiamata SP-API per SKU): usalo quando l'utente nomina 1-20 SKU. Per la domanda "quali dei miei articoli NON sono in vendita / sono bloccati / soppressi e perché" NON usare questo in loop: usa list_inactive_listings, che copre tutto il catalogo con una chiamata ogni 20 SKU.

Catalog detail from local cache

Your own pricing per SKU

Items for a specific order

List individual orders (last N days): order ids, status, dates and totals only — no buyer data. Live Amazon Orders API, throttled (≈1 req/min): use ONLY when you need order-level rows. For daily sales/orders charts or trends over a period use get_daily_sales; for a single revenue total use get_revenue_summary — both are served from cache and never throttle.

Get product type definition. product_type is REQUIRED (e.g. PUZZLE, SAFETY_AND_HEALTH, LUGGAGE). By default fetches the JSON Schema server-side and returns allowed enum values per attribute (attribute_enums) + required_attributes — no need to open the S3 link. The schema is personalised for the selected seller: shipping_templates = the seller's shipping templates (modelli di spedizione) as [{id, name}] — use product_type="PRODUCT" to list them. Templates (rates, zones, transit times) can only be created or edited in Seller Central → Shipping settings: SP-API cannot change them, only assign the…

Read one SOP with all its steps (from list_sops → id). Follow the steps in order when the user asks to run the procedure.

Vendor invoices — SP-API non espone un endpoint di lettura per le fatture vendor retail (solo POST submitInvoices). Questo tool restituisce una spiegazione della limitazione e rimanda a get_vendor_remittances per gli importi stimati e a Vendor Central per le fatture reali.

Vendor PO aggregate summary

Vendor PO details

Vendor POs

Vendor: importi stimati dai PO (SP-API non espone remittance reali in lettura)

Vendor trading terms — SP-API non espone termini commerciali (payment terms, sconti, accordi) in lettura. Questo tool restituisce una spiegazione della limitazione e rimanda a Vendor Central e a get_vendor_remittances per i netCost per PO.

Invite a colleague to the user's OWN Vendooly organization (the one of this connection — you cannot choose another). Use when the user says "invite this person to my account/team". Only owners/admins can invite. `role` is admin (sees every seller) or member (sees only the sellers listed in `seller_ids`; get them from list_team_members → sellers). With send_email=true (default) Vendooly emails the invitation; with send_email=false NO email is sent and the tool returns an invite link (valid 7 days) for the user to pass on. Ask the user to confirm the email and role before calling.

READ-ONLY. Elenco dei documenti A+ Content del seller su questo marketplace, con stato (DRAFT | SUBMITTED | APPROVED | REJECTED), badge e data di aggiornamento. Solo APPROVED è visibile al cliente. Per la domanda "quanto del mio catalogo ha A+" usa audit_aplus_coverage, non questo.

List the connected Amazon outposts (an outpost = one seller on one marketplace; the account_id of each is what you pass to other tools). Org-scoped.

List the cockpits of the user's organization (a cockpit = a group of outposts watched together with monthly sales targets and a traffic light). Max 10 active per organization.

List built-in documentation topics (guides and recipes for using Vendooly tools correctly: write confirmation flow, catalog cache fields, rate limits, multi-account, cross analyses). Read the relevant guide BEFORE an operation you are not familiar with.

READ-ONLY. Elenco CATALOGO-WIDE dei listing che NON sono in vendita, CON IL MOTIVO — la risposta a "quali prodotti sono inattivi/bloccati/soppressi?", "cosa mi ha bloccato Amazon dopo il caricamento?", "perché questo articolo non si vende?". Legge lo stato reale della Listings Items API (BUYABLE / DISCOVERABLE) e gli enforcement dichiarati da Amazon: LISTING_SUPPRESSED (offerta non acquistabile), ATTRIBUTE_SUPPRESSED (attributo rifiutato), CATALOG_ITEM_REMOVED (pagina disattivata), SEARCH_SUPPRESSED (nascosto dalla ricerca), più le esenzioni in scadenza (tipico GPSR: ancora attivo ma bloccherà…

List own products from local cache (SKU, ASIN, title, price, stock FBA+MFN, fulfillment channel, velocity = avg units/day last 30d, days_cover = stock/velocity — paginated, default 50 rows, no customer data). Use velocity/days_cover for stock-out risk ("sells 3.2/day, runs out in ~4 days"). Filter channel:"FBM" for merchant-fulfilled only. NB: sorted by sales rank, so unranked FBM items appear in the last pages — use the channel filter instead of paginating.

List the standard operating procedures (SOP) saved in the user's Vendooly organization: title, schedule, number of steps, outposts it applies to. Use it to answer "what do we do every day/week" or before running a procedure. Max 10 active SOP per organization.

List the people of the user's Vendooly organization (role, status, assigned sellers, per-function permissions) and the seller ids that can be assigned to a member. Owners/admins only.

Healthcheck

Titolo conforme SENZA perdere SEO, passo 1 (solo lettura): per ogni SKU accorcia il titolo a 72 caratteri (o usa new_titles), calcola le parole di ricerca perse e le ricolloca in generic_keyword (≤250 byte, niente doppioni); quello che non entra va come frase presa pari pari dal titolo vecchio in coda al bullet più affine, o alla descrizione. MAI parole nuove. Se il taglio è già stato fatto passa original_titles (sku → titolo lungo di prima): il titolo attuale resta e si ricollocano solo le parole perse. Ritorna plan_id + anteprima prima→dopo per SKU con status ok|ready|needs_review (needs_rev…

ACTION. Reprices the given SKUs to win the Buy Box: compares your price with the Buy Box price and proposes a new one (`delta` below the Buy Box, never below `floor`). With confirm=false it returns a PREVIEW (before→after); with confirm=true it applies the prices. ALWAYS show the preview and get the user's explicit approval before calling with confirm=true.

Create (without cockpit_id) or update a cockpit of the user's organization. Owners/admins only. outpost_ids from list_clients (omit = all outposts). status=archived / active. Max 10 active cockpits.

Create (without sop_id) or update (with sop_id) a SOP of the user's organization. Owners/admins only. steps = ordered list of {title, body?, role?} (max 40). outpost_ids = the outposts it applies to (from list_clients; omit = all). status=archived archives it, status=active restores it. Max 10 active SOP: the 11th is refused with limit_reached. Show the user the title and steps before saving.

Search the Amazon catalog. IMPORTANT: use identifiers (ASIN/EAN/ISBN) for reliable, compact results. Keyword search returns up to 10 items (summaries only) and may be incomplete — prefer identifiers when you know the ASIN or EAN.

Send the user's feedback (a bug, an idea, a question or a general comment) straight to the Vendooly team — they read every one. Use it whenever the user reports a problem, is frustrated, hits an error, or suggests something. ALSO proactively OFFER to send it when something clearly is not working ("vuoi che lo segnali al team Vendooly?") and call it once they agree. Put the user's words in `message`; use `ai_context` to summarize what they were trying to do, which account/tool, and any error you saw. Confirm to the user once it is sent.

Set the monthly sales target of one outpost (seller × marketplace) for a calendar month. Owners/admins only. vat says whether the target is VAT included (inclusa, default, same basis as the data) or excluded (esclusa: the cockpit then flags it yellow because it compares different bases). status: proposto (default) | validato | concordato; changing the numbers of a validato/concordato target without passing status puts it back to proposto. Only validato/concordato targets drive the projection light. Confirm amount, month and VAT with the user before saving.

ACTION. Registra le SCATOLE del piano inbound FBA (dopo il packing confermato): per ogni packing group, le scatole con dimensioni in CM, peso in KG, quantità di scatole identiche e contenuto (SKU+quantità per scatola, salvo content_source diverso). Passo obbligatorio PRIMA di generare le opzioni di placement. Chiedi all'utente dimensioni/peso reali: Amazon le verifica in ricezione.

Titolo-SEO (SCRITTURA): rimette titolo, generic_keyword, bullet e descrizione com'erano prima di un lotto, dal registro.

Titolo-SEO: stato per l'outpost (ultimo piano con i conteggi, ultimi lotti con esito, verificato, annullabile).

Update Item Highlights on a listing. L'attributo UFFICIALE è title_differentiation (max 125 char, rollout titoli modulari 27/7/2026); item_highlights è il nome legacy visto su alcuni schema US — il tool risolve da solo quale espone lo schema del product type e scrive su quello. ATTENZIONE: non tutti i marketplace/product type lo espongono — dove manca il tool rifiuta con esito chiaro (not_supported) rimandando ai bullet_point (update_listing → bullet_point). VINCOLO Amazon: title_differentiation è accettato SOLO se il titolo (item_name) è ≤ 75 char — con un titolo più lungo il tool si ferma (t…

Modifica una listing esistente. SHORTCUT amichevoli (consigliati — costruiscono la struttura attributo corretta, niente schema SP-API a mano): bullets:[...] → bullet_point ("Funzionalità principali", la leva dei punti-elenco su amazon.it/EU, fino a 5 ~100 char l'uno), title → item_name, shipping_template → merchant_shipping_group (modello di spedizione: ID o nome esatto come in Seller Central; il tool risolve il nome nell'ID e rifiuta i nomi sconosciuti elencando i modelli veri; vale per le offerte FBM). In alternativa patches:[...] grezzi (JSON Patch SP-API, path /attributes/<nome>; la strutt…

Update MFN inventory quantity for a SKU

Update price for a SKU

READ-ONLY operational recap, aggregates only (no customer data): revenue, orders, FBA/FBM split, account health and top products by sales velocity. Use when the user asks "how did it go", "recap", "how am I doing".