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.