# Registrare un PEM

> Creazione e censimento automatico del PEM, i suoi stati, il cambio di stato e la dismissione.

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

## Registrare un PEM

Come nasce un Punto di Emissione (PEM), come viene censito presso l'Agenzia delle Entrate e quando può emettere documenti commerciali.

Cloud PEM

Punto di Emissione

Il PEM è un'entità cloud che crea, firma e concatena i documenti commerciali per conto dell'esercente. Nessun hardware o certificato da installare.

1 esercente → N PEM

Più casse

Un esercente può avere più PEM. Ognuno ha un numero seriale univoco.

### Creazione

Il primo PEM nasce con l'approvazione della registrazione dell'esercente, sulla sua sede operativa. I PEM successivi li crea Sender su richiesta dell'esercente: le API non permettono a un partner di crearne, in quanto questa è un'operazione di competenza dell'Erogatore certificato.

Il PEM riceve un **numero seriale** di undici caratteri (es. `ABCD-0012EF`): quattro che identificano l'erogatore, un trattino e sei di progressivo. È il parametro `serial_number` di tutte le chiamate sul PEM.

### Censimento automatico

Appena creato, il PEM chiede il proprio certificato all'Agenzia delle Entrate (_censimento_) e passa nello stato `In attesa`. Billy verifica l'esito ogni 30 minuti; quando il certificato arriva configura il PEM, lo porta `In servizio` e lo comunica via email al referente della sede. Non serve alcun intervento. Puoi seguire l'avanzamento con `GET /api/pem` (campo `stato`) e con le richieste del PEM (`GET …/fiscale/richieste`).

### Stati

| Stato | Significato |
| --- | --- |
| In attesa | Censimento in corso presso l'AdE. |
| In servizio | Il PEM emette documenti commerciali ed esegue la chiusura di cassa. |
| Fuori servizio | Il PEM non può emettere: guasto, impossibilità di trasmettere o scelta dell'esercente. Torna In servizio con PUT …/fiscale/stato. |
| Dismissione | Il PEM è definitivamente cessato. |

Lo stato si legge con `GET /api/pem/{serial_number}` e lo storico con `GET …/fiscale/stati`. Con lo scope `fiscale:manage` il tuo software può anche:

-   cambiare lo stato con `PUT …/fiscale/stato`: `"01"` Fuori servizio, con `motivazione` e `note` obbligatorie (vedi Modalità di emergenza per i codici), oppure `"03"` In servizio, senza motivazione;
-   dismettere il PEM con `POST …/fiscale/stato/dismissione` e il campo `note`, obbligatorio. L'operazione è definitiva ed è riservata all'esercente titolare, non a un operatore.

Pronto all'invio

Con il PEM `In servizio` e con l'access token del tuo client, puoi emettere documenti commerciali.