Laskunvienti Heerosiin (API)

Tässä Artikkeli

Voit lähettää verkkolaskuja asiakkaillesi VAN-operaattori Heerosin kautta. Lisätietoa Heerosista on saatavilla osoitteessa heeros.com (suomeksi) ja heeros.com/en (englanniksi).

Vaihe 1: Luo laskunvienti Heerosiin Opterissa

Valitse Hallinto > Laskut > Laskunvienti ja luo uusi laskunvienti valitsemalla . Seuraavat kentät on täytettävä välilehdellä Yleinen:
- Nimi: Esimerkiksi ”Heeros (API)”.
- Raportti: Ilman.
- Laji: XmlSerializer.
- Merkkikoodaus: UTF-8.
- Asiakastunnus: Löydät asiakaskoodisi Heerosista, ”la_id” tai ”end customer id” (loppuasiakastunnus).
- Toimiston koodi: Löydät toimistokoodisi Heerosista, ”tt_id” tai ”accounting customer id” (tilitoimistotunnus).
- Aloitusteksti: Tähän kenttään voit lisätä muita parametreja viennin mukauttamiseksi.
  
  Käytettävä muoto on ”parametri=arvo”. Kirjoita yksi parametri yhdelle riville kuten alla olevassa esimerkissä.
```
1
2
3
4
5
6
7
MoveOnlyToLedger=true
SendToCustomer=false
CreateCustomer=true
UpdateCustomer=true
CreateProduct=true
UpdateProduct=true
CreateAccountingObjects=true
```
  Jos et syötä tiettyä parametria kenttään Aloitusteksti, käytetään oletusasetusta. Lisätietoa parametreista on alla olevassa taulukossa Kentän Starttext parametrit.
- Merkitse valintaruutu Yksi tiedosto per lasku.
Tallenna muutokset valitsemalla .
Napsauta välilehteä Tiedoston siirto. Seuraavat kentät on täytettävä:
- Menetelmä: Heeros API.
- Asiakkaan henkilöllisyys: API-käyttäjätunnus Heerosista. (”Heeros user name”)
- Asiakasavain: API-avain Heerosista. (”Heeros password”)
Tallenna muutokset valitsemalla .

Vaihe 2: Syötä muunnos laskun vientiin

Tämän vaiheen tilaa Opter. Ota yhteyttä osoitteeseen saadaksesi lisätietoja.

Vaihe 3: Lisää laskun vienti laskun vientiryhmään.

Voit luoda uuden laskunvientiasetuksen (eli vientiryhmän) tai tarkistaa, onko laskunvientiasetus (ryhmä) olemassa jos siellä, johon haluat lisätä laskunviennin Heerosiin, seuraavasti:

Valitse Hallinto > Laskut > Laskunvientiasetukset.
Katso vasemmanpuoleisesta luettelosta, onko laskunvientiasetus (ryhmä) olemassa jo siellä, johon haluat lisätä laskunviennin Heerosiin. Napsauta kyseistä laskunvientiasetusta ja merkitse valintaruutu ”Heeros API” (tai nimi, jonka annoit laskunviennille) kohdassa Viennit.

Jos laskunvientiasetusta (ryhmä) ei ole olemassa siellä, johon haluat lisätä laskunviennin Heerosiin, luo uusi. Valitse ja anna laskunvientiasetuksille nimi, esimerkiksi ”Heeros API”. Merkitse valintaruutu ”Heeros API” (tai nimi, jonka annoit laskunviennille) kohdassa Viennit.
Tallenna muutokset valitsemalla .
Valitse, mitä laskunvientiasetusta käytetään oletuksena. Valitse Heeros API oletukseksi merkitsemällä ”Heeros API” vasemmalla olevassa luettelossa ja napsauta .
Sen varmistamiseksi, että kaikki laskut kirjataan kirjanpitoon Heerosissa, valitse ”Heeros API” -vienti kaikkiin vientiasetuksiin (ryhmiin).
Tallenna muutokset valitsemalla .
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 4: Laskujen vienti Heerosiin

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

