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.

Codariva ·

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 osservataControllo a basso rischioIl prossimo passo
Avviso sul servizio licenza/MAGConfronta la validità del servizio per l'azienda e il prodotto corretti con un registro autorizzatoChiedi conferma al partner Mikro o al responsabile delle licenze
Messaggio di chiave API non validaVerifica se l'applicazione legge la chiave dell'ambiente corretto; non stamparne il valoreVerifica la configurazione dell'accesso API con la persona autorizzata
Nessuna rispostaControlla se la richiesta raggiunge il servizio APIRivolgiti 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?

  1. 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.
  2. Verifica lo stato HTTP, ma anche il campo di errore dell'applicazione e la restituzione dei dati attesi.
  3. Elenca le attività in attesa. Una lettura riuscita non dimostra che gli ordini precedenti siano stati elaborati.
  4. 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 →