Raporttien tallennus omalle sftp-palvelimelle – Heeros Help Center

Raporttien suora tallennus omalle SFTP-palvelimelle

Raportit voidaan tallentaa automaattisesti suoraan asiakkaan omalle SFTP-palvelimelle. Toiminto määritetään järjestelmän pääkäyttäjätoiminnoissa.

SFTP-asetusten sijainti

Siirry kohtaan:

Pääkäyttäjätoiminnot → API Center → SFTP

Tällä sivulla määritetään asiakkaan SFTP-yhteyden tiedot.

Asetusten määrittäminen

Täytä seuraavat tiedot:

Asetus	Kuvaus
Pankki-SFTP aktivoitu	Ei liity raporttien tallennukseen. Jätä pois käytöstä, ellei pankkiyhteyttä käytetä.
SFTP arkisto aktivoitu	Ota käyttöön, jotta raportit tallennetaan asiakkaan SFTP-palvelimelle.
Palvelin	Asiakkaan SFTP-palvelimen osoite (esim. `sftp.yritys.fi` tai IP-osoite).
Käyttäjätunnus	SFTP-palvelimen käyttäjätunnus.
Salasana	SFTP-käyttäjän salasana.
Tiedoston nimen malli	Valinnainen tiedostonimen malli. Jos kenttä jätetään tyhjäksi, käytetään järjestelmän oletusnimeämistä.

Käyttöönotto

Siirry kohtaan Pääkäyttäjätoiminnot → API Center → SFTP.
Ota käyttöön SFTP arkisto aktivoitu.
Syötä asiakkaan toimittamat SFTP-yhteystiedot:
- palvelimen osoite
- käyttäjätunnus
- salasana
Määritä tarvittaessa tiedostonimen malli.
Tallenna asetukset.

Tämän jälkeen järjestelmä mahdollistaa muodostettavan raportin automaattisesti asiakkaan määrittämälle SFTP-palvelimelle. Raportilla rastitetaan sekä "Arkistoi"

Huomioitavaa

Varmista, että asiakkaan SFTP-palvelin on saavutettavissa ja että käyttäjätunnuksella on kirjoitusoikeus kohdehakemistoon.
Mikäli yhteys ei toimi, tarkista palvelimen osoite, käyttäjätunnus, salasana sekä mahdolliset palomuuri- ja IP-osoiterajoitukset.
Suosittelemme testaamaan toiminnan muodostamalla raportin käyttöönoton jälkeen ja varmistamalla, että tiedosto tallentuu onnistuneesti SFTP-palvelimelle.

Tiedoston nimen malli

Tiedoston nimen malli -kentässä voidaan määrittää, millä nimellä raportti tallennetaan asiakkaan SFTP-palvelimelle. Tiedostonimeen voidaan lisätä avainsanoja, jotka järjestelmä korvaa raportin tiedoilla tallennuksen yhteydessä.

Käytettävät avainsanat

Avainsana	Korvataan tiedolla	Esimerkki
`(nimi)`	Raportin tai aineiston nimi	`kausiyhteenveto`
`(ytunnus)`	Yrityksen Y-tunnus	`1234567-8`
`(vuosi)`	Maksupäivän vuosi	`2026`
`(kausi)`	Raportille valittu kausi	`202606`
`(maksupvm)`	Maksupäivä muodossa `ppkkvvvv`	`30062026`
`(aikaleima)`	Tiedoston muodostamishetken päivämäärä ja kellonaika	esimerkiksi `2026-06-30T143015`

Avainsanat voi kirjoittaa isoilla tai pienillä kirjaimilla. Järjestelmä käsittelee tiedostonimimallin pienillä kirjaimilla ennen avainsanojen korvaamista.

Esimerkki

Tiedoston nimen malliksi määritetään:

(ytunnus)_(nimi)_(vuosi)_(kausi)_(maksupvm)_(aikaleima).pdf

Kun raportin tiedot ovat:

Y-tunnus: 1234567-8
aineiston nimi: kausiyhteenveto
kausi: 202606
maksupäivä: 30.6.2026
muodostamisajankohta: 30.6.2026 klo 14.30.15

tiedostonimeksi muodostuu esimerkiksi:

1234567-8_kausiyhteenveto_2026_202606_30062026_2026-06-30T143015.pdf

Oletusnimi

Jos Tiedoston nimen malli -kenttä jätetään tyhjäksi, järjestelmä muodostaa tiedostonimen automaattisesti seuraavan rakenteen mukaisesti:

Y-tunnus_aineiston-nimi_vuosi_kausi_maksupäivä_aikaleima.pdf

Huomioitavaa

Tiedostopääte on lisättävä tiedoston nimen malliin, esimerkiksi:

.pdf

Kun oma tiedostonimimalli on määritetty, järjestelmä käyttää mallia sellaisenaan eikä lisää .pdf-päätettä automaattisesti. Tiedostonimessä kannattaa välttää erikoismerkkejä, välilyöntejä ja muita merkkejä, joita vastaanottava SFTP-palvelin ei välttämättä hyväksy.

Raportin tallentaminen asiakkaan SFTP-palvelimelle

Kun SFTP-asetukset on määritetty Pääkäyttäjätoiminnot → API Center → SFTP -sivulla, voidaan raportti tallentaa suoraan asiakkaan SFTP-palvelimelle raporttia muodostettaessa.

Ota käyttöön Arkistoi-valinta.
Kun Arkistoi on valittuna, Käytä sftp-palvelua -valinta aktivoituu.
Ota käyttöön Käytä sftp-palvelua, mikäli haluat raportin tallennettavan asiakkaan SFTP-palvelimelle.
Muodosta raportti normaalisti.

Huom! Käytä sftp-palvelua on käytettävissä vain, kun Arkistoi-toiminto on valittuna. Raportti tallennetaan sekä järjestelmän arkistoon että asiakkaan SFTP-palvelimelle käyttäen pääkäyttäjän määrittämiä SFTP-asetuksia.