Asiantuntija: David Magnusson-Rosén

Laskun vienti Procountoriin (API)

Voit yhdistää (integroida) Opterin Procountor-talousjärjestelmään. Tämän jälkeen voit viedä laskut Opterista Procountoriin API:n kautta. Lisätietoja Procountorista on saatavilla osoitteessa https://procountor.fi, ruotsiksi https://procountor.se/ ja englanniksi https://procountor.fi/en/.

Kun viet laskun Opterista Procountoriin, tapahtuu seuraavaa:

• Laskut viedään "tiliöintituotteina", eli siirretään vain tiliöinti.

  Halutessasi graafisen Opter-laskun kaikkine yksityiskohtineen voit liittää PDF-tiedostona. (Asetukset tehdään alla olevassa vaiheessa 2.)

• Asiakastiedot viedään ja päivitetään Procountoriin.

Edellytykset

Suorituskykyyksiköt ja mitat

Mitä Opterissa kutsutaan "tulosyksiköksi", kutsutaan Procountorissa "ulottuvuudeksi". Kun laskuja viedään (tuotteita kirjataan), Opterin tulosyksikön nimi vastaa Procountorin ulottuvuuden nimeä.

Tarkista seuraavat asiat:

• kaikki Opterissa käyttämäsi tulosyksiköt ovat käytettävissä ulottuvuuksina Procountorissa. (Procountorissa ei ole mahdollista luoda uusia ulottuvuuksia API-kutsujen avulla.)

• että käytät Opterissa samoja nimiä tulosyksiköille kuin Procountorissa oleville ulottuvuuksille.

Jos lisäät Opterissa uuden osaston tai ryhmän tulosyksikön alle, uusi osasto tai ryhmä luodaan automaattisesti Procountoriin laskun viennin yhteydessä (jos uusi osasto tai ryhmä sisältyy johonkin koodaustuotteeseen).

Tilinumero

Opterissa käytettävien tilinumeroiden on oltava olemassa Procountorissa.

Laskunumero ja laskunumerosarja

Procountor hyväksyy laskunumerot Opterista. Suosittelemme varmistamaan, että Opterissa luotujen laskujen numerot eivät ole ristiriidassa suoraan Procountorissa luotujen laskujen numeroiden kanssa. Voit ratkaista tämän käyttämällä eri laskunumerosarjoja Opterissa ja Procountorissa.

Valuuttakoodit

Procountor käyttää samoja valuuttakoodeja kuin Opter.

Asiakkaan numero

Tarkista, että kaikilla Opter-asiakkailla on asiakasrekisterin Yleinen -välilehden Reskontranumero -kentässä asiakasnumero.

Kun laskut viedään, myös asiakasnumero lähetetään Procountoriin. Jos Reskontranumero -kentässä ei ole numeroa, saat virheilmoituksen viennin yhteydessä.

(Asiakaskoodi on saatavilla Opterissa, mutta ei Procountorissa.)

Asiakkaan pankki

Asiakkaan pankin koodi on syötettävä Opter-asiakasrekisterin EDI koodi -kenttään, välilehdelle Yksityiskohdat. Tarkista, että EDI koodi -kenttä sisältää oikeat tiedot kaikista asiakkaistasi. Lisätietoja on alla olevassa taulukossa ja osoitteessa https://support.procountor.fi/.

Asiakkaan pankki	EDI koodi
Aktia/Paikallisosuuspankki	HELSFIHH
Ålandsbanken	AABAFI22
Apix Messaging Oy	003723327487
Apix Messaging Oy (vanha koodi)	00372332748700001
BasWare Einvoices Oy	BAWCFI22
CGI Suomi (ent. Logica Suomi Oy)	003703575029
Danske Bank	DABAFIHH
DNB Bank ASA, Finland Branch	DNBAFIHX
Enfo	003714377140
Handelsbanken	HANDFIHH
InExchange Factorum AB	INEXCHANGE
InExchange Factorum AB (vanha koodi)	SE556700997101
Liaison Technologies Oy (ent. Anilinker)	003708599126
Maventa	003721291126
Netbox Finland Oy	003726044706
Nordea	NDEAFIHH
Notebeat Oy	003717203971
OpusCapita Solutions Oy	E204503
Osuuspankki	OKOYFIHH
Pagero	003723609900
POP Pankki	POPFFI22
PostNord Strålfors Oy	003701150617
Ropo Capital	003714377140
Säästöpankki	ITELFIHH
S-Pankki/LähiTapiola	SBANFIHH
Sproom ApS	SPROOM
TeliaSonera Finland Oyj	003714756079
Tieto Oyj	003701011385
Peppol	PEPPOL

