L'integrazione di Perk Spend collega Perk a Microsoft Dynamics 365 Finance (D365 Finance) in modo che oggetti di costo, tag, categorie, fornitori e dipendenti vengano sincronizzati automaticamente e spese e fatture vengano esportate nell'entità legale corretta. Questo articolo illustra l'intera procedura di configurazione, dalla registrazione dell'app in Entra ID o AD FS alla verifica della prima sincronizzazione.

Per informazioni di base su cosa sincronizza l'integrazione e come, vedere Integrazione con Microsoft Dynamics 365 Finance per l'elaborazione di spese e fatture..

Prima di iniziare

La configurazione dell'integrazione coinvolge sia l'ambiente D365 Finance che l'account Perk. Assicurati di soddisfare i requisiti elencati prima di iniziare. Requisiti di D365 Finance:

• Una versione di D365 Finance in uso (non una versione fuori servizio).
• Un sistema di contabilità fornitori completamente funzionale modulo, se stai configurando l'integrazione della fattura.
• Un sistema di gestione delle spese completamente funzionale modulo, se stai configurando l'integrazione delle spese.
• Accedi con ID (cloud) o AD FS (locale) per registrare l'applicazione.
• Accesso a LCS (Lifecycle Services) per distribuire il pacchetto di integrazione.
• I ruoli di sicurezza D365 Finance corretti assegnati ai tuoi utenti: un ruolo di responsabile dell'integrazione per gli amministratori che necessitano di accesso completo alla configurazione e un ruolo di addetto all'integrazione per le persone che necessitano solo di accesso alle operazioni quotidiane. Assegna questi ruoli tramite Amministrazione del sistema Utenti di sicurezza.

Requisiti per usufruire del vantaggio:

• Un account Perk attivo.
• Accesso amministratore account a Impostazioni Integrazioni per impostare le impostazioni di integrazione e per Persone assegnare i ruoli.
• L'ID client e il segreto client ottenuti dalla registrazione dell'app Entra ID o AD FS.

Registra l'app in Entra ID o AD FS

La registrazione di un'app fornisce a Perk un'identità sicura che può utilizzare per connettersi al tuo ambiente D365 Finance. Esegui questa operazione per prima, poiché i passaggi successivi richiedono l'ID client e il segreto client che vengono generati. Il sistema da utilizzare dipende dal tipo di implementazione: nel cloud, D365 Finance utilizza Microsoft Entra ID, mentre in locale, D365 Finance utilizza AD FS. Cloud: registra l'app in Entra ID

1. Nel portale di Azure, accedi a Microsoft Entra ID, apri Proprietà e annota l'ID directory (il tuo ID tenant).
2. Vai a Registrazioni app Nuova registrazione.
3. Inserisci un nome che identifichi l'applicazione esterna, ad esempio Integrazione PerkNon è necessario impostare un URI di reindirizzamento: questa app si autentica come client riservato utilizzando un segreto client, non tramite un reindirizzamento di accesso.
4. Copia l'ID dell'applicazione (client): ti servirà nei passaggi successivi.
5. Configura le autorizzazioni API: seleziona Aggiungi un'autorizzazione Autorizzazioni delegate Microsoft Dynamics ERP (Microsoft.ERP), quindi selezionare Accesso al servizio personalizzato Dynamics AX, Accedere ai dati di Dynamics AXe Accedere a Dynamics AX online come utenti dell'organizzazione.
6. Genera un segreto client: vai su Certificati e segreti > Nuovo segreto client e imposta la scadenza al periodo più lungo consentito dalla policy sui segreti della tua organizzazione.

In locale: registrare l'app in AD FS Se il tuo ambiente D365 Finance è locale, registra l'app con AD FS invece di Entra ID. La registrazione AD FS è specifica per la tua distribuzione locale, quindi segui le istruzioni di Microsoft documentazione per la distribuzione in locale e la configurazione AD FS della tua organizzazione per registrare l'applicazione e generare un ID client e un segreto client per essa.

Registra l'app in Dynamics 365 Finance

D365 Finance necessita di un proprio record dell'ID Entra o dell'applicazione AD FS prima di poter accettare chiamate da Perk. Questo collega l'ID client a un account di servizio all'interno di D365 Finance.

1. Vai a Amministrazione del sistema Configura Applicazioni ID Microsoft Entra Nuovo.
2. Inserisci l'ID client ottenuto dalla registrazione al tuo Entra ID o all'app AD FS.
3. Inserisci un nome per l'applicazione.
4. Selezionare l'ID utente appropriato per l'account di servizio.
5. Salva il record.

