L'integrazione di Xero con Perk automatizza il flusso di dati per la gestione delle spese tra Perk e Xero. Importa i dati anagrafici (conti, categorie di monitoraggio, aliquote fiscali, contatti) da Xero a Perk ed esporta le spese approvate e le note di credito da Perk a Xero. Il flusso di approvazione delle spese rimane interamente all'interno di Perk.
Ruolo: Gli amministratori dell'account possono eseguire attività di configurazione.
Per configurare l'integrazione, consulta la sezione Configurare l'integrazione di Xero per le spese relative ai benefit aziendali. Per errori di esportazione e importazione, consulta la sezione Risoluzione dei problemi relativi all'integrazione di Xero per le spese relative ai benefit aziendali.
Cosa fa l'integrazione
L'integrazione di Xero con Perk mantiene sincronizzati i dati relativi alle spese tra i due sistemi, consentendo al team finanziario di lavorare con un'unica fonte affidabile. Perk preleva i dati di riferimento da Xero e li reinserisce, mentre il flusso di approvazione delle spese rimane interamente all'interno di Perk.
- Importa (da Xero a Perk): piano dei conti, categorie di monitoraggio, aliquote fiscali e contatti.
-
Esporta (Perk to Xero): spese approvate e note di credito. La registrazione in Xero dipende da come è stata pagata la spesa:
- Spese pagate privatamente (rimborsabili): fatture approvate.
- Note di credito pagate privatamente: crediti fornitori approvati.
- Carta aziendale e spese di viaggio: Spese bancarie.
- Carta aziendale e note di credito di viaggio: Ricezione di transazioni bancarie.
È possibile collegare un solo tenant Xero per ogni azienda Perk (entità legale). Le connessioni vengono effettuate per singola azienda, pertanto un account (entità di livello superiore) con diverse aziende esegue una configurazione separata per ciascuna di esse.
Come Perk e Xero mappano i dati
| Dati Xero | Mappe per in Perk | Note |
|---|---|---|
| Conto Xero (piano dei conti) | Categoria di spesa | È possibile importare qualsiasi tipo di conto Xero (Spese, Banca, Entrate, Attività, Passività, altri). |
| Categoria di tracciamento Xero | Oggetto di costo o campo personalizzato | Scelto per categoria durante la configurazione. Xero supporta fino a due categorie di monitoraggio. |
| Aliquota Xerotassa | Aliquota fiscale di Perk | Importato con nome, percentuale e codice IVA. |
| Contatto Xero | Utente Perk | Abbinamento tramite email. L'utente deve già essere presente in Perk. |
| Conto carta di credito Xero | Carta aziendale Perk | La carta aziendale deve essere creata prima in Perk. |
Una categoria di spesa è il campo in cui una spesa viene codificata in Perk. Un oggetto di costo è un valore che i dipendenti scelgono quando codificano una spesa; determina l'allocazione dei costi e il percorso di approvazione. Un campo personalizzato memorizza una classificazione secondaria della spesa.
L'integrazione richiede le seguenti autorizzazioni in Xero:
- Leggi: Account, Informazioni aziendali, Contatti, Articoli, Allegati, Categorie di tracciamento, Aliquote fiscali.
- Scrivere: Fatture, Conti, Allegati, Spese, Note di credito ai fornitori.
Se desideri maggiori dettagli tecnici su come viene mappato ciascun campo in Perk, consulta la sezione "Scambio di dati (mappatura tecnica dei campi)" alla fine di questo articolo.
Come funziona la sincronizzazione
Dopo la prima importazione, Xero e Perk rimangono sincronizzati quasi in tempo reale. Le modifiche apportate in Xero vengono trasmesse a Perk tramite webhook, solitamente in pochi secondi. Una riconciliazione notturna alle 00:00 UTC individua eventuali anomalie non rilevate dai webhook. Ogni sincronizzazione è una sincronizzazione incrementale: considera solo i record modificati in Xero. Le spese vengono esportate in Xero in tempo reale, tramite un trigger manuale o automatico.
Poiché la sincronizzazione è basata sulle modifiche incrementali, una modifica che non viene registrata in Xero non viene rilevata. Ad esempio: l'aggiunta di un utente Perk il cui contatto Xero esiste già non verrà associata, perché non è stata apportata alcuna modifica al contatto. Consultare la sezione "Aggiunta di nuovi dipendenti dopo la configurazione" nell'articolo sulla configurazione.
| Tipo di dati | Prelevato | Non raccolto | attributi aggiornati | Non aggiornato |
|---|---|---|---|---|
| Account | Nuovo account (importazione automatica se hai selezionato l'intero tipo); rinomina; account deselezionato nelle impostazioni di importazione (diventa inattivo in Perk). | Account eliminato o archiviato in Xero (rimane attivo in Perk finché non lo disattivi). Un nuovo account in una tipologia in cui hai selezionato singoli account (aggiungilo manualmente). | Nome; stato attivo/inattivo. | Codice ERP modificato in Perk (l'esportazione utilizza un ID interno). |
| Categorie di tracciamento | Nuovo valore di opzione in una categoria mappata; categoria o opzione rinominata. | Categoria o opzione eliminata o archiviata in Xero. È stata aggiunta una nuova categoria di monitoraggio dopo la configurazione (vai a Impostazioni di importazione > Modifica per associarla). | Nome; valori delle opzioni. | Il tipo di mappatura (oggetto di costo vs campo personalizzato) è fisso in fase di configurazione. Gli approvatori dell'oggetto di costo vengono impostati manualmente in Perk. |
| Aliquote fiscali | Nuova tariffa attiva (sempre importata automaticamente); tariffa deselezionata, eliminata, disattivata o archiviata; modifica del nome o della percentuale. | Nessuno. È stata rilevata la cancellazione dell'aliquota fiscale. | Nome; tariffa; stato. | Nessuno. |
| Utenti (contatti) | Nuovo contatto Xero corrispondente a un indirizzo email di un utente Perk; qualsiasi modifica a un contatto esistente (rivaluta la corrispondenza); contatto disattivato (l'utente diventa inattivo). | Nuovo utente Perk il cui contatto Xero esiste già e non è stato modificato (modifica un qualsiasi campo del contatto per attivare la corrispondenza). Gli utenti non vengono creati da Xero. | Nome; cognome; stato; ID contatto. | E-mail (la chiave di corrispondenza; aggiornare entrambi i lati manualmente). Limiti di approvazione, responsabili di linea, oggetti di costo predefiniti (impostati in Perk). |
Buono a sapersi
- I dati Xero eliminati o archiviati non vengono rilevati. L'eliminazione o l'archiviazione di un account o di una categoria di monitoraggio in Xero non disattiva la categoria di spesa, l'oggetto di costo o il campo personalizzato corrispondenti in Perk. Disattivarli manualmente. Una spesa registrata su un account eliminato in Xero non viene esportata. Le eliminazioni delle aliquote fiscali vengono rilevate.
- I record creati manualmente non hanno un collegamento con Xero. Le categorie di spesa, gli oggetti di costo e i campi personalizzati creati manualmente in Perk non vengono abbinati in modo inverso. Le esportazioni che utilizzano una categoria o un oggetto di costo manuale non vanno a buon fine; il valore di un campo personalizzato manuale viene omesso dall'esportazione.
-
Le spese con carta e di viaggio vengono registrate come non riconciliate. Xero crea sempre le transazioni bancarie di Spend Money come non riconciliate e solo le app nella sua categoria API "conversione" (migrazione una tantum) possono impostare
IsReconciled. Xero inoltre non espone i dati degli estratti conto bancari non riconciliati tramite la sua API pubblica. Riconcilia queste transazioni manualmente in Xero. Questo è il comportamento previsto di Xero, non una lacuna di integrazione. - Fatture dei fornitori. L'esportazione delle fatture dei fornitori di Perk in Xero non è supportata.
Scambio di dati (mappatura dei campi tecnici)
Dati principali (da Xero a Perk)
Utenti
Gli utenti di Perk si sincronizzano con i contatti di Xero. L'utente deve prima essere presente in Perk. L'indirizzo email è l'identificativo univoco e deve essere identico in entrambi i sistemi. Se l'indirizzo email di un contatto Xero cambia, aggiornalo anche in Perk.
| Dati di contatto Xero | Dati utente di Perk | Descrizione |
|---|---|---|
| Indirizzo e-mail | Indirizzo e-mail | Identificativo univoco durante la sincronizzazione. |
| Nome | Nome | Xero Nome diviso al primo spazio. |
| Nome | Cognome | Il nome Xero è diviso in corrispondenza dell'ultimo spazio. |
| stato del contatto | Stato | Gli elementi eliminati o archiviati in Xero diventano inattivi in Perk. |
Aliquote fiscali
Le aliquote fiscali di Perk si sincronizzano con le aliquote fiscali di Xero. Per le aliquote selezionate (sincronizzate automaticamente), la sincronizzazione aggiorna nome, aliquota e stato alla successiva esecuzione.
| Dati sull'aliquota fiscale di Xero | Dati sull'aliquota fiscale di Perk | Descrizione |
|---|---|---|
| Nome | Nome | Verrà aggiornato al prossimo aggiornamento in caso di modifiche. |
| Codice | Codice ERP | Identificativo univoco durante la sincronizzazione. |
| Aliquota fiscale totale o aliquota fiscale effettiva | Importo dell'imposta | Percentuale dell'aliquota. Se entrambe le aliquote sono utilizzate in Xero, si applica l'aliquota più alta. |
| Stato | Stato | Attivo alla sincronizzazione iniziale. Eliminato, disattivato o archiviato in Xero, diventa inattivo in Perk. Anche la deselezione di una tariffa nelle impostazioni di importazione la disattiva. |
Carte aziendali
Le carte aziendali Perk si sincronizzano con gli account Xero di tipo Banca e di tipo Carta di credito. La carta deve prima essere registrata in Perk. Dopo la configurazione, solo le modifiche di stato sull'account della carta di credito Xero vengono aggiornate in Perk.
| Dati della carta di credito Xero | Dati della carta aziendale Perk | Descrizione |
|---|---|---|
| Stato | Stato | Gli elementi eliminati in Xero diventano inattivi in Perk. |
| Codice conto bancario | Numero del creditore | Identificativo univoco durante la sincronizzazione. |
Oggetti di costo (categorie di monitoraggio)
Una categoria di monitoraggio mappata come oggetto di costo viene sincronizzata con un oggetto di costo Perk. Le categorie attive vengono importate come attive, quelle archiviate come inattive. Ogni opzione viene importata come valore di un oggetto di costo; le nuove opzioni sotto una categoria mappata vengono importate alla successiva sincronizzazione.
| Dati della categoria di tracciamento Xero | Dati dell'oggetto Costo del vantaggio | Descrizione |
|---|---|---|
| Nome | Nome | Nome della categoria di tracciamento. |
| Nome dell'opzione | Valore dell'oggetto di costo | Un solo valore per opzione. |
| Stato | Stato | Le cancellazioni e gli archivi in Xero non vengono rilevati. |
Campi personalizzati (categorie di monitoraggio)
Una categoria di tracciamento mappata come campo personalizzato crea un nuovo campo personalizzato Perk con il suo nome. Ogni opzione viene importata come valore.
| Dati della categoria di tracciamento Xero | Dati del campo personalizzato Vantaggio | Descrizione |
|---|---|---|
| Nome | Nome del campo personalizzato | Viene creato un nuovo campo personalizzato con il nome della categoria. |
| Nome dell'opzione | Valore del campo personalizzato | Un solo valore per opzione. |
| Stato | Stato | Se il tuo account è inattivo in Xero, significa che è inattivo anche in Perk. Le cancellazioni e gli archivi non vengono rilevati. |
Categorie di spesa (conti)
Gli account Xero corrispondono alle categorie di spesa di Perk. Puoi scegliere quali account importare durante la configurazione. Solo gli account attivi vengono importati alla prima sincronizzazione. Un account rinominato viene aggiornato alla sincronizzazione successiva. L'esportazione utilizza un ID interno, non il codice ERP.
| Dati dell'account Xero | Dati relativi alle categorie di spesa per benefit aziendali | Descrizione |
|---|---|---|
| Nome | Nome | Il nome dell'account. |
| Codice | Codice ERP | Codice definito dal cliente, ad esempio 200 o VENDITE. |
| ID account | uso interno | Identificativo univoco durante la sincronizzazione. |
| Stato | Stato | Deselezionando un account nelle impostazioni di importazione, questo viene disattivato. Le eliminazioni e gli archivi in Xero non vengono rilevati. |
Esporta (Vantaggio per Xero)
Spese pagate privatamente
Le spese rimborsabili vengono esportate come fatture approvate. Le note di credito vengono esportate come note di credito fornitore approvate.
| Campo Xero | Dati sulle spese relative ai benefit | Descrizione |
|---|---|---|
| Tipo | n/d |
ACCPAY (spesa) o ACCPAYCREDIT (nota di credito). |
| Totale | Importo totale della richiesta di rimborso spese | Calcolato prima dell'esportazione dalla valuta di spesa e dalla configurazione della valuta di esportazione. |
| Stato | n/d |
AUTORIZZATO. |
| Da (contatto) | Inviante | Identificativo interno mappato all'utente Xero. |
| Importo per riga | Importo (per voce) | Calcolato tramite la funzionalità di registrazione contabile di Perk. |
| Conto (per singola voce) | Categoria per riga | |
| Categoria (intestazione) | n/d | Xero ricava queste informazioni dall'identificativo interno dell'oggetto costo o dal campo personalizzato, a seconda della mappatura. |
| Valore nella colonna Categoria (per ogni riga) | Nome dell'oggetto di costo | |
| Aliquota fiscale (per voce) | Importo dell'imposta | |
| Imposta totale | n/d | Calcolato in Xero in base all'importo e al tipo di imposta. |
| Riferimento | ID spesa | ID spesa benefit. |
| Descrizione (per ogni voce) | Nome del commerciante | |
| Data | Data di pubblicazione | |
| Importo Valuta | n/d | In base alla configurazione della valuta di spesa e della valuta di esportazione. |
| Scadenza | Data di spesa |
Transazioni con carta
Le transazioni con carta aziendale vengono esportate come transazioni bancarie Spesa. Le note di credito della carta vengono esportate come Ricezione.
| Dati Xero | Dati sulle spese relative ai benefit | Descrizione |
|---|---|---|
Conto (tipo BANCA, tipo di conto CARTA DI CREDITO) |
Carta aziendale | Identificativo interno mappato all'account della carta di credito Xero. |
| Data | Data di spesa | |
| Spendere vs ricevere denaro | n/d |
SPEND per le spese ordinarie, RECEIVE per le note di credito. |
| A | Inviante | Identificativo interno mappato all'utente Xero. |
| Importo per riga | Importo (per voce) | Calcolato tramite la funzionalità di registrazione contabile. |
| Conto (per singola voce) | Categoria per riga | |
| Categoria (intestazione) | n/d | Dall'oggetto costo o dall'identificativo del campo personalizzato. |
| Valore nella colonna Categoria (per ogni riga) | Nome dell'oggetto di costo | |
| Aliquota fiscale (per voce) | Importo dell'imposta | |
| Prezzo unitario (per articolo) | Importo netto (per voce) | Calcolato tramite la funzionalità di registrazione contabile. |
| Imposta totale | n/d | Calcolato in Xero. |
| Riferimento | ID spesa | |
| Descrizione (per ogni voce) | Nome del commerciante | |
| Importo Valuta | n/d | In base alla configurazione della valuta di spesa e della valuta di esportazione. |
Spese di viaggio
Esportazione delle spese di viaggio come transazioni bancarie Spendi denaro. Esportazione delle note di credito di viaggio come Ricevi denaro. Stessi campi delle transazioni con carta, ad eccezione del conto:
| Dati Xero | Dati sulle spese per i benefit | Descrizione |
|---|---|---|
Conto (tipo BANCA, tipo di conto BANCA) |
Trasferimento conto (configurazione fornitore di viaggi) | Il valore del conto di trasferimento corrisponde a un codice di categoria di spesa ERP in Perk. |
Valuta e tasse
A seconda della strategia di contabilizzazione impostata nelle impostazioni aziendali, Perk esporta ogni spesa nella valuta aziendale, nella valuta della ricevuta originale o nella valuta dell'utente. Perk invia l'aliquota fiscale selezionata e Xero calcola l'imposta.