Procountor-API rajapinta
Procountor-API rajapinta mahdollistaa sitä vasten rakennettavien integraatioiden välityksellä tietojen tuontia ohjelmaan (import) sekä tietojen vientiä ohjelmasta (export).
Procountor-API rajapinta ei itsessään kontrolloi siirrettävien tietojen sisältöjä tai määriä, vaan niistä asiakkaan tulee olla itse viime kädessä vastuussa. Tietojen oikeellisuuden osalta API-rajapinnassamme on samat muototarkisteet ja validoinnit kuin vastaavan tiedon tallentamisessa manuaalisesti käyttöliittymän kautta.
Import – tositteiden tuonti Procountoriin toisesta järjestelmästä
Procountor-API rajapintaa hyödynnettäessä tositteiden (esim. lasku tai muistiotosite) onnistunut tuonti (=tositteen tallennus Procountor-ohjelmaan) palauttaa rajapintaan standardin mukaisen kuittauksen (200 OK). Kuittauksen ohella palautetaan Procountoriin tositteesta tallentuneet tiedot sekä niiden lisäksi tositteen tunnistamiseen ja mahdolliseen jatko-operointiin rajapinnassa tarvittavat sisäiset id-tunnisteet (invoiceId, laskunumero, ledgerReceiptId).
Nämä edellä mainitut Procountor API -rajapinnassa palautettavat tiedot mahdollistavat Procountoriin siirrettyjen tietojen todentamisen integraattorille. Näiden palautussanomassa tulevien tietojen kerääminen, niiden vertaaminen lähtöjärjestelmän tietoihin, käyttäminen onnistuneen tiedonsiirron todentamiseksi sekä esittäminen integraation käyttäjälle ovat integraation toteuttavan tahon vastuulla.
Mikäli tositteen siirto epäonnistuu (tositetta ei ole tallennettu Procountor-ohjelmaan), rajapinta antaa siirron hetkellä reaaliaikaisen virheilmoituksen. Virheilmoituksen sisältämistä virhekoodeista löytyy listaus API-kehittäjäsivustolta. Integraation toteuttajan vastuulla on kerätä rajapinnan mahdollisesti antamat ilmoitukset ja kuittaukset sekä tulkita ja näyttää ne valitsemallaan tavalla toisen ohjelman käyttäjälle.
Tiivistetysti Procountor-API rajapinta mahdollistaa tiedon siirron seurannan (onnistunut tai epäonnistunut), mutta seurannan toteutus ja esittäminen toisen järjestelmän käyttäjälle on integraation toteuttajan vastuulla. Viime kädessä vastuu tietojen vertailusta ja täsmäyttämisestä lähdejärjestelmän ja Procountorin välillä on asiakkaan vastuulla.
Export – tietojen vienti Procountorista toiseen järjestelmään
Tietojen haku Procountor-API rajapintaa vasten edellyttää haettavien tietojen määrittämistä ja näiden mukaisten hakuehtojen toteuttamista Procountor-API rajapintaa vasten API-tietuekuvaustemme mukaiset ominaisuudet huomioiden. Procountor-API rajapinnan kautta ei ole mahdollista päivittää esimerkiksi noudettujen tositteiden tila-tietoa Procountorissa indikoimaan niiden onnistunutta tai epäonnistunutta noutoa Procountorin ulkopuoliseeen kohdejärjestelmään.
Integraatiossa käytettyjen hakuehtojen kontrollointi ei ole mahdollista Procountorista käsin, vaan vastuu riittävän kattavista hakuehdoista ja haun palauttavien tositteiden tulkinnasta on integraation toteuttavan tahon vastuulla. Accountor Finago on dokumentoinut yleisimpiä integraatiokäyttötapauksia Procountor- API rajapinnan näkökulmasta ja nostanut esiin niissä huomioitavia yksityiskohtia sähköisessä ohjekirjassaan. Ohjeistuksia lisätään ja tarkennetaan tarvittaessa.
Viime kädessä vastuu tietojen vertailusta ja täsmäyttämisestä Procountorin ja kohdejärjestelmän välillä on asiakkaan vastuulla.