Per le implementazioni di Microsoft Dynamics 365 Business Central Cloud, puoi scegliere di installare Perk Spend Management Connector da AppSource o 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 Cloud:

1. Installare l'estensione da AppSource o come un'estensione.
2. Configurare il servizio Web in Business Central Cloud.
3. Configurare il connettore in Business Central.
4. Imposta l'esportazione in Perk:
   • esportazione delle spese
   • esportazione della fattura
5. Sincronizzare i dati master e transazionali.

Installa il connettore Perk da Microsoft 365 Dynamics App Source

Per installare il connettore Perk, cercare estensione nell'AppSource digitando Perk e cliccando Ottienilo ora.

In questo modo l'estensione verrà installata nel tenant di Microsoft 365 Dynamics Business Central.

Installa il connettore Perk come estensione

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

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 di ID sono dinamici e possono essere influenzati dalla licenza del cliente.
Se il cliente utilizza questi intervalli di ID, potrebbe essere necessario assegnarne un altro per gli 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.

Configurare il servizio Web in Business Central per Cloud

Poiché Business Central è responsabile del recupero dei dati da Perk, è necessario creare il servizio Web in Business Central per gestire questo processo.

1. Registrare un'applicazione sul portale MS Azure.
2. Pubblicare il servizio Web sulla pagina del servizio Web in Business Central.
3. Assegnare le autorizzazioni appropriate in Business Central.

Attenzione: Assicurati di disabilitare l'aggiornamento sandbox se stai installando l'estensione in un ambiente di test. In caso contrario, dovrai riconfigurare l'estensione dopo ogni aggiornamento.

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://businesscentral.dynamics.com/OAuthLanding.htm
   • https://businesscentral.dynamics.com/
   • https://test.yokoy.ai/oauth2/callback (test di vantaggio) o https://app.yokoy.ai/oauth2/callback (Prodotto vantaggioso)
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 applicazione (creato nella sezione Panoramica del portale di Azure) In ID cliente.
3. Entra Vantaggi per Business Central nella Descrizione.
4. In "Stato", seleziona 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 hanno bisogno di Set di autorizzazioni Perk BC (SET DI AUTORIZZAZIONI YKY) per apportare eventuali modifiche successive all'integrazione e sincronizzare i dati.

Successivamente, dovresti configurare la pagina di configurazione delle integrazioni Perk in Business Central prima di continuare a configurare l'esportazione delle spese o delle fatture in Perk.

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 (3110567)
   • Elaborazione delle fatture: Webhook YKY (3110566)
5. Inserisci un nome di servizio univoco (ad esempio Elaborazione fatture o Elaborazione spese). Assicurati che Pubblicato la casella di controllo è selezionata.

Imposta l'esportazione delle spese in Perk

Perk è responsabile dell'esportazione dei dati di spesa nel libro mastro di Business Central. Le ricevute di spesa e gli allegati possono essere allegati alle registrazioni contabili secondo necessità. Se l'azienda prevede di elaborare note di accredito, è necessario abilitare le note di accredito per la persona giuridica.

È necessario impostare la scheda Esportazione spese (Amministrazione > Integrazioni, Esportazione spese) per inviare i dati delle spese (spese, transazioni con carta, spese di viaggio) a Business Central. Non è possibile utilizzare il connettore Perk per esportare separatamente le indennità giornaliere/chilometraggio.

Per fare ciò:

1. Vai su Impostazioni > Integrazioni.
2. Seleziona il Esportazione delle spese carta di integrazione.
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:

Impostazione dell'esportazione delle spese Escludi oggetti di costo dall'esportazione non è compatibile con questa integrazione.
L'integrazione Perk per MS Dynamics 365 Business Central prevede sempre un oggetto di costo quando si esportano le 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 il Esportazione fatture carta.
3. Nel Esportazioni di fatture scheda, fare clic Avvia procedura guidata.
4. Inserisci questi dettagli:
   • Nome dell'esportazione: Fatture Business Central
   • Tipo di documento: Fatture fornitore
5. In Sistema scheda, seleziona Integrazione Business Central.
6. 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.