> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Conduit right-sizing: staccare l'operatività senza chiudere il contratto

> Ultimo stadio del dunning Conduit: quando uno studente non paga da tempo, si riduce il numero di appartamenti attivi fino a 1 per togliergli l'operatività senza chiudere il contratto. Si tiene così finché non paga, poi si ripristina da backup.

Il right-sizing è lo **stadio finale** della procedura di mancato pagamento (dunning). Serve quando uno studente **non paga da un tot di tempo** e i passaggi soft non hanno sbloccato la situazione. Il contratto del **Servizio AI Ospiti non si chiude per morosità**: le condizioni le regola l'Addendum, e non stanno qui. Quello che si può fare è **togliere l'operatività mantenendo il contratto**: si riduce il numero di appartamenti attivi **fino a 1**, lo si tiene così **finché non paga**, e poi si **ripristina tutto da un backup**.

<Note>
  Questa pagina è la coda di [Mancato pagamento](/delivery/mancato-pagamento): lì trovi la scala completa (banner → email → sospensione al giorno 7 → holding dell'agente). Il right-sizing arriva **dopo** quegli stadi, non al posto loro.
</Note>

## Perché si fa così

Chiudere il servizio per morosità sarebbe la scelta peggiore per entrambi. Il right-sizing separa le due cose:

* **Contratto** → resta in piedi, con quello che ne consegue sul piano amministrativo (i termini sono nell'Addendum, non in questa pagina).
* **Operatività** → si azzera nei fatti, perché l'agente resta attivo su **un solo appartamento** invece che su tutto il portafoglio dello studente.

<Warning>
  Il right-sizing è una **leva dura** su un servizio dal vivo. Si attiva **solo** dopo gli stadi precedenti del dunning e **solo dietro conferma esplicita della direzione**. In caso di dubbio su un singolo studente, **non forzare**: segnala e attendi conferma.
</Warning>

## Trigger (quando scatta)

Tutte queste condizioni devono essere vere:

1. Lo studente è **passato per gli stadi precedenti** del dunning (reminder → sospensione → holding dell'agente) e **continua a non pagare da un tot di tempo**.
2. **Mancato pagamento / morosità confermata** (non un semplice ritardo tecnico: nessuna Esenzione o Sconto attivo per quel caso).
3. **Conferma esplicita della direzione.** Nessun automatismo esegue il right-sizing.

<Info>
  Se lo studente è **attivo e sta pagando** (o c'è un problema tecnico in corso), **non si tocca**: prima la scala soft del dunning, mai il right-sizing come scorciatoia.
</Info>

## I passi: BACKUP → riduci a 1 → hold → ripristina

<Steps>
  <Step title="1 · BACKUP di tutto ciò che c'è dentro">
    Prima di ridurre qualsiasi cosa, fai lo **snapshot completo** del workspace Conduit dello studente, così il ripristino è fedele al 100%:

    * **KB per-listing** (cartelle, `entity_ids`, articoli) di ogni appartamento
    * **Skill** e **custom tool** per-listing (mapping tool ↔ skill)
    * **Workflow**, **guardrail** e configurazione agente
    * Elenco dei **listing attivi** (`list_listings`) con il loro `listing_id` e `isActive`

    Questo backup è ciò da cui ripristinerai: senza, la riattivazione è un rimontaggio a mano. Salvalo (export/note) e registralo nel record billing dello studente.
  </Step>

  <Step title="2 · Riduci a 1 appartamento attivo">
    Porta i listing dello studente a `isActive: false` **lasciandone uno solo** come riferimento. Si può fare via MCP con `set_listing_active` (anteprima con `dry_run: true`, poi applica; audit loggato) **oppure** a monte in KrossBooking (delisting dell'unità, che si propaga a Conduit come `isActive: false`) o dalla UI Conduit.

    <Warning>
      `isActive: false` da solo **non ferma l'assistente**: è un bug Conduit confermato, vedi [Troubleshooting](/integrazioni/conduit/troubleshooting#bug-noti). Il portafoglio ridotto resta esposto (Airbnb/Booking/PMS) finché non applichi anche l'interruttore AI per-listing in Settings → Listings del pannello Conduit (non è raggiungibile via MCP), o almeno un guardrail-tampone con l'elenco dei listing spenti.
    </Warning>

    Scendere a 1 listing attivo è ciò che stacca l'operatività **e** ferma l'accumulo sul portafoglio.
  </Step>

  <Step title="3 · Conferma la sub con Conduit ops">
    L'abbassamento reale della sottoscrizione **non è auto-verificabile via MCP**: il billing è gestito a livello di account partner. Scrivi a **Conduit ops** per farti confermare che il conteggio fatturabile è sceso davvero. Le condizioni dell'accordo partner stanno nel repo interno.
  </Step>

  <Step title="4 · Hold finché non paga">
    Lasci lo studente **a 1 appartamento** finché non regolarizza. Il contratto resta valido, l'arretrato resta dovuto: registra lo stato nel record billing così la posizione amministrativa non si perde. Nel frattempo l'agente lavora solo sull'appartamento di riferimento.
  </Step>

  <Step title="5 · Ripristina dal backup (al pagamento)">
    Appena lo studente paga, **riabiliti gli appartamenti in KrossBooking** → si ri-sincronizzano su Conduit come `isActive: true` → **ri-verifichi il mapping** KB / skill / tool per-listing usando lo snapshot dello **Step 1**. Da lì riprende la normale fatturazione per-listing. La procedura è **reversibile**: il backup garantisce che lo studente ritrovi KB, skill, tool e workflow come prima.
  </Step>
</Steps>

<Warning>
  **Sospensione ≠ risparmio.** Un listing messo in stato "SOSPESO" continua a pesare: non azzera la spesa. Se l'obiettivo è togliere operatività **e** fermare il costo, serve la **disattivazione piena** (`isActive: false`), non la sospensione.
</Warning>

## Reversibilità

Il right-sizing è **completamente reversibile**: nulla viene cancellato in modo distruttivo. Il portafoglio dello studente vive nel **backup** (Step 1) e negli appartamenti disattivati (non eliminati) su KrossBooking. Riabilitare in Kross + ri-verificare il mapping dallo snapshot riporta lo studente esattamente com'era.

## Chi si notifica

| Destinatario | Perché |
| - | - |
| **Direzione** | Deve **confermare prima** che si esegua: è una leva dura. Il canale su cui avvisare è quello concordato nel team. |
| **Conduit ops** | **Obbligatorio**: sono loro a confermare che la sottoscrizione è scesa davvero. |
| **Studente** | Solo se la riduzione è concordata; altrimenti la comunicazione resta quella standard del dunning. |

<Note>
  **Nota operativa.** Registra il right-sizing nel record billing dello studente insieme al backup: è ciò che tiene tracciato l'arretrato dovuto e permette il ripristino fedele. Il right-sizing ha senso **solo** su studenti morosi/churned confermati — mai su un workspace attivo e in stagione: ridurre lì taglierebbe l'AI Ospiti su proprietà vive.
</Note>

<Tip>
  **▷ Prompt Claude Code: Right-sizing Conduit (studente moroso)**  ·  incolla in Claude Code:
</Tip>

```text theme={null}
Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa LEGGI le pagine mattone-docs /integrazioni/conduit/right-sizing e
/delivery/mancato-pagamento (leggile davvero, non a memoria); per i dati veri usa
l'MCP Conduit (list_workspaces, list_listings, get_billing_usage) col token partner.
Poi procedi:

Guidami nel right-sizing dello studente [NOME], ULTIMO stadio del dunning.
PRIMA verifica i trigger: (1) è passato per reminder+sospensione+holding e non
paga da tempo? (2) morosità confermata (nessuna Esenzione/Sconto attivo)? (3) ho
la conferma della direzione? Se anche uno solo manca, FERMATI e dimmelo.
Se OK: (1) fai lo SNAPSHOT completo (list_listings + KB/skill/tool/workflow
per-listing) per il ripristino e dimmi dove l'hai salvato; (2) elenca i listing
da portare a isActive:false lasciandone 1 di riferimento (via set_listing_active
con dry_run:true come anteprima, o a monte in KrossBooking); (3) ricordami che
isActive:false da solo NON ferma l'assistente su quei listing (bug Conduit
confermato) e che serve anche l'interruttore AI per-listing in Settings → Listings
(solo UI, non via MCP) o almeno un guardrail-tampone con l'elenco dei listing;
(4) preparami il messaggio per Conduit ops per confermare l'abbassamento sub +
assenza minimi; (5) dimmi cosa registrare nel record billing (stato hold +
arretrato dovuto).
NON eseguire disattivazioni: preparami i passi, li confermo io.
```

<CardGroup cols={2}>
  <Card title="Mancato pagamento (la scala completa)" icon="arrow-up-right-from-square" href="/delivery/mancato-pagamento">Banner → email → sospensione → holding → right-sizing</Card>
  <Card title="KrossBooking (dove si disattiva il listing)" icon="arrow-up-right-from-square" href="/integrazioni/kross/panoramica">Il delisting a monte propaga isActive:false a Conduit</Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.