Valitse Hallinto > Laskut > Laskut.
Valitse lasku tai laskutuskausi, jonka haluat viedä, napsauta sitä hiiren kakkospainikkeella ja valitse Vie.
Napsauttamalla Vie ja lähetä voit viedä laskun tai laskutuskauden Heerosiin.

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 ei onnistu, näytölle tulee virheviesti. Katso jäljempänä oleva kohta Virheviestit.

Laskujen vienti Heerosiin voi kestää hyvin kauan. Se riippuu siitä, miten Heeron järjestelmä on rakennettu. Suosittelemme, että käynnistät erillisen Opter-ohjelman ja viet laskut siitä. Sitten voit jättää viennin niin pitkäksi aikaa kuin on tarpeen keskeyttämättä sitä.

Kentän Aloitusteksti parametrit

Taulukossa luetellaan parametrit, jotka voidaan syöttää kenttään Aloitusteksti. Lisätietoa ja esimerkkejä on edellä olevassa kohdassa Vaihe 1.

Parametri	Selitys
MoveOnlyToLedge=<true/false>	Heerosissa laskut voidaan lähettää vastaanottajalle (asiakkaalle) Opentextin kautta. Valitse, lähetetäänkö lasku automaattisesti Opentextiin vai ei: ”True” (oletus): Lasku lähetetään automaattisesti Opentextiin. ”False”: Lasku tallennetaan ”Heeros Sales Invoices” -osioon statuksella ”complete”. Tämän jälkeen voit lähettää laskun manuaalisesti Opentextiin tai suoraan asiakkaalle. Vain toinen parametreista MoveOnlyToLedge ja SendToCustomer (katso alla) voidaan asettaa arvoon ”true”.
SendToCustomer=<true/false>	Valitse, lähetetäänkö lasku automaattisesti asiakkaalle vai ei: ”True”: Lasku lähetetään automaattisesti asiakkaalle. ”False” (oletus): Lasku tallennetaan ”Heeros Sales Invoices” -osioon statuksella ”complete”. Tämän jälkeen voit lähettää laskun manuaalisesti Opentextiin tai suoraan asiakkaalle. Vain toinen parametreista MoveOnlyToLedge (katso edellä) ja SendToCustomer voidaan asettaa arvoon ”true".
CreateCustomer=<true/false>	Valitse, luodaanko asiakas automaattisesti Heerosissa vai ei: ”True” (oletus): Jos vietävään laskuun merkittyä asiakasta ei ole Heerosissa, asiakas luodaan automaattisesti Heerosissa. ”False”: Jos vietävään laskuun merkittyä asiakasta ei ole Heerosissa, Heeros antaa virheviestin, kun lasku viedään. Asiakasta ei siis luoda automaattisesti Heerosissa, mutta voit luoda asiakkaan manuaalisesti Heerosissa ja viedä laskun sitten uudelleen.
UpdateCustomer=<true/false>	Valitse, päivitetäänkö asiakastiedot Heerosissa automaattisesti vai ei: ”True” (oletus): Jos vietävän laskun asiakastiedot eivät vastaa Heerosissa olevia tietoja, asiakastiedot päivitetään automaattisesti Heerosissa. ”False”: Jos vietävän laskun asiakastiedot eivät vastaa Heerosissa olevia tietoja, Heeros antaa virheviestin, kun lasku viedään. Asiakastietoja ei siis päivitetä automaattisesti Heerosissa, mutta voit päivittää asiakastiedot manuaalisesti Heerosissa ja viedä laskun sitten uudelleen.
CreateProduct=<true/false>	Opterissa voi luetella laskun artikkeleita ja/tai tuotteita (yleensä valitaan, haluaako käyttää artikkeleita vai tuotteita). Heerosissa niitä kutsutaan vain tuotteiksi. Valitse, luodaanko tuote automaattisesti Heerosissa vai ei: ”True” (oletus): Jos vietävän laskun tuotetta ei ole Heerosissa, tuote luodaan automaattisesti Heerosissa. ”False”: Jos vietävän laskun tuotetta ei ole Heerosissa, Heeros antaa virheviestin, kun lasku viedään. Tuotetta ei siis luoda automaattisesti Heerosissa, mutta voit luoda tuotteen manuaalisesti Heerosissa ja viedä laskun sitten uudelleen.
UpdateProduct=<true/false>	Opterissa voi luetella laskun artikkeleita ja/tai tuotteita (yleensä valitaan, haluaako käyttää artikkeleita vai tuotteita). Heerosissa niitä kutsutaan vain tuotteiksi. Valitse, päivitetäänkö tuote automaattisesti Heerosissa vai ei: ”True” (oletus): Jos vietävän laskun tuotetiedot eivät vastaa Heerosissa olevia tietoja, tuotetiedot päivitetään automaattisesti Heerosissa. ”False”: Jos vietävän laskun tuotetiedot eivät vastaa Heerosissa olevia tietoja, Heeros antaa virheviestin, kun lasku viedään. Tuotetietoja ei siis päivitetä automaattisesti Heerosissa, mutta voit päivittää tiedot manuaalisesti Heerosissa ja viedä laskun sitten uudelleen.
CreateAccountingObjects=<true/false>	Valitse, luodaanko tiliöinti automaattisesti Heerosissa vai ei: ”True” (oletus): Tiliöinti luodaan automaattisesti Heerosissa laskunviennin yhteydessä. ”False”: Tiliöintiä ei luoda automaattisesti Heerosissa.

