Per le implementazioni on-premise di Microsoft Dynamics 365 Business Central, è necessario installare il connettore Perk Spend Management come estensione.

Attenzione: Installando il connettore Perk come estensione, è necessario essere consapevoli del fatto che non verranno forniti aggiornamenti automatici con nuove funzionalità. L'utente sarà responsabile dell'installazione e della gestione di eventuali aggiornamenti del connettore Perk.

L'estensione deve essere registrata e configurata con Microsoft Entra per consentire a Perk di accedere agli endpoint API di Business Central.

Per configurare il connettore per Business Central On Premises:

1. Installa l'estensione.
2. Configura Business Central per Microsoft Entra.
3. Configurare il connettore in Business Central.
4. Imposta l'esportazione in Perk:
   1. esportazione delle spese
   2. esportazione della fattura
5. Sincronizzare i dati master e transazionali.

Attenzione: L'edizione on-premise di Business Central potrebbe essere ospitata su server web privati ​​con accesso limitato da e verso reti non protette. Assicurarsi che le policy di sicurezza non impediscano lo scambio di traffico tra Perk e i servizi del tenant di Business Central.
In altre parole, è necessario configurare le regole del firewall, le regole di inoltro delle porte e i gateway di rete sicuri per consentire il passaggio del traffico da e verso Business Central On Premises e Perk prima di procedere alla sincronizzazione dei dati o all'avvio dell'esportazione.

Panoramica architettonica

Per lo scambio di dati tra Perk e Microsoft Dynamics 365 Business Central, l'applicazione utilizza l'autenticazione e l'autorizzazione OAuth 2.0 per proteggere il trasferimento dei dati.