Tuoteryhmä "(Undefined variable: UI.IES_ProcountorApiProductGroup)"

Asiakkaan numero

Tarkista, että kaikilla Opter-asiakkailla on asiakasrekisterin Yleinen -välilehden Reskontranumero -kentässä asiakasnumero.

Kun laskut viedään, myös asiakasnumero lähetetään Procountoriin. Jos Reskontranumero -kentässä ei ole numeroa, saat virheilmoituksen viennin yhteydessä.

(Asiakaskoodi on saatavilla Opterissa, mutta ei Procountorissa.)

Rajoitukset

Procountor-integraatio eri markkinoille

Integraatiota testataan vain Suomen markkinoilla. Opter voi kuitenkin räätälöidä integraation kaikille Procountor-markkinoille. Jos haluat käyttää Procountoria muilla markkinoilla kuin Suomessa, ota yhteyttä Opterin tukeen.

Vaihe : Luo käyttäjä ja API-avain Procountoriin.

Jotta voit viedä laskuja Procountoriin, sinun on ensin luotava niin sanottu m2m-käyttäjä ("machine to machine" -käyttäjä). M2m-käyttäjällä on oltava alla olevan taulukon mukaiset oikeudet ja siihen liittyvä API-avain. Et tarvitse henkilökohtaisia kirjautumistietoja viedäksesi laskuja Procountoriin.

Voit viedä laskuja Procountoriin seuraavasti:

1. Luo Procountorissa m2m-käyttäjä. Katso "Uuden käyttäjän luominen" (kohdassa "Käyttäjät ja käyttäjien oikeudet" > "Käyttäjän lisääminen ja poistaminen"), https://support.procountor.fi/hc/en-us/articles/360000252297-Adding-and-removing-a-user#CREATENEWUSER.

   Jos tarvitset apua m2m-käyttäjän luomisessa, oikeuksien ja API-avaimen antamisessa, ota yhteyttä Procountorin tukeen.

2. Varmista Procountorissa, että m2m-käyttäjällä on kaikki alla olevan taulukon mukaiset oikeudet.

   Käyttäjäoikeuksien määrittäminen Procountorissa, katso "Users and user rights", https://support.procountor.fi/hc/en-us/articles/10142366663580-Users-and-user-rights.

   Nimitys	Oikeuksien taso
   basicAccountingInfo	ALL_RIGHTS
   importData	ALL_RIGHTS
   editPersonalInfo	ALL_RIGHTS
   salesOrGroupInvoices	ALL_RIGHTS
   salesInvoiceSearch	ALL_RIGHTS
   customerRegister	ALL_RIGHTS
   productRegister	ALL_RIGHTS
   verification	ALL_RIGHTS
   hyväksyntä	ALL_RIGHTS
   journalReceipts	ALL_RIGHTS
   journalReceiptSearch	ALL_RIGHTS

3. Luo Procountorissa API-avain ("API-avain"). Katso "API-avaimen luominen Procountor UI:n avulla", https://dev.procountor.com/m2m-authentication/#creating an api key using procountor ui.

   (Kopioi ja liitä API-avain Opteriin alla olevassa vaiheessa.)

4. Tallenna kaikki muutokset Procountoriin.

Vaihe : Luo laskunvienti

1. Napsauta Opterissa Hallinto > Laskut > Laskunvienti ja luo uusi laskuvienti napsauttamalla . Seuraavat kentät on täytettävä välilehdellä Yleinen:

   • Nimi: Esimerkiksi "Procountor (API)".

   • Raportti: Ilman.

   • Laji: Procountor API.

   • Merkkikoodaus: UTF-8.

   • Salasana: Syötä tähän API-avain, jonka olet luonut Procountorissa edellä olevassa vaiheessa.

2. Jos haluat, että Opter-lasku liitetään PDF-muodossa, merkitse valintaruutu Sisällytä PDF-kopio.

   Liitä Opter-lasku, jos haluat, että kaikki kuljetuksen tiedot, kuten tilauksen lähettäjä, vastaanottaja, etäisyys, paino ja rahtikirjan numero, sisällytetään Procountoriin.

   Jos PDF-tiedostoa ei voida liittää laskuun viennin aikana, näkyviin tulee varoitus (katso Virheilmoitukset alla). Tämä ei kuitenkaan estä laskun luomista Procountorissa.

3. Jos haluat pienentää PDF-tiedoston kokoa, merkitse kohta Pienennä PDF-tiedoston kokoa.

   Tiedoston kokoa pienennetään poistamalla kaikki tekstin muotoilut (lihavointi, kursivointi, alleviivaus) ja vaihtamalla fontti sellaiseen, joka käyttää vähemmän tallennustilaa. Se, kuinka paljon tiedostokoko pienenee, riippuu muun muassa siitä, kuinka paljon muotoilua tiedosto sisältää.