Vianetsintä

Virheviestit

Jos vienti Heerosiin ei onnistu, näyttöön tulee virheviesti. Virheilmoitus näytetään vain, jos vienti epäonnistuu ja tapahtuu virhe. Virheilmoitukset näytetään ponnahdusikkunassa, eikä sitä tallenneta mihinkään.

Virheviesti	Selitys
Heerokseen kirjautuminen ei onnistu. Käyttäjänimi/salasana on virheellinen tai Heerokseen ei saada yhteyttä. Yritä uudelleen muutaman minuutin kuluttua.	Tarkista, että Opterin välilehdellä Tiedoston siirto olevat kentät ovat oikein: Asiakkaan henkilöllisyys: API-käyttäjätunnus Heerosista. (Heeros user name) Asiakasavain: API-avain Heerosista. (Heeros password) (Katso ohjeet edellä.) Yritä sitten viedä laskut uudelleen.
Laskun lähettäminen Heerokseen ei onnistunut. Heeroksen virhekoodi: {0}. Heeroksen virheviesti: {1}	Lue Heerosin virhekoodi ja -viesti ja kokeile korjata ongelma. Sitten voit yrittää viedä laskut uudelleen.
Lasku on lähetetty, mutta sitä ei voitu käsitellä Heeroksessa, koska se on puutteellinen. Tarkista puutteelliset laskut Heeroksesta. Laskun tunnus Heeroksessa: {0}.	Ota yhteyttä Heerosiin ja kysy lisätietoja.
Lasku on lähetetty, mutta sitä ei voitu vahvistaa aikarajan puitteissa. Tarkista puutteelliset laskut Heeroksessa ja tarkista, että se on saapunut ja mikä sen tila on. Laskun tunnus Heeroksessa: {0}.	Tarkista, onko lasku saapunut Heerosiin ja mikä sen status on. Voit yrittää viedä laskun uudelleen.
Laskun {0} lähettäminen Heerokseen ei onnistunut validointivirheen vuoksi. Virheiden määrä: {1}. Ota yhteyttä Opterin tukeen.	Jos saat tämän virheviestin, ota yhteyttä Opterin tukeen.

Katso myös

Sähköiset laskut