Microsoft Entra viene utilizzato come provider di identità (IdP). Gestisce in modo sicuro le informazioni utente, i diritti di accesso e le relazioni di fiducia tra Business Central e Perk. Dopo che un utente si autentica (ovvero effettua l'accesso), il server di autorizzazione rilascia token di sicurezza che l'applicazione client (ovvero l'app web di Perk) utilizza per concedere, negare o revocare l'accesso all'API di Business Central (autorizzazione). Una volta che l'applicazione client dispone di token di accesso validi (accesso, ID e aggiornamento), può accedere ai dati in Business Central ed eseguire operazioni come creazione, aggiornamento o eliminazione. In altre parole, quando l'app Perk effettua chiamate API a Business Central, l'estensione verifica i token di accesso forniti e determina se consentire o negare l'accesso alle risorse richieste. Se l'accesso è consentito, Perk può quindi registrare spese o fatture.

Pertanto, è necessario configurare Microsoft Entra in modo che riconosca l'app client (Perk) e rilasci i token di sicurezza.

Installa il connettore Perk come estensione

Per installare il connettore Perk come estensione, è necessario avere accesso al pacchetto del connettore (.app). aprire una richiesta di assistenza per ottenere l'accesso al pacchetto di connettori.

Una volta ottenuto l'accesso a questo file, puoi procedere a installare l'app utilizzando Gestione delle estensioni pagina.

Il pacchetto di estensione utilizza questi intervalli di ID per gli oggetti elencati di seguito:

Nota: Gli intervalli ID sono dinamici e possono essere influenzati dalla licenza in uso.
Se si utilizzano questi intervalli di ID, potrebbe essere necessario assegnarne un altro agli oggetti del pacchetto di estensione. In caso contrario, si verificheranno dei conflitti.

Le estensioni possono essere disinstallate automaticamente dopo un aggiornamento di Business Central senza perdita di dati. Vedi Disinstallazione dell'estensione.

Configura Business Central per Microsoft Entra

Una volta installata l'estensione, è necessario registro E configuralo in Microsoft Entra per consentire a Perk l'accesso agli endpoint API di Business Central. Devi anche configurare le autorizzazioni dell'app.

Attenzione:È estremamente importante seguire i passaggi descritti nel documentazione ufficiale Microsoft, in particolare le sezioni Configura Business Central Server e Configura il componente server Web di Business Central

Per potersi fidare dei token di sicurezza emessi da Microsoft Entra, è necessario registrare la propria app. Durante la registrazione, la piattaforma assegna valori chiave, come ad esempio:

• ID applicazione (client): Chiamato anche ID applicazione o ID client, questo identificatore univoco viene assegnato alla tua app dalla piattaforma di identità. L'ID client aiuta a identificare la tua applicazione all'interno della piattaforma ed è incluso nei token di sicurezza emessi dalla piattaforma.
• URI di reindirizzamento: L'URI di reindirizzamento specifica dove il server di autorizzazione deve indirizzare l'agente utente (ad esempio, un browser web o un'app mobile) dopo aver completato il processo di autenticazione. Ad esempio, dopo che l'utente ha effettuato l'accesso, il server di autorizzazione lo reindirizza all'URI specificato. Si noti che non tutti i tipi di client richiedono un URI di reindirizzamento.

La registrazione dell'app fornisce anche gli endpoint di autenticazione e autorizzazione necessari per ottenere ID e token di accesso.

Registrare un'applicazione sul portale MS Azure

Per prima cosa è necessario registrare un'app sul portale MS Azure per il connettore Perk.
Vedere Registra un'app nella piattaforma di identità Microsoft per una guida.

Creare la definizione di base dell'applicazione configurando il Panoramica, Autenticazione, Certificati e segreti, E Autorizzazione API sezioni.

Panoramica sezione:

• Nome dell'app: Connettore Perk Business Central
• Applicazione (ID cliente): Copia questo ID, ti servirà più tardi.

Autenticazione scheda:

Clic + Aggiungi una piattaforma.

1. Selezionare Rete.
2. Entra URI di reindirizzamento:
   • https:///BC230/SignIn
   • https:///BC230/auth-response
   • https:///BC230/OAuthLanding.htm
   • https://test.yokoy.ai/oauth2/callback (test) o https://app.yokoy.ai/oauth2/callback (prod.)
3. Fai clic su Salva.

Mancia: Per aggiungere più URI di reindirizzamento, è necessario aggiungerne uno e fare clic Salva. Quindi puoi aggiungere il secondo nella schermata principale.

Permessi API sezione:

1. Clic + Aggiungi un permesso.
2. Selezionare Dynamics 365 Business Central.
3. In Permessi delegati, seleziona e aggiungi i permessi:
   • impersonificazione utente
   • Finanziari.Leggi.Scrivi.Tutto
4. In Autorizzazioni dell'applicazione, seleziona e aggiungi i permessi:
   • accesso_app
   • AdminCenter.ReadWrite.All
   • API.ReadWrite.All
5. Clic Concedi il consenso dell'amministratore per...

Certificati e segreti sezione:

Crea un nuovo client secret. Ti consigliamo di impostare una scadenza di 24 mesi. Copia il file Valore E ID segreto.

Pubblica il servizio web in Business Central

Inserisci "Applicazioni Microsoft Entra” nello strumento di ricerca globale di Business Central (angolo in alto a destra) per accedere alla configurazione dell'applicazione.

Crea l'applicazione

È necessario creare una nuova applicazione in Business Central:

1. Crea una nuova scheda di candidatura.
2. Inserisci l'ID dell'applicazione (creato nella sezione Panoramica del portale di Azure) in ID cliente.
3. Entra Vantaggi per Business Central nella Descrizione.
4. Nella sezione “Stato”, selezionare Abilitato

Assegnare le autorizzazioni utente in Business Central

È necessario configurare l'applicazione in modo che abbia permessi di super amministratore.

Più specificatamente, è necessario aggiungere questi set di autorizzazioni in Gruppi di utenti sezione nella scheda Applicazione Microsoft Entra appena creata.

Una volta completata l'installazione iniziale, gli utenti standard necessitano del set di autorizzazioni Perk BC (PERMISSIONSET YKY) per apportare modifiche successive all'integrazione e sincronizzare i dati.

Inoltre, è necessario determinare l'intervallo di ID su cui è possibile creare nuovi oggetti (ad esempio da 50000 a 55000).

Poiché l'intervallo di ID utilizzato per gli sviluppi personalizzati può variare, è importante specificare questo intervallo in quanto il pacchetto di installazione sovrascriverà tutti gli oggetti esistenti a cui è assegnato lo stesso intervallo di ID. Vedi installare il connettore come prolunga per un elenco degli intervalli di ID utilizzati nell'estensione per impostazione predefinita.

Configurare i servizi web

È necessario aggiungere i servizi Web in Business Central per ogni modulo che si intende integrare (ad esempio un servizio Web per l'elaborazione delle fatture e un altro per l'elaborazione delle spese).

Per fare ciò:

1. Vai a Servizi Web.
2. Clic + Nuovo per creare un nuovo oggetto.
3. Seleziona il Tipo di oggetto Codeunit.
4. Cerca gli ID degli oggetti in base al modulo che vuoi implementare:
   • Elaborazione delle spese: Spese di importazione YKY (63807)
   • Elaborazione fatture: Webhooks YKY (63806)
5. Inserisci un nome di servizio univoco (ad esempio Elaborazione fatture o Elaborazione spese). Assicurati che Pubblicato la casella di controllo è selezionata.

Una volta fatto questo, dovresti Configura la pagina di configurazione delle integrazioni di Perk in Business Central prima di procedere con la configurazione dell'esportazione delle spese o delle fatture in Perk.

Imposta l'esportazione delle spese in Perk

Perk si occupa di esportare i dati relativi alle spese nel libro mastro di Business Central. Le ricevute di spesa e gli allegati possono essere allegati alle registrazioni contabili secondo necessità.

Se l'azienda intende elaborare note di credito, è necessario aver abilitato le note di credito per l'entità legale.

È necessario configurare la scheda Esportazione spese (Amministrazione > Integrazioni, Esportazione spese) per inviare i dati relativi alle spese (spese, transazioni con carta, spese di viaggio) a Business Central.

Attenzione: Non è possibile utilizzare il connettore Perk per esportare separatamente le indennità giornaliere/il rimborso chilometrico.

Per fare ciò:

1. Vai su Impostazioni > Integrazioni.
2. Seleziona la scheda Esportazione spese.
3. Scegliere Business Central [API] come il sistema ERP.
4. Inserisci le credenziali di autenticazione:
   • ID directory di Azure: ID tenant di Business Central
   • ID cliente: ID client del portale MS Azure creato in precedenza
   • Segreto del cliente: segreto client del portale MS Azure creato in precedenza
5. Clic Accedi con Business Central.

Assicurati di disabilitare tutti i blocchi popup nella finestra del browser. L'autenticazione di MS Dynamics utilizza una finestra popup per inviare la richiesta di autenticazione a MS Entra.

Attenzione: Assicuratevi di selezionare il sistema ERP corretto! Ms Dynamics Cloud e MS Dynamic OnPrem sono le funzionalità di esportazione per un altro connettore MS Dynamics Business Central, non per il connettore sviluppato da Perk.

Una volta stabilita la connessione, è possibile configurare le impostazioni di esportazione:

Avviso:L'impostazione di esportazione delle spese Escludi gli oggetti di costo dall'esportazione non è compatibile con questa integrazione. L'integrazione di Perk per MS Dynamics 365 Business Central prevede sempre un oggetto di costo durante l'esportazione delle spese.

Imposta l'esportazione della fattura in Perk

Per elaborare le fatture con Business Central, Perk utilizza webhook per notificare a Business Central eventuali modifiche allo stato del documento. Perk dispone di una specifica funzionalità di esportazione delle fatture per gestire la risposta ai webhook. Attualmente, i webhook sono sincroni. Ciò significa che il fornitore deve attendere il completamento dell'elaborazione del webhook per ricevere una risposta.

Per consentire a Business Central di connettersi a Perk, è necessario configurare l'integrazione in Perk:

1. Vai su Impostazioni > Integrazioni .
2. Seleziona la scheda Esportazione fatture.
3. Inserisci questi dettagli:
   • Nome dell'esportazione: Fatture Business Central
   • Tipo di documento: Fatture fornitore
4. In Sistema scheda, seleziona Integrazione Business Central.
5. In Configurazione scheda, inserisci i dati utilizzati per formare l'URL per accedere all'API di Business Central. Devi inserire questi dati:

Devi farlo per ogni entità giuridica che si desidera collegare a un'azienda Business Central.

Avvertimento: Se si tenta di impostare più funzionalità di esportazione (ad esempio il connettore Perk insieme alle integrazioni esistenti), è possibile che venga visualizzato l'errore Validazione: applicabili più strutture di esportazione Quando si tenta di esportare una fattura, è possibile avere attiva una sola funzione di esportazione alla volta.

Mancia: Passo successivo: Impostare e sincronizzare i dati master e transazionali.