Risolvere i problemi di autenticazione di Business Central durante l'esportazione delle spese

Perk verifica la connessione a Business Central prima di ogni esportazione delle spese. Se la connessione non è valida, l'esportazione viene bloccata immediatamente con un messaggio di errore chiaro e comprensibile, anziché interrompersi silenziosamente a metà. Questo articolo spiega i motivi per cui l'autenticazione può fallire e come risolvere ciascuno di essi.

Solo gli amministratori dell'account possono eseguire questa operazione.

Quando e dove Perk mostra errori di autenticazione

Perk esegue il controllo delle credenziali prima dell'avvio dell'esportazione, in modo che l'errore venga rilevato immediatamente, prima che qualsiasi documento venga inviato a Business Central, anziché dopo un tentativo fallito.

Esportazioni manuali — l'errore viene visualizzato come notifica toast nel momento in cui si avvia l'esportazione. La notifica include il messaggio di errore specifico, in modo da poter intervenire immediatamente.
Esportazioni automatiche — l'errore appare direttamente sulla spesa stessa, poiché non esiste un momento di attivazione manuale a cui associare una notifica. Controlla la registrazione della spesa per visualizzare l'errore di autenticazione e i passaggi successivi.

In entrambi i casi, l'esportazione viene bloccata completamente, senza errori parziali o silenziosi, e il messaggio visualizzato corrisponde a una delle cause elencate di seguito. Questo controllo convalida solo l'autenticazione. Non rileva:

Nome dell'azienda, nome del servizio web, istanza o URL di base errati.
Errori successivi all'autenticazione riuscita, come ad esempio errori nell'API da Azure AD a Business Central.
Errori nella mappatura dei dati anagrafici.

Questi problemi si manifestano come errori nei documenti di esportazione durante il processo di esportazione stesso.

Nota: Tutti questi problemi generano documenti di esportazione non riusciti nel modo consueto e non sono interessati da questa modifica.

Credenziali mancanti

Perché succede: L'ID client o il segreto client per la connessione a Business Central non sono mai stati salvati in Perk.

Cosa fare: Vai a Impostazioni > Integrazioni > Business Central e completa la configurazione delle credenziali inserendo l'ID client e il segreto client.

Configurazione del tenant di Azure AD mancante

Perché accade:

Cloud Business Central: il campo ID Tenant è vuoto nella configurazione ERP.
Business Central locale: l'ID della directory non è presente nelle credenziali.

Cosa fare:

Cloud: vai a Impostazioni > Integrazioni > Business Central [API] e verifica l'ID tenant nelle impostazioni di integrazione.
In locale: vai a Impostazioni > Integrazioni > Business Central [API] e verifica l'ID directory nella sezione credenziali.

Credenziali rifiutate da Azure AD

Perché succede: Azure AD ha rifiutato le credenziali: l'ID client o il segreto client potrebbero essere errati o scaduti, oppure la registrazione dell'app in Azure AD potrebbe essere stata eliminata. Il messaggio di errore include il codice di errore di Azure AD e la relativa descrizione.

Cosa fare:

Esamina il codice di errore di Azure AD visualizzato nel messaggio.
Vai su Impostazioni > Integrazioni > Business Central e riconnettiti utilizzando credenziali valide.
Se la registrazione dell'app è stata eliminata, creane una nuova in Azure AD e aggiorna le credenziali in Perk.

Rete o firewall bloccano il servizio di accesso di Microsoft

Perché succede: Perk non riesce a raggiungere login.microsoftonline.com: un firewall o una configurazione DNS blocca la connessione. L'errore mostra il codice di errore POSIX (ad esempio, ECONNREFUSED o ETIMEDOUT) e l'endpoint bloccato.

Cosa fare: Contatta il tuo responsabile IT o l'amministratore di rete e condividi il codice di errore e l'endpoint visualizzati nel messaggio. Assicurati che login.microsoftonline.com sia raggiungibile.

Errore imprevisto durante la verifica delle credenziali

Perché succede: Si è verificato un errore imprevisto durante il controllo, ad esempio un errore di analisi della configurazione o un'eccezione di runtime. Viene mostrato il messaggio di errore non elaborato.

Cosa fare: Prendi nota del messaggio di errore completo e contatta l'assistenza. I problemi di configurazione di Business Central (come il nome dell'azienda o il nome del servizio web) non vengono rilevati da questo controllo e potrebbero manifestarsi separatamente come documenti di esportazione non riusciti.