# Percorso di integrazione

> I passi dall'affiliazione al go-live: ambiente di prova, consenso dell'esercente, primo documento, passaggio in produzione.

Pagina HTML: https://app.billyssw.it/documentazione/checklist  
Indice della documentazione: https://app.billyssw.it/documentazione/index.md  
Tutta la documentazione in un file: https://app.billyssw.it/documentazione/full.md

## Percorso di integrazione

1.  **Candidati come partner**
    
    L'accesso alle API è riservato ai partner affiliati. Compila il [modulo di affiliazione](https://app.billyssw.it/affiliati/registrazione) con denominazione, partita IVA ed email, e con i dati del client OAuth del tuo software: il **nome** che l'esercente vede nella schermata di consenso e i `redirect_uri` da autorizzare (URL `https` o custom scheme per le app native, gli stessi in staging e in produzione). Dettagli nella pagina [Autenticazione](https://app.billyssw.it/documentazione/auth).
    
2.  **Ricevi codice partner e client\_id**
    
    Il supporto Sender valuta la candidatura e ti risponde all'email indicata. Se è approvata ricevi il codice partner `AFF-…`, il link di iscrizione per i tuoi esercenti e il `client_id` del tuo software, attivo in staging.
    
3.  **Prepara un esercente di prova**
    
    Registra un esercente di prova in staging. Dopo l'approvazione riceve l'email per scegliere la password; il primo punto di emissione (PEM) viene creato e censito in automatico. Vedi [Registrare un esercente](https://app.billyssw.it/documentazione/esercente).
    
4.  **Collega il gestionale**
    
    Esegui il flusso Authorization Code con PKCE: l'esercente accede e autorizza il tuo software. Con l'access token chiama `GET /api/pem` per conoscere il seriale e lo stato dei suoi PEM.
    
5.  **Testa l'integrazione**
    
    Testa le API in ambiente di staging senza inviare dati all'Agenzia delle Entrate. Per l'emissione del primo documento commerciale vedi la [Guida rapida](https://app.billyssw.it/documentazione/quickstart).
    
6.  **Go-live**
    
    Chiedi il passaggio in produzione a [api@sender.it](mailto:api@sender.it): Sender abilita il tuo software e ti comunica host e client OAuth di produzione, oggi ancora da definire. Da quel momento ogni documento emesso con `invio/dc` è un documento fiscale.
    

I tuoi esercenti aderiscono dal link di iscrizione, che porta il tuo codice nel parametro `?aff=AFF-XXXXXXXX`, oppure il gestionale invia la richiesta per loro con `POST /api/auth/register` e il campo `affiliate_code`.