Kolmisoft MOR: utenti, credito e dispositivi VoIP

Scopo e prerequisiti

L’integrazione amministra dal gestionale gli utenti e i device presenti su un server Kolmisoft MOR. Consente ricerca, dettaglio, modifica, ricarica credito, creazione e gestione dispositivi e accesso contestuale al pannello MOR.

Prima dell’attivazione servono un server raggiungibile, API abilitate, un account Admin/Master o Reseller e le chiavi previste dalla propria installazione MOR. Le operazioni restano remote: dopo ogni salvataggio occorre rileggere il risultato dal server.

Impostazioni di connessione

Selezionare il ruolo, inserire l’URL base completo della directory /billing/, username, password e API Secret Key. Le chiamate vengono indirizzate agli endpoint /billing/api/... e firmate con l’hash previsto da MOR.

Il ruolo Admin/Master può vedere l’ambito concesso all’amministratore; il Reseller è limitato ai propri utenti. Non scegliere Admin per correggere un problema di visibilità: usare il ruolo reale dell’account e verificare i permessi in MOR.

UniqueHash per il reseller

Con ruolo Reseller compare UniqueHash, usato come parametro id nella registrazione utente e incluso nella firma. In MOR si trova normalmente in Settings → Setup → Settings → API, Settings → Global → Registration URL o nel percorso di accesso del reseller.

Copiare il valore senza spazi e non confonderlo con API Secret Key. Se registrazione e lettura hanno esiti diversi, controllare ruolo, proprietario dell’utente, UniqueHash e regole di firma.

Utenti MOR

L’elenco può essere filtrato per ID, username, nome, cognome, tipo e stato bloccato. Il dettaglio raccoglie anagrafica, contatti, proprietario, tariffa, LCR, valuta, fuso orario e opzioni amministrative disponibili sul server.

Prima di modificare un utente ricaricare il dettaglio e cambiare soltanto i campi necessari. Tariffa, LCR, proprietario, postpaid e credito illimitato influenzano instradamento e rischio economico e richiedono una verifica con il profilo contrattuale.

Credito e ricariche

La ricarica registra sul server l’importo e un commento destinato all’utente. Controllare valuta, segno, saldo iniziale, documento o incasso che giustifica l’operazione e saldo restituito. Non usare una ricarica per correggere alla cieca un disallineamento contabile.

Credito disponibile, postpaid e credito illimitato sono concetti distinti. Dopo l’operazione aggiornare il dettaglio MOR e riconciliare il movimento con pagamenti e prima nota secondo le procedure dell’ISP.

Dispositivi SIP

Dal dettaglio utente si elencano e creano i dispositivi associati. I dati comprendono nome, tipo device, username, host, porta, Caller ID, account code, password o secret e stato attivo; la modifica deve rispettare le capacità del server e del terminale.

Generare segreti unici, non mostrarli in screenshot e trasferirli al tecnico in modo protetto. Dopo creazione o modifica controllare registrazione SIP, chiamata uscente, chiamata entrante, presentazione del Caller ID e tariffazione.

Accesso al pannello MOR

Il comando contestuale costruisce un accesso al pannello MOR per l’utente selezionato e può aprirlo in una cornice o nuova pagina. È una sessione amministrativa: verificare utente, ruolo e dominio del server prima di proseguire.

Non condividere URL o token temporanei. Le operazioni eseguite direttamente in MOR possono cambiare dati che il gestionale mostrerà soltanto al successivo aggiornamento.

Diagnosi e checklist

Un errore di connessione può dipendere da URL senza /billing/, TLS, credenziali, Secret Key, hash o ruolo. Un elenco vuoto può invece essere corretto per un Reseller senza utenti propri. Separare sempre autenticazione, autorizzazione e assenza di dati.

• Abilitare le API sul server MOR
• Usare URL base e ruolo corretti
• Proteggere password e Secret Key
• Impostare UniqueHash solo per il reseller
• Verificare proprietario, tariffa e LCR
• Distinguere saldo, postpaid e credito illimitato
• Riconciliare ogni ricarica
• Usare segreti SIP unici
• Provare registrazione e chiamate
• Proteggere gli accessi al pannello remoto
• Rileggere lo stato dopo ogni azione