Integraatioasetukset

Organisaatiohierarkiassa tarkemmalle integraatioasetukselle annetaan korkeampi prioriteetti kuin yleisemmälle integraatioasetukselle. Tämä tarkoittaa sitä, että jos yksikön asetus on eri kuin kirjaston tai ryhmän asetus, yksikön asetus on ensisijainen. Jotkin integraatioasetukset voidaan tehdä vain tietyllä organisaatiotasolla, ja ne on kuvattu alla kunkin integraation osalta.

BaseBibliotek

Nämä asetukset ovat tällä hetkellä käytössä vain norjalaisille asiakkaille.

Libris ILL

Nämä asetukset ovat tällä hetkellä käytössä vain ruotsalaisille asiakkaille. Katso myös: Quria-verkkotuki ruotsiksi

Metadata Update Service

Nämä asetukset ovat tällä hetkellä käytössä vain ruotsalaisille asiakkaille. Katso myös: Quria-verkkotuki ruotsiksi

SBD

SBD-integraatio mahdollistaa tiedostojen hakemisen SBD.bibliotheksservice ag -palvelusta EAN tai toimituskuitin numeron perusteella. Alla olevia integraatioavaimia käytetään Quria-palvelussa.

Integraatioavain	Kartoitus/kuvaus
customer	Asiakasnumero
username	Käyttäjänimi
password	Salasana

SEPA

Single Euro Payments Area (SEPA) is used for bank transfers denominated in Euro. Alla olevia integraatioavaimia käytetään Quria-palvelussa.

Integraatioavain	Kartoitus/kuvaus
BIC	Kirjaston pankkitili BIC. Konfiguraatio kirjastotasolla Quria-palvelussa.
IBAN	Kirjaston pankkitili IBAN. Konfiguraatio kirjastotasolla Quria-palvelussa.
accountName	Kirjaston nimi (enintään 70 merkkiä). Konfiguraatio kirjastotasolla Quria-palvelussa.
initiatingParty	Ilmaisee, mistä tiedosto on peräisin. Konfiguraatio kirjastotasolla Quria-palvelussa.
patronCardLength	Käytetään osana PaymentId:n määrittämistä Direct Debit Transfer -tietoja varten. PaymentId koostuu organisaatiokoodista ja asiakaskortin numerosta muodossa organisaatiokoodi / asiakaskortin numero. Asiakaskortin numero täydennetään nollilla sopivan pituiseksi. Arvoksi on asetettava 0, jos täydennystä ei haluta. Konfiguraatio kirjastotasolla Quria-palvelussa.
paymentId	Tunnistaa maksujen kerääjän (kirjasto). Tämä parametri tunnetaan myös nimellä Creditor Identification Number. Konfiguraatio kirjastotasolla Quria-palvelussa.
privateId	Käytetään osana Creditor Scheme Idä. Konfiguraatio kirjastotasolla Quria-palvelussa.

Taloushallintojärjestelmien integraatio

Visma

Quria voi kommunikoida Visma-palvelun kanssa laskutustietojen vaihtamista varten. Visma-asetukset lisätään ryhmä- tai kirjastotasolla. Alla olevia integraatioavaimia käytetään Quria-palvelussa.

Integraatioavain	Kartoitus/kuvaus
service.userName	Visma-palvelun käyttäjänimi
externalSystem	Jos tämä on asetettu, integraatio on käytössä Visma-palvelulle. Konfiguraatio ryhmätasolla Quria-palvelussa.
division	Konfiguraatio ryhmätasolla Quria-palvelussa. (voi olla vain numeerinen)
commodityNumber.billAdminFee	Tilinumero kirjaston laskujen ja hyvitysten käsittelyä varten kirjaston taloushallintojärjestelmässä. Konfiguraatio ryhmätasolla Quria-palvelussa. (voi olla vain numeerinen)
profile	Jos asetettu, käytetään orderLine.profile:lle. Jos tätä ei haluta käyttää, kirjoita Visma lähetettäväksi n/a-järjestelmään tyhjänä.
orderRef	Jos asetettu, käytetään orderLine.orderRef:lle. Jos tätä ei haluta käyttää, kirjoita Visma lähetettäväksi n/a-järjestelmään tyhjänä.
service.url	Visma-palvelun URL-osoite.
service.password	Visma-palvelun salasana
company	Konfiguraatio ryhmätasolla Quria-palvelussa. (voi olla vain numeerinen)
principalNumber	Konfiguraatio ryhmätasolla Quria-palvelussa. (voi olla vain numeerinen)
commodityNumber.billReplacementCharge	Tilinumero kirjaston laskujen ja hyvitysten käsittelyä varten kirjaston taloushallintojärjestelmässä. Konfiguraatio ryhmätasolla Quria-palvelussa. (voi olla vain numeerinen)
yourRef	Jos asetettu, käytetään orderLine.yourRef:lle. Jos tätä ei haluta käyttää, kirjoita Visma lähetettäväksi n/a-järjestelmään tyhjänä.

Agresso

Quria voi kommunikoida Agresso-palvelun kanssa laskutustietojen vaihtamista varten. Agresso-asetukset lisätään ryhmä- tai kirjastotasolla.

Tiedonsiirto tapahtuu ainoastaan Quria-palvelusta Agresso-palveluun. Alla olevia integraatioavaimia käytetään Quria-palvelussa.

Integraatioavain	Kartoitus/kuvaus
integration.agresso.enabled	Määrittää, onko Agresso-palvelu otettava käyttöön.
integration.agresso.service.userName	Agresso-palvelun käyttäjänimi
integration.agresso.producer	Lähettäjäjärjestelmä, esim. Vigilo, Impleo. Aseta Axiell-palveluun.
integration.agresso.responsible	Laskun vastuuhenkilö, esim. AD-käyttäjätunnus. (enintään 3 merkkiä). Konfiguraatio kirjastotasolla Quria-palvelussa. (huomaa enimmäispituus).
integration.agresso.invoice.responsibilityNumber	Vastuunumero (enintään 8 merkkiä). Konfiguraatio kirjastotasolla Quria-palvelussa.
integration.agresso.invoice.accountNumber	Tilinumero (enintään 8 merkkiä).
integration.agresso.invoice.ansvarsnr	Vastuunumero (enintään 100 merkkiä)
integration.agresso.invoice.articleNumberReplacementFee	Korvausmaksun tuotenumero. Tuotekuvaus sisältää niteen viivakoodin.
integration.agresso.service.authenticationUrl	Agresso-todennuspalvelimen URL-osoite
integration.agresso.service.url	Agresso-palvelun URL-osoite
integration.agresso.service.password	Agresso-palvelun salasana
integration.agresso.client	Asiakaskoodi, esim. DK (sisällettävä 2 merkkiä). Konfiguraatio kirjastotasolla Quria-palvelussa.
integration.agresso.billNumber	Käytetään laskunumeroiden luomiseen Agresso-palvelun määrittämässä sarjassa.
integration.agresso.invoice.serviceNumber	Palvelun numero (enintään 8 merkkiä). Konfiguraatio kirjastotasolla Quria-palvelussa.
integration.agresso.invoice.dimvalue1	Kirjanpidon ulottuvuus 1 (enintään 12 merkkiä) Konfiguraatio kirjastotasolla Quria-palvelussa.
integration.agresso.invoice.articleNumberAdminFee	Hallintomaksun tuotenumero. Tuotekuvaus sisältää laskunumeron.

 

 

Laskujen XML-tiedostot

Tulosteiden lisäksi on mahdollista ladata XML-tiedostoja, joissa on laskutiedot sekä myöhästymisilmoitusprosessin päättävistä laskuista että maksumuistutusprosessin päättävistä laskuista. Tämä tehdään määrittämällä Peppol -integraatio.

Peppol on kansainvälinen standardi, jota Quria käyttää XML-muotoisten laskujen luomiseen. Peppolin integraatioasetuksissa on määritettävät kentät. Jos haluat lisätietoa siitä, mitä tietoja tulisi käyttää, ota yhteyttä talousasioista vastaavaan tahoon.

Ennen XML-laskujen kanssa aloittamista on otettava huomioon tietyt asetukset, kuten arvonlisäverokannat ja tilikoodit.

Peppol-/XML-integraatioasetukset löytyvät kohdasta Konfiguraatio – Asetukset – Oheislaitteet ja integraatio – Integraatioasetukset.

Valitse Organisaatio pudotusvalikosta ja lisää asetus Peppol . Huomaa, että konfiguraatio voidaan tehdä kirjasto- tai ryhmätasolla.

Peppolin oletusarvonlisävero on 0 %, ja se määritellään erityisellä koodilla Z (Zero). Jos haluat määrittää toisen oletusarvonlisäveron, voit määrittää arvonlisäverokoodin ja arvonlisäveroprosentin kohdassa Konfiguraatio – Järjestelmäasetukset – Oletusarvonlisäverokoodi tai Konfiguraatio – Järjestelmäasetukset – Oletusarvoinen ALV-prosentti.

Integrointiasetuksissa voidaan asettaa myös oletusarvoinen tilikoodi, jota vastaan laskujen summa kirjataan.

Jos haluat käyttää eri arvonlisäverokantoja tai tilikoodeja kuin Peppolin integraatioasetusten oletusarvot, voit määrittää ne asetuksissa:

• Myytävät tuotteet

• Jäsenyystyypit

• Taloudelliset tiedot maksun tyypeille

• Korvausmaksut laskutusta varten

Voit lisätä määritetyn ALV- tai tilikoodin yhdelle tai useammalle kohteelle. Jos arvoa ei ole määritetty, käytetään integraatioasetusten Peppol -oletusasetuksia ja järjestelmäasetuksia. Jos Peppol -integraatioasetuksissa määritettyä oletustiliä tulee käyttää, sitä ei ole syytä määrittää näin yksityiskohtaisella tasolla.

Kun integraatioasetukset on tehty ja otettu käyttöön, ajastetut tehtävät Luo myöhästymislaskuja ja Luo maksumuistutuksia tuottavat laskuja XML-muodossa. Huomaa, että asiakkaita, joilla ei ole henkilötunnusta, ei sisällytetä XML-tiedostoihin, vaan he saavat tulosteet.

XML-tiedostot löytyvät kohdasta Asiakas – Tiedostot. Valitse pudotusvalikosta Laskut XML-muodossa.

Map

Jos karttatoimittajan kanssa on tehty sopimus, voit näyttää karttoja Arena-palvelussa syöttämällä karttatoimittajakohtaiset URL-osoitteet niiden yksiköiden osalta, joilla on karttoja. Asetus voidaan lisätä millä tahansa organisaatiotasolla.

Kartan URL-osoite koostuu kahdesta osasta:

1. Alkuosa on yksilöllinen kullekin karttatoimittajalle ja asiakkaalle/kartalle. Tämä osa päättyy, kun ensimmäinen ”?” saavutetaan, ja se on lihavoitu alla olevassa esimerkissä.

2. Toinen osa alkaa ensimmäisestä ”?”-merkistä, ja se koostuu parametreistä, joiden avulla karttatoimittaja voi antaa oikeat karttasijainnit. Myös tämä osa on karttatoimittajakohtainen, mutta se on aina sama tietylle toimittajalle riippumatta siitä, onko karttoja useita esimerkiksi eri yksiköitä varten.

Esimerkki URL-osoitteesta:

https://provider.com/xxx/123?Lang=sv&encoding=utf-8&unit_code={{UnitCode}}&locale={{Locale}}&param0={{DepartmentCode}}&param1={{SectionCode}}&param2={{FirstCharacterAuthorOrTitle}}&shelf={{ItemShelfmark}}&text={{AuthorAndTitle}}

Wagner guide-palvelussa toisen osan tulisi näyttää tältä: ?Lang=sv&encoding=utf-8&unit_code={{UnitCode}}&locale={{Locale}}&param0={{DepartmentCode}}&param1={{SectionCode}}&param2={{FirstCharacterAuthorOrTitle}}&shelf={{ItemShelfmark}}&text={{AuthorAndTitle}}

Integraatioavain	Kartoitus/kuvaus
mapURL	Karttatoimittajakohtainen URL-osoite yllä olevan kuvauksen mukaisesti