OpNet: SIM, profili, VAS e copertura
Configurare l’API OpNet, censire e assegnare le SIM, gestire stato, profilo e servizi VAS e verificare la copertura.
Ultimo aggiornamento: 2026-08-19
Ambito del modulo
OpNet gestisce SIM e servizi mobili: inventario ICCID, associazione cliente/servizio, prima attivazione, sospensione, riattivazione, cessazione, profilo di navigazione e servizi VAS. Include inoltre un controllo copertura utilizzabile internamente o tramite script incorporabile.
Gli stati provengono dal provider e devono guidare le azioni disponibili. Non forzare localmente una SIM in uno stato diverso dall’esito remoto.
Impostazioni API e catalogo VAS
Configurare endpoint, App ID, bearer token, username e password consegnati da OpNet. I cinque valori devono appartenere allo stesso ambiente MVNO; l’endpoint è la base usata sia per la gestione SIM sia per il GIS.
Il catalogo VAS è una lista di definizioni composta da ID tecnico, descrizione leggibile e parametri ammessi. Per esempio un VAS IP può richiedere il parametro IpType con un insieme di valori concordati. ID e nomi parametro devono corrispondere esattamente al catalogo OpNet: la descrizione serve all’operatore, non viene usata al posto del codice.
Proteggere token e password e verificare raggiungibilità prima di importare SIM. Un errore di autenticazione non va compensato creando nuovi record locali.
Inserire una SIM
Nell’elenco digitare ICCID o ID SIM completo; il comando Aggiungi si abilita quando il valore raggiunge la lunghezza prevista. Il sistema controlla che la SIM non sia già presente e la interroga tramite provider.
Confrontare ICCID fisico, risposta OpNet, tipo servizio e stato. Non aggiungere numeri inventati o appartenenti a un altro tenant.
Elenco, inquiry e dettaglio
La tabella usa paginazione a cursore e consente di filtrare identificativo, stato e tipo servizio; per ogni SIM include anche i VAS memorizzati. Il dettaglio mostra stato remoto, classe servizio, cliente, VAS attivi e servizi collegati.
La funzione Inquiry interroga il provider con ID SIM e, quando disponibile, ID Record. Usarla per rileggere il dato prima di un’azione sensibile; confrontare timestamp, ICCID, record e proprietario. Lo stesso ICCID non può essere assegnato a più servizi non cessati e l’associazione è consentita soltanto al cliente proprietario della SIM.
Associare cliente e servizio
Dalla gestione SIM cercare il cliente corretto e salvare l’associazione. Il pannello elenca poi i servizi che utilizzano la SIM. È possibile rimuovere il cliente soltanto dopo aver considerato i servizi dipendenti.
Nel dettaglio di un servizio OpNet si può cambiare la SIM associata scegliendone una appartenente allo stesso cliente e non già usata altrove.
Prima attivazione
Per una SIM attivabile inserire Record ID, Area Code e tipo servizio. L’Area Code viene scelto mediante la ricerca prevista dal provider. Il comando Attiva diventa disponibile soltanto quando i dati obbligatori sono coerenti.
Confermare piano, cliente e profilo prima dell’invio. Dopo l’attivazione rileggere lo stato e non considerare concluso il processo sulla sola risposta iniziale.
Sospensione, riattivazione e cessazione
Le azioni cambiano in base allo stato: una SIM attiva può essere sospesa, cambiare profilo o VAS; una sospesa può essere riattivata; la cessazione è un’operazione distinta e definitiva secondo il contratto provider.
Prima di sospendere o cessare verificare servizio, fatturazione e richiesta cliente. Dopo l’azione controllare stato remoto e conseguenze sull’istanza commerciale.
Servizi VAS
Il pannello legge i VAS attivi e permette di aggiungere o rimuovere soltanto codici presenti nel catalogo configurato. Alcuni VAS possono richiedere parametri aggiuntivi costruiti dinamicamente.
Verificare prezzo, consenso e compatibilità prima dell’attivazione. La disattivazione richiede che il VAS sia realmente associato alla SIM.
Copertura interna e script pubblico
La verifica interna passa al GIS OpNet latitudine e longitudine. Lo script pubblico carica la configurazione dell’ISP e offre un campo e un pulsante incorporabili: si possono impostare placeholder, testo del pulsante, colori, bordi, raggi, padding e CSS aggiuntivo.
Configurare una destinazione separata per ogni Service Type OpNet e una per nocoverage. Le URL di destinazione trasformano il risultato in un percorso commerciale, ma non devono contenere credenziali; provare coordinate coperte, non coperte e non valide, su desktop e smartphone.
Il risultato GIS è una verifica tecnica del provider, non una promessa automatica di attivazione. Conservare indirizzo, coordinate e tecnologia scelti nel successivo flusso commerciale.
Servizi non fatturati e checklist
L’elenco servizi non fatturati aiuta a trovare SIM attive o collegate che non hanno una corrispondente istanza commerciale. Ogni riga va riconciliata con cliente, ordine, stato remoto e periodo.
- Configurare endpoint e credenziali OpNet
- Definire il catalogo VAS
- Verificare ICCID prima dell’importazione
- Associare la SIM al cliente proprietario
- Impedire l’uso su più servizi
- Controllare Record ID, Area Code e profilo
- Rileggere lo stato dopo ogni azione
- Distinguere sospensione, riattivazione e cessazione
- Verificare prezzo e consenso VAS
- Non trasformare la copertura in garanzia
- Riconciliare i servizi non fatturati