Xero-integraatio
Ohjeet Xero-kirjanpitojärjestelmän yhdistämiseen Caleidoon OAuth2-todennuksella sekä tilikausiasetusten konfigurointiin.
Xero on kansainvälisesti käytetty pilvikirjanpitojärjestelmä. Caleidon Xero-integraatio käyttää OAuth2-todennusta, joten API-avaimen sijasta kirjaudutaan suoraan Xeron kautta.
Edellytykset
- Aktiivinen Xero-tili
- Oikeudet Xero-organisaation kirjanpitodataan
- Organisaation pääkäyttäjäoikeudet Caleidossa
Integraation käyttöönotto
Avaa integraatioasetukset
Siirry Caleidossa kohtaan Asetukset → Integraatiot.
Valitse Xero
Valitse integraatiolistasta Xero ja valitse Yhdistä Xero.
Salli käyttöoikeus Xerossa
Sinut ohjataan Xeron kirjautumissivulle. Kirjaudu Xero-tunnuksillasi ja valitse Salli, kun Xero pyytää Caleido-sovellukselle pääsyä tiliisi.
Caleido pyytää vain lukuoikeutta kirjanpitodataasi. Caleido ei muokkaa Xeron tietoja.
Valitse organisaatio
Jos sinulla on useampi Xero-organisaatio (tenant), valitse se, jonka datan haluat tuoda Caleidoon.
Vahvista synkronoitavat tilit
Ensimmäinen synkronointi pysähtyy vaiheeseen AWAITING_ACCOUNTS. Tarkista tilit ja hyväksy synkronointi jatkaaksesi.
Odota valmistumista
Synkronointi etenee tilaan IN_PROGRESS ja lopulta FULL. Tapahtumat alkavat synkronoitua Caleidoon.
Xero-integraatio on valmis. Kaikki tapahtumat ovat nyt saatavilla Caleidossa.
Tilikausiasetus
Xero-integraatiossa voit konfiguroida Xeron tilikauden päättymispäivän, joka vaikuttaa siihen, miten Xeron data tulkitaan.
Sijainti: Asetukset → Integraatiot → Xero
| Asetus | Oletusarvo | Kuvaus |
|---|---|---|
| Tilikauden päättymisPäivä | 31 | Tilikauden viimeinen päivä |
| Tilikauden päättymiskuukausi | 12 (Joulukuu) | Tilikauden viimeinen kuukausi |
Jos organisaatiosi tilikausi ei pääty joulukuun lopussa, muuta nämä asetukset vastaamaan Xeron tilikausirakennetta.
Tracking categories – dimensiot Caleidossa
Xeron tracking categoryt tuodaan dimensioina Caleidoon, aivan kuten Procountorin ja Netvisorin kustannuspaikat. Jokainen aktiivinen tracking category ja sen arvot näkyvät Caleidossa dimensioina ja dimensiokohteina.
Tracking categoryt siirtyvät dimensioina vain, jos ne ovat aktiivisina Xerossa ja liitettyinä kirjauksiin. Jos kategoriat puuttuvat Caleidosta, suorita synkronointi uudelleen.
Useampi Xero-organisaatio
Caleidossa yhdellä Caleido-organisaatiolla voi olla integraatio yhteen Xero-organisaatioon. Jos haluat tuoda dataa useammasta Xero-organisaatiosta, luo kustakin erillinen Caleido-organisaatio.
Tunnisteiden hallinta
Xeron OAuth2-integraatio käyttää access- ja refresh-tokeneja. Caleido hallitsee tokenien uusimisen automaattisesti.
| Tilanne | Toiminto |
|---|---|
| Access token vanhenee | Caleido uusii sen automaattisesti refresh tokenilla |
| Refresh token vanhenee | Yhteys katkeaa – sinun täytyy valtuuttaa integraatio uudelleen |
| Xero-tunnuksen oikeudet muuttuvat | Integraatio voi lakata toimimasta – valtuuta uudelleen |
Jos integraatio lakkaa toimimasta, siirry Asetukset → Integraatiot → Xero ja valitse Uudelleenvaltuuta.
Synkronoitavat tiedot
| Tietotyyppi | Kuvaus |
|---|---|
| Kirjanpitokirjaukset | Kaikki pääkirjaviennit |
| Laskut | Osto- ja myyntilaskut |
| Tilikartta | Xeron tililuettelo |
| Yhteystiedot | Asiakkaat ja toimittajat (vastapuolet) |
| Tracking categories | Xeron dimensiorakenne → Caleidon dimensiot |
Vianmääritys
Last updated Feb 21, 2026
Built with Documentation.AI