Installare il pacchetto di integrazione tramite Lifecycle Services

L'integrazione viene distribuita come pacchetto distribuibile che è necessario caricare e applicare tramite Lifecycle Services (LCS), quindi promuovere dall'ambiente di test (sandbox) alla produzione. Questo passaggio installa il codice che alimenta l'integrazione all'interno di D365 Finance. Parte 1: Caricare il pacchetto in LCS

1. Accedi lcs.dynamics.com.
2. Seleziona il progetto più adatto al tuo ambiente di destinazione.
3. Vai a Altri strumenti Libreria risorse Pacchetto software distribuibile.
4. Seleziona + per aggiungere un nuovo pacchetto e inserisci un nome e una descrizione.
5. Seleziona Aggiungi un file e caricare il file ZIP del pacchetto di integrazione.
6. Seleziona Conferma per avviare il caricamento e attendi la convalida: al termine, nella colonna Valido verrà visualizzato un segno di spunta.

Parte 2: Applicare il pacchetto al proprio ambiente

1. Apri la pagina dei dettagli dell'ambiente.
2. Vai a Mantieni Applica aggiornamenti.
3. Inserisci un nome univoco per l'aggiornamento.
4. Seleziona il pacchetto caricato dall'elenco.
5. Seleziona Applica e monitora lo stato mentre passa da In coda a In manutenzione, a Post-manutenzione, a Distribuito.

Parte 3: Promuovere l'aggiornamento in produzione

1. Nell'ambiente sandbox, vai a Cronologia Modifiche all'ambiente.
2. Seleziona l'aggiornamento convalidato.
3. Seleziona Contrassegna come candidato al rilascio.
4. Nell'ambiente di produzione, vai a Mantieni ambiente di aggiornamento.
5. Selezionare l'ambiente di test di origine e la release candidate.
6. Pianifica la finestra di inattività e seleziona Pianifica.

Impostare i parametri di integrazione in Dynamics 365 Finance

I parametri di integrazione indicano a D365 Finance con quali organizzazioni e entità legali di Perk sincronizzarsi, nonché quali dimensioni finanziarie e dati fiscali includere. È possibile impostarli a tre livelli: sistema, entità legale e parametri di integrazione globali.

1. Impostazione dei parametri di sistema: vai a Amministrazione del sistema Parametri di sistemaApri la scheda Generale, individua la sezione Integrazione e inserisci l'ID dell'organizzazione Perk.
2. Imposta i parametri dell'entità legale: vai a Amministrazione dell'organizzazione Organizzazioni Entità legaliPer ogni entità legale che utilizza l'integrazione, apri il record, individua la sezione integrazione nella scheda Generale e inserisci l'ID dell'entità legale Perk.
3. Imposta i parametri di integrazione globali: vai all'area di configurazione dei parametri di integrazione in Amministrazione organizzazione e configura quanto segue.
   • Nella scheda Generale, imposta il tipo di documento utilizzato per la creazione degli allegati tramite l'integrazione.
   • Nella scheda Dimensione finanziaria, imposta il nome della dimensione finanziaria che rappresenta i centri di costo e sposta le dimensioni che desideri sincronizzare nella casella Selezionate.
   • Nella scheda Aliquote fiscali, seleziona i gruppi di imposta sulle vendite e i gruppi di imposta sulle vendite degli articoli che desideri sincronizzare. Solo le combinazioni che imposti qui verranno sincronizzate con Perk.

Configura gli endpoint degli eventi aziendali

Gli eventi aziendali sono ciò che attiva la sincronizzazione dei dati in tempo reale da D365 Finance a Perk. È sufficiente configurare un endpoint per la maggior parte dei dati e attivare i singoli eventi aziendali necessari.

1. Vai a Amministrazione del sistema Eventi aziendali Catalogo eventi aziendali Scheda Endpoint Nuovo.
2. Imposta il tipo di endpoint su Connettore di spesae assegnagli un nome (ad esempio Endpoint di integrazione Perk) e descrizione.
3. Inserisci gli URL di autenticazione e di endpoint per il tuo ambiente (vedi sotto).
4. Aggiungi l'intestazione X-Yk-Auth-Method:yokoy Esattamente come mostrato: si tratta di un'intestazione tecnica fissa prevista dal pacchetto di integrazione, non di un nome visualizzato.
5. Inserisci l'ID client Perk e il segreto client Perk (generato in Strumenti per sviluppatori Strumenti di spesa Credenziali di accesso).

URL degli endpoint per l'ambiente di test:

• Endpoint di autenticazione: https://accounts.test.yokoy.ai/oauth2/token
• Endpoint dei dati master: https://api.test.yokoy.ai/v1
• Endpoint del fornitore: https://service.test.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

URL degli endpoint per l'ambiente di produzione:

• Endpoint di autenticazione: https://accounts.yokoy.ai/oauth2/token
• Endpoint dei dati master: https://api.yokoy.ai/v1
• Endpoint del fornitore: https://service.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Una volta configurato l'endpoint, attiva gli eventi aziendali necessari nel catalogo degli eventi aziendali:

• Per l'integrazione della fattura: evento dati fornitore, evento dimensione centro di costo, evento altre dimensioni finanziarie, evento categorie di approvvigionamento, evento conferma ordine di acquisto, evento ricezione prodotto ordine di acquisto, evento termini di pagamento ed evento aliquota fiscale.
• Per l'integrazione delle spese: l'evento relativo ai dati dei dipendenti, l'evento relativo alle categorie di spesa e l'evento relativo ai progetti. L'evento relativo alla dimensione del centro di costo e gli eventi relativi ad altre dimensioni finanziarie sono condivisi tra entrambe le integrazioni.

È possibile attivare eventi aziendali senza specificare un'entità legale: questi si attivano per ogni entità legale che disponga della configurazione di integrazione richiesta.

Eseguire la sincronizzazione iniziale dei dati

Prima di affidarti alla sincronizzazione automatica continua, esegui dei processi batch una tantum per trasferire i dati master esistenti da D365 Finance a Perk. Troverai questi processi batch nell'area di elaborazione dei processi batch dell'integrazione, nella sezione Amministrazione organizzazione. Esegui i seguenti processi batch:

• Dipendenti, categorie di spesa e progetti, se stai configurando l'integrazione delle spese.
• Sincronizzazione delle dimensioni finanziarie per centri di costo e altre dimensioni finanziarie come campi personalizzati.
• I fornitori, utilizzando l'endpoint del fornitore corretto, con Invia richiesta di test disattivato. (solo elaborazione fatture)
• Categorie di approvvigionamento, per le quali è necessario impostare prima le associazioni dei ruoli della gerarchia di categoria. (solo elaborazione fatture)
• Le aliquote fiscali, che è consigliabile programmare per l'esecuzione ricorrente, ad esempio ogni dieci minuti, poiché la sincronizzazione delle aliquote fiscali avviene solo tramite processi batch e non tramite eventi aziendali.
• Ordini di acquisto, che sincronizza solo gli ordini di acquisto confermati che hanno già un registro di conferma. (solo elaborazione fatture)
• Termini di pagamento, basati su query e con supporto per il filtraggio. (solo elaborazione fatture)
• Scontrini dei prodotti.

Configura l'integrazione in Perk

Una volta configurato D365 Finance, completa la configurazione su Perk: collega le tue entità legali e configura l'esportazione di spese e fatture.

1. Configura il codice aziendale: vai a Impostazioni Account Azienda Spesa Impostazioni Generalee inserire l'ID dell'entità legale D365 Finance in Codice azienda (ERP) per ogni entità legale di Perk. Ciò garantisce che le spese e le fatture vengano esportate nella corretta entità legale di D365 Finance.
2. Configura due campi tecnici personalizzati sull'oggetto costo, che vengono utilizzati per sincronizzare centri di costo e progetti. Vai a Impostazioni Account Aziende Spesa Impostazioni e fai clic su Aggiungi campo personalizzato Centri di costo:

1. Configura l'esportazione delle spese: vai a Impostazioni > Integrazioni > Esportazione spese, selezionare Finanza e Operazioni Dall'elenco dei sistemi ERP, immettere l'ID client e il segreto client dalla registrazione dell'app Entra ID o AD FS e selezionare Aggiorna ERP per salvare le credenziali. Quindi imposta l'URL del token e l'URL di base (l'URL del tuo ambiente D365 Finance):
   • Nuvola: L'URL del token è https://login.microsoftonline.com/{tenant-id}/oauth2/token, sostituendo {tenant-id} con il tuo ID Entra ID Directory ID. L'URL di base è l'URL del tuo ambiente cloud, ad esempio https://your-company.operations.dynamics.com..
   • In locoL'URL del token è l'endpoint del token del tuo server AD FS anziché login.microsoftonline.com. — Richiedi queste informazioni al tuo team di amministrazione di rete o AD FS. L'URL di base è l'URL del tuo server locale, ad esempio https://your-msd365f-server.yourdomain.com..

Facoltativamente, attiva Invia documenti Per inviare ricevute e allegati, Invia spesa in Finanza e Operazioni per inviare automaticamente le spese al flusso di lavoro D365 Finance, Includi le imposte in Finanza e Operazioni Esportare i campi relativi al gruppo fiscale e configurare la mappatura dei metodi di pagamento. Ripetere questa operazione per ogni tipo di spesa: spese rimborsabili, transazioni e spese di viaggio.

1. Configura l'esportazione delle fatture: vai a Impostazioni > Integrazioni > Esportazione fatture, seleziona Esportazione fatture fornitori Finanza e operazionie nella scheda Configurazione inserisci l'URL del token e l'URL di base utilizzando lo stesso schema dell'esportazione delle spese, nel cloud o in locale, a seconda della tua implementazione. Facoltativamente, attiva Invia documenti e Registra fattura in Finanza e Operazioni per registrare automaticamente le fatture. Nella scheda Autorizzazione, immettere l'ID cliente e il segreto cliente, quindi selezionare Salva per completare la procedura guidata.
2. Se si utilizzano dimensioni finanziarie come campi personalizzati, verificare Impostazioni > Gestione dei costi > Campi personalizzati per visualizzare i campi personalizzati sincronizzati.

Verifica la sincronizzazione

Dopo le prime sincronizzazioni, verifica che i dati siano stati caricati correttamente in Perk prima di andare online. Controlla ciascuna delle seguenti aree:

• Impostazioni Gestione dei costi Oggetti di costoper centri di costo e progetti.
• Impostazioni Gestione dei costi Campi personalizzati, per quanto riguarda gli aspetti finanziari.
• Impostazioni Impostazioni spese Categorie di spesa, per le categorie di spesa.
• Impostazioni Fatture dei fornitori Categorie di fattura, per le categorie di approvvigionamento.
• Persone, per i lavoratori e gli utenti.
• Fattura Fatture dei fornitori Fornitori, per i fornitori.

Se una qualsiasi di queste aree appare vuota o incompleta, torna indietro e verifica il corrispondente processo batch o evento aziendale dei passaggi precedenti prima di estendere l'integrazione al tuo team.

Risoluzione dei problemi di configurazione

Ecco alcuni potenziali problemi che potresti incontrare e come risolverli.

Gli eventi aziendali non raggiungono Perk

• Conferma che l'evento aziendale è attivato in Amministrazione di sistema Eventi aziendali.
• Verifica la configurazione dell'endpoint (URL di autenticazione, URL dell'endpoint, credenziali).
• Assicurati che all'entità legale sia stato assegnato l'ID dell'entità legale Perk.
• Esaminare il registro degli eventi aziendali per individuare eventuali errori.

La sincronizzazione iniziale non ha trasferito i dati

• Verificare che i parametri del processo batch siano impostati correttamente.
• Verifica che l'endpoint corrisponda a quello richiesto per quel job batch (i fornitori utilizzano l'endpoint del fornitore separato, con l'opzione "Invia richiesta di test" disattivata).
• Assicurati che l'account di servizio disponga di autorizzazioni sufficienti.
• Esamina la cronologia dei processi batch per i dettagli sugli errori.

Le spese o le fatture non vengono esportate

• Verifica la configurazione di esportazione in Perk (URL del token, URL di base, credenziali).
• Per quanto riguarda le spese, verificare che il dipendente disponga di una connessione utente D365 Finance valida e attiva (o di un delegato che la possieda).
• Per le fatture, verificare che il fornitore sia presente in D365 Finance.
• Esamina i log di esportazione per i dettagli dell'errore.

Le aliquote fiscali non vengono aggiornate

Le aliquote fiscali vengono sincronizzate tramite un'elaborazione batch programmata, non in tempo reale.

• Verificare che il processo batch per l'aliquota fiscale sia pianificato e in esecuzione.
• Verificare che le combinazioni Gruppo IVA / Gruppo IVA articolo siano selezionate nei parametri di integrazione.