list_inactive_listings

com.vendooly/vendooly · Verify this server

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_<MOTIVO>; 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.