4. Tallenna muutokset valitsemalla .

Vaihe : Käännä Opterin ALV-koodit

Laskut viedään Opterista Procountoriin "lähetystuotteina". Procountorissa arvonlisäverotuksen tila asetetaan jokaiselle kirjanpitotuotteelle.

Jotta Opter voi luoda oikeita lähetystuotteita, Opterin on tiedettävä, mitä alv-statuskoodia käytetään kunkin Opterin alv-kannan osalta. Esimerkiksi "alv-statuskoodia" = "vat_1" olisi käytettävä, jos alv-kanta on 25,5 prosenttia.

Kuvaukset ja yleisimmät koodit ("alv-statuskoodit") löytyvät osoitteesta https://support.procountor.fi/hc/en-us/articles/360000240818-VAT-defaults. Jos haluat nähdä täydellisen luettelon kaikista koodeista, katso Procountorin käyttöliittymästä hakusanalla englanniksi "VAT defaults" tai suomeksi "ALV-oletukset".

Jotta Opter tietäisi, mitä "alv-statuskoodia" on käytettävä kunkin Opterin alv-kannan osalta, toimi seuraavasti:

1. Valitse Opterissa Hallinto > Laskut > Laskunvienti.

2. Valitse Laskunvienti-ikkunassa "Procountor (API)" vasemmanpuoleisesta luettelosta.

   Napsauta Koodeja -välilehteä ja valitse avattavasta valikosta Verokannat.

3. Kirjoita käyttämäsi arvonlisäverokannan tai -prosenttien 'alv-statuskoodi' sarakkeeseen Koodi. Katso esimerkki alla olevasta kuvasta.

   

4. Tallenna muutokset valitsemalla .

Vaihe : Lisää laskunvienti laskunvientiryhmään

Voit luoda uuden laskunvientiasetuksen (eli vientiryhmän) tai tarkistaa, onko jo olemassa laskunvientiasetus (ryhmä), johon haluat lisätä laskun viennin Procountoriin, seuraavasti:

1. Valitse Hallinto > Laskut > Laskunvientiasetukset.

2. Katso vasemmanpuoleisesta luettelosta, onko jo olemassa laskun vientiasetus (ryhmä), johon haluat lisätä Procountor-viennin. Napsauta kyseistä laskunvientiasetusta ja merkitse rasti kohtaan "Procountor (API)" (tai nimi, jonka annoit laskun viennille) kohdassa Viennit.

   Jos ei ole olemassa laskunvientiasetusta (ryhmää), johon haluat lisätä Procountor-viennin, luo uusi. Napsauta ja anna laskun vientiasetukselle nimi, esimerkiksi "Procountor (API)". Valitse valintaruutu "Procountor (API)" (tai nimi, jonka annoit laskun viennille) kohdassa Viennit.

3. Tallenna muutokset valitsemalla .

4. Valitse, mitä laskunvientiasetusta käytetään oletuksena. Jos haluat valita Procountorin (API) oletusasetukseksi, valitse "Procountor (API)" vasemmanpuoleisesta luettelosta ja napsauta .

5. Jos haluat varmistaa, että kaikki laskut kirjataan Procountoriin, rastita "Procountor (API)" -vienti kaikissa vientiasetuksissa (ryhmissä).

6. Tallenna muutokset valitsemalla .

7. Jos haluat määrittää, mikä laskunvientiasetus (ryhmä) koskee tiettyä asiakasta, valitse Hakemisto > Asiakkaat ja etsi asiakas, jolle haluat tehdä asetuksen. Napsauta välilehteä Laskutustiedot ja valitse laskunvientiasetus (ryhmä) pudotusvalikosta Laskun vientiasetukset. Tallenna muutokset valitsemalla .

Vaihe : Laskujen vienti Procountoriin

Voit viedä laskutiedot Opterista laskutuskauden sulkemisen yhteydessä tai sen jälkeen, kun olet valinnut, haluatko viedä kokonaisia laskutuskausia vai yksittäisiä laskuja.

Tee näin:

1. Valitse Opterissa Hallinto > Laskut > Laskut.

2. Valitse lasku tai laskutuskausi, jonka haluat viedä, napsauta sitä hiiren kakkospainikkeella ja valitse Vie.

3. Napsauta Vie ja lähetä viedäksesi laskun tai laskutuskauden Procountoriin.

   Opterin ikkunassa Laskunvienti näytetään vietävien ja vietyjen laskujen määrä sekä edistymisosoitin (ikkunan alareunassa). Kun laskunvienti on valmis, koko edistymispalkki on vihreä.

   Jos laskunvienti epäonnistuu, siitä kertoo edistymispalkin harmaa väri. Jos vienti epäonnistuu, näyttöön tulee virheilmoitus, katso vianmääritys jäljempänä.

Vianetsintä

Jos vienti Procountoriin ei toimi oikein, näyttöön tulee virheilmoitus. Ota huomioon seuraavat virheilmoituksia koskevat seikat:

• Ne näytetään vain, jos vienti epäonnistuu ja tapahtuu virhe.

• Ne näytetään Opterin ponnahdusikkunassa vientihetkellä.

• Tarkempia tietoja saat Windowsin tapahtumalokista. (Katso siis asiakasohjelman tapahtumalokia, koska kutsut tulevat asiakasohjelmasta).

Virheilmoitukset ja korjaavien toimenpiteiden ehdotukset on lueteltu alla olevassa taulukossa. Kun olet korjannut ongelman/virheen, voit viedä laskut uudelleen.

Virheviestit

Virheviesti	Kuvaus
(Undefined variable: UI.IES_ERR_ProcountorApiError)	Tämä virheilmoitus liittyy Procountorin virheilmoitukseen. Ota yhteyttä Opterin tukeen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorAuthenticationFailed)	Varmista, että olet syöttänyt Procountorin API-avaimen Salasana-kenttään (katso vaiheet 1 ja 2 edellä). Tarkista, että luomallasi m2m-käyttäjällä on kaikki taulukossa näkyvät oikeudet. Vaihe 1 edellä.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorProductGroupMissing)	Lisätietoja on edellä olevassa tuoteryhmässä "OpterGroup ". Ota yhteyttä Opterin tukeen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorAccountFormatError)	Tarkista tilinumero Opterissa.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorAccountMissing)	Opterissa käytettävien tilinumeroiden on oltava olemassa Procountorissa.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorGettingAccounts)	Ota yhteyttä Opterin tukeen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorDimensionMissing)	Mitä Opterissa kutsutaan "tulosyksiköksi", kutsutaan Procountorissa "ulottuvuudeksi". Lisätietoa: Tulosyksiköt ja mitat edellä.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorGettingLedgerReceipt)	Opter ei pystynyt hakemaan Opterin viemän laskun kirjausta. Ota yhteyttä Opterin tukeen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorUpdatingAccounting)	Ota yhteyttä Opterin tukeen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorFiscalYearMissingOrClosed)	Procountorissa ei ole laskutusjaksoja, mutta Opterissa laskun päivämäärän on osuttava Procountorissa avoinna olevaan tilikauteen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorCreatingCustomer)	Voit yrittää luoda asiakkaan manuaalisesti Procountorissa. On tärkeää, että asiakasnumero vastaa Opterissa jo olevaa asiakasnumeroa, katso asiakasnumero edellä. Voit sitten yrittää viedä laskun uudelleen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorUpdatingCustomer)	Voit yrittää päivittää asiakastiedot manuaalisesti Procountorissa. On tärkeää, että asiakasnumero vastaa Opterissa jo olevaa asiakasnumeroa, katso asiakasnumero edellä. Voit sitten yrittää viedä laskun uudelleen.
Asiakasnumero puuttuu Opterista asiakkaalle: {0} (asiakaskoodi: {1}, asiakasnumero: {2}).	Katso asiakasnumero edellä. Voit sitten yrittää viedä laskun uudelleen.
(Undefined variable: UI.IES_ERR_ProcountorApiErrorAttachingPdf)	Tämä virheilmoitus on varoitus, mutta se ei estä laskun luomista Procountorissa. PDF-muotoista Opter-laskua ei voitu liittää laskuun Procountorissa. Tämä voi johtua esimerkiksi siitä, että PDF-tiedosto on liian suuri. Voit lisätä PDF-tiedoston (Opter-lasku) manuaalisesti laskuun Procountorissa. Jos et ole vielä laittanut rastia Pienennä PDF-tiedoston kokoa-valintaruutuun, voit tarkistaa, auttaako se seuraavalla kerralla, kun on aika viedä laskuja. (Katso Vaihe 2: Luo laskun vienti edellä). Jos et halua, että Opter-lasku liitetään vientiin, poista rasti valintaruudusta Sisällytä PDF-kopio, (ks. Vaihe 2): Luo laskun vienti edellä).
(Undefined variable: UI.IES_ERR_ProcountorApiErrorRateLimiterError)	Ota yhteyttä Opterin tukeen.

Katso myös