Centro risoluzione errori
MikroAPI 401: avviso di licenza e MAG, ordine dei controlli
Distingui l'avviso MAG e di licenza nella risposta MikroAPI 401 da una chiave API errata; segui i passaggi per controlli sicuri, assistenza e riavvio.
Se la risposta MikroAPI contiene un avviso relativo alla licenza o al servizio MAG, il primo passo è distinguere la condizione segnalata, prima di cambiare la password. Nella documentazione della risposta di licenza di Mikro, questa condizione è descritta sotto il numero di modello 401-05. Questo numero non è un codice di stato HTTP distinto; nell'esempio, nel corpo della risposta il campo StatusCode è 401 e IsError è true.
Primo controllo: distingui risposta HTTP ed errore applicativo
Nell'ambiente autorizzato registra l'orario della richiesta fallita, lo stato HTTP e il messaggio di errore depurato. Verifica se il corpo contiene un avviso di licenza/MAG, una chiave non valida o un messaggio diverso. Non applicare la stessa soluzione a tutti i casi basandoti soltanto su "401". Chiave API, password, dati aziendali e corpo completo della richiesta non devono comparire in screenshot o e-mail di assistenza.
| Situazione osservata | Controllo a basso rischio | Il prossimo passo |
|---|---|---|
| Avviso sul servizio licenza/MAG | Confronta la validità del servizio per l'azienda e il prodotto corretti con un registro autorizzato | Chiedi conferma al partner Mikro o al responsabile delle licenze |
| Messaggio di chiave API non valida | Verifica se l'applicazione legge la chiave dell'ambiente corretto; non stamparne il valore | Verifica la configurazione dell'accesso API con la persona autorizzata |
| Nessuna risposta | Controlla se la richiesta raggiunge il servizio API | Rivolgiti al responsabile di rete/servizio; non presumere un problema di licenza |
Quali informazioni su licenza e servizio verificare?
La descrizione ufficiale dell'errore richiama la validità del servizio MAG per il prodotto acquistato e la durata del servizio per il prodotto a noleggio. Occorre verificare insieme famiglia del prodotto, versione, azienda/esercizio e configurazione dell'accesso API del cliente. Non si presume qui un costo di rinnovo né che la stessa licenza sia sufficiente per ogni installazione; il fornitore autorizzato conferma le condizioni aggiornate.
Come verificare che il problema sia risolto?
- Dopo che la persona autorizzata ha corretto lo stato dell'accesso o del servizio, esegui nell'ambiente di test una sola lettura autorizzata che non modifichi dati.
- Verifica lo stato HTTP, ma anche il campo di errore dell'applicazione e la restituzione dei dati attesi.
- Elenca le attività in attesa. Una lettura riuscita non dimostra che gli ordini precedenti siano stati elaborati.
- Prima di riaprire la coda di scrittura, confronta i record ERP con i riferimenti esterni. Non reinviare alla cieca un ordine il cui esito dopo un timeout è sconosciuto.
Scenario di esempio: Tre ordini sono in attesa nel portale rivenditori; la risposta di uno è andata persa. Quando l'accesso viene ripristinato, si verifica prima se quell'ordine esiste nell'ERP. Se non emerge una corrispondenza e non è possibile eseguire una ricerca affidabile, l'operazione viene assegnata alla verifica umana. Anche le altre attività procedono con un numero limitato di tentativi; non si crea un ciclo continuo di richieste in presenza dell'errore di licenza.
Quando chiedere assistenza?
Se l'avviso persiste dopo la conferma dell'azienda e dell'ambiente corretti e della validità del servizio da parte della persona autorizzata, contatta l'assistenza del prodotto. Versione del prodotto/API, testo dell'errore depurato, orario e controlli eseguiti sono un punto di partenza sufficiente. Disattivare i controlli di sicurezza o scrivere direttamente nelle tabelle ERP non è una soluzione consigliata per questo avviso.
Per la connessione nel suo insieme, esamina nella guida al portale rivenditori Mikro ERP le decisioni su titolarità dei dati e accettazione degli ordini.
Fonti e verifica
Il flusso di controllo e lo scenario sono proposte architetturali; non costituiscono un test eseguito nell'ambiente reale di un cliente né una dichiarazione di partnership con il produttore. Verifica delle fonti tecniche: 17 ottobre 2026.
Affronta i problemi ricorrenti di integrazione
Una volta chiarite le responsabilità su licenza e accesso, per code, monitoraggio degli errori e deduplicazione esamina il perimetro dello sviluppo software su misura.
Parliamo delle tue esigenze →