list_inactive_listings
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à alla data indicata → state "at_risk"). Ritorna: counts per stato, by_reason (gruppi per motivo, con gli attributi da correggere e gli SKU), items (dettaglio con action_hint) e summary pronto da leggere. Distingue "bloccato da Amazon" da "zero disponibilità" e NON inventa il motivo quando Amazon non lo dichiara: per gli SKU FBA che Amazon non motiva legge l'inventario e separa "zero pezzi in FBA" da "stock fermo/STRANDED" (merce in magazzino ma offerta non acquistabile — si sblocca dal listing, non rifornendo). Per gli STRANDED riporta la CAUSA REALE dal report Stranded Inventory di Amazon (lo stesso dato di Seller Central → "Correggi inventario stranded"): stranded.reason (es. Listing error, Listing closed, Pricing error), error_message, azione consigliata da Amazon, data in cui è diventato stranded e data di RIMOZIONE AUTOMATICA (urgenza) — reason_code FBA_STRANDED_; include anche gli SKU con merce in FBA ma offerta cancellata (from_stranded_report=true). scope: not_buyable (default) | search_suppressed | errors (tutte le issue ERROR, anche su listing ancora vendibili) | all. changed_since="YYYY-MM-DD" filtra i soli listing aggiornati da quella data — usalo dopo un caricamento a batch. COSTO: 1 chiamata SP-API ogni 20 SKU; Amazon pagina al massimo 1000 SKU per ricerca (se truncated, restringi con changed_since o scope). La correzione si fa con update_listing / bulk_update_listings sugli attributi indicati.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | not_buyable (default) = tutto ciò che il cliente non può comprare | |
| top_n | No | Quanti item dettagliati restituire (default 50); by_reason li conta comunque tutti | |
| max_pages | No | Pagine da 20 SKU da scorrere (default 25 = 500 SKU, max 50 = cap Amazon) | |
| account_id | No | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. | |
| issue_locale | No | Lingua dei messaggi Amazon (es. it_IT); default = lingua del marketplace | |
| changed_since | No | Solo listing aggiornati da questa data (YYYY-MM-DD o ISO8601) — "cosa si è rotto dopo il batch di ieri" | |
| check_fba_stock | No | Default true: legge FBA Inventory (1 chiamata) per spiegare gli SKU FBA che Amazon non motiva. false = report più rapido, quegli SKU restano "motivo non dichiarato" | |
| stranded_wait_sec | No | Attesa massima del report stranded in secondi (default 60, max 300); oltre → stranded_report.pending e si riprende al giro dopo | |
| check_stranded_report | No | Report Stranded Inventory (~20 s, riusato 20 min) per la causa reale degli stranded. Default automatico: richiesto solo se ci sono SKU stranded; true = forzalo (porta anche gli SKU stranded con offerta cancellata, invisibili alla ricerca listing); false = saltalo |