Percorso di integrazione

Candidati come partner
L'accesso alle API è riservato ai partner affiliati. Compila il modulo di affiliazione 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.
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.
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.
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.
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.
Go-live
Chiedi il passaggio in produzione a 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.