Ropo24 - Laskutus API - 202306

Laskutusrajapinta
Ropo24 REST API 202306

Tekninen kuvaus
23.06.2023
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 2 / 139
Tiivistelmä
Ropo 24:ään voidaan lähettää rajapinnan kautta laskuja, maksumuistutuksia,

perintätehtäviä ja muita kirjeitä yrityksesi omasta tietojärjestelmästä käsin.
Rajapinta voidaan integroida osaksi yrityksesi laskutusohjelmaa, jolloin laskujen

tulostus, kuoritus, postitus ja maksunvalvonta voidaan ulkoistaa helposti Ropo
Capitalille. Rajapintaa voidaan käyttää myös osana yrityksesi nettikauppaa tai muuta
automaattista laskutusjärjestelmää, joka luo laskut ennalta määriteltyinä aikoina ja
lähettää ne postitettavaksi Ropo Capitalille automaattisesti ilman ihmisen jatkuvaa
huomiota.
Tämä dokumentti kuvaa rajapinnan tekniseen toteutukseen liittyviä yksityiskohtia.

Dokumentti on tarkoitettu tietojärjestelmäpäälliköille ja ohjelmoijille, jotka integroivat
yrityksesi omia tietojärjestelmiä Ropo Capitalin tietojärjestelmiin.
Ropo Capital Oy
PL 25, 70101 Kuopio | Puh. 030 688 6600 | info@ropocapital.fi | www.ropocapital.fi
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 3 / 139
SISÄLLYS
1 JOHDANTO ___________________________________________________________________________________ 11
JSON REST-API _________________________________________________________________ 11
Tunnukset ______________________________________________________________________ 11
2 KÄSITTEET ___________________________________________________________________________________ 12
3 UUDET JA MUUTTUNEET OMINAISUUDET _____________________________________________________ 13
Kesäkuu 2023 _______________________________________________________________________________ 13
Huhtikuu 2023 ______________________________________________________________________________ 13
Syyskuu 2020 _______________________________________________________________________________ 13
Maaliskuu 2019 _____________________________________________________________________________ 13
Syyskuu 2018 _______________________________________________________________________________ 13
Huhtikuu 2018 ______________________________________________________________________________ 14
Helmikuu 2018 ______________________________________________________________________________ 14
Tammikuu 2018 _____________________________________________________________________________ 14
Toukokuu 2017 ______________________________________________________________________________ 14
Heinäkuu 2017 ______________________________________________________________________________ 14
Toukokuu 2017 ______________________________________________________________________________ 15
Kesäkuu 2016 _______________________________________________________________________________ 15
Kesäkuu 2014 _______________________________________________________________________________ 15
Joulukuu 2013 ______________________________________________________________________________ 16
Elokuu 2013 _________________________________________________________________________________ 16
Toukokuu 2013 ______________________________________________________________________________ 17
Tammikuu 2013 _____________________________________________________________________________ 17
Marraskuu 2012 _____________________________________________________________________________ 18
Huhtikuu 2012 ______________________________________________________________________________ 18
Maaliskuu 2012 _____________________________________________________________________________ 19
Joulukuu 2011 ______________________________________________________________________________ 20
4 AINEISTOJEN SIIRTO _________________________________________________________________________ 21
4.1 Palvelimet ______________________________________________________________________________ 21
4.2 Tunnistautuminen (JSON-Webtoken) _____________________________________________________ 21
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 4 / 139
4.3 Datan siirto _____________________________________________________________________________ 23

4.4 Vastauksen tulkinta _____________________________________________________________________ 24
4.5 Aineistojen siirto pakattuna ______________________________________________________________ 25
5 LASKUTUS ____________________________________________________________________________________ 26
5.1 Myyntilaskun esittäminen ________________________________________________________________ 26
5.2 Hintojen esittäminen ____________________________________________________________________ 31
5.3 Kassa-alennus (käteisalennus) ___________________________________________________________ 33
5.4 Osamaksukauppa ja maksusuunnitelma__________________________________________________ 34
Itselaskettu maksusuunnitelma __________________________________________________ 36
5.5 Käteiskuitti _____________________________________________________________________________ 37
5.6 Hyvityslasku ____________________________________________________________________________ 37
5.7 Laskun lähettäminen omalla viitteellä ja tilinumerolla______________________________________ 42
5.8 Kuluttajan e-laskut ja suoramaksut _______________________________________________________ 43
5.9 Laskun rahoittaminen ___________________________________________________________________ 44
5.10Laskujen ostopalvelu ____________________________________________________________________ 46
5.11Maksuviivästysdirektiivin mukaisen vakiokorvauksen vaatiminen __________________________ 48
5.12Rakennusalan työmaatunnisteiden välittäminen laskulla___________________________________ 49
6 MAKSUMUISTUTUS ___________________________________________________________________________ 51
7 PERINTÄ ______________________________________________________________________________________ 53
7.1 Perintätehtävän esittäminen JSON-muodossa ____________________________________________ 53
7.2 Huomautuskulut perinnässä _____________________________________________________________ 54
8 JSON-TIETOSISÄLLÖN YKSITYISKOHTAINEN KUVAUS _______________________________________ 55
8.1 accepted _______________________________________________________________________________ 55
8.2 accountdate ____________________________________________________________________________ 55
8.3 accountid _______________________________________________________________________________ 56
8.4 accountrow _____________________________________________________________________________ 56
8.5 addaddress _____________________________________________________________________________ 57
8.6 address_________________________________________________________________________________ 57
8.7 addressaddline1, addressaddline2, addressaddline3 ______________________________________ 57
8.8 addresscountry _________________________________________________________________________ 58
8.9 addresstype ____________________________________________________________________________ 58
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 5 / 139
8.10advancepayment ________________________________________________________________________ 60
8.11ahinta __________________________________________________________________________________ 61
8.12allownullvalues _________________________________________________________________________ 61
8.13amount _________________________________________________________________________________ 61
8.14attachment _____________________________________________________________________________ 62
8.15attachmentfile __________________________________________________________________________ 62
8.16attachmentid ___________________________________________________________________________ 63
8.17backorderquantity _______________________________________________________________________ 64
8.18batchid _________________________________________________________________________________ 64
8.19billcode _________________________________________________________________________________ 64
8.20billdate _________________________________________________________________________________ 65
8.21billnow _________________________________________________________________________________ 65
8.22billnum _________________________________________________________________________________ 65
8.23billtemplate _____________________________________________________________________________ 65
8.24billtemplateid ___________________________________________________________________________ 66
8.25cashbill _________________________________________________________________________________ 66
8.26cashdiscountrow ________________________________________________________________________ 67
8.27claimtext _______________________________________________________________________________ 67
8.28checkbillnum ___________________________________________________________________________ 67
8.29city _____________________________________________________________________________________ 68
8.30clientnoticefee __________________________________________________________________________ 68
8.31code____________________________________________________________________________________ 68
8.32collectionprocess _______________________________________________________________________ 69
8.33color ___________________________________________________________________________________ 70
8.34commonerror ___________________________________________________________________________ 70
8.35company _______________________________________________________________________________ 70
8.36contactperson __________________________________________________________________________ 71
8.37contract ________________________________________________________________________________ 71
8.38contract_no _____________________________________________________________________________ 71
8.39count ___________________________________________________________________________________ 71
8.40country _________________________________________________________________________________ 72
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 6 / 139
8.41countryname ____________________________________________________________________________ 72
8.42credit ___________________________________________________________________________________ 72
8.43custnum ________________________________________________________________________________ 73
8.44customaddress _________________________________________________________________________ 73
8.45customerid _____________________________________________________________________________ 73
8.46customertype ___________________________________________________________________________ 73
8.47dataset _________________________________________________________________________________ 74
8.48datastream _____________________________________________________________________________ 74
8.49date ____________________________________________________________________________________ 75
8.50debit ___________________________________________________________________________________ 75
8.51debug __________________________________________________________________________________ 75
8.52definitiondetails _________________________________________________________________________ 77
8.53definitions ______________________________________________________________________________ 77
8.54deliverydate _____________________________________________________________________________ 78
8.55deliverymethod _________________________________________________________________________ 78
8.56deliverymethodid ________________________________________________________________________ 78
8.57deliveryterm ____________________________________________________________________________ 78
8.58deliverytermid ___________________________________________________________________________ 79
8.59desc ____________________________________________________________________________________ 79
8.60discount ________________________________________________________________________________ 79
8.61discountamount ________________________________________________________________________ 80
8.62discountdate ____________________________________________________________________________ 80
8.63discountfreetext ________________________________________________________________________ 80
8.64discountpercent _________________________________________________________________________ 81
8.65doublesided ____________________________________________________________________________ 81
8.66eancode ________________________________________________________________________________ 81
8.67email ja email2 __________________________________________________________________________ 82
8.68enddate ________________________________________________________________________________ 82
8.69energycontract __________________________________________________________________________ 82
8.70error ____________________________________________________________________________________ 83
8.71evoice __________________________________________________________________________________ 83
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 7 / 139
8.72evoiceint ________________________________________________________________________________ 83
8.73expdate_________________________________________________________________________________ 84
8.74finance _________________________________________________________________________________ 84
8.75fixedfee_________________________________________________________________________________ 84
8.76foreignamount __________________________________________________________________________ 85
8.77foreigncurrency _________________________________________________________________________ 85
8.78freetext _________________________________________________________________________________ 85
8.79fromfinvoice ____________________________________________________________________________ 86
8.80fuse ____________________________________________________________________________________ 86
8.81govid ___________________________________________________________________________________ 86
8.82headertext ______________________________________________________________________________ 87
8.83instalment ______________________________________________________________________________ 87
8.84insurance _______________________________________________________________________________ 87
8.85invoicerowtype __________________________________________________________________________ 87
8.86istaxbill _________________________________________________________________________________ 88
8.87itemtype ________________________________________________________________________________ 88
8.88jobid____________________________________________________________________________________ 88
8.89jobtype _________________________________________________________________________________ 89
8.90kwh ____________________________________________________________________________________ 90
8.91language _______________________________________________________________________________ 90
8.92madeintp _______________________________________________________________________________ 90
8.93model __________________________________________________________________________________ 91
8.94name ja name2 _________________________________________________________________________ 91
8.95negvat __________________________________________________________________________________ 91
8.96netamount ______________________________________________________________________________ 91
8.97noreport ________________________________________________________________________________ 92
8.98notice __________________________________________________________________________________ 92
8.99noticefee _______________________________________________________________________________ 93
8.100 noticedate __________________________________________________________________________ 93
8.101 operator ____________________________________________________________________________ 93
8.102 ordernumber ________________________________________________________________________ 94
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 8 / 139
8.103 origbillnum__________________________________________________________________________ 94
8.104 ourcode ____________________________________________________________________________ 94
8.105 overdueinterest _____________________________________________________________________ 94
8.106 ovt _________________________________________________________________________________ 95
8.107 ownref ______________________________________________________________________________ 95
8.108 partycode ___________________________________________________________________________ 97
8.109 partytext ____________________________________________________________________________ 97
8.110 paydate _____________________________________________________________________________ 97
8.111 payplan _____________________________________________________________________________ 97
8.112 payplanamount _____________________________________________________________________ 98
8.113 payplancount _______________________________________________________________________ 98
8.114 payplaninterval ______________________________________________________________________ 99
8.115 payrow _____________________________________________________________________________ 99
8.116 period _____________________________________________________________________________ 101
8.117 person _____________________________________________________________________________ 101
8.118 phone _____________________________________________________________________________ 101
8.119 postcode __________________________________________________________________________ 102
8.120 priceunit ___________________________________________________________________________ 102
8.121 printoperator _______________________________________________________________________ 102
8.122 productarea ________________________________________________________________________ 103
8.123 productid __________________________________________________________________________ 103
8.124 productidentifier ___________________________________________________________________ 103
8.125 productgroup ______________________________________________________________________ 103
8.126 propertyrow ________________________________________________________________________ 103
billtype ______________________________________________________________________ 104
E2001 (sähkön lämmitysriippuvuus) __________________________________________ 104
SEN04 (laskutuksen tyyppi) __________________________________________________ 104
s_bonus_amount, s_bonus_number ja s_bonus_send __________________________ 104
8.127 propname _________________________________________________________________________ 105
8.128 propvalue __________________________________________________________________________ 106
8.129 receiver ____________________________________________________________________________ 106
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 9 / 139
8.130 reference __________________________________________________________________________ 106

8.131 refundiban _________________________________________________________________________ 107
8.132 refundtobillnum ____________________________________________________________________ 107
8.133 refundtojobid ______________________________________________________________________ 107
8.134 result ______________________________________________________________________________ 108
8.135 row ________________________________________________________________________________ 110
8.136 rowline ____________________________________________________________________________ 111
8.137 rowno _____________________________________________________________________________ 111
8.138 rowtype ____________________________________________________________________________ 111
8.139 rowpositionidentifier _______________________________________________________________ 112
8.140 salesman __________________________________________________________________________ 112
8.141 salesmanname_____________________________________________________________________ 112
8.142 sendtype___________________________________________________________________________ 112
8.143 sensible ___________________________________________________________________________ 113
8.144 servicecode ________________________________________________________________________ 114
8.145 sitecode ___________________________________________________________________________ 114
8.146 source _____________________________________________________________________________ 114
8.147 startdate ___________________________________________________________________________ 115
8.148 staticref ___________________________________________________________________________ 115
8.149 storage ____________________________________________________________________________ 115
8.150 subidentifier _______________________________________________________________________ 115
8.151 TA0001 ____________________________________________________________________________ 115
8.152 TA0002 ____________________________________________________________________________ 116
8.153 TA0003 ____________________________________________________________________________ 116
8.154 taxpr ______________________________________________________________________________ 116
8.155 taxrow _____________________________________________________________________________ 116
8.156 text ________________________________________________________________________________ 117
8.157 totalamount________________________________________________________________________ 117
8.158 totalitemprice ______________________________________________________________________ 118
8.159 trafi _______________________________________________________________________________ 118
8.160 transferkey ________________________________________________________________________ 118
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 10 / 139
8.161 type _______________________________________________________________________________ 118

8.162 type2 ______________________________________________________________________________ 118
8.163 type3 ______________________________________________________________________________ 119
8.164 type4 ______________________________________________________________________________ 119
8.165 type5 ______________________________________________________________________________ 119
8.166 unitcode ___________________________________________________________________________ 119
8.167 updatestorage _____________________________________________________________________ 120
8.168 updatestoragejobid_________________________________________________________________ 120
8.169 usage_estimate ____________________________________________________________________ 120
8.170 usage_estimate_unit _______________________________________________________________ 120
8.171 usageplacecode ___________________________________________________________________ 120
8.172 usageplaces _______________________________________________________________________ 120
8.173 userid _____________________________________________________________________________ 121
8.174 value ______________________________________________________________________________ 121
8.175 vatamount _________________________________________________________________________ 122
8.176 vatcode ____________________________________________________________________________ 123
8.177 vatfreetext _________________________________________________________________________ 123
8.178 vatid _______________________________________________________________________________ 123
8.179 vatperiod __________________________________________________________________________ 123
8.180 vatlayout___________________________________________________________________________ 123
8.181 vendor_name ______________________________________________________________________ 124
8.182 voucherbatch ______________________________________________________________________ 124
8.183 vouchernum _______________________________________________________________________ 124
8.184 xmldetailsrow ______________________________________________________________________ 124
8.185 yourcode __________________________________________________________________________ 125
9 EUROOPPALAINEN VERKKOLASKUSTANDARDI _____________________________________________ 126
10 LIITE 4: LASKUPOHJAT _____________________________________________________________________ 127
11 LIITE 5: ISO 3166 -MAAKOODIT JA MAAN NIMET ___________________________________________ 130
12 LIITE 7: SWAGGER KIRJAUTUMINEN (JSON) ________________________________________________ 136
13 LIITE 8: LASKURIVIEN MUOTOILU (JSON) ___________________________________________________ 138
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 11 / 139
1 Johdanto
JSON REST-API
Tämän dokumentin JSON-esimerkit on merkitty sinisellä.
Swagger dokumentaatio löytyy https://rc.ropo24.fi/swagger sekä swaggerin

kirjautumisohjeet tämän dokumentin liitteistä.
Tunnukset
Tarvitset rajapinnan käyttämiseen asiakasnumeron (cid) ja salasanan (apicode). Saat
nämä tiedot Ropo Capitalin IT-palveluista (integraatiot@ropocapital.fi), joka antaa
myös lisätietoja rajapinnan käytöstä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 12 / 139
2 Käsitteet
Tässä dokumentissa käytetään seuraavia käsitteitä:
Asiakas Organisaatio, joka ostaa tavaraa tai palvelua toimeksiantajalta, tämän tytäryritykseltä tai
jälleenmyyjältä.
e-Lasku Kuluttajalle sähköisesti lähetetty lasku, joka toimitetaan tyypillisesti kuluttajan

henkilökohtaiseen verkkopankkiin.
Jälleenmyyjä Organisaatio, joka myy toimeksiantajan tuottamaa tavaraa tai palvelua toimeksiantajan
nimissä.
Laskuttaja Organisaatio, joka luo laskun ja jonka tiedot näkyvät laskun lähettäjänä. Käytännössä
laskuttaja ja toimeksiantaja ovat usein sama organisaatio.
Myyjä Laskuttaja- tai jälleenmyyjäorganisaation henkilö, jonka kanssa asiakas on sopinut kaupasta,
joka palvelee asiakasta tai jonka kanssa asiakas on tehnyt palvelusopimuksen. Esimerkiksi
yksityisellä lääkäriasemalla palvelun tuottava hoitaja tai lääkäri voi olla myyjä, vaikka laskun
kirjoittaa sihteeri.
Operaattori Organisaatio, joka välittää toisen organisaation puolesta laskuja ja perintätehtäviä Ropo
Capitalille
Ostaja Asiakkaan henkilö, joka ostaa tavaraa tai palvelua toimeksiantajalta.
Saatava Velalliselta perittävä maksamaton rahasumma toimeksiantajan myymistä tavaroista tai

palveluista, johon on lisätty viivästyskorot ja Ropo Capitalin kulut
Toimeksiantaja Organisaatio, joka antaa Ropo Capitalille tehtäväksi periä saatavaa. Käytännössä yleensä
sama kuin laskuttaja.
Velallinen Henkilö tai yritys, joka on vastuussa laskun maksamisesta. Usein velallinen on sama kuin
laskun alkuperäinen vastaanottaja eli asiakas.
Verkkolasku Yritykselle lähetetty sähköinen lasku, joka toimitetaan tyypillisesti yrityksen omaan
ostolaskujen käsittelyohjelmaan.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 13 / 139
3 Uudet ja muuttuneet ominaisuudet

Kesäkuu 2023
Muutettu testiympäristön osoitteet beta -> rc
Beta poistettu käytöstä
Poistettu viittaukset dataset xml-formaattiin. Mikäli tarve dataset xml:lle, niin tulee
tästä sopia erikseen palvelun käyttöönoton yhteydessä.
Lisätty ohjeet aineiston toimituksesta zip-pakattuna.
Huhtikuu 2023
Poistettu vanhentunut palvelu “Tilausvahvistukset ja muut kirjeet”
Syyskuu 2020
Tuki Eurooppalaiselle verkkolaskustandardille
Maaliskuu 2019
Versio 3.20 muutokset:
• http-liikenteen tuki lopetettu
• tarkennettu tehtävien yksittäisen toimistuserän maksimikokoa
Syyskuu 2018
Versio 3.19 uudet ominaisuudet:
• accountrow-tagi lisätty payrow-tagin alle, jolloin tiliöintitiedot voidaan lisätä

rivikohtaisesti
• lisätty propertyrow arvot E2001 (sähkön lämmitysriippuvuus), SEN04

(laskutuksen tyyppi) ja S-Bonus määrien ilmoitus tietokentät s_bonus_amount,
s_bonus_number ja s_bonus_send
• payplan tagilla itselaskettu maksusuunnitelma
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 14 / 139
Huhtikuu 2018
Versio 3.14 uusi tagi:
• datastream: batchid
Helmikuu 2018
Uudet ja muuttuneet tagit:
• dataset: accountdate, vatlayout, contract, ovt
• addaddress: ovt
• contract: contract_no
Tammikuu 2018
Versio 3.10 sisältää uusia ominaisuuksia:
• Laskujen ostopalvelu: voit nyt hakea laskujen ostopalvelua Ropo Financelta!
• dataset: addressaddline3, error, origbillnum

• addaddress: addressaddline3, contactperson, countryname
• payrow: allownullvalues, subindentifier, rowpositionidentifier, usageplacecode
Toukokuu 2017
Versio 3.07
• https://beta.ropo24.fi -osoite otettu käyttöön.

• https://beta2.trustpoint.fi poistuu 31.10.2017.
Heinäkuu 2017
Versio 3.05
• https://www.ropo24.fi -osoite otetaan käyttöön 3.7.2017.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 15 / 139
• https://www.trustpoint.fi sekä https://online.trustpoint.fi -osoitteet poistuvat

31.10.2017.
• https://beta2.trustpoint.fi jää toistaiseksi käyttöön.
Toukokuu 2017
• JSON REST-API: Mahdollisuus käyttää laskutukseen JSON-muotoista dataa.

• Swagger: JSON REST-API:n testaus ja dokumentaatio.
• Trust Kapital ja TrustPoint termien päivitys Ropo Capital ja Ropo 24.
Kesäkuu 2016
• Ennakkomaksu: laskuttaja voi nyt lähettää ennakkomaksun tiedot, josta

muodostetaan suoritus Trustpointiin ja vähennetään laskutettavaa summaa.
Laskulla ennakkomaksu näkyy suorituksena. Lue lisää sivulta 63.
• Laskurivikohtainen kustannuspaikka: Jos rajapintaan syötetyillä laskuriveillä
(payrow-tietueilla) on annettuna servicecode, käytetään sitä
kustannuspaikkana sen sijaan että käytettäisiin koko laskulla samaa
kustannuspaikkaa. Huom! Tämä on vain käytössä siinä tapauksessa, että
tiliöintirivejä (accountrow) ei anneta erikseen! sivulta 124.
• lisätty advancepayment-tagi
• payrow-tagin alle lisätty tagi servicecode
Kesäkuu 2014
• Rakennusalan työmaatunnisteet: sähköisissä laskuissa voidaan nyt siirtää

verohallinnon vaatimat rakennusalan työmaa-avaimet ja työmaanumerot
asiakkaalle koneellisesti luettavassa muodossa.
• Parempi Finvoice ja Teapps-tuki: laskuttaja voi nyt lähettää vapaamuotoisia
lisätietoja asiakkaalle laskun automaattista kohdistusta tai maksamista varten.
Lue lisää xmlsdetailsrow-tagista sivulta 124.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 16 / 139
• Lisää räätälöintimahdollisuuksia: voit nyt muokata laskun ulkoasua ja perintää

antamalla Trust Kapitalille ohjaustietoja. Lue lisää propertyrow-tagista sivulta
103.
• Toimitustapa ja toimitusehto: voit nyt tulostaa laskuille toimitustavan ja
toimitusehdon. Lue lisää sivulta 78.
1. lisätty propertyrow-tagi ja sen alle tagit propname ja propvalue
2. lisätty xmldetailsrow-tagi ja sen alle tagit source, text, code, value
3. dataset-tagin alle lisätty tagit deliverymethod, deliveryterm
4. dataset-tagin ja payrow-tagien alle lisätty tagit TA0001, TA0002, TA0003
Joulukuu 2013
• Kuluttajan e-laskut: voit nyt lähettää kuluttajille e-laskuja tarvitsematta muuttaa

sovellustasi millään tavalla!
• Laskusaatavarahoitus: voit nyt hakea rahoitusta laskullesi Trust Financelta!
• Toimituspäivä: laskun tai lähetteen tiedoissa voidaan näyttää toimitusosoitteen
lisäksi myös tuotteiden toimituspäivä.
Uudet ja muuttuneen tagit:
1. dataset-tagin alle lisätty tagit finance, deliverydate
Elokuu 2013
• Kassa-alennus: laskusta voidaan antaa esimerkiksi 2% alennus, jos velallinen

maksaa saatavan 10 vuorokaudessa.
1. dataset-tagin alle lisätty cashdiscountrow-tagi, jonka alla voi olla tagit

discountdate, discountpercent, discountamount ja discountfreetext
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 17 / 139
2. Tagit color ja printoperator eivät ole enää käytössä. Värikirjeiden lähettäminen

on edelleen mahdollista, mutta väritulostuksen käyttöönotosta tulee sopia
etukäteen Trust Kapitalin kanssa.
Toukokuu 2013
• Vakiokorvaus: maksuviivästysdirektiivin 2011/7/EU perusteella yritysvelalliselta

voidaan periä kiinteä 40 euron vakiokorvaus maksuviiveestä. Jos olet sopinut
Trust Kapitalin kanssa vakiokorvausten käyttöönotosta, voit nyt valita
laskukohtaisesti keneltä vaadit korvausta ja keneltä et.
• Toimeksiantajan kulu: jos muistutat velallisia itse ja siirrät tehtävän Trust
Kapitalille vasta perintävaiheessa, voit nyt antaa omat huomautuskulusi Trust
Kapitalille edelleen perittäväksi.
1. dataset-tagin alle lisätty tagit: noticefee, fixedfee
Tammikuu 2013
Versio 2.52 tuo uusia ominaisuuksia:
• EAN-koodi: laskulla voidaan esittää tuotteen yhteydessä skannattava EAN-

viivakoodi varastonhallinnan helpottamiseksi.
• Laskurivikohtainen myyjä: yhdellä laskulla voi olla usean
myyjän/asiakaspalvelijan tuotteita, jotka ryhmitellään ja esitetään myyjän
nimen alla. Ominaisuutta voidaan hyödyntää esimerkiksi lääkäriasemalla ja
varaosaliikkeissä: laskurivin myyjä täsmentää kuka oli hoitava lääkäri tai kenen
kanssa kaupasta neuvoteltiin. Laskurivin myyjällä voi olla merkitystä myös
myyntiprovisioiden kannalta: jos myyjien palkkiot perustuvat laskutettuihin
määriin, asiakkaalle ei enää tarvitse toimittaa useita laskuja pelkästään sen
takia, että jokaiselle myyjälle täytyy saada oikea palkkio!
• Laskuriville alku- ja loppupäivä: laskurivillä voidaan nyt esittää toimituspäivä tai
päivämääräväli. Tämä on hyödyllistä esimerkiksi majoitus- ja sairaala-alalla,
missä palvelun käyttö tapahtuu tiettynä aikana, ja lasku voi muodostua useista
eri aikoina käytetyistä palveluista.
• Laskujen tiliöinti: myyntilaskut voidaan tiliöidä alustavasti automaatin toimesta
ja tiliöinti voidaan viedä Trustpointin-läpi. Tämä mahdollistaa myyntilaskujen
yksityiskohtaisemman erittelyn raporteilla ja helpottaa kirjanpitäjän työtä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 18 / 139
2. payrow-tagin alle on lisätty tagit: eancode, salesman, salesmanname, startdate,

enddate
3. dataset-tagin alle lisätty accountrow-tagi, jonka alla voivat esiintyä tagit:

accountid, taxpr, vatamount, netamount, credit, debit, servicecode, desc
4. dataset-tagin alle lisätty tagit: period, vatperiod, vouchernum, voucherbatch
Marraskuu 2012
Rajapinnan versio 2.50 antaa asettaa täsmälliset loppusummat, arvonlisäveroerittelyn

rivit ja verolliset yksikköhinnat. Aiemmissa rajapinnan versioissa nämä summat on
laskettu laskurivien perusteella, jolloin erilaisesta laskentatavoista ja liukulukujen
pyöristysvirheistä johtuen arvonlisäveron määrä ja laskun loppusumma eri
järjestelmissä on voinut poiketa toisistaan yhdellä sentillä.
1. dataset-tagin alle on lisätty netamount-tagi, joka ilmoittaa laskun verottoman

loppusumman, vatamount-tagi, joka ilmoittaa laskun sisältämän
arvonlisäveron määrän yhteensä, ja totalamount-tagi, joka ilmoittaa laskun
verollisen loppusumman
2. dataset-tagin alle on lisätty taxrow-tagi, jolla esitetään arvonlisäveroerittelyn

rivi
3. payrow-tagin alle on lisätty totalitemprice-tagi, joka ilmoittaa tuotteen

verollisen yksikköhinnan INC-laskupohjaa varten, netamount-tagi, joka
ilmoittaa tuoterivin verottoman kokonaishinnan, vatamount-tagi, joka ilmoittaa
veron määrän ja totalamount-tagi, joka ilmoittaa laskurivin verollisen
kokonaishinnan.
4. muistutus- ja perintätehtävien verollinen loppusumma voidaan esittää dataset-

tagin alla amount- tai totalamount-tagilla.
Huhtikuu 2012
Versio 2.32 tuo uusia ominaisuuksia:
• Maksusuunnitelma: velallisen ei enää tarvitse maksaa laskua kerralla, vaan voit

halutessasi antaa lisää maksuaikaa laatimalla maksusuunnitelman ja
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 19 / 139
lähettämällä sen Trustpointtiin laskun yhteydessä. Kuluttajalle ensimmäisen

laskun lähettäminen maksusuunnitelmalla on kuitenkin vastoin
kuluttajasuojaviranomaisen ohjeistusta. Yrityslaskutuksessa
maksusuunnitelman voi tehdä jo suoraan ensimmäiselle laskulle.
• Verolliset hinnat: järjestelmään on lisätty kuluttajakauppaa varten INC-
laskupohja, jolla tuotteiden hinnat esitetään verollisena. Laskupohja on
hyödyllinen pienyrityksille, jotka tekevät pääsääntöisesti kauppaa kuluttajien
kanssa.
1. payplanamount
2. payplancount
3. payplaninterval
4. billtemplate
Maaliskuu 2012
Versio 2.1 tuo mukanaan uusia ominaisuuksia:
• Liitteet: voit lisätä laskuille mm. PDF ja JPG-muotoisia liitteitä attachmentfile-

tagilla.
• Väritulostus: laskut ja muut kirjeet voidaan nyt tulostaa väreissä! Voit ottaa
värit käyttöön muuttamalla yrityksen asetuksia tai antamalla color-tagin niillä
laskuilla, jotka lähetetään väreissä.
• Merkki: laskulle tulostuu viitteemme ja viitteenne kenttien lisäksi merkki-kenttä.
Kenttää voidaan käyttää esimerkiksi asiakkaan kustannuspaikan, merkin tai
mallin ilmoittamiseen. Merkki annetaan model-tagilla.
• Myyjä: myyjän nimi tulostuu nyt laskulle.
• Laskurivin vapaa teksti: laskurivin yhteyteen voidaan lisätä monirivinen
seliteteksti freetext-tagilla. Selitettä voidaan käyttää esimerkiksi tuotteen
ominaisuuksien täsmentämiseen.
• Tulostuspalvelu: laskutusrajapinnan kautta voidaan nyt lähettää myös
tiedotteita ja muita kirjeitä.
1. attachmentfile
2. color
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 20 / 139
3. model
4. printoperator
5. freetext
6. jobtype
7. language
Joulukuu 2011
Versio 2.0.1 tuo uusia ominaisuuksia:
• Saatavan laji: saatavan laji vaikuttaa tehtävän etenemiseen perinnässä, mm.

velalliselta perittäviin kuluihin ja aikatauluihin. Saatavan laji annetaan
collectionprocess-tagilla.
• Laskupohja: voit valita laskulle uuden ulkoasun käyttämällä billtemplate-tagia.
Ulkoasu vaikuttaa mm. siihen onko arvonlisävero eroteltu riveittäin, ja millaista
fonttia laskulla käytetään.
1. collectionprocess
2. billtemplate
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 21 / 139
4 Aineistojen siirto
4.1 Palvelimet
Laskut, muistutukset ja muut kirjeet toimitetaan sovitussa formaatissa. Tässä

dokumentissa kuvattuna Ropo24:n dataset-sanoma json-muodossa. Muussa kuin
Ropo24:n dataset json-muodossa toimitetut aineistot vaativat muunnoksen
Ropo24:ssa, joten nämä sovittava aina erikseen käyttöönoton yhteydessä. Kappaleet
tunnistautuminen Sanomat lähetetään rc.ropo24.fi tai ropo24.fi -palvelimelle HTTP-
protokollan päällä. Näistä edellinen on testipalvelin, jonka avulla voidaan kehittää
rajapintaa tukevia sovelluksia ja jälkimmäinen on tuotantopalvelin, jonne lähetetään
oikeita laskuja. Testiympäristöön lähetettyjä laskuja, muistutuksia tai
perintätoimeksiantoja ei toimiteta velallisille, eivätkä tehtävät etene automaattisesti
maksuvalvonnassa.
Palvelu tukee ainoastaan HTTPS-muotoisia pyyntöjä. Pyynnöt lähetetään TCP-porttiin

443.
Yhden HTTPS-pyynnön maksimikoko riippuu lähetettävien tehtävien tyypistä.

Muistutuksia, perintätoimeksiantoja ja ns. normaalilaskuja voi olla yhdessä
pyynnössä 1000 kpl. Jos taas lähetys sisältää koontilaskuja tai muuten isoja
yksittäisiä laskuja, niin yhden pyynnön maksimikoko on 500 kpl. Sopiva eräkoko
suurille masoille tulee aina testata yhdessä Ropo Capitalin kanssa.
Sanomat voidaan toimittaa tarvittaessa myös pakattuna (zip).
4.2 Tunnistautuminen (JSON-Webtoken)
Rajapinta käyttää tunnistautumiseen JSON-webtokenia. Token haetaan lähettämällä

HTTP POST pyyntö
curl -X POST --header 'Content-Type: application/json' --header

'Accept: application/json' -d '{ \
"cid": "1000011", \
"apicode": "password123" \
}' 'https://rc.ropo24.fi/rest/token'
siten, että asiakasnumero annetaan cid-muuttujassa ja salasana apicode-muuttujassa.

Onnistuneesta kirjautumisesta saat vastaukseksi tokenin.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 22 / 139
{
"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIxMDAwMDExIi
wiaWF0IjoxNDk1NTIxODI4LCJleHAiOjE0OTU1MjkwMjh9.OTtOIR2vseuytI95KXmtS
oxnG2HQq7pfGd2aP9rGeZRXf5a5pRb4zsSbGo8xrDe-EQZ-0q3EjtcuxZHI3VUu_g"
}
Poimi token-arvo talteen, ja lisää se jatkossa HTTP-kutsun Headerin Authorization

arvoon.

'Accept: application/json' --header 'Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIxMDAwMDExIiwiaWF0Ijo
xNDk1NTIxODI4LCJleHAiOjE0OTU1MjkwMjh9.OTtOIR2vseuytI95KXmtSoxnG2HQq7
pfGd2aP9rGeZRXf5a5pRb4zsSbGo8xrDe-EQZ-0q3EjtcuxZHI3VUu_g’
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 23 / 139
4.3 Datan siirto
Data siirretään HTTPS POST metodilla alla olevaan osoitteeseen. Data http-bodyssa
ja Token Authorization Headerissa.
https://rc.ropo24.fi/REST/jobs
Yksinkertainen lasku Ropo24 dataset JSON-muodossa voisi esimerkiksi olla:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"company": "Kaneli & Pulla Oy",
"address": "Satamakatu 123",
"postcode": "70100",
"city": "KUOPIO",
"customertype": "1",
"billdate": "2017-05-23",
"paydate": "2017-06-17",
"payrow": [
{
"desc": "Leivokset",
"count": "20",
"amount": "15.53",
"taxpr": "24.00"
}
],
"freetext": "Kiitos ostoksesta! Tervetuloa
uudelleen. Olemme avoinna myös isänpäivänä 10.11 klo 12-16."
}
]
}
}
Sanoman lähettäminen
Esimerkki curl:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 24 / 139

'Accept: application/json' --header 'Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIxMDAwMDExIiwiaWF0Ijo
xNDk1NTIzMjQ2LCJleHAiOjE0OTU1MzA0NDZ9.5QFAZyghLNSDSfTAEO2YQjzok8AB1F
zjKrSqq_jLImYbEz1KIt_5UCLI170aWqzzZxSkNP1FwA2FGC1ZSWB8EQ' -d '{ \
"datastream": { \
"dataset": [ \
{ \
"jobtype": "0", \
"company": "Kaneli %26 Pulla Oy",
\
"address": "Satamakatu 123", \
"postcode": "70100", \
"city": "KUOPIO", \
"customertype": "1", \
"billdate": "2017-05-23", \
"paydate": "2017-06-17", \
"payrow": [ \
{ \
"desc": "Leivokset", \
"count": "20", \
"amount": "15.53", \
"taxpr": "24.00" \
} \
], \
"freetext": "Kiitos
ostoksesta! \
\
Tervetuloa uudelleen. Olemme
avoinna myös isänpäivänä 10.11 klo 12-16." \
} \
] \
} \
} \
' 'https://rc.ropo24.fi/rest/jobs'
4.4 Vastauksen tulkinta
Kun edellä luotu sanoma on lähetetty Ropo 24:ään, palvelin vastaa lähettämällä
laskulle generoidun tehtävänumeron ja muut lisätiedot JSON-muodossa:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 25 / 139
{
"accepted": 1,
"result": [
{
"billnum": "1125",
"reference": "7100001195662912",
"ownref": "",
"jobid": 9566291,
"jobtype": "0",
"amount": "385.14",
"receiver": "Kaneli & Pulla Oy",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
4.5 Aineistojen siirto pakattuna
Laskutus API rajapintaan aineistot voidaan toimittaa tarvittaessa myös zip-pakattuna.

Hyödyllinen toiminnallisuus varsinkin, jos aineistot toimitetaan muussa kuin Ropo24
json dataset formaatissa ja kyseinen data ei tue esim. liitteiden toimittamista Base64
koodattuna datan sisällössä.
Kun data lähetetään rajapintaan, laskuaineisto header-tiedoissa on oltava Content-

Type oikein:
• "Content-Type: application/zip"
Esimerkki curl zip-pakatun aineiston lähetyksestä curlilla:
curl -X POST "https://rc.ropo24.fi/rest/jobs" -H "accept:

application/json" -H "Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3MDAwNDM5Iiwic2NvcGU
iOltdLCJyb2xlcyI6WyJhcGljb2RlIl0sImlhdCI6MTU2ODk2Mzc4OCwiZXhwIjoxNTY
4OTcwOTg4fQ.KyVsEJ63eUBvTrOz4bsfrm0gNLL-cSJcBBMWJnJ183jgc5zEye7p-
u3kYSjUdzehoYuN-TayHJJy502DSKXXX" -H "Content-Type:
application/zip" --data-binary "@/home/user/ftptest/sy/XXX123.zip"
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 26 / 139
5 Laskutus
5.1 Myyntilaskun esittäminen
Myyntilaskun tulee sisältää vähintään tagit:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"person": "Teppo Testaaja",
"address": "Sammonkatu 23-25 A 7",
"city": "KUOPIO",
"billdate": "2017-03-03",
"paydate": "2017-03-17",
"payrow": [
{
"desc": "Hieronta",
"count": "1",
"itemtype": "h",
"amount": "35.00",
"taxpr": "24.00"
}
],
}
]
}
}
Tilanteesta riippuen lasku voi sisältää myös vapaaehtoisia tageja, joista yleisimmät
on esitelty alla. Tagien yksityiskohtaiset kuvaukset löytyvät tämän dokumentin
lopusta.
Laskun tiedot (dataset-tag)
Tagi Kuvaus
addaddress Toimitusosoite tai lisäosoite, johon lähetetään kopio laskusta
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 27 / 139
Tagi Kuvaus
address Vastaanottajan katuosoite, esim Mäkikatu 12 B 4
addressaddline1 Ensimmäinen osoitekortin lisärivi, tulostuu vastaanottajan nimen ylle
addressaddline2 Toinen osoitekortin lisärivi, tulostuu nimen ja katuosoitteen väliin
addresscountry Vastaanottajan kotimaa, esim FIN
attachment Liitedokumentti
billcode Viite tai viesti, jolla suoritus tilitetään laskuttajalle
billdate Laskun päiväys muodossa vvvv-kk-pp
billnum Laskun juokseva numero toimeksiantajan kirjanpidossa
billtemplate Laskun asettelumalli: CUSTOM, ECOM, BOBCAT, INC
cashbill Käteiskuitti, merkitään suoraan maksetuksi: 1=käteiskuitti
checkbillnum Varmista, että laskunumero on yksilöivä: 1=päällä
city Velallisen postitoimipaikka
collectionprocess Perintää ohjaava saatavan laji
company Yritysasiakkaan nimi, esim Matin konepaja Oy
country Maa, johon asiakasyritys on rekisteröity, esim FIN
custnum Asiakkaan asiakasnumero toimeksiantajan järjestelmässä
customertype Asiakkaan tyyppi: 1=yritys, 2=yksityishenkilö
deliverydate Toimituspäivä muodossa VVVV-KK-PP
deliverymethod Toimitustapa tekstinä
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 28 / 139
Tagi Kuvaus
deliveryterm Toimitusehto tekstinä
email Sähköpostiosoite, johon lasku lähetetään
email2 Toinen sähköpostiosoite, johon lasku lähetetään
evoice Verkkolaskuosoite, esim FI123578612717718
evoiceint Välittäjän tunnus sähköisessä laskutuksessa, esim NDEAFIHH
freetext Laskun loppuun liitettävä vapaa teksti
govid Asiakkaan Y-tunnus tai henkilöllisyystunnus
jobtype Sanoman tyyppi: 0 = lasku, 1=maksumuistutus, 2=Perintä, 300=tulostuspalvelu,

301=postituspalvelu (muut dokumentit)
language Laskun kieli: eng, fin, swe, est
model Merkki, kustannuspaikka asiakkaan kirjanpidossa tai muu viite
negvat 1, jos laskulla käytetään käännettyä verovelvollisuutta
ordernumber Tilausnumero
ourcode Toimeksiantajan viite, esim Ford Transporter 1.2.2010-15.2.2010
overdueinterest Viivästyskorkoprosentti, esim 8.00
ownref Tilapäinen lähetysviite
paydate Laskun eräpäivä muodossa vvvv-kk-pp
period Päivämäärä, jolle lasku kirjataan toimeksiantajan kirjanpidossa
person Kuluttaja-asiakkaan nimi, esim Teppo Nuutinen
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 29 / 139
Tagi Kuvaus
phone Asiakkaan/ostajan/velallisen puhelinnumero
postcode Asiakkaan postinumero, esim 70100
salesman Myyjän tunnus
salesmanname Myyjän nimi tai nimikirjaimet
sendtype Laskun lähetystapa: post, print, email tai evoice
sensible Lähetetäänkö maksumuistutus automaattisesti: 1=ei, 0=kyllä
servicecode Kustannuspaikka, Ropo 24 -järjestelmässä
vatid Asiakkaan ALV-tunnus, esim FI22059054
vatperiod Päivämäärä, jolle arvonlisävero kohdistuu toimeksiantajan kirjanpidossa
voucherbatch Tositelaji
vouchernum Tositteen numero
yourcode Ostajan viite, esim Teppo Nuutinen
advancepayment Ennakkosuoritus
Laskurivit (payrow-tagi)
Tagi Kuvaus
amount Veroton yksikköhinta
count Kappalemäärä
desc Tuotteen nimi
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 30 / 139
Tagi Kuvaus
discount Alennusprosentti
eancode EAN-koodi
enddate Ajanjakson loppupäivä (esimerkiksi hotellihuoneen luovutuspvm)
freetext Tuotetta täydentävä mahdollisesti monirivinen selite
itemtype Määrän yksikkö, esimerkiksi kpl, h tai m3
netamount Laskurivin veroton summa
productid Tuotekoodi
salesman Myyjän koodi
startdate Ajanjakson alkupäivä
taxpr Arvonlisäveroprosentti 0-100
totalamount Laskurivin verollinen summa
totalitemprice Verollinen yksikköhinta
vatamount Laskurivin sisältämä arvonlisäveron määrä
servicecode Kustannuspaikka
Metatiedot (datastream-tagi)
Tagi Kuvaus
debug Rajapinnan testaus, true=päällä
transferkey Siirtoavain, ks. luku 4.2
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 31 / 139
5.2 Hintojen esittäminen
Helppo tapa
Laskun hinnat voidaan esittää yksinkertaisesti antamalla laskuriveille veroton

yksikköhinta amount-tagilla, kappalemäärä count-tagilla ja veroprosentti taxpr-tagilla.
Ropo 24 laskee näiden tietojen perusteella laskulle verottoman hinnan, arvonlisäveron
ja verollisen loppusumman.
Jos esimerkiksi myydään 2 kpl pelikortteja hintaan 8,05 euroa kpl ja kirja hintaan 22,89
euroa, niin vastaava lasku voidaan luoda yksinkertaisesti lähettämällä Ropo 24:ään
laskurivit:
JSON:
"payrow": [
{
"desc": "Angry Birds -pelikortit",
"count": "2",
"amount": "8.05",
"taxpr": "24"
},
{
"desc": "The Theory of Poker",
"count": "1",
"amount": "22.89",
"taxpr": "10"
}
]
Ropo 24 laskee yllä olevien tietojen perusteella verottomaksi hinnaksi 38,99 euroa (2
x 8,05 + 22,89 = 38,99), arvonlisäveron määräksi 6,15 euroa (2 x 8,05 x 0,24 + 22,89 x
0,10 = 6,1530) sekä verolliseksi loppusummaksi 45,14 euroa (39,99 + 6,15 = 45,15).
Verollinen loppusumma 45,14 euroa palautuu Ropo 24:n vastaussanomassa amount-
tagissa, josta se voidaan poimia talteen yrityksen omaan reskontraan.
Yksinkertainen tapa on helppo ottaa käyttöön ja se on hyödyllinen erityisesti

tilanteissa, joissa ostaja ei näe lopullista hintaa tai arvonlisäveroerittelyä ennen
ostoksen vahvistusta.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 32 / 139
Täsmällinen tapa
Täsmällisessä tavassa laskun veroton summa, veron määrä ja verollinen summa

lasketaan etukäteen mahdolliset alennukset huomioiden, ja tulos välitetään Ropo
24:ään JSON-sanomassa. Ropo 24 tulostaa JSON-sanomassa ilmoitetut tiedot
laskulle sellaisenaan.
Kunkin laskurivin veroton summa, veron määrä ja verollinen loppusumma esitetään

payrow-tagin alla netamount-, vatamount- ja totalamount-tageilla. Nämä
laskurivikohtaiset tiedot summataan arvonlisäveroprosentin mukaan ja summat
esitetään taxrow-tagin avulla. Lopuksi arvonlisäveroerittelyn rivit summataan yhteen,
ja laskun veroton summa, veron määrä ja verollinen summa esitetään dataset-tagin
alla netamount-, vatamount- ja totalamount-tageilla.
Jos esimerkiksi myydään 2 kpl pelikortteja hintaan 8,05 euroa kpl ja kirja hintaan 22,89
euroa, niin lasku luodaan lähettämällä Ropo 24:ään laskurivit:
JSON:
"payrow": [
{
"desc": "Angry Birds -pelikortit",
"count": "2",
"amount": "8.05",
"taxpr": "8.05",
"netamount": "16.10",
"vatamount": "3.86",
"totalamount": "19.96"
},
{
"desc": "The Theory of Poker",
"count": "1",
"amount": "22.89",
"taxpr": "10",
}
]
Laskurivit summataan arvonlisäveroprosentin mukaan ja laskulle lisätään

arvonlisäveroerittely:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 33 / 139
JSON:
"taxrow": [
{
"taxpr": "24",
"totalamount": "19.96",
},
{
"taxpr": "10",
}
]
Lopuksi arvonlisäveroerittelyn rivit summataan yhteen, ja laskun veroton summa,

veron määrä ja verollinen loppusumma esitetään dataset-tagin alla:
JSON:
Täsmällinen tapa on hyödyllinen, jos hinnan laskentamenetelmä omassa

järjestelmässäsi on erilainen kuin Ropo 24:ssa tai jos ostajalle näytetään laskun
loppusumma ja arvonlisäveroerittely ennen laskun lähettämistä Ropo 24:ään.
Käyttämällä täsmällistä tapaa varmistat, että laskun loppusumma, arvonlisäveron
määrä ja veroton hinta Ropo 24:ssä on sentilleen sama kuin omassa järjestelmäs-
säsi1.
5.3 Kassa-alennus (käteisalennus)
Kassa-alennusta käyttämällä yrittäjä voi pyrkiä nopeuttamaan rahan kiertoa: yrittäjä

voi esimerkiksi luvata ostajalle 2% alennuksen, mikäli tämä maksaa laskun 10
vuorokauden kuluessa.
Pyöristysvirheitä saattaa yhä esiintyä Ropo 24:ssä luotavalla hyvityslaskulla. Pyöristysvirheiden määrää voi vähentää
1
esittämällä tuotteiden yksikköhinnat useammalla desimaalilla, ja pyöristysvirheet voidaan eliminoida kokonaan luomalla
myös hyvityslasku laskuttajan järjestelmässä ja välittämällä se Ropo 24:ään tämän laskutusrajapinnan kautta.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 34 / 139
Kassa-alennus annetaan lisäämällä dataset-tagin alle cashdiscountrow-tagi. Jos

esimerkiksi 1 415,00 euron laskusta annetaan 2% alennus, mikäli asiakas maksaa 10
vuorokauden kuluessa, niin laskun tietoihin lisätään cashdiscountrow-tagi:
JSON:
"cashdiscountrow": [
{
"discountdate": "2016-11-01",
"discountpercent": "2",
"discountamount": "28.30"
}
]
missä 2016-11-01 on käteisalennuksen viimeinen voimassaolopäivä, 2 on

alennusprosentti ja 28,30 on käteisalennuksen määrä euroina. Lisäksi
cashdiscountrow-tagin alle voidaan antaa discountfreetext-tagi, joka ilmoittaa
alennuksen määrän selväkielisenä. Tagin arvo voi olla esimerkiksi:
JSON:
"discountfreetext": "10 pv -2%"
Jos discountfreetext-tagia ei anneta JSON-sanomassa, Ropo 24 muodostaa laskulle

yllä olevan kaltaisen tekstin laskun päiväyksen, eräpäivän ja alennusprosentin
perusteella.
5.4 Osamaksukauppa ja maksusuunnitelma
Osamaksukaupassa asiakkaalle laaditaan maksusuunnitelma, jossa määritellään

erien lukumäärä ja summa. Ropo Capital valvoo suorituksia ja lähettää asiakkaalle
muistutuksen, jos tämä ei noudata maksusuunnitelmaa. On kuitenkin hyvä huomioida
se, että kuluttajaviranomaisen ohjeistuksen mukaan kuluttajalle ei voida lähettää
suoraan laskua, jossa on maksusuunnitelma.
Maksusuunnitelma voidaan laatia Ropo 24:ssa kahdella tavalla: (1) antamalla erän
maksettava summa ja jättämällä erien lukumäärä avoimeksi, tai (2) antamalla erien
lukumäärä ja jättämällä erän maksettava summa avoimeksi (voit myös laskea itse
erät kts. Itselaskettu maksusuunnitelma). Ensimmäinen tapa on hyödyllinen, jos
asiakas maksaa tietyn summan säännöllisesti kuten esimerkiksi 50 euroa joka kuu-
kausi. Jälkimmäinen tapa on taas hyödyllinen, jos halutaan vaatia, että lasku tulee
maksetuksi tietyn ajan kuluessa.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 35 / 139
Maksusuunnitelma luodaan payplaninterval-, payplanamount- ja payplancount-

tageilla. Payplaninterval ilmoittaa maksuerien välisen ajan kokonaisina kuukausina,
payplanamount yhden maksuerän summan euroina ja payplancount maksuerien
lukumäärän. Maksusuunnitelmaa laadittaessa JSON-sanomaan lisätään aina
payplaninterval-tagi ja sekä toinen payplanamount- ja payplancount-tageista.
Jos esimerkiksi luodaan maksusuunnitelma laskulle, jonka loppusumma on 499,99

euroa siten, että asiakas maksaa 100 euroa kuukaudessa, niin Ropo 24:ään lähetetään
laskun tietojen yhteydessä tagit:
JSON:
"billdate": "2017-03-01",
"paydate": "2017-03-15",
"payplaninterval": "1",
"payplanamount": "100"
jolloin laskulle muodostuu maksusuunnitelma:
Erä Maksupäivä Summa
1 15.03.2017 100,00 €
2 15.04.2017 100,00 €
3 15.05.2017 100,00 €
4 15.06.2017 100,00 €
5 15.07.2017 99,99 €
Jos sen sijaan luodaan samalle laskulle maksusuunnitelma siten, että lasku
maksetaan kahdessa erässä 6 kuukauden välein, niin laskulle lisätään tagit:
JSON:
"billdate": "2017-03-01",
"paydate": "2017-03-15",
"payplancount": "2"
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 36 / 139
jolloin laskulle muodostuu maksusuunnitelma:
1 15.03.2017 250,00 €
2 15.09.2017 249,99 €
Huomaa, että maksusuunnitelmaa ei voi välittää sähköisessä laskussa tai kuluttajalle

lähetettävässä laskussa (estetty myös rajapinnassa). Jos haluat laskuttaa myynnin
useassa osassa käyttäen sähköistä laskutusta tai teet laskun kuluttajalle, tee Ropo
24:n käyttöliittymässä jaksolasku tai lähetä rajapinnan kautta erillinen lasku aina kun
uusi erä lankeaa maksettavaksi.
Itselaskettu maksusuunnitelma
Itselaskettu maksusuunnitelma toimii, kuten edelliset versiot, mutta saat itse päättää
eräpäivät ja summat.
1 15.03.2017 250,00 €
2 15.09.2017 249,99 €
JSON:
"payplan": {
"instalment": [
{
"date": "2017-03-15",
"amount": "250.00"
},
{
"date": "2017-09-15",
"amount": "249.99"
}
]
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 37 / 139
5.5 Käteiskuitti
Käteiskuitti lähetetään rajapintaan samalla tavoin kuin lasku, mutta sanomaan

lisätään cashbill-tagi, jonka arvoksi annetaan 1. Käteiskuittiin ei sisälly
maksunvalvontaa eikä käteiskuitteja postiteta velalliselle tai viedä perintään.
Käteiskuitin summa voi olla positiivinen tai negatiivinen. Positiivinen käteiskuitti kirjaa
maksun vastaanotetuksi ja negatiivinen käteiskuitti kirjaa maksun palautetuksi
asiakkaalle.
JSON Esimerkki:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"person": "Nelli Niirulainen",
"address": "Kellokoskenkatu 15 A 3",
"city": "KUOPIO",
"cashbill": "1",
"billdate": "2017-01-12",
"paydate": "2017-01-26",
"payrow": [
{
"desc": "Peko-peräkärry",
"count": "1",
"amount": "500",
"taxpr": "23"
}
]
}
]
}
}
Käteiskuitin kirjaaminen Ropo 24:ään on tarpeellista, jos haluat käyttää Ropo 24:n
kirjanpito- tai myyntiraportteja. Jos muodostat vastaavat raportit omassa
järjestelmässäsi, sinun ei tarvitse lähettää käteiskuitteja Ropo 24:ään.
5.6 Hyvityslasku
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 38 / 139
Rajapintaan lähetettyjä laskuja ei voi perua eikä muuttaa. Jos laskussa on ollut virhe
tai jos lasku halutaan perua, tulee rajapintaan lähettää vastakkaismerkkinen
hyvityslasku, joka kumoaa alkuperäisen laskun osittain tai kokonaan.
Hyvityslasku on muuten samanlainen kuin normaali lasku, mutta laskuriveillä

lukumäärät käännetään negatiiviseksi ja laskuun lisätään tarvittaessa refundtojobid-
tai refundtobillnum-tagi, joka ilmoittaa alkuperäisen laskun tehtävä- tai laskunumeron,
johon hyvitys kohdistuu. Jos hyvityslasku ei kohdistu aiemmin Ropo 24:ään
lähetettyyn laskuun, jätä refundtojobid ja refundtobillnum-tagi antamatta: voit aina
kohdistaa hyvityslaskun myöhemmin Ropo 24:ssä, jos se on tarpeellista.
Huom! Laskurivien netamount, vatamount ja totalamount on käännettävä myös

negatiivisiksi, jos niitä käyttää.
Esimerkki, lähetetään tavallinen lasku:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"city": "KUOPIO",
"billdate": "2017-03-04",
"paydate": "2017-03-18",
"payrow": [
{
"desc": "Siivous",
"count": "1",
"itemtype": "h",
"amount": "100",
"taxpr": "23"
}
]
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 39 / 139
Johon laskutusrajapinta vastaa:
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1015",
"reference": "7100001195668518",
"ownref": "",
"jobid": 549220,
"jobtype": "0",
"amount": "123.00",
"receiver": "Nelli Niirulainen",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Poimitaan vastausviestistä tehtävänumero (jobid) talteen.
Hyvitetään alkuperäinen lasku täydellisesti lähettämällä laskun tiedot uudelleen

tehtävänumeron ja negatiivisten lukumäärien kera:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 40 / 139
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"refundtojobid": "549220",
"city": "KUOPIO",
"billdate": "2017-03-04",
"paydate": "2017-03-18",
"payrow": [
{
"desc": "Siivous",
"count": "-1",
"itemtype": "h",
"amount": "100",
"taxpr": "23"
}
]
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 41 / 139
Johon laskutusrajapinta vastaa:

JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1016",
"reference": "7100001195669232",
"ownref": "",
"jobid": 549221,
"jobtype": "0",
"amount": "-123.00",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Edellinen esimerkki hyvittää alkuperäisen laskun täysimääräisesti. Jos lasku halutaan

hyvittää vain osittain, voidaan hyvityslaskun laskurivejä muuttaa vastaavasti.
Esimerkiksi 50%:n hyvitys saadaan aikaan discount-tagilla:
JSON:
"payrow": [
{
"desc": "Siivous",
"count": "-1",
"itemtype": "h",
"amount": "100",
"discount": "50",
"taxpr": "23"
}
]
Hyvityslaskuissa voidaan poistaa laskurivejä tai muuttaa tuotteiden määrää (count)

tarpeen mukaan. Huomaa kuitenkin, että hyvityslaskulle ei voi lisätä uusia tuotteita:
jos asiakkaalle on myyty alkuperäisen laskun lähettämisen jälkeen uusia tuotteita, niin
nämä täytyy laskuttaa erillisellä laskulla!
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 42 / 139
Ropo Capital suosittelee, että amount-tagilla annettu tuotteen yksikköhinta esitetään

aina positiivisena ja mahdollinen hyvitys tehdään vaihtamalla count-tagissa
lukumäärän etumerkkiä: jos määrä alkuperäisellä laskulla oli positiivinen, niin
hyvityslaskulla määrä tulee tällöin negatiiviseksi, ja jos määrä oli alun perin
negatiivinen, niin hyvityslaskulla määrä tulee positiiviseksi. Tämä suositus johtuu siitä,
että mikäli laskurivin hintatietoja ei ole esitetty täsmällisellä tavalla, niin Ropo Capital
joutuu laskemaan erinäisiä lisätietoja, ja amount-tagin lisäksi tähän laskentaan
vaikuttavat count- ja totalamount-tagit. Alla olevassa taulukossa on kuvattu
esimerkiksi, miten count-, amount- ja totalamount-tagien etumerkki vaikuttaa
laskurivin loppusumman etumerkkiin.
Count Amount Totalamount Loppusumma
+ + + +
- + + -
+ - + +
- - + +
+ + - -
- + - -
+ - - -
- - - -
Jos totalamount-tagia ei ole annettu laskurivillä, niin tällöin loppusumman etumerkki

saadaan suoraan kertolaskusta amount  count.
5.7 Laskun lähettäminen omalla viitteellä ja tilinumerolla
Lasku voidaan lähettää asiakkaalle laskuttajan omalla viitteellä ja tilinumerolla

käyttämällä tulostuspalvelua. Tulostuspalvelussa Ropo Capital ei valvo tai välitä
suorituksia, vaan asiakkaat maksavat laskut suoraan laskuttajan tilille.
Lasku lähetetään tulostuspalveluun kuten normaali myyntilasku, mutta jobtype-tagin

arvoksi asetetaan 300 tai vaihtoehtoisesti collectionprocess-tagin arvoksi T1.
Molemmat tavat ajavat saman asian, ja voit valita itsellesi helpomman tavan. Jos
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 43 / 139
esimerkiksi annat jo tällä hetkellä käyttäjän valita laskulle saatavan lajin

collectionprocess-tagilla, voit tuoda tulostuspalvelun helposti käyttäjien ulottuville
lisäämällä valittavien lajien joukkoon tulostuspalvelun T1.
Tulostuspalvelussa laskulle tulostuu Ropo 24:ssä toimeksiantajan asetuksiin

tallennettu tilinumero. Laskulle tulostuva viite annetaan JSON-sanomassa billcode-
tagilla. Jos viitenumeroa ei anneta billcode-tagilla, Ropo Capital palauttaa
vastaussanomassa laskulle generoidun viitenumeron, jonka voit poimia talteen.
Huomaa, että tulostuspalvelussa Ropo Capital ei valvo suorituksia eikä lähetä

muistutuksia tai perintäkirjeitä automaattisesti: saatavien valvonta ja velallisten
muistuttaminen jää laskuttajan tehtäväksi. Mikäli suoritusta ei kuulu tulostuspalvelun
kautta lähetettyyn laskuun, voi muistutuksen tai perintäkirjeen lähettää Ropo Capitalin
kautta lähettämällä tehtävän tiedot uudestaan rajapintaan siten, että jobtype-tagin
arvona on 1 (muistutus) tai 2 (perintä).
5.8 Kuluttajan e-laskut ja suoramaksut
Ropo 24:n kautta voidaan lähettää e-laskuja ja suoramaksuja helposti kuluttajille

tarvitsematta muokata rajapintaa käyttävää ohjelmaa millään tavalla: jos e-
laskutuspalvelut ovat käytössä, niin asiakkaat tilaavat e-laskut omassa
verkkopankissaan, ja Ropo Capital reitittää rajapintaan lähetetyt laskut verkkopankkiin
sanomassa annetusta sendtype-tagista, sähköpostiosoitteesta tai postiosoitteesta
riippumatta. Siten laskun lähettävän ohjelman ei tarvitse välittää laskutustavasta,
vaan se voi lähettää laskut rajapintaan ikään kuin asiakas olisi tilannut paperi- tai
sähköpostilaskun.
Laskun lähettäminen e-laskuna tai suoramaksuna vaatii, että:
1. e-laskutuspalveluiden käytöstä on tehty sopimus Ropo Capitalin kanssa
2. tiettyä kuluttajaa koskevissa laskuissa on aina sama asiakasnumero tai

henkilötunnus
Ropo Capital käyttää e-laskujen reititykseen toimeksiantajan valitsemaa tunnistetta:

asiakasnumeroa, henkilötunnusta tai näiden yhdistelmää. Siksi on tärkeää, että
asiakasnumero tai henkilötunnus on sama kaikissa tiettyä kuluttajaa koskevissa
laskuissa.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 44 / 139
Vaikka lasku lähetetäänkin e-laskuna tai suoramaksuna, niin asiakkaan osoite on silti
annettava, koska postiosoitetta käytetään mahdollisten muistutusten ja
maksuvalvontakirjeiden lähettämiseen.
5.9 Laskun rahoittaminen
Laskusaatavarahoitus on Ropo Financen palvelu, jossa toimeksiantajalle annetaan

lainaa laskuja vastaan. Palvelussa toimeksiantaja saa rahat nopeasti käyttöönsä ja
voi maksaa omille tavarantoimittajilleen ja alihankkijoilleen tarvitsematta odottaa
asiakkaan suoritusta.
Jos haluat käyttää laskusaatavarahoitusta, niin lisää JSON-sanomaan finance-tagi

arvolla 1, ja lähetä lasku rajapintaan kuten normaalisti. Palvelussa laskua ei postiteta
välittömästi, vaan se jää hetkeksi odottamaan Ropo Financen rahoituspäätöstä. Mikäli
Ropo Finance rahoittaa laskun, niin toimeksiantaja saa laskun rahat tililleen yleensä jo
seuraavana päivänä ja lasku lähetetään asiakkaalle Ropo Financen siirtomerkinnöillä
ja toimeksiantajan asettamalla eräpäivällä. Kun asiakas maksaa laskun eräpäivänä,
asiakkaan suoritus kuittaa lainan maksetuksi, ja toimeksiantaja voi pitää lainarahat
itsellään.
Laskusaatavarahoituksen käyttö vaatii, että:
1. olet tehnyt Ropo 24:ssä rahoitushakemuksen ja Ropo Finance on hyväksynyt sen
2. asiakas on yritys, jonka y-tunnus annetaan govid-tagilla
3. merkitset rajapinnassa finance-tagilla tehtävät, joille haluat hakea rahoitusta
Lasku, johon haetaan rahoitusta saattaisi esimerkiksi sisältää tagit:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 45 / 139
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"city": "KUOPIO",
"finance": "1",
"govid": "2262509-5",
"billdate": "2016-12-12",
"paydate": "2016-12-26",
"payrow": [
{
"count": "20",
"amount": "15.53",
"taxpr": "24"
}
]
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 46 / 139
johon palvelin vastaisi esimerkiksi:
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1064",
"reference": "3100001638952361",
"ownref": "",
"jobid": 3895236,
"jobtype": "0",
"amount": "385.14",
"sendtype": "print",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": 3895236
}
],
"errors": []
}
Huomaa, että accepted-tagi kertoo vain, että lasku on vastaanotettu onnistuneesti

Ropo 24:ään, ja että lasku jää yhä odottamaan rahoituskäsittelijän päätöstä.
Rahoituspäätös annetaan pääsääntöisesti kahden arkipäivän aikana. Näet
rahoituspäätöksen Ropo 24:ssä tehtävän merkinnöissä, ja huomaat myönteisen
päätöksen seuraavalla tilitysraportilla. Jos rahoitusta ei hyväksytä, niin lasku
lähetetään asiakkaalle normaalisti, jos Ropo Financen kanssa ei ole sovittu muuta.
5.10 Laskujen ostopalvelu
Laskujen ostopalvelu on Ropo Financen palvelu, jossa toimeksiantajalta ostetaan

erääntymätön laskusaatava. Palvelussa toimeksiantaja saa rahat nopeasti
käyttöönsä ja voi maksaa omille tavarantoimittajilleen ja alihankkijoilleen
tarvitsematta odottaa asiakkaan suoritusta.
Jos haluat käyttää laskujen ostopalvelua, niin lisää JSON-sanomaan finance-tagi

arvolla 2, ja lähetä lasku rajapintaan kuten normaalisti. Palvelussa laskua ei postiteta
välittömästi, vaan se jää hetkeksi odottamaan Ropo Financen ostopäätöstä. Mikäli
Ropo Finance ostaa laskun, niin toimeksiantaja saa laskun rahat tililleen yleensä jo
seuraavana päivänä ja lasku lähetetään asiakkaalle Ropo Financen siirtomerkinnöillä
ja toimeksiantajan asettamalla eräpäivällä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 47 / 139
Laskujen ostopalvelun käyttö vaatii, että:
4. olet tehnyt Ropo 24:ssä laskujen ostohakemuksen ja Ropo Finance on hyväksynyt

sen
5. asiakas on yritys, jonka y-tunnus annetaan govid-tagilla
6. merkitset rajapinnassa finance-tagilla tehtävät, joille haluat hakea ostoa
Lasku, johon haetaan ostoa saattaisi esimerkiksi sisältää tagit:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"city": "KUOPIO",
"finance": "2",
"govid": "2262509-5",
"billdate": "2016-12-12",
"paydate": "2016-12-26",
"payrow": [
{
"count": "20",
"amount": "15.53",
"taxpr": "24"
}
]
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 48 / 139
johon palvelin vastaisi esimerkiksi:
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1064",
"reference": "3100001638952361",
"ownref": "",
"jobid": 3895236,
"jobtype": "0",
"amount": "385.14",
"sendtype": "print",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": 3895236
}
],
"errors": []
}
Huomaa, että accepted-tagi kertoo vain, että lasku on vastaanotettu onnistuneesti

Ropo 24:ään, ja että lasku jää yhä odottamaan rahoituskäsittelijän ostopäätöstä.
Ostopäätös annetaan pääsääntöisesti kahden arkipäivän aikana. Näet ostopäätöksen
Ropo 24:ssä tehtävän merkinnöissä, ja huomaat myönteisen päätöksen seuraavalla
tilitysraportilla. Jos ostoa ei hyväksytä, lasku lähetetään asiakkaalle normaalisti, jos
Ropo Financen kanssa ei ole sovittu muuta.
5.11 Maksuviivästysdirektiivin mukaisen vakiokorvauksen vaatiminen
Maksuviivästysdirektiivi 2011/7/EU antaa mahdollisuuden vaatia 40 euron vakiokor-

vausta, jos yritys, valtion liikelaitos tai muu julkisoikeudellinen laitos ei maksa laskua
ajoissa. Tämä 40 euron korvaus on toimeksiantajalle tilitettävää rahaa, josta Ropo
Capital vähentää omat perintäkulut sekä provision.
Jos olet sopinut Ropo Capitalin kanssa vakiokorvauksen käytöstä, merkitse fixedfee-
tagilla laskut, joissa vaadit vakiokorvausta. Jos fixedfee-tagia ei ole annettu tai tagin
arvo on nolla, Ropo Capital olettaa, ettet vaadi velalliselta viivästyskoron lisäksi muuta
korvausta maksuviiveestä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 49 / 139
Lain mukaan vakiokorvausta ei voida veloittaa kuluttajalta. Jos fixedfee-tagin arvo on

1 ja velallinen on kuluttaja, tehtävän lisäys epäonnistuu virheilmoitukseen: "Fixed fee
requires customertype 1".
Vakiokorvausta ei voida käyttää Ropo Financen rahoittamissa laskuissa.
5.12 Rakennusalan työmaatunnisteiden välittäminen laskulla
Suomen eduskunta on hyväksynyt lait, joiden nojalla rakennusalan yrityksillä ja

tilaajilla on 1.7.2014 lähtien velvollisuus ilmoittaa verohallinnolle tietoja rakennusalan
urakoista. Näihin tietoihin sisältyy mm. alihankintasopimuksiin kirjatut urakkahinnat
ja toteutunut urakkalaskutus.
Kuva 1: Tiedonantovelvolliset tahot
Tämän lakisääteisen tiedonantovelvollisuuden vuoksi Ropo Capital on lisännyt

laskutusrajapintaan tagit TA0001, TA0002 ja TA0003. Tageilla aliurakoitsija välittää
pääurakoitsijalle työmaa-avaimen (TA0001-tagi), työmaanumeron (TA0002-tagi) ja
tiedon siitä, onko työmaa merkitty työmaarekisteriin vai ei (TA0003-tagi).
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 50 / 139
Ropo Capital suosittelee, että työmaan nimi ja osoite annetaan toistaiseksi laskun
vapaalla tekstillä (freetext-tagi).
Esimerkki rakennusalan laskusta:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"company": "Maansiirto Hasse Wind Oy",
"address": "PL 123",
"city": "KUOPIO",
"billdate": "2017-06-03",
"paydate": "2017-06-17",
"evoice": "003722059054",
"evoiceint": "003714377140",
"sendtype": "evoice",
"TA0001": "TA-FI-STVOY0001-B",
"TA0002": "1234",
"TA0003": "Y",
"freetext": "Työmaan osoite:
Kallan viljavarasto Oy
Tekniikantie 23
70100 Kuopio",
"payrow": [
{
"desc": "Kirvesmiestyöt Olli Ojansuu
27.3.2017",
"freetext": "Kuivauskopin rakennustyö ja
kuivaimien asennus",
"taxpr": "24",
"count": "7",
"amount": "55"
}
]
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 51 / 139
6 Maksumuistutus
Jos velallinen ei maksa laskua ajoissa, laskusta voidaan lähettää maksumuistutus
Ropo 24-rajapinnan kautta. Maksumuistutus lähetetään kuten lasku mutta:
1. sanoman tyyppinä on 1 (jobtype-tagi)
2. maksumuistutuksella ei esitetä laskurivejä (payrow-tagi)
3. laskun avoin summa esitetään amount-tagilla
4. pankin viitenumero (billcode-tagi) on pakollinen tieto
Esimerkki:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "1",
"billcode": "4349",
"amount": "55.32",
"billnum": "1000",
"city": "KUOPIO",
"billdate": "2017-01-01",
"paydate": "2017-01-14"
}
]
}
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 52 / 139
Johon palvelin vastaa:
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1000",
"reference": "7100998595672424",
"ownref": "",
"jobid": 549224,
"jobtype": "1",
"amount": 55.32,
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Lähetä saatava rajapintaan vain kerran! Jos olet lähettänyt saatavan aiemmin
rajapintaan laskuna, ota huomioon, että Ropo Capital lähettää maksumuistutuksen
automaattisesti eikä sinun pidä lähettää saatavaa enää toista kertaa rajapintaan.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 53 / 139
7 Perintä
7.1 Perintätehtävän esittäminen JSON-muodossa
Jos velallinen ei maksa saatavaa maksumuistutuksesta huolimatta, saatava voidaan

siirtää perintään Ropo 24-rajapinnan kautta. Saatava lähetetään perintään kuten
maksumuistutus mutta:
1. sanoman tyyppinä on 2 (jobtype-tagi),
2. maksumuistutuksen päivämäärä annetaan noticedate tagilla muodossa vvvv-kk-

pp.
Esimerkki:
JSON:
{
"datastream": {
"dataset": [
{
"jobtype": "2",
"noticedate": "2017-02-01",
"billnum": "1000",
"billcode": "4349",
"city": "KUOPIO",
"billdate": "2017-01-01",
"paydate": "2017-01-14"
"amount": "55.32",
}
]
}
}
Johon palvelu vastaa:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 54 / 139
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1000",
"reference": "7100998595672453",
"ownref": "",
"jobid": 549225,
"jobtype": "2",
"amount": 55.32,
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Lähetä kukin saatava perintään vain kerran! Jos olet lähettänyt saatavan aiemmin
rajapintaan laskuna tai maksumuistutuksena, ota huomioon, että Ropo Capital
lähettää perintäkirjeen automaattisesti eikä sinun pidä lähettää saatavaa enää toista
kertaa perintään.
7.2 Huomautuskulut perinnässä
Jos käytät Ropo Capitalin tulostuspalvelua ja hoidat maksumuistutusten lähettämisen

itse, voit antaa omat huomautuskulusi Ropo Capitalille edelleen perittäväksi noticefee-
tagilla.
Huomaa, että laki rajoittaa huomautuskulujen määrää. Lain mukaan kuluttajalle

voidaan lähettää maksullinen maksumuistutus vasta 14 vuorokautta laskun
erääntymisestä, ja veloittaa lähetetystä maksumuistutuksesta enintään 5 euroa.
Yritystä voidaan muistuttaa jo aiemmin ja voidaan veloittaa kuluttajaa enemmän,
mutta kulujen tulee aina olla suhteessa tehtyyn työhön.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 55 / 139
8 JSON-tietosisällön yksityiskohtainen kuvaus

Seuraavissa kappaleissa on kuvattu Ropo 24 rajapinnassa liikkuvien JSON -sanomien
tietosisältö yksityiskohtaisesti. Rajapinta on alaspäin yhteensopiva eli aiemmalle
Ropo 24 versiolle kirjoitetut ohjelmat toimivat sellaisenaan. Ainoastaan
yhteensopivuuden vuoksi sisällytetyt tagit on merkitty vanhentuneeksi. Uusien
rajapintaa käyttävien ohjelmien tulisi välttää näiden tagien käyttöä.
8.1 accepted
Kuvaus: Palvelun palauttama tosi/epätosi lippu, joka ilmoittaa, hyväksyttiinkö

lasku järjestelmään.
JSON:
{
"accepted": 0,
"result": [
{
"billnum": "",
"ownref": "",
"amount": 43.05,
"receiver": "Teppo Testaaja",
"accepted": 0,
"error": "Billnum 1000 already exists"
}
],
"errors": [
{
"error": "Virhe laskussa : Billnum 1000 already
exists"
}
]
}
Sisältyy: row
8.2 accountdate
Kuvaus: Päivämäärä, jolle tiliöinnit kirjataan.
Esimerkki JSON: "accountdate": "2018-02-25"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 56 / 139
8.3 accountid
Kuvaus: Tilikoodi rajapintaa käyttävän yrityksen kirjanpitoa varten.
Esimerkki JSON: "accountid": "1000"

Sisältyy: payrow, accountrow
8.4 accountrow
Kuvaus: Myyntilaskun tiliöinti toimeksiantajan kirjanpitoa varten.
Kuva 2: accountrow-tagiin sisältyvät elementit
Huomaa, että accountrow-tagi voi toistua monta kertaa dataset ja payrow-tagin alla:
erillistä ylätagia ei käytetä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 57 / 139
JSON esimerkki:
"accountrow": [
{
"accountid": "3000",
"servicecode": "0",
"taxpr": "24.00",
"vatamount": "27.62"
"debit": "",
"credit": "100.00",
"desc": "Rupi-webhotelli",
"type":"A12345",
"type2:"B12345",
"type3:"C12345",
"type4":"D12345",
"type5":"E12345"
}
]
Sisältyy: dataset, payrow
8.5 addaddress
Kuvaus: Lisää laskulle toimitusosoitteen tai toisen lähetysosoitteen

addresstype-tagista riippuen.
JSON Esimerkki:
"addaddress": [
{
"address": "Kuninkaankatu 15",
"city": "KUOPIO",
"addresscountry": "FIN",
"addresstype": "1"
}
]
Sisältyy: dataset
8.6 address
Kuvaus(dataset): Asiakkaan katuosoite.
Kuvaus(usageplaces): Energiatoimialan käyttöpaikan osoitetiedot.
Sisältyy: dataset, usageplaces
8.7 addressaddline1, addressaddline2, addressaddline3
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 58 / 139
• Ensimmäinen lisärivi tulostuu osoitekortilla vastaanottajan nimen yläpuolelle.
• Toinen lisärivi vastaanottajan nimen alapuolelle.
• Kolmas lisärivi katuosoitteen yläpuolelle.
Tagia voidaan käyttää varsinaisen osoitteen (dataset-tagi) tai lisäosoitteen

yhteydessä (addaddress-tag).
JSON Esimerkki:
"addaddress": [
{
"addressaddline2": "c/o Rakennus Heimo Ky",
"city": "KUOPIO",
"addresstype": "1"
}
]
Sisältyy: dataset, addaddress
8.8 addresscountry
Kuvaus: Asiakkaan kotimaa postia varten.
Tagin arvoksi annetaan 3-kirjaiminen ISO 3166 -maakoodi tai englanninkielinen

maan nimi liitteestä 5. Jos tagi jätetään pois sanomasta, lasku lähetetään kotimaan
osoitteella.
Esimerkki JSON: "addresscountry": "FIN"

8.9 addresstype
Kuvaus: Lisäosoitteen tyyppi:
Arvo Selite
1 Toinen postitusosoite
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 59 / 139
Arvo Selite
2 Toimitusosoite
3 Laskutusosoite
Osoitetyyppiä 1 käytettäessä kopio laskusta, muistutuksesta tai perinnästä

lähetetään varsinaisen pääosoitteen lisäksi toiseen osoitteeseen, esimerkiksi
tilitoimistoon.
Osoitetyyppi 2 asettaa laskulla näkyvän toimitusosoitteen. Kullakin laskulla voi olla

enintään yksi toimitusosoite. Toimitusosoite ei tulostu muistutuksille tai
perintäkirjeille.
Osoitetyyppi 3 asettaa laskutusosoitteen, jota käytetään ensimmäisen laskun

toimituksessa. Jos laskua ei makseta ajoissa, seuraavat muistutus- ja perintäkirjeet
lähetetään tehtävän pääosoitteeseen. Osoitetyyppi 3 on hyödyllinen käytettäessä
automaattisia skannauspalveluita ja ostolaskujärjestelmiä, jotka ottavat vastaan vain
laskuja.
Esimerkki, kopio laskusta lähetetään osoitteeseen Kuninkaankatu 5:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 60 / 139
JSON:
{
"datastream": {
"dataset": [
{
"city": "KUOPIO",
"addaddress": [
{
"city": "KUOPIO",
"addresstype": "1"
}
],
"billdate": "2017-03-03",
"paydate": "2017-03-17"
"jobtype": "0",
"payrow": [
{
"desc": "Hieronta",
"count": "1",
"itemtype": "h",
"amount": "35",
"taxpr": "23"
}
]
}
]
}
}
Sisältyy: addaddress
8.10 advancepayment
Kuvaus: Ennakkomaksu: Ennakkomaksun summa (>0).
Esimerkki JSON: "advancepayment ": "100"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 61 / 139
8.11 ahinta
Kuvaus: Alennettu yksikköhinta (veroton). Yleensä ahintaa ei

tarvitse ilmoittaa vaan Ropo 24 laskee sen automaattisesti amount- ja discount-tagien
avulla.
Sisältyy payrow
8.12 allownullvalues
Kuvaus: Laskuriville ei tarvitse ilmoittaa arvoja tageille: desc, count, amount,

taxpr, vatamount, netamount, totalamount. Näin voi toimittaa laskurivillä esimerkiksi
vapaata tekstiä.
Esimerkki JSON: "allownullvalues ": "1"

Sisältyy: payrow
8.13 amount
Kuvaus: Tuotteen veroton ja alentamaton kappalehinta laskurivillä, laskun

loppusumma, laskun avoin summa tai erän suuruus riippuen siitä, esiintyykö amount-
tagi payrow, row, dataset vai instalment tagin alla.
Amount-tagilla annettu summa esitetään euroissa. Muistutus- ja perintäkirjeiden

yhteydessä laskun loppusumma muussa valuutassa voidaan antaa foreignamount-
tagilla, mutta tällöinkin laskun loppusumma on annettava amount-tagilla palvelimen
mukaisessa valuutassa.
Rajapinnan versiosta 2.5 lähtien laskun, muistutuksen ja perintäkirjeen

loppusumma voidaan antaa amount-tagin sijasta myös totalamount-tagilla.
Totalamount-tagin arvo on aina verollinen summa, kun taas amount-tagin verollisuus
vaihtelee sen mukaan, minkä tagin alla amount-tagia käytetään. Ropo Capital
suosittelee esittämään laskun, muistutuksen ja perintäkirjeen loppusumman
totalamount-tagilla sekaannusten välttämiseksi.
Ropo Capital suosittelee myös, että laskurivillä amount-tagilla annettu tuotteen

yksikköhinta esitetään aina positiivisena ja mahdollinen hyvityslasku tehdään
vaihtamalla count-tagissa annetun lukumäärän etumerkkiä.
Sisältyy: dataset, payrow, row, instalment
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 62 / 139
8.14 attachment
Kuvaus: Laskun yksittäinen liite. Liitteen sisältöön voidaan viitata

attachmentid-tagilla tai sisältö voidaan antaa laskukohtaisesti attachmentfile-tagilla.
Ensimmäinen tapa on hyödyllinen, jos samaa liitettä käytetään sadoilla eri laskuilla
pitkän ajan kuluessa. Jälkimmäinen tapa on hyödyllinen, jos liite sisältää
laskukohtaista tietoa.
JSON Esimerkki:
"attachment": [
{
"attachmentid": "2519700"
},
{
}
]
Sisältyy: dataset
8.15 attachmentfile
Kuvaus: Laskun loppuun erilliselle sivulle tulostuva JPG-, PNG-, GIF- tai PDF-
muotoinen liite base64-koodattuna.
Ropo 24 käsittelee liitetiedostoja ennen tulostusta seuraavasti:
• kuvatiedostot skaalataan kokoon 17x25cm

• RGB-värit muutetaan CMYK-muotoon
• sivut käännetään vaaka-asennosta pystyasentoon
• interaktiiviset elementit suljetaan
Huomaa, että laskujen automaattisessa käsittelyssä tarvittavat kuoritusmerkinnät

tulostuvat myös liitesivuille. Kuvatiedostot skaalataan automaattisesti siten, että
sivun reunoille jää 2 cm marginaali kuoritusmerkintöjä varten, mutta jos lähetät PDF-
muotoisia liitteitä, varmista itse, että sivun kaikille reunoille jää vähintään 2 cm
marginaali.
Lasku voi sisältää useita liitetiedostoja, joista kukin voi sisältää useita sivuja. Suosit-
telemme kuitenkin rajoittamaan liitteet enintään kahdeksaan sivuun, jolloin lasku
voidaan postittaa normaalina kirjeenä. Yli 10 sivua sisältävät kirjeet joudutaan
kuorittamaan manuaalisesti, joka saattaa viivästyttää kirjeiden postitusta, ja
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 63 / 139
tulostusoperaattorista riippuen yli 50-sivuiset kirjeet postitetaan joko useammassa

pussissa tai hylätään.
Jos lähetät useita kymmeniä liitteellisiä laskuja tai tilausvahvistuksia, jaa lähetys
enintään 100 megatavun kokoisiin paloihin. Jos sama liitetiedosto toistuu useassa
laskussa tai tilausvahvistuksessa, suosittelemme myös käyttämään attachmentid-
tagia attachmentfile-tagin sijasta. Attachmentid-tagia käytettäessä liitetiedoston
sisältöä ei tarvitse esittää jokaisessa laskussa, jolloin sanomasta tulee pienempi.
JSON Esimerkki:
"attachment": [
{
"attachmentfile":
"JVBERi0xLjQNJeLjz9MNCjEyIDAgb2JqDTw8L0xpbmVhcml6ZWQgMS9M
EwNjUzNTIvTiAxL1QgMTA4MzUyMy9IIFsgNDc2IDE1N10+Pg1lbmRvYm
DQp4cmVmDQoxMiA5DQowMDAwMDAwMDE2IDAwMDAwIG4NCjAwMDAwMDA3
....
Zg0KMDAwMDAwMDAwMCA2NTUzNSBmDQp0cmFpbGVyDQo8PC9aXplIDEyL
NDE1QTRDODQ4QTFGNUY0QTEzzdGFydHhyZWYNCjExNg0KJSFT0YNCg=="
}
]
Sisältyy: attachment
8.16 attachmentid
Kuvaus: Liitedokumentin tunniste Ropo 24:ssä.
Tätä tagia käytettäessä liite luodaan etukäteen Ropo 24:ssa ja vain liitteen tunniste
lisätään JSON-sanomaan. Siten varsinaista dataa ei tarvitse välittää sanomassa ja
täsmälleen sama liitetiedosto voidaan helposti lisätä sadoille laskuille.
Lisää liite Ropo 24 Asetukset -> Asetukset ja sopimukset -valikossa Laskutustiedot -

välilehdellä klikkaamalla Valitse tiedostot. Kun tiedosto on siirretty Ropo 24:ään, ota
talteen pudotuslistalla näkyvä id. Esimerkiksi oheisessa kuvassa liitetiedoston tunnus
on 2519701. Kun haluat lisätä liitteen myöhemmin laskulle, lisää JSON/XML-
sanomaan attachmentid-tagi ja anna tagin arvoksi käyttöliittymästä poimimasi
numero.
Huomaa, että attachment- tai attachmentid-tagia ei tarvitse antaa, jos asetat liitteen
vakioliitteeksi. Vakioliite lisätään automaattisesti jokaisen Ropo 24:ään lähetettyyn
laskuun ilman, että sitä tarvitsee mainita sanomassa.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 64 / 139
JSON Esimerkki:
"attachment": [
{
}
]
Sisältyy: attachment
8.17 backorderquantity
Kuvaus: Varattu Ropo 24:n sisäiseen käyttöön.
Sisältyy: payrow
8.18 batchid
Kuvaus: Aineiston tunnus. Asiakkaan generoima aineistotunnus

tuotannonseurantaan. Aineistotunnuksella voi REST-rajapinnasta pyytää aineistoa
koskevan siirtoraportin.
Sisältyy: datastream
8.19 billcode
Kuvaus: Pankin viitenumero tai viesti, jolla suoritus tilitetään toimeksiantajan

tilille.
Jos viitenumeroa ei määritellä siirrossa, Ropo 24 generoi laskulle viitenumeron

automaattisesti. Automaattisesti generoitu viitenumero on nähtävissä Ropo 24-
palvelussa tai luettavissa paluuviestin reference-tagista.
Viitenumeron muodostaminen on kuvattu osoitteessa
www.fkl.fi/teemasivut/sepa/tekninen_dokumentaatio/Sivut/default.aspx
kohdassa kotimaisen viitteen rakenneohje.
Esimerkki JSON: "billcode": "4349"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 65 / 139
8.20 billdate
Kuvaus: Laskun päiväys muodossa vvvv-kk-pp.
Laskun päiväys voidaan jättää antamatta, jos tehtävä lähetetään laskuna. Tällöin
Ropo 24 päivää laskun kuluvalle päivälle. Muistutus- ja perintätehtävissä laskun
päiväys on pakollinen tieto.
Esimerkki JSON: "billdate": "2017-06-01"

Sisältyy: dataset
8.21 billnow
Kuvaus: Varattu Ropo 24 sisäiseen käyttöön.
Sisältyy: payrow
8.22 billnum
Kuvaus: Laskun tai lähetteen juokseva numero rajapintaa käyttävän yrityksen

omassa tietojärjestelmässä. Jos laskunumeroa ei määritellä JSON-sanomassa, Ropo
24 generoi laskunumeron automaattisesti ja palauttaa generoidun laskunumeron
vastausviestissä.
Jos laskuja luodaan sekä Ropo 24 -nettisivuilla että rajapinnan kautta, on kiinni-
tettävä erityistä huomiota siihen, ettei kahdelle laskulle tule samaa laskunumeroa.
Tämä on yksinkertaisinta toteuttaa siten, että kaikki rajapinnan kautta lähetetyt laskut
numeroidaan sadasta tuhannesta ylöspäin. Ropo 24 generoi laskunumeroita
oletusarvoisesti tuhannesta ylöspäin, joten yhteentörmäyksiä ei pitäisi tulla.
Tarvittaessa voit ottaa käyttöön laskunumeroiden tarkistuksen checkbillnum-tagilla:
jos checkbillnum-tagin arvo on 1, niin laskutusrajapinta hylkää automaattisesti
päällekkäisillä laskunumeroilla lähetetyt laskut.
Lähetteet numeroidaan eri sarjassa kuin laskut.
Esimerkki JSON: "billnum": "11213"

Sisältyy: dataset, row
8.23 billtemplate
Kuvaus: Laskulla käytettävä asettelumalli:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 66 / 139
Arvo Selite
CUSTOM Yleinen laskupohja Helvetica 11pt -fontilla
ECOM Ecom järjestelmän laskupohja Helvetica 9pt -fontilla
BOBCAT Rivikohtainen alv-erittely
INC Verollisen hinnat
Asettelumalli vaikuttaa esimerkiksi fonttien kokoon, kirjeen ylätunnisteen muotoon

ja arvonlisäverojen esittämiseen. Mallit eri laskupohjista löytyvät tämän dokumentin
lopusta.
Edellä lueteltujen asettelumallien lisäksi on olemassa LETTER-malli. Tämä

asettelumalli on tarkoitettu postituspalvelun kautta lähetettäville kirjeille. Käytä
LETTER-mallia ainoastaan kirjeillä, joiden jobtype-tagi saa arvon 301.
Jos billtemplate-tagi on jätetty esittämättä sanomassa, käytetään Ropo 24:ssä

yrityksen asetuksissa annettua oletusmallia.
Ropo Capital saattaa pyytää sinua käyttämään myös muita kuin tässä
dokumentissa kuvattuja asettelumalleja.
Esimerkki JSON: "billtemplate": "CUSTOM"

Sisältyy: dataset
8.24 billtemplateid
Kuvaus: Ropo 24:ssa luodun FLEX-laskupohjan tunniste.
Sisältyy: dataset
8.25 cashbill
Kuvaus: Käteiskuitti, joka merkitään suoraan maksetuksi. 1=käteiskuitti
Esimerkki JSON: "cashbill": "1"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 67 / 139
8.26 cashdiscountrow
Kuvaus: Laskulle annettava kassa-alennus (käteisalennus).
Kuva 6: cashdiscountrow-tagin sisältämät elementit
JSON:
"cashdiscountrow": [
{
"discountdate": "2016-11-01",
"discountpercent": "2",
"discountamount": "28.30"
}
]
Sisältyy: dataset
8.27 claimtext
Kuvaus: Muistutus- ja perintätehtävissä saatavan peruste.
Esimerkki JSON:
"claimtext": "Suorittamaton laskusaatava 15.09.2010 tilatusta
kirjasta. Lasku nro 1234, päiväys 15.09.2010, eräpäivä 29.09.2010."
Sisältyy: dataset
8.28 checkbillnum
Kuvaus: Rajapinta ei hyväksy laskua, mikäli laskunumero (billnum) on sama

kuin jollakin muulla laskulla. 1=päällä
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 68 / 139
Esimerkki JSON: "checkbillnum": "1"

Sisältyy: dataset
8.29 city
Kuvaus: Asiakkaan postitoimipaikka.
Esimerkki JSON: "city": "Helsinki"

8.30 clientnoticefee
Kuvaus: Toimeksiantajan kulu: jos muistutat velallisia itse ja siirrät tehtävän

Ropo Capitalille vasta perintävaiheessa, voit nyt antaa omat huomautuskulusi Ropo
Capitalille edelleen perittäväksi.
Esimerkki JSON: "clientnoticefee": "2.00"

Sisältyy: dataset
8.31 code
Kuvaus(xmldetailsrow): Esim. Finvoice- tai Teapps -laskusanomassa

välitettävän lisätiedon konekielinen nimikoodi.
Kuvaus(usageplaces): Energiatoimialan käyttöpaikan tunnus
Kuvaus(definitiondetails): Laskusanoman lisätiedon otsikon koodi
Kuvaus(definitions): Laskusanoman laskurivikohtaisen lisätiedon otsikon

koodi
Nimikoodit TA0001, TA0002 ja TA0003 on varattu rakennusalan

työmaatunnisteiden välittämistä varten. Nämä tiedot tulisi välittää xmldetailsrow-
tagin sijasta omissa TA0001, TA0002 ja TA0003 -tageissa. Muut nimikoodit ovat
vapaasti käytettävissä, ja laskuttaja ja asiakas voivat sopia vapaasti keskenään, mitä
tietoa välitetään milläkin nimikoodilla.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 69 / 139
Huomaa, että nimikoodit välittyvät laskuttajalta asiakkaalle ainoastaan sähköisissä

laskuissa. Paperilaskuissa tieto tulostetaan laskun loppuun selväkielisessä
muodossa, eikä nimikoodia näytetä.
Sisältyy: xmldetailsrow, usageplaces. definitiondetails, definitions
8.32 collectionprocess
Kuvaus: Perintää ohjaava saatava laji.
Seuraavat saatavan lajit ovat käytettävissä Suomessa (ts. silloin kun tehtävä
lähetetään ropo24.fi -palvelimelle):
Arvo Selite
A2 Kirjeperintä
AUTO Automaattinen valinta (oletus)
ICC Vakuutuskorvaus2
J1 Vapaaehtoinen jäsenmaksu: tehtävä ei koskaan etene perintään
K1 Suomalainen kuluttajasaatava
KV2 Kansainvälinen kuluttajasaatava
KV1 Kansainvälinen yrityssaatava
MUU1 Muu saatava
T1 Tulostuspalvelu (ei maksunvalvontaa)
U1 Suoraan ulosottokelpoinen viranomaismaksu
V1 Huoneenvuokra3
Y1 Suomalainen yrityssaatava
Saatavan lajia ICC (vakuutuskorvaus) voidaan käyttää vain yrityksille, joilla on suomalainen Y-tunnus.
2
Saatavan lajia V1 (huoneenvuokra) voidaan käyttää vain kuluttajille, joilla on suomalainen henkilötunnus. Jos vuokraajana on
3
yritys tai ulkomaalainen kuluttaja, käytä saatavan lajia AUTO.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 70 / 139
Arvo Selite
Y2 Kuntalaskutus
Y3 Trataton yritysperintä
Yllä olevien saatavan lajien lisäksi on olemassa joitakin asiakaskohtaisia lajeja; Ropo
Capital saattaa pyytää sinua käyttämään saatavan lajia, jota ei löydy yllä olevasta
taulukosta.
Jos saatavan lajia ei ole annettu JSON-sanomassa, käytetään Ropo 24:ssä

yrityksen asetuksissa annettua oletuslajia.
Esimerkki JSON: "collectionprocess": "V1"

Sisältyy: dataset
8.33 color
Kuvaus: Tagi ei ole tällä hetkellä käytössä.
Ropo 24:ssä on mahdollista lähettää väritulosteita, mutta väritulostuksen

käyttöönotosta ja hinnoista tulee sopia tapauskohtaisesti Ropo Capitalin kanssa.
Sisältyy: dataset
8.34 commonerror
Kuvaus: Yleinen virheilmoitus paluuviestissä. Tagi esiintyy lähinnä silloin, kun

siirtoavain on virheellinen.
Esimerkki JSON:
"commonerror": "No rows added. Transferkey deleted."
Sisältyy: result
8.35 company
Kuvaus: Yritysasiakkaan nimi. Tätä tagia käytetään ainoastaan, jos asiakkaan

tyypiksi on määritelty customertype tagissa yritys (1).
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 71 / 139
Esimerkki JSON:
"customertype ": "1",
"company ": "A & A Repolainen Ltd."
Sisältyy: dataset
8.36 contactperson
Kuvaus: Osapuolen yhteyshenkilö. Esimerkiksi sähköisten

laskujen hyväksyjä.
Esimerkki JSON: "contactperson": "Matti Malli"

Sisältyy dataset, addaddress
8.37 contract
Kuvaus: Sopimukset tiedot. Sopimukselle lisätään

sopimusnumero.
Sisältyy dataset
JSON Esimerkki:
"contract": [
{
"contract_no": "123456"
}
]
8.38 contract_no
Kuvaus (energycontract): Energiatoimialan käyttöpaikan sopimusnumero
Kuvaus (dataset): Sopimusnumero
Esimerkki JSON: "contract_no": "123456"

Sisältyy: contract, energycontract
8.39 count
Kuvaus: Tuotteiden kappalemäärä laskurivillä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 72 / 139
Hyvityslaskuissa kappalemäärä on yleensä negatiivinen.
JSON Esimerkki:
"payrow": [
{
"productid": "XN5",
"count": "20",
"itemtype": "pcs",
"amount": "15.53",
"taxpr": "24.00"
}
]
Sisältyy: payrow
8.40 country
Kuvaus: Maa, johon yritysasiakas on rekisteröity.
Maa annetaan 3-kirjaimisena ISO 3166 -maakoodina tai englanninkielisenä nimenä

liitteen 5 mukaan.
Huomaa, että country-tagia ei käytetä postiosoitteiden muodostamisessa, vaan tätä

tarkoitusta varten on addresscountry-tagi.
8.41 countryname
Kuvaus: Vastaanottajan maan nimi.
Esimerkki JSON: "countryname": "Finland"

8.42 credit
Kuvaus: Myyntilaskun tiliöinti toimeksiantajan omaa kirjanpitoa varten.
Debit- ja credit-tagit ovat toisensa poissulkevia: vain toisessa tagissa voi olla arvo
kullakin accountrow-tietueella.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 73 / 139
Sisältyy: accountrow
8.43 custnum
Kuvaus: Asiakkaan yksilöivä numero rajapintaa käyttävän yrityksen omassa

tietojärjestelmässä.
Asiakasnumero näkyy asiakkaan saamalla laskulla, ja sen avulla mahdolliset

yhteydenotot voidaan kohdistaa oikeaan asiakkaaseen. Ropo Capital saattaa myös
käyttää asiakasnumeroa kuluttajan e-laskujen reitittämiseen ja velkojen ryhmittelyyn.
Mikäli mahdollista, anna jokaiselle asiakkaalle yksilöllinen asiakasnumero.
Jos yrityksesi käyttää y-tunnuksia asiakasnumeroiden asemasta, jätä custnum-

kenttä pois sanomasta ja käytä sen sijaan govid-kenttää.
Esimerkki JSON: "custnum": "1022"

Sisältyy: dataset
8.44 customaddress
Kuvaus: Tagi ei ole enää käytössä.
Sisältyy: dataset
8.45 customerid
Kuvaus: Vastaava kenttä kuin custnum, mutta asiakasnumero tulee asiakkaan

järjestelmän sijaan Ropo 24:stä
Esimerkki JSON: "customerid": "1022"

Sisältyy: dataset
8.46 customertype
Kuvaus: Asiakkaan tyyppi alla olevan taulukon mukaan:
Arvo Selite
1 Yritys
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 74 / 139
Arvo Selite
2 Yksityishenkilö
Customertype-tagi on annettava kaikissa sanomissa, ja sillä on suuri merkitys

perinnän nopeuteen ja tehokkuuteen. Esimerkiksi Suomen laki vaatii odottamaan 2
viikkoa laskun eräpäivästä, ennen kuin kuluttajaa saadaan muistuttaa maksullisella
muistutuksella. Yrityksillä vastaavia rajoituksia on vähemmän, ja perintä on siten
nopeampaa ja tehokkaampaa.
Jos et tiedä asiakkaan tyyppiä, anna tagin arvoksi 2, jolloin perintä suoritetaan
hitaampana kirjeperintänä.
Sisältyy: dataset
8.47 dataset
Kuvaus: Sisältää yhden laskun, muistutuksen tai perinnän tiedot.
8.48 datastream
Kuvaus: JSON-dokumentin juuri.
Kuva 7: datastream-tagiin sisältyvät elementit
Sisältyy: -
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 75 / 139
8.49 date
Kuvaus: Maksusuunnitelman erän eräpäivä muodossa vvvv-kk-pp.
Sisältyy: instalment
8.50 debit
Kuvaus: Myyntilaskun tiliöinti toimeksiantajan omaa kirjanpitoa varten.
Debit- ja credit-tagit ovat toisensa poissulkevia: vain toisessa tagissa voi olla arvo
kullakin accountrow-tietueella.
Sisältyy: accountrow
8.51 debug
Kuvaus: Rajapinnan testauslippu.
Jos debug tagin arvoksi on annettu true, Ropo 24 lukee ja yrittää tulkita lähetetyn
JSON-sanoman tallentamatta laskua minnekään. Debug lippu on käyttökelpoinen
sanoman muodon ja vaadittavien tagien tarkistamiseen.
Huomaa, että Ropo 24 palauttaa aina virheen "cannot write row", jos debug lippu on
päällä.
Rajapintaa voidaan testata myös ilman debug-tagia lähettämällä sanoma

osoitteeseen rc.ropo24.fi.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 76 / 139
JSON Esimerkki:
{
"datastream": {
"debug": "true",
"dataset": [
{
"jobtype": "0",
"city": "KUOPIO",
"billdate": "2017-03-03",
"paydate": "2017-03-17",
"payrow": [
{
"desc": "Hieronta",
"count": "1",
"itemtype": "h",
"amount": "35",
"taxpr": "23"
}
]
}
]
}
}
JSON Vastaus:
{
"accepted": 0,
"result": [
{
"billnum": "",
"ownref": "",
"amount": "43.05",
"accepted": 0,
"error": "Cannot write row"
}
],
"errors": [
{
"error": "Virhe laskussa : Cannot write row"
}
]
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 77 / 139
8.52 definitiondetails
Kuvaus: Finvoice- tai Teapps -laskusanoman lisätiedon arvo.
Tagin arvo riippuu välitettävästä lisätiedosta ja laskutusaineistosta: Finvoice

(DefinitionDetails) -muodossa arvo voi olla enintään 70 merkkiä pitkä, kun taas
Teapps (HEADER_INFO) -muodossa 60 merkkiä pitkä. Ropo Capital suosittelee
käyttämään Finvoice/Teapps rajoituksia, jotta arvo välittyy luotettavasti asiakkaalle.
JSON Esimerkki:
"definitiondetails": [
{
"headertext": "Vuosikayttoarvio",
"code": "E1003",
"value": "17030",
"unitcode": "kWh"
}
],
Sisältyy: dataset
8.53 definitions
Kuvaus: Finvoice- tai Teapps -laskurivikohtaisen lisätiedon arvo.
Tagin arvo riippuu välitettävästä lisätiedosta ja laskutusaineistosta: Finvoice

(RowDefinitionDetails) -muodossa arvo voi olla enintään 70 merkkiä pitkä, kun taas
Teapps (ARTICLE_DESCRIPTION) -muodossa 60 merkkiä pitkä. Ropo Capital
suosittelee käyttämään Finvoice/Teapps rajoituksia, jotta arvo välittyy luotettavasti
asiakkaalle.
JSON Esimerkki:
"definitions": [
{
"code": "E1003",
"value": "17030",
"unitcode": "kWh"
}
],
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 78 / 139
Sisältyy: payrow
8.54 deliverydate
Kuvaus: Tuotteiden toimituspäivä laskulla tai lähetteellä.
Esimerkki JSON: "deliverydate": "2016-12-24"

Sisältyy: dataset
8.55 deliverymethod
Kuvaus: Tuotteiden toimitustapa tekstinä.
Toimitustapa tulostuu yleisillä laskupohjilla sellaisenaan laskun oikeaan

yläkulmaan. Tagin arvoksi tulisi siten antaa selväkielinen ja asiakkaan ymmärtämä
nimike kuten "Kiitolinja".
Huomaa, että tagin arvoa ei käännetä laskun kielen mukaan: jos haluat lähettää
laskun ruotsin kielellä, niin anna deliverymethod-tagin arvoksi toimitustavan nimi
ruotsiksi.
Esimerkki JSON: "deliverymethod": "Kiitolinja"

Sisältyy: dataset
8.56 deliverymethodid
Sisältyy: dataset
8.57 deliveryterm
Kuvaus: Toimitusehto tekstinä.
Toimitusehto tulostuu yleisillä laskupohjilla sellaisenaan laskun oikeaan

yläkulmaan. Laskuttaja voi vapaasti valita toimitusehdon tekstin: Ropo Capital ei
rajoita tämän tagin sisältöä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 79 / 139
Esimerkki JSON: "deliveryterm": "NOK"

Sisältyy: dataset
8.58 deliverytermid
Sisältyy: dataset
8.59 desc
Kuvaus: Tuotteen nimi laskurivillä (payrow-tagi) tai vientirivin selite

myyntilaskun tiliöinnissä (accountrow-tagi).
JSON Esimerkki:
"payrow": [
{
"desc": "Hieronta",
"count": "1",
"itemtype": "h",
"amount": "35",
"taxpr": "23"
}
]
Sisältyy: payrow, accountrow
8.60 discount
Kuvaus: Alennusprosentti laskurivillä.
Huomaa, että laskurivin amount-tagilla annettu yksikköhinta esitetään JSON-

sanomassa ilman alennusta. Jos esimerkiksi tuotteen yksikköhinta on 100,00 euroa
ja siitä halutaan antaa 25% alennus, niin amount-tagissa annetaan tuotteen
alkuperäinen alentamaton yksikköhinta 100,00 euroa ja discount-tagissa
alennusprosentti 25.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 80 / 139
JSON Esimerkki:
"payrow": [
{
"desc": "Kasipallo",
"count": "1",
"amount": "100",
"discount": "25",
"taxpr": "23"
}
]
Sisältyy: payrow
8.61 discountamount
Kuvaus: Kassa-alennuksen määrä euroina. Jos esimerkiksi 1 000,00 euron

laskusta annetaan 2 prosentin alennus, niin discountamount-tagin arvoksi tulee 20,00
euroa.
Sisältyy: cashdiscountrow
8.62 discountdate
Kuvaus: Kassa-alennuksen viimeinen voimassaolopäivä muodossa vvvv-kk-

pp.
Alennettu summa voidaan maksaa pätevästi pankkiin viimeistä voimassaolopäivää

seuraavana arkipäivänä. Jos esimerkiksi kassa-alennuksen viimeinen
voimassaolopäivä on lauantai, niin Ropo Capital antaa alennuksen myös maanantaina
pankkiin maksetuille laskuille.
8.63 discountfreetext
Kuvaus: Asiakkaan saamalla laskulla näkyvä teksti, joka ilmoittaa kassa-

alennuksen olemassaolosta. Jos tagia ei anneta, Ropo 24 muodostaa sopivan tekstin
automaattisesti laskun päiväyksen, eräpäivän ja discountpercent-tagilla annetun
alennusprosentin perusteella.
Esimerkki JSON: "discountfreetext ": "10 pv -2%"

Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 81 / 139
8.64 discountpercent
Kuvaus: Kassa-alennuksen määrä prosentteina laskun verollisesta

loppusummasta laskettuna.
Tagin arvoksi annetaan desimaaliluku väliltä 0-100. Prosenttiluvussa kannattaa

käyttää riittävän montaa desimaalia; laskutusrajapinta tarkistaa tällä tagilla annetun
alennusprosentin ja discountamount-tagilla annetun euromäärän ja hylkää tehtävän,
jos ero tagien antamien summien välillä on yli euron.
8.65 doublesided
Kuvaus: Laskun puoleisuus, 0=yksipuoleinen, 1=kaksipuoleinen
Esimerkki JSON: "doublesided": "0"

Sisältyy: dataset
8.66 eancode
Kuvaus: Tuotteen EAN-koodi. Jos EAN-koodi on oikein muodostettu, Ropo 24

muodostaa EAN-koodia vastaavan viivakoodin ja tulostaa sen laskulle tuotteen nimen
yhteyteen.
Ropo 24 tukee seuraavia viivakoodiformaatteja:
Formaatti Esimerkki
EAN-8
EAN-13
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 82 / 139
Formaatti Esimerkki
EAN-13 + EAN-2
EAN-13 + EAN-5
UPC-A
EAN-koodi kirjoitetaan kokonaan numeroilla 0-9. Tarvittaessa EAN-13 -koodin

lisäosa voidaan erottaa varsinaisesta EAN-koodista plusmerkillä tai välilyönnillä.
Sisältyy: payrow
8.67 email ja email2
Kuvaus: Ensimmäinen ja toinen sähköpostiosoite, johon lasku lähetetään.
Tagia käytetään, jos laskun lähetystavaksi on asetettu sähköposti (sendtype-tagi).

Jos lähetystapaa ei ole asetettu, lasku lähetetään ensisijaisesti sähköisesti ja
toissijaisesti sähköpostilla.
Sisältyy: dataset
8.68 enddate
Kuvaus(payrow): Laskurivillä näkyvä päättymispäivämäärä
Kuvaus(energycontract): Energiatoimialan käyttöpaikan sopimuksen

päättymisaika.
Esimerkki JSON: "enddate": "2016-12-24"

Sisältyy: payrow
8.69 energycontract
Kuvaus: Energiatoimialan käyttöpaikkasopimus
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 83 / 139
JSON Esimerkki:
"energycontract": {
"contract_no": "123456",
"name": "Verkkosopimus",
"vendor_name": "Testiverkot",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"expdate": "2018-06-01"
}
Sisältyy: usageplaces
8.70 error
Kuvaus: Laskua koskeva virheilmoitus paluuviestissä. Jos lähetyksessä

laitetaan error-viesti, tehtävää ei käsitellä ja virhe palautuu paluuviestissä.
Esimerkki JSON: "error": "Cannot write row"

Sisältyy: JSON – result, dataset
8.71 evoice
Kuvaus: Verkkolaskuosoite sähköisen laskun lähettämistä varten.
Evoice- ja evoiceint-tageja käytetään, jos laskun lähetystavaksi on asetettu

sendtype-tagilla sähköinen laskutus. Lisäksi jos sekä verkkolaskuosoite että välittäjän
tunnus on esitetty JSON-sanomassa, mutta sendtype-tagi on jätetty pois, niin lasku
lähetetään sähköisesti.
Muistutukset ja perintäkirjeet lähetetään velalliselle aina paperikirjeenä sendtype-

tagilla annetusta lähetystavasta ja verkkolaskuosoitteesta huolimatta.
Huomaa, että sendtype-, evoice- ja evoiceint-tageja ei käytetä lähetettäessä e-

laskua kuluttajalle: jos asiakas on tilannut e-laskun pankistaan, niin Ropo 24 välittää
laskun pankkiin JSON-sanomassa annetusta lähetystavasta riippumatta.
JSON Esimerkki:
"sendtype": "evoice",
"evoice": "FI123578612717718",
"evoiceint": "NDEAFIHH"
Sisältyy: dataset
8.72 evoiceint
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 84 / 139
Kuvaus: Välittäjän tunnus sähköisessä laskussa.
Sisältyy: dataset
8.73 expdate
Kuvaus: Energiatoimialan käyttöpaikan laskutuskauden päättymispäivä
Esimerkki JSON: "expdate": "2018-06-01"

Sisältyy: energycontract
8.74 finance
Kuvaus: Laskun hakeminen rahoitukseen tai laskujen ostoon: 1= rahoitus tai

2=laskujen osto.
Tagin käyttö vaatii, että toimeksiantaja on sopinut etukäteen Ropo Financen kanssa
laskujen rahoittamisesta tai laskujen ostopalvelusta. Jos sopimusta ei ole solmittu,
lasku hylätään virheilmoituksella "No valid Finance contract".
Jos laskusaatavarahoitusta käytetään ja finance-tagin arvona on numero 1, laskua

ei postiteta heti velalliselle, vaan se jää odottamaan Financen rahoituspäätöstä.
Laskua ei lähetetä velalliselle eikä sitä voi tulostaa Ropo 24:stä ennen kuin Finance on
tehnyt myönteisen tai kielteisen rahoituspäätöksen.
Jos laskujen ostoa käytetään ja finance-tagin arvona on numero 2, laskua ei

postiteta heti velalliselle, vaan se jää odottamaan Financen ostopäätöstä. Laskua ei
lähetetä velalliselle eikä sitä voi tulostaa Ropo 24:stä ennen kuin Finance on tehnyt
myönteisen tai kielteisen ostopäätöksen.
Esimerkki JSON: "finance": "1"

Sisältyy: dataset
8.75 fixedfee
Kuvaus: Vakiokorvaus maksuviivästysdirektiivin 2011/7/EU perusteella

yritysvelalliselta voidaan periä kiinteä 40 euron vakiokorvaus maksuviiveestä. Jos olet
sopinut Ropo Capitalin kanssa vakiokorvausten käyttöönotosta, voit valita
laskukohtaisesti keneltä vaadit korvausta ja keneltä et.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 85 / 139
Esimerkki JSON: "fixedfee": "1"

Sisältyy: dataset
8.76 foreignamount
Kuvaus: Laskun loppusumma alkuperäisellä valuutalla. Tagia käytetään

ulkomaan muistutus- ja perintäkirjeiden yhteydessä, jos tavara tai palvelu on myyty
ulkomaan valuutassa.
Foreignamount-tagista riippumatta perinnässä käytetään euroja. Laskun summa

tulee siten aina muuttaa euroiksi ja esittää amount-tagilla.
JSON Esimerkki:
"foreignamount": "123.32",
"foreigncurrency": "SEK"
Sisältyy: dataset
8.77 foreigncurrency
Kuvaus: Laskulla käytetyn rahayksikön tunniste. Tagia käytetään ulkomaan

muistutuksissa ja perintätehtävissä.
Esimerkki JSON: "foreigncurrency ": "SEK"

Sisältyy: dataset
8.78 freetext
Kuvaus: Laskun loppuun tai laskurivin yhteyteen liitettävä vapaa teksti. Pitkä
teksti rivitetään automaattisesti usealle riville, ja teksti voi sisältää rivinvaihtoja ja
tyhjiä rivejä.
Esimerkki JSON (laskun vapaa teksti):

"freetext": "Kiitokset tilauksesta!
Olemme ulkoistaneet maksuvalvonnan Ropo Capital Oy:lle."
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 86 / 139
Esimerkki JSON (laskurivin lisäselite):

"payrow": [
{
"desc": "Super-webhotelli 12kk",
"freetext": "- 500 Mt kotisivutilaa
- 3 kpl sähköposteja
- 5 Gt/kk siirtokaistaa",
"count": "1",
"amount": "257,00",
"taxpr": "23"
}
]
8.79 fromfinvoice
Sisältyy: dataset
8.80 fuse
Kuvaus: Energiatoimialan käyttöpaikan sulakkeen koko
Esimerkki JSON: "fuse ": "25 A"

8.81 govid
Kuvaus: Asiakkaan y-tunnus tai henkilötunnus.
Y-tunnus tai henkilötunnus auttaa kohdistamaan velan oikeaan

yritykseen/henkilöön ja nopeuttaa maksuvalvontatoimenpiteitä. Ropo Capital saattaa
myös käyttää y-tunnusta ja henkilötunnusta velkojen ryhmittelyyn.
Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 87 / 139
8.82 headertext
Kuvaus(definitiondetails): Laskusanoman lisätiedon otsikko
Kuvaus(definitions): Laskusanoman laskurivikohtaisen lisätiedon otsikko
Esimerkki JSON: "headertext ": "Asiakasnumero"

Sisältyy: definitiondetails, definitions
8.83 instalment
Kuvaus: Maksusuunnitelman erä.
Rajapintaan voi lähettää maksusuunitelman kahdella tavalla. Joko itselasketuilla erillä

tai antaa Ropo24:n laskea erät.
JSON:
"payplan": {
"instalment": [
{
"date": "2017-01-17",
"amount": "10.00"
}
]
}
Sisältyy: payplan
8.84 insurance
Sisältyy: dataset
8.85 invoicerowtype
Kuvaus: Laskurivin tyyppikoodi.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 88 / 139
Arvo Selite
0 Normaali laskurivi
25600 Välisumma, joka ei vaikuta laskentaan
25601 Otsikkorivi
Esimerkki JSON: "invoicerowtype ": "0"

Sisältyy payrow
Esimerkki otsikkoriville ja välisummalle liitteessä: Laskurivien muotoilu (JSON)
8.86 istaxbill
Sisältyy: dataset
8.87 itemtype
Kuvaus: Määrän yksikkö laskurivillä kuten esimerkiksi tunti (h) tai kilometri
(km).
Esimerkki JSON: "itemtype ": "h"

Sisältyy: payrow
8.88 jobid
Kuvaus: Palauttaa laskulle luodun tehtävänumeron.
Tehtävänumero on hyödyllinen, jos palveluun lisättyä laskua halutaan hallita

rajapinnan kautta. Asianumero kannattaa ottaa talteen!
Esimerkki:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 89 / 139
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1002",
"reference": "7100998595672453",
"ownref": "",
"jobid": 549198,
"jobtype": "0",
"amount": 43.05,
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Sisältyy: JSON - result
8.89 jobtype
Kuvaus: JSON-sanoman tyyppi:
Arvo Selite
0 Lasku
1 Maksumuistutus
2 Perintä
300 Tulostuspalvelu
301 Postituspalvelu
Tämän tagin arvo määrää, mitkä tagit ovat pakollisia ja mitkä vapaaehtoisia
sanomassa.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 90 / 139
Sisältyy: dataset, JSON - result
8.90 kwh
Kuvaus: kWh lukema.
Esimerkki JSON: "kwh": "123.10"

Embedded: accountrow
8.91 language
Kuvaus: Laskupohjan kieli:
Arvo Selite
fin Suomi
eng Englanti
swe Ruotsi
est Viro
ger Saksa
Language-tagilla asetettua kieltä käytetään laskun ja ensimmäisen

maksumuistutuksen yhteydessä. Toisessa maksumuistutuksessa ja perintäkirjeissä
käytetään Ropo 24:n valitsemaa kieltä. Esimerkiksi virolaiselle yritykselle lähetetään
englanninkielinen perintäkirje language-tagista riippumatta.
Huomaa, että language-tagi ei vaikuta laskun tietosisältöön: laskurivit, vapaa teksti

ja muut JSON-sanomassa esitetyt tiedot näytetään laskulla juuri siinä muodossa, kun
lähetät ne. Käännä tarvittaessa tuotenimet halutulle kielellä omassa järjestelmässäsi
ennen JSON-sanoman lähettämistä.
Sisältyy: dataset
8.92 madeintp
Kuvaus: Varattu Ropo 24:n sisäiseen käyttöön – älä käytä. Tagin liittäminen
JSON-sanomaan vaikuttaa mm. laskunumeroiden generointiin.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 91 / 139
Sisältyy: dataset
8.93 model
Kuvaus: Merkki, malli, ostajan viite, kustannuspaikka asiakkaan kirjanpidossa

tai muu lisäviite, joka halutaan tulostaa laskulle.
Sisältyy: dataset
8.94 name ja name2
Kuvaus(dataset): Vanhentunut. Asiakkaan nimi. Uusien ohjelmien tulisi

käyttää tämän tagin sijasta person ja company tageja sekä antaa lisärivit tarvittaessa
addressaddline1 ja 2 tageilla.
Jos tämä tagi kuitenkin esiintyy JSON-sanomassa, jätä person ja company-tagit

pois.
Kuvaus(energycontract): käyttöpaikkasopimuksen nimi
Sisältyy: dataset, energycontract
8.95 negvat
Kuvaus: Käytetäänkö laskulla käännettyä verovelvollisuutta vai ei. Jos tagi

esiintyy sanomassa ja sen arvona on "1", tulostuu laskun vapaan tekstin loppuun
lause: "Ei lisättyä arvonlisäveroa, ostajan käännetty verovelvollisuus (AVL 8c§)".
Tätä tagia käytettäessä kaikilla laskuriveillä tulisi olla arvonlisäveroprosentti nolla.

Jos laskurivillä kuitenkin annetaan arvonlisäveroprosentti taxpr-tagilla, lisätään
laskulle arvonlisävero negvat-tagista huolimatta.
Esimerkki JSON: "negvat": "1"

Sisältyy: dataset
8.96 netamount
Kuvaus: Laskun veroton loppusumma, laskurivin veroton kokonaishinta tai

veron peruste arvonlisäveroerittelyssä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 92 / 139
Jos netamount-tagi on annettu laskurivillä, niin tällöin myös vatamount-tagi on

annettava.
JSON Esimerkki:
"taxrow": [
{
"taxpr": "23",
}
]
Sisältyy: dataset, accountrow
8.97 noreport
Kuvaus: Estää siirtovahvistuksen lähettämisen tehtävästä. Tämä tagi on

hyödyllinen lähinnä käytettäessä debug-parametria.
Esimerkki JSON: "noreport": "true"

8.98 notice
Kuvaus: Ropo 24:n palauttama huomautusteksti vastaussanomassa.
Esimerkki:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 93 / 139
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1017",
"reference": "7100998595672453",
"ownref": "",
"jobid": 549222,
"jobtype": "0",
"amount": -61.5,
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": [
"Muista kohdistaa hyvityslasku Ropo 24:ssä"
],
"print": null
}
],
"errors": []
}
8.99 noticefee
Kuvaus: Toimeksiantajan huomautuskulu.
Jos lähetät huomautuksen velalliselle itse ja siirrät tehtävän Ropo Capitalille

perintään, voit laskuttaa omat huomautuskulusi velalliselta tällä tagilla.
Esimerkki JSON: "noticefee": "1"

Sisältyy: dataset
8.100 noticedate
Kuvaus: Maksumuistutuksen päivämäärä muodossa vvvv-kk-pp.

Maksumuistutuksen päivämäärää käytetään siirrettäessä lasku perintään (ts. kun
jobtype on 2).
Esimerkki JSON: "noticedate": "2017-06-01"

Sisältyy: dataset
8.101 operator
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 94 / 139
Kuvaus: Operaattorin tunnus. Tagia käytetään, jos sovellus välittää rajapinnan

kautta useiden toisistaan riippumattomien laskuttajien laskuja.
Ropo Capital pyytää sinua käyttämään tätä tagia, mikäli se on Ropo Capitalin
mielestä tarpeellista.
8.102 ordernumber
Kuvaus: Tilauksen numero laskuttajan omassa tietojärjestelmässä.

Tilausnumero tulostuu sellaisenaan laskulle.
Sisältyy: dataset
8.103 origbillnum
Kuvaus: Koontilaskua muodostaessa on alilaskujen (jobtype=602) tiedoissa

määriteltävä koontilaskun (jobtype=601) laskunumero.
8.104 ourcode
Kuvaus: Laskuttajan viite.
Esimerkki JSON: "ourcode": "Volvo ABC-553"

Sisältyy: dataset
8.105 overdueinterest
Kuvaus: Viivästyskorko desimaalilukuna: vuosikorko esimerkiksi 8.0. Jos

viivästyskorkoa ei anneta JSON-sanomassa, niin tehtävässä käytetään korkolain
mukaista viivästyskorkoa.
Ropo Capital voi oman harkintansa mukaan käyttää myös overdueinterest-tagia

pienempää viivästyskorkoprosenttia: esimerkiksi Suomessa kuluttajaa ei voida vaatia
maksamaan korkolakia suurempaa viivästyskorkoa. Vastuu overdueinterest-tagissa
annetun koron laillisuudesta on kuitenkin aina laskuttajalla - älä käytä tätä tagia, jos et
ole varma velallisen tyypistä tai asiakkaan kanssa sovitusta korosta.
Esimerkki JSON: "overdueinterest": "8.0"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 95 / 139
8.106 ovt
Kuvaus: Ovt-tunnusta voidaan käyttää varsinaisen osoitteen

(dataset) tai lisäosoitteen yhteydessä (addaddress).
Esimerkki JSON: "ovt": "00371234567800001"
Sisältyy: dataset, addaddres
8.107 ownref
Kuvaus: Tilapäinen lähetysviite, joka välittyy sellaisenaan rajapinnan läpi.

Lähetysviite auttaa liittämään yhteen rajapintaan lähetetyn laskun ja saapuvan
paluuviestin.
Jos rajapintaa käyttävä ohjelma määrittää laskulle laskunumeron billnum-tagilla,

niin ownref-tagia ei välttämättä tarvita, sillä tehtävänumero voidaan liittää laskuun
rajapinnan palauttaman laskunumeron perusteella.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 96 / 139
JSON Esimerkki:
{
"datastream": {
"dataset": [
{
"jobtype": "0",
"ownref": "155",
"company": "A Repolainen Ky",
"address": "Kauppakatu 12",
"city": "KUOPIO",
"billdate": "2017-03-03",
"paydate": "2017-03-17",
"payrow": [
{
"desc": "Siivous",
"count": "1",
"itemtype": "h",
"amount": "100",
"taxpr": "23"
}
]
}
]
}
}
JSON Vastaus:
{
"accepted": 1,
"result": [
{
"billnum": "1009",
"reference": "7100001195673532",
"ownref": "155",
"jobid": 549206,
"jobtype": "0",
"amount": "123.00",
"receiver": "A Repolainen Ky",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 97 / 139
Sisältyy: dataset, JSON - result
8.108 partycode
Description: Osoitteen tyyppi. (AnyPartycode Finvoice-määrityksessä)
Example JSON: "partycode": "xyz"

Embedded: addaddress
8.109 partytext
Description: Osoitteen kuvaus. (AnyPartyText Finvoice-määrityksessä)
Example JSON: "partytext": "Workshop"

Embedded: addaddress
8.110 paydate
Kuvaus: Laskun eräpäivä muodossa vvvv-kk-pp.
Jos eräpäivää ei anneta JSON-sanomassa, järjestelmä antaa laskulle

automaattisesti 14 päivää maksuaikaa laskun päiväyksestä lukien.
Muistutus- ja perintätehtävissä laskun eräpäivä on pakollinen tieto.
Sisältyy: dataset
8.111 payplan
Kuvaus: Maksusuunnitelman lähettäminen itselasketuilla erillä.
Rajapintaan voi lähettää maksusuunitelman kahdella tavalla. Joko itselasketuilla erillä

tai antaa Ropo24:n laskea erät.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 98 / 139
JSON:
"payplan": {
"instalment": [
{
"date": "2017-01-17",
"amount": "10.00"
}
]
}
Sisältyy: dataset
8.112 payplanamount
Kuvaus: Maksusuunnitelman yhden maksuerän summa euroissa.
Tätä tagia käytetään, jos asiakas voi maksaa tietyn summan säännöllisesti,
esimerkiksi 100 euroa kuukaudessa. Maksuerien lukumäärä määräytyy laskun
loppusumman perusteella.
Esimerkki, laskua lyhennetään 100,00 euroa kuukaudessa:
JSON:
"billdate": "2017-03-01",
"paydate": "2017-03-15",
"payplanamount": "100.00"
Sisältyy: dataset
8.113 payplancount
Kuvaus: Maksuerien lukumäärä maksusuunnitelmassa.
Tagia käytettäessä maksuerän euromääräinen summa lasketaan automaattisesti

siten, että koko lasku tulee suoritetuksi vaaditussa ajassa.
Maksusuunnitelman tulisi sisältää joko payplanamount- tai payplancount-tagi. Jos

molemmat tagit kuitenkin annetaan sanomassa, payplancount-tagi jätetään
huomiotta.
Esimerkki; lasku suoritetaan viidessä erässä kuukauden välein:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 99 / 139
JSON:
"billdate": "2017-03-01",
"paydate": "2017-03-15",
"payplancount": "5"
Sisältyy: dataset
8.114 payplaninterval
Kuvaus: Maksusuunnitelman maksuerien välinen aika kuukausina.
Jos laskulle luodaan maksusuunnitelma, payplaninterval-tagi esitetään aina ja

lisäksi valitaan joko payplanamount- tai payplancount-tagi.
Sisältyy: dataset
8.115 payrow
Kuvaus: Laskutettava tuote.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 100 / 139
Kuva 8: payrow-tagiin sisältyvät elementit
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 101 / 139
JSON:
"payrow": [
{
"accountid": "1000",
"productid"; "XN5",
"desc": "Kasipallo",
"count": "10",
"itemtype": "kpl",
"discount": "25.0",
"amount": "5.60",
"taxpr": "23"
}
]
Sisältyy: dataset
8.116 period
Kuvaus: Päivämäärä, jolle lasku kohdistuu toimeksiantajan kirjanpidossa.
Tagin arvoa voidaan käyttää asiakaskohtaisesti räätälöidyillä erikoisraporteilla. Ota

yhteyttä Ropo Capitaliin ennen kuin käytät tagia!
Sisältyy: dataset
8.117 person
Kuvaus: Henkilöasiakkaan etu- ja sukunimi. Tätä tagia käytetään, kun

customertype tagissa on määritelty asiakkaan tyypiksi yksityishenkilö (2).
JSON:
"person": "Teppo Testaaja"
Sisältyy: dataset
8.118 phone
Kuvaus: Asiakkaan puhelinnumero.
Puhelinnumero nopeuttaa ja tehostaa perintää, mikäli lasku päätyy perintään. Ropo

Capital voi esimerkiksi käyttää puhelinnumeroa puhelinperinnässä.
Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 102 / 139
8.119 postcode
Kuvaus: Asiakkaan postinumero. Laskutusrajapinta tarkistaa postinumeron

velallisen kotimaan mukaan:
• Suomalaisen postinumeron on oltava muotoa 99999, missä 9 on numero 0 - 9.

Maatunniste FI- tai FIN- saa olla postinumeron alussa.
• Virolaisen postinumeron on oltava muotoa 99999. Maatunniste EE- tai EST-
saa olla postinumeron alussa.
• Ruotsalaisen postinumeron on oltava muotoa 19999, missä 1 on numero 1 - 9.
Maatunniste S-, SE-, tai SWE-saa olla postinumeron alussa. Postinumeron
kolme ensimmäistä merkkiä voi olla erotettu välilyönnillä, kuten ruotsissa on
yleisesti tapana.
• Jos kyseessä on mikä tahansa muu maa tai kyseessä on toimitusosoite, niin
postinumeron muoto on vapaa, mutta jonkinlainen postinumero on oltava.
Jos postinumeron muoto ei täytä yllä olevia vaatimuksia, niin rajapinta hylkää
tehtävän virheilmoituksella: "Olet valinnut kirjeen kohdemaaksi suomen, mutta
postinumero 020662 ei kelpaa osoitteeksi kotimaassa: tarkista postinumero ja
velallisen kotimaa". Virheilmoitus aiheutuu usein siitä, että käyttäjä on kirjoittanut
maan nimen kaupungin tai postinumeron yhteyteen ja jättänyt varsinaisen maan
valitsematta. Jos näet yllä olevan virheilmoituksen, niin tarkista ensin, että maakoodi
on syötetty oikein.
Laskutusrajapinta on varsin tiukka postinumeroiden suhteen, koska Ropo Capitalille

on tärkeä saada asiakkaan postitusosoite ja kotimaa oikein. Asiakkaan kotimaa
vaikuttaa muun muassa perinnän nopeuteen, kuluihin ja perinnässä käytettävään
kieleen.
8.120 priceunit
Kuvaus: Hinnan yksikkö
Esimerkki JSON: "priceunit": "snt/kWh"

Sisältyy: payrow
8.121 printoperator
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 103 / 139
Sisältyy: dataset
8.122 productarea
Sisältyy: dataset
8.123 productid
Kuvaus: Tuotteen tuotekoodi rajapintaa käyttävän yrityksen

tietojärjestelmässä. Tuotekoodi tulostuu laskulle tuotenimikkeen yhteyteen.
Sisältyy: payrow
8.124 productidentifier
Sisältyy: payrow
8.125 productgroup
Sisältyy: payrow
8.126 propertyrow
Kuvaus: Antaa laskun ulkoasuun tai perintään vaikuttavan ohjaustiedon.
Anna propertyrow-tagi useita kertoja dataset-tagin alla, jos haluat asettaa useamman
ohjaustiedon arvon.
JSON:
"propertyrow": [
{
"propname": "debtclass",
"propvalue": " Energian toimitus"
}
]
Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 104 / 139
billtype
Kuvaus: Ropo 24 päättelee laskun otsikon automaattisesti. Jos automatiikka
halutaan ohittaa, voidaan billtypen avulla ylikirjoittaa laskun otsikkotieto.
JSON:
"propertyrow": [
{
"propname": "billtype",
"propvalue": "LÄMPÖLASKU"
}
]
Laskupohja: EXSTREAM
E2001 (sähkön lämmitysriippuvuus)

Kuvaus: Käyttöpaikan lämmityksen riippuvuus sähköstä. Jos käyttöpaikan
lämmitys on sähköstä riippuvainen, täytyy propvalue arvon olla ”riippuvainen”, muussa
tapauksessa käyttöpaikka ei ole sähköstä riippuvainen.
JSON:
"propertyrow": [
{
"propname": "E2001",
"propvalue": "riippuvainen"
}
]
SEN04 (laskutuksen tyyppi)

Kuvaus: Kuvaa asiakkaan laskutuksen tyyppiä, oletus tyyppi on kertalasku/
jatkuva. Jos kyseessä on loppulasku, täytyy propvalue:n arvo olla ”loppulasku”.
JSON:
"propertyrow": [
{
"propname": "SEN04",
"propvalue": "loppulasku"
}
]
s_bonus_amount, s_bonus_number ja s_bonus_send
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 105 / 139
Kuvaus: Jos toimeksiantajan käytössä on S-Bonus järjestelmä, voidaan S-Bonukseen

oikeuttavan euromäärän ilmoitus tehdä seuraavilla ohjaustiedoilla: s_bonus_amount,
s_bonus_number ja s_bonus_send. Käytettäessä S-Bonus järjestelmään, kaikki
luetellut S-Bonukseen liittyvät tiedot on annettava. Ennen S-Bonuksen käyttöönottoa
on Ropo Capitalille ilmoitettava S-bonustietojen lähettäjän tunnus (TLY-tunnus).
S-Bonukseen oikeuttava euromäärä
• propname: “s_bonus_amount” ja propvalue: “<määrä euroina>”
S-Etukortin numeron ilmoittaminen
• propname: “s_bonus_number” ja propvalue: “<s-etukortin numero>”
S-Bonus lähetyksen salliminen Ropo24:ssä. Jotta S-Bonuksen määrä lähetetään

Roposta eteenpäin s_bonus_send ohjaustietoon on annettava arvoksi nolla.
• propname: “s_bonus_send” ja propvalue: ”0”
Esimerkki:
JSON:
"propertyrow": [
{
"propname": "s_bonus_amount",
"propvalue": "345.40"
},
{
"propname": "s_bonus_number",
"propvalue": "1234123456"
},
{
"propname": "s_bonus_send",
"propvalue": "0"
}
]
8.127 propname
Kuvaus: Laskun ulkoasuun tai perintään vaikuttava ohjaustieto:
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 106 / 139
Ohjaustieto Arvo
debtclass Perintäkirjeellä näkyvä saatavan peruste, esimerkiksi

"hammashoitomaksu", "energian toimitus" tai "tv/internetpalvelut"
distraintcode Ulosoton asianimikoodi kuntien ja sairaaloiden ulosottokelpoisia

tehtäviä varten, esimerkiksi 37 tai 39
origcreditor Alkuperäisen velkojan nimi. Käytä tätä tagia, jos yrityksesi on vaihtanut
nimeä laskun lähettämisen jälkeen.
Ropo Capital saattaa pyytää sinua käyttämään myös asiakaskohtaisia

ohjaustietoja, joita ei löydy yllä olevasta taulukosta.
Sisältyy: propertyrow
8.128 propvalue
Kuvaus: Tagilla propname annetun ohjaustiedon arvo. Ohjaustiedon arvo

riippuu täysin propname-tagilla annetusta arvosta.
JSON:
"propertyrow": [
{
"propname": "E1002",
"propvalue": "1402465093"
}
]
Sisältyy: propertyrow
8.129 receiver
Kuvaus: Kopio laskutettavan nimestä (company tai person tagi). Tagi esiintyy
Ropo 24:n vastaussanomassa.
Sisältyy: row
8.130 reference
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 107 / 139
Kuvaus: Ropo Capitalin generoima viitenumero, jolla asiakkaan on tarkoitus

suorittaa maksu Ropo Capitalin asiakasvaratilille. Jos toimeksiantajan kanssa on
sovittu muista maksujärjestelyistä, tämän tagin arvo voidaan jättää huomiotta.
Tagi esiintyy rajapinnan vastausviestissä.
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1044",
"reference": "20171221047643",
"ownref": "",
"jobid": 2104764,
"jobtype": "0",
"amount": "129.15",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"print": null
}
],
"errors": []
}
8.131 refundiban
Kuvaus: Tilinumero, jolle hyvityslaskun palautukset toimitetaan.
Sisältyy: dataset
8.132 refundtobillnum
Kuvaus: Toimeksiantajan laskunumero, jolle hyvityslasku kohdistetaan.
Tällä tagilla ei ole merkitystä tulostuspalvelutehtävissä.
Sisältyy: dataset
8.133 refundtojobid
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 108 / 139
Kuvaus: Ropo Capitalin laskulle antama asianumero, johon hyvityslasku

kohdistetaan.
Tällä tagilla ei ole merkitystä tulostuspalvelutehtävissä.
Sisältyy: dataset
8.134 result
Kuvaus: Laskutusrajapinnan lähettämän vastaussanoman juuritagi.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 109 / 139
Kuva 10: result-tagin sisältämät elementit (ks. selitteet liitteestä 6)
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 110 / 139
JSON:
{
"accepted": 0,
"result": [
{
"billnum": "",
"ownref": "",
"amount": "43.05",
"accepted": 0,
"error": "Cannot write row"
}
],
"errors": [
{
"error": "Virhe laskussa : Cannot write row"
}
]
}
8.135 row
Kuvaus: Palauttaa yksittäiselle laskulle Ropo 24:ssä generoidut tiedot kuten

esimerkiksi laskunumeron, viitenumeron ja mahdollisen virheilmoituksen.
Huomaa, että Ropo 24:n vastausviestissä esiintyy yksi row-tagi per lähetetty lasku; jos
palveluun lähetetty sanoma sisältää neljä laskua, niin vastausviestissä saadaan
vastaavasti neljä row-tietuetta.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 111 / 139
JSON:
{
"accepted": 1,
"result": [
{
"billnum": "1002",
"reference": "2017035491985",
"ownref": "",
"jobid": 549198,
"jobtype": "0",
"amount": "43.05",
"sendtype": "post",
"evoicetype": "",
"accepted": 1,
"notice": null,
"print": null
}
],
"errors": []
}
8.136 rowline
Sisältyy: payrow
8.137 rowno
Kuvaus: Vapaavalintainen laskurivien järjestyksen määritys.
Sisältyy: payrow
8.138 rowtype
Sisältyy: payrow
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 112 / 139
8.139 rowpositionidentifier
Kuvaus: Laskurivin tunniste (finvoice)
Sisältyy: payrow
8.140 salesman
Kuvaus: Vapaavalintainen myyjän tunniste Ropo 24:ssä. Myyjän tunnusta

voidaan käyttää esimerkiksi myyntien raportointiin ja myyjäkohtaisten palkkioiden
laskemiseen.
Jos myyjän tunnusta ei ole käytetty aiemmin ja myyjän nimi on annettu

salesmanname-tagilla, myyjän nimi ja tunnus tallennetaan Ropo 24:ään siten, että
myyjän nimeä ei välttämättä tarvitse toistaa seuraavissa sanomissa. Ropo Capital
suosittelee kuitenkin antamaan myyjän nimen selvyyden vuoksi kaikissa sanomissa,
joissa myyjä halutaan näyttää asiakkaalle.
Esimerkki JSON: "salesman": "12"

8.141 salesmanname
Kuvaus: Myyjän nimi.
Rajapinnan versiosta 2.1 alkaen tunnusta vastaava myyjän nimi tulostuu laskun
oikeaan yläkulmaan. Ota yhteyttä Ropo Capitaliin, jos myyjän nimi ei saa missään
tapauksessa tulostua laskulle.
Esimerkki JSON: "salesmanname": "Matti Myyjä"

Sisältyy: dataset
8.142 sendtype
Kuvaus: Laskun lähetystapa:
Arvo Selite
post Kirje
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 113 / 139
Arvo Selite
print Tulosta itse
email Sähköposti
evoice Sähköinen lasku
Jos sendtype-tagi jätetään pois JSON-sanomasta, niin laskun lähetystapa

päätellään annettujen tietojen perusteella: (1) jos laskussa on verkkolaskuosoite
(evoice- ja evoiceint-tagi), niin lasku lähetetään sähköisenä, (2) jos laskussa on
sähköpostiosoite (email-tagi) mutta ei verkkolaskuosoitetta, niin lasku lähetetään
sähköpostilla, tai (3) jos laskussa ei ole verkkolaskuosoitetta tai sähköpostia, niin
lasku lähetetään kirjeenä.
Jos asiakas on tilannut e-laskun tai suoramaksun, niin lasku toimitetaan sendtype-
tagista riippumatta e-laskuna asiakkaan verkkopankkiin, mikäli laskun loppusumma
on nolla tai suurempi. Hyvityslaskut ja käteiskuitit toimitetaan aina sendtype-tagin
osoittamalla tavalla.
Muistutus- ja perintäkirjeet lähetetään sendtype-tagista riippumatta kirjeenä.
Sisältyy: dataset
8.143 sensible
Kuvaus: Lähetetäänkö maksumuistutus automaattisesti: 1=ei lähetetä,

0=lähetetään.
Jos maksumuistutuksen automaattinen lähettäminen estetään tällä tagilla,

käyttäjän tulee käydä Ropo 24:ssä vahvistamassa muistutuksen lähettäminen
manuaalisesti, jotta velallista muistutetaan maksamattomasta laskusta.
Jos sensible-tagi jätetään pois sanomasta tai tagin arvo on 0, maksumuistutus

lähetetään automaattisesti.
Sensible-tagi voidaan antaa sanomassa ainoastaan, jos lähetettävän tehtävän

tyyppi on lasku (ts. jobtype on 0).
Esimerkki JSON: "sensible": "1"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 114 / 139
8.144 servicecode
Kuvaus: Kustannuspaikan sisäinen id-numero toimeksiantajan kirjanpitoa

varten.
Kustannuspaikan sisäisen id-numeron saat Ropo 24:stä välilehdeltä Asetukset →

Tilikartat ja kustannuspaikat. Rajapinnassa on tarkistus, joka tarkastaa, että annettu
servicecode on lähettäjän Ropo 24 -profiilissa. Virheellinen servicecode antaa
virheilmoituksen. Tagin arvo nolla tulkitaan tyhjäksi kustannuspaikaksi ja näin ollen ei
aiheuta virheilmoitusta.
Sisältyy: dataset, accountrow, payrow
8.145 sitecode
Kuvaus: Osoitteen toimipistetunniste. (AnyPartySiteCode Finvoice-

määrityksessä)
Esimerkki JSON: "sitecode": "999"

Sisältyy: addaddress
8.146 source
Kuvaus: Sähköisen lasku lisätiedon tyyppi: finvoice tai teapps.
Finvoice- ja Teapps -laskusanomaformaatit asettavat välitettäville lisätiedoille

erilaisia vaatimuksia. Source-tagi auttaa Ropo 24:ää tulkitsemaan, mitä standardia
vasten lisätieto on muodostettu, ja Ropo 24 voi käyttää tagia muuntaessaan lisätiedon
Finvoice-muodosta Teapps-muotoon tai päinvastoin.
Jos välität Finvoice- tai Teapps -muotoista laskutusaineistoa Ropo 24:ään, niin
aseta tagi sen mukaan, mistä aineistosta lisätieto tuli. Jos sovelluksesi tuottaa
laskutusaineiston suoraan Ropo 24:n vaatimassa JSON-muodossa ilman konversioita
eri formaattien välillä, niin anna tagin arvoksi finvoice.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 115 / 139
JSON:
"xmldetailsrow": [
{
"text": "Rekisterinumero",
"source": "teapps",
"code": "rekno",
"value": "ABC-123"
}
]
Sisältyy: xmldetailsrow
8.147 startdate
Kuvaus(payrow): Laskurivillä näkyvä alkamispäivämäärä
Kuvaus(energycontract): Energiatoimialan käyttöpaikan sopimuksen alkamisaika
Esimerkki JSON: "startdate": "2015-12-24"

Sisältyy: payrow, energycontract
8.148 staticref
Sisältyy: dataset
8.149 storage
Kuvaus: Tuotteen id Ropo24:n varastossa. Vaatii varastosopimuksen.
Sisältyy: payrow
8.150 subidentifier
Kuvaus: Yhteenvetorivin ja varsinaisten laskurivien välinen suhde voidaan

ilmoittaa antamalla sama viitetieto yhteenvetorivin SubIdentifier-elementissä ja
viiteriviin liittyvien laskurivien RowSubIdentifier-elementissä. (Finvoice-kuvaus)
Sisältyy: payrow
8.151 TA0001
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 116 / 139
Kuvaus: Työmaa-avain rakennusalan laskuissa.
Tagin arvoksi tulee antaa oikein muodostettu työmaa-avain.
Verohallinto suosittelee, että rakennusalan laskuissa annetaan sekä työmaa-avain

että työmaanumero (TA0002-tagi).
Esimerkki JSON: "TA0001": "TA-FI-STVOY0001-B"

8.152 TA0002
Kuvaus: Työmaanumero rakennusalan laskuissa.
Verohallinto suosittelee, että rakennusalan laskuissa annetaan sekä

työmaanumero että työmaa-avain (TA0001-tagi).
Esimerkki JSON: "TA0002": "1234"

8.153 TA0003
Kuvaus: Onko raportoitu työmaarekisteriin: Y = kyllä, N = ei
Esimerkki JSON: "TA0003": "Y"

8.154 taxpr
Kuvaus: Tuotteen arvonlisäveroprosentti laskurivillä tai

arvonlisäveroerittelyssä.
Jos laskulle on määritelty käännetty verovelvollisuus negvat-tagilla, jokaisen

laskurivin taxpr-tagilla annettava arvonlisäveroprosentti tulisi olla nolla.
Esimerkki JSON: "taxpr": "24"

Sisältyy: payrow, taxrow, accountrow
8.155 taxrow
Kuvaus: Yhden arvonlisäverokannan alaiset summat.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 117 / 139
Kuva 12: taxrow-tagin sisältämät elementit

Taxrow-tagia käytetään, kun laskun hinnat esitetään täsmällisellä tavalla.
JSON:
"taxrow": [
{
"taxpr": "24",
}
]
Sisältyy: dataset
8.156 text
Kuvaus: Finvoice- tai Teapps -laskusanoman lisätiedon selväkielinen nimike,

esimerkiksi "Rekisterinumero" tai "Työmääräys".
JSON:
"xmldetailsrow": [
{
"source": "teapps",
"code": "rekno",
"value": "ABC-123"
}
]
Sisältyy: xmldetailsrow
8.157 totalamount
Kuvaus: Laskurivin verollinen kokonaishinta, laskun verollinen yhteismäärä tai

verollinen summa arvonlisäveroerittelyssä.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 118 / 139
Huomaa, että hyvityslaskuilla totalamount-tagin arvon tulisi olla negatiivinen.

Tällöin myös tuotteiden lukumäärän (count) tulisi olla negatiivinen.
Sisältyy: payrow, dataset, taxrow
8.158 totalitemprice
Kuvaus: Tuotteen verollinen yksikköhinta laskurivillä. Tagin arvoa käytetään

INC-laskupohjalla.
8.159 trafi
Sisältyy: dataset
8.160 transferkey
Kuvaus: Laskuttajan siirtoavain. Siirtoavain muodostetaan erillisellä HTTP

POST kyselyllä ja se osoittaa laskuttajan.
8.161 type
Kuvaus: Tyyppi, esim liiketoiminto.
Esimerkki JSON: "type": "A12345"

Sisältyy accountrow
8.162 type2
Kuvaus: Tyyppi, esim projekti.
Esimerkki JSON: "type": "B12345"
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 119 / 139
8.163 type3
Kuvaus: Tyyppi, esim vastuuyksikkö.
Esimerkki JSON: "type": "C12345"

8.164 type4
Kuvaus: Tyyppi, esim liiketoiminta aluenumero.
Esimerkki JSON: "type": "D12345"

8.165 type5
Kuvaus: Tyyppi, esim rakenne.
Esimerkki JSON: "type": "E12345"

8.166 unitcode
Kuvaus(definitiondetails): Laskusanoman lisätiedon arvon yksikkö.
Kuvaus(definitions): Laskusanoman laskurivikohtaisen arvon yksikkö.
Esimerkki JSON: "unitcode": "kWh"

Sisältyy definitiondetails, definitions
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 120 / 139
8.167 updatestorage
8.168 updatestoragejobid
8.169 usage_estimate
Kuvaus: Energiatoimialalla käyttöpaikan vuosikäyttöarvio.
Esimerkki JSON: "usage_estimate": "20000"

8.170 usage_estimate_unit
Kuvaus: Energiatoimialalla käyttöpaikan vuosikäyttöarvion laatu.
Esimerkki JSON: "usage_estimate_unit": "kWh"

8.171 usageplacecode
Kuvaus: Mahdollistaa laskurivin liittämisen käyttöpaikkaan. Code

vastaa usagaplacescode -tagia.
Sisältyy: payrow
8.172 usageplaces
Kuvaus: Energiatoimialan käyttöpaikat
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 121 / 139
JSON:
"usageplaces": [
{
"address": {
"person": "Tauno Testaaja",
"company": "Toiminimi Testaaja",
"city": "KUOPIO",
"addressaddline1": "Johto",
"addressaddline2": "PL 43",
"custnum": "123456",
"addresstype": "1"
},
"energycontract": {
"contract_no": "123456",
"name": "Verkkosopimus",
"vendor_name": "Testiverkot",
"startdate": "2017-06-01",
"enddate": "2018-06-01",
"expdate": "2018-06-01"
},
"code": "0070100",
"fuse": "25 A",
"usage_estimate": "20000",
"usage_estimate_unit": "kWh"
}
]
Sisältyy: dataset
8.173 userid
Sisältyy: dataset
8.174 value
Kuvaus (xmldetailsrow): Finvoice- tai Teapps -laskusanoman lisätiedon arvo.
Kuvaus(definitiondetails): Laskusanoman lisätiedon arvo.
Kuvaus(definitions): Laskusanoman laskurivikohtaisen arvo.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 122 / 139
Tagin arvo riippuu välitettävästä lisätiedosta ja laskutusaineistosta: Finvoice-

muodossa arvo voi olla enintään 70 merkkiä pitkä, kun taas Teapps -muodossa
pituutta ei ole rajattu. Ropo Capital suosittelee käyttämään Finvoicen rajoituksia, jotta
arvo välittyy luotettavasti ostajalle.
JSON:
"xmldetailsrow": [
{
"source": "teapps",
"code": "rekno",
"value": "ABC-123"
}
]
JSON:
"definitiondetails": [
{
"code": "E1003",
"value": "17030",
"unitcode": "kWh"
}
]
Sisältyy: xmldetailsrow, definitiondetails, definitions
8.175 vatamount
Kuvaus: Arvonlisäveron yhteismäärä laskussa, arvonlisäveron kokonaismäärä

laskurivillä tai arvonlisäveron määrä arvonlisäveroerittelyssä.
Jos laskuriville on annettu vatamount-tagi, niin tällöin myös netamount-tagi on

annettava.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 123 / 139
JSON:
"taxrow": [
{
"taxpr": "24",
}
]
8.176 vatcode
Kuvaus: Finvoicen tai cabin mukainen alv-koodi.
Sisältyy: payrow
8.177 vatfreetext
Kuvaus: Verottomuuden peruste.
Sisältyy: payrow
8.178 vatid
Kuvaus: Asiakkaan ALV-tunnus.
Esimerkki JSON: "vatid": "FI22059054"

Sisältyy: dataset
8.179 vatperiod
Kuvaus: The date on which VAT is applied in the principals

accounting. Contact our customer service before using this
Esimerkki JSON: "vatperiod": "2018-02-25"

Sisältyy: dataset
8.180 vatlayout
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 124 / 139
Kuvaus: Arvonlisänveron näkyminen laskuriveillä. 0 = Alvittomat. 1 =

arvonlisäverolla.
Esimerkki JSON: "vatlayout": "1"

Sisältyy: dataset
8.181 vendor_name
Kuvaus: Energiatoimialan käyttöpaikan toimittajan nimi
Esimerkki JSON: "vendor_name": "Testiverkot"

Sisältyy: energycontract
8.182 voucherbatch
Kuvaus: Tositelajin numero toimeksiantajan kirjanpidossa.

yhteyttä Ropo Capitaliin ennen kuin käytät tagia!
8.183 vouchernum
Kuvaus: Tositteen numero tositesarjan sisällä. Jos esimerkiksi laskuun liittyy

tosite 43-202132 toimeksiantajan kirjanpidossa, niin numero 43 asetetaan
voucherbatch-tagiin ja numero 202132 vouchernum-tagiin.

yhteyttä Ropo Capitaliin ennen kuin käytät tagia.
Sisältyy: dataset
8.184 xmldetailsrow
Kuvaus: Esim. Finvoice tai Teapps -laskusanoman lisätieto.
Lisätietoja käytetään, jos ostaja on automatisoinut ostolaskujen käsittelyä ja vaatii

laskuttajaa toimittamaan joitakin tietoja koneellisesti luettavassa muodossa laskun
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 125 / 139
kohdistamista tai maksamista varten. Lisätietojen avulla esimerkiksi autokorjaamo

voi välittää auton rekisterinumeron vakuutusyhtiölle tai aliurakoitsija voi välittää
työmaan numeron pääurakoitsijalle.
Jos lasku lähetetään asiakkaalle sähköisesti, niin Ropo 24:n JSON-sanomassa

annetut lisätiedot muutetaan tarvittaessa Finvoice- tai Teapps -muotoon ja välitetään
asiakkaalle koneellisesti luettavassa muodossa. Jos sen sijaan lasku lähetetään
kirjeenä tai sähköpostilla, niin lisätiedot tulostuvat laskun loppuun selväkielisessä
muodossa.
Huomaa, että Ropo 24:ssä lisätieto liittyy aina laskuun kokonaisuutena. Tällä hetkellä
Finvoice- ja Teapps -muodon tukemista tuotekohtaisista lisätiedoista voidaan esittää
ainoastaan työmaa-avain ja onko raportoitu työmaarekisteriin vai ei. Nämä tiedot
esitetään tageilla TA0001 ja TA0003.
JSON:
"xmldetailsrow": [
{
"source": "teapps",
"code": "rekno",
"value": "ABC-123"
}
]
Sisältyy: dataset
8.185 yourcode
YKuvaus: Ostajan viite: kustannuspaikka asiakkaan kirjanpidossa, ostajan nimi

tai muu viite.
Esimerkki JSON: "yourcode ": "Mikko Mäkelä"

Sisältyy: dataset
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 126 / 139
9 Eurooppalainen verkkolaskustandardi
Ropo24 laskutusrajapinta tukee Eurooppalaista verkkolaskustandardia. Pakolliset ja
ehdolliset kentät ja niiden määritys löytyy liitteestä dataset_EN16931.xlsx. Rajapinnan
toteuttajan tulee huomioida mitkä ehdollisista tiedoista on välttämättömiä kyseisen
toimialan laskujen välittämisessä. Lisätietoa verkkolaskustandardista löytyy esim.
alla olevien linkkien takaa.
• https://www.finlex.fi/fi/laki/alkup/2019/20190241
• https://www.valtiokonttori.fi/palvelu/verkkolaskutus/#696df2f1
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 127 / 139
10 Liite 4: Laskupohjat
Yleinen
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 128 / 139
ECOM
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 129 / 139
Rivikohtainen alv-erittely
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 130 / 139
11 Liite 5: ISO 3166 -maakoodit ja maan nimet

ABW Aruba
AFG Afghanistan
AGO Angola
AIA Anguilla
ALA Åland Islands
ALB Albania
AND Andorra
ARE United Arab Emirates
ARG Argentina
ARM Armenia
ASM American Samoa
ATA Antarctica
ATF French Southern Territories
ATG Antigua and Barbuda
AUS Australia
AUT Austria
AZE Azerbaijan
BDI Burundi
BEL Belgium
BEN Benin
BES Bonaire, Sint Eustatius and Saba
BFA Burkina Faso
BGD Bangladesh
BGR Bulgaria
BHR Bahrain
BHS Bahamas
BIH Bosnia and Herzegovina
BLM Saint Barthélemy
BLR Belarus
BLZ Belize
BMU Bermuda
BOL Bolivia, Plurinational State of
BRA Brazil
BRB Barbados
BRN Brunei Darussalam
BTN Bhutan
BVT Bouvet Island
BWA Botswana
CAF Central African Republic
CAN Canada
CCK Cocos (Keeling) Islands
CHE Switzerland
CHL Chile
CHN China
CIV Côte d'Ivoire
CMR Cameroon
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 131 / 139
COD Congo, the Democratic Republic of the

COG Congo
COK Cook Islands
COL Colombia
COM Comoros
CPV Cape Verde
CRI Costa Rica
CUB Cuba
CUW Curaçao
CXR Christmas Island
CYM Cayman Islands
CYP Cyprus
CZE Czech Republic
DEU Germany
DJI Djibouti
DMA Dominica
DNK Denmark
DOM Dominican Republic
DZA Algeria
ECU Ecuador
EGY Egypt
ERI Eritrea
ESH Western Sahara
ESP Spain
EST Estonia
ETH Ethiopia
FIN Finland
FJI Fiji
FLK Falkland Islands (Malvinas)
FRA France
FRO Faroe Islands
FSM Micronesia, Federated States of
GAB Gabon
GBR United Kingdom
GEO Georgia
GGY Guernsey
GHA Ghana
GIB Gibraltar
GIN Guinea
GLP Guadeloupe
GMB Gambia
GNB Guinea-Bissau
GNQ Equatorial Guinea
GRC Greece
GRD Grenada
GRL Greenland
GTM Guatemala
GUF French Guiana
GUM Guam
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 132 / 139
GUY Guyana
HKG Hong Kong
HMD Heard Island and McDonald Islands
HND Honduras
HRV Croatia
HTI Haiti
HUN Hungary
IDN Indonesia
IMN Isle of Man
IND India
IOT British Indian Ocean Territory
IRL Ireland
IRN Iran, Islamic Republic of
IRQ Iraq
ISL Iceland
ISR Israel
ITA Italy
JAM Jamaica
JEY Jersey
JOR Jordan
JPN Japan
KAZ Kazakhstan
KEN Kenya
KGZ Kyrgyzstan
KHM Cambodia
KIR Kiribati
KNA Saint Kitts and Nevis
KOR Korea, Republic of
KWT Kuwait
LAO Lao People's Democratic Republic
LBN Lebanon
LBR Liberia
LBY Libya
LCA Saint Lucia
LIE Liechtenstein
LKA Sri Lanka
LSO Lesotho
LTU Lithuania
LUX Luxembourg
LVA Latvia
MAC Macao
MAF Saint Martin (French part)
MAR Morocco
MCO Monaco
MDA Moldova, Republic of
MDG Madagascar
MDV Maldives
MEX Mexico
MHL Marshall Islands
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 133 / 139
MKD Macedonia, the former Yugoslav Republic of

MLI Mali
MLT Malta
MMR Myanmar
MNE Montenegro
MNG Mongolia
MNP Northern Mariana Islands
MOZ Mozambique
MRT Mauritania
MSR Montserrat
MTQ Martinique
MUS Mauritius
MWI Malawi
MYS Malaysia
MYT Mayotte
NAM Namibia
NCL New Caledonia
NER Niger
NFK Norfolk Island
NGA Nigeria
NIC Nicaragua
NIU Niue
NLD Netherlands
NOR Norway
NPL Nepal
NRU Nauru
NZL New Zealand
OMN Oman
PAK Pakistan
PAN Panama
PCN Pitcairn
PER Peru
PHL Philippines
PLW Palau
PNG Papua New Guinea
POL Poland
PRI Puerto Rico
PRK Korea, Democratic People's Republic of
PRT Portugal
PRY Paraguay
PSE Palestinian Territory, Occupied
PYF French Polynesia
QAT Qatar
REU Réunion
ROU Romania
RUS Russian Federation
RWA Rwanda
SAU Saudi Arabia
SDN Sudan
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 134 / 139
SEN Senegal
SGP Singapore
SGS South Georgia and the South Sandwich Islands
SHN Saint Helena, Ascension and Tristan da Cunha
SJM Svalbard and Jan Mayen
SLB Solomon Islands
SLE Sierra Leone
SLV El Salvador
SMR San Marino
SOM Somalia
SPM Saint Pierre and Miquelon
SRB Serbia
SSD South Sudan
STP Sao Tome and Principe
SUR Suriname
SVK Slovakia
SVN Slovenia
SWE Sweden
SWZ Swaziland
SXM Sint Maarten (Dutch part)
SYC Seychelles
SYR Syrian Arab Republic
TCA Turks and Caicos Islands
TCD Chad
TGO Togo
THA Thailand
TJK Tajikistan
TKL Tokelau
TKM Turkmenistan
TLS Timor-Leste
TON Tonga
TTO Trinidad and Tobago
TUN Tunisia
TUR Turkey
TUV Tuvalu
TWN Taiwan, Province of China
TZA Tanzania, United Republic of
UGA Uganda
UKR Ukraine
UMI United States Minor Outlying Islands
URY Uruguay
USA United States
UZB Uzbekistan
VAT Holy See (Vatican City State)
VCT Saint Vincent and the Grenadines
VEN Venezuela, Bolivarian Republic of
VGB Virgin Islands, British
VIR Virgin Islands, U.S.
VNM Viet Nam
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 135 / 139
VUT Vanuatu
WLF Wallis and Futuna
WSM Samoa
YEM Yemen
ZAF South Africa
ZMB Zambia
ZWE Zimbabwe
Lähde: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 136 / 139
12 Liite 7: Swagger kirjautuminen (JSON)
Aloitetaan auth – kohtaa klikkaamalla.
Lisää omat cid ja apicode tunnuksesi. (Example valueta hiirellä klikkaamalla saat
esitäytetyt arvot)
Kilkkaa Try it out! -nappia
Token arvo talteen
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 137 / 139
Oikean yläkulman “Authorize” – napista kirjaudutaan. Value kenttään ”Bearer

tokenarvo”. Nyt swagger muistaa kirjautumisen ja voit alkaa testaamaan rajapintaa.
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 138 / 139
13 Liite 8: Laskurivien muotoilu (JSON)

Esimerkki EXSTREAM laskupohjalla
JSON:
{
"datastream": {
"dataset": [
{
"address": "Mäkikatu 15",
"billdate": "2017-12-01",
"billnum": "testi12345",
"checkbillnum": 0,
"city": "Kuopio",
"company": "Demo",
"custnum": 1000,
"customertype": 1,
"freetext": "Demolasku",
"jobtype": 0,
"ownref": 512279489,
"paydate": "2018-03-25",
"salesman": "TP_TESTI",
"payrow": [
{
"invoicerowtype": 25601,
"desc": "Vuokraotsikko",
"allownullvalues": 1
},
{
"netamount": 1000.00,
"totalamount": 1240.00,
"vatamount": 24,
"amount": 1000.00,
"count": 1,
"desc": "Mäkikatu 15 vuokra",
"taxpr": 24
},
{
"desc": "Vuokrakulut yhteensä",
"allownullvalues": 1,
"netamount": 1000.00
},
{
"netamount": 20.00,
Ropo Capital Oy
LUOTTAMUKSELLINEN
Tekninen kuvaus
31.5.2019 139 / 139
"vatamount": 0,
"amount": 10.00,
"totalitemprice": 10.00,
"count": 2,
"desc": "Vesimaksu",
"taxpr": 0
},
{
"netamount": 28.00,
"vatamount": 0,
"amount": 28.00,
"totalitemprice": 28.00,
"count": 1,
"desc": "Sähkömaksu",
"taxpr": 0
},
{
"desc": "Muut kulut yhteensä",
"allownullvalues": 1,
"netamount": 48.00
}
]
}
]
}
}
Laskulle muodostuvat rivit
Ropo Capital Oy

Ropo24 - Laskutus API - 202306

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ropo24 - Laskutus API - 202306

Uploaded by

Copyright:

Available Formats

Laskutusrajapinta

Ropo24 REST API 202306

Ropo 24:ään voidaan lähettää rajapinnan kautta laskuja, maksumuistutuksia,

Rajapinta voidaan integroida osaksi yrityksesi laskutusohjelmaa, jolloin laskujen

Tämä dokumentti kuvaa rajapinnan tekniseen toteutukseen liittyviä yksityiskohtia.

4.3 Datan siirto _____________________________________________________________________________ 23

8.130 reference __________________________________________________________________________ 106

8.161 type _______________________________________________________________________________ 118

Swagger dokumentaatio löytyy https://rc.ropo24.fi/swagger sekä swaggerin

e-Lasku Kuluttajalle sähköisesti lähetetty lasku, joka toimitetaan tyypillisesti kuluttajan

Ostaja Asiakkaan henkilö, joka ostaa tavaraa tai palvelua toimeksiantajalta.

Saatava Velalliselta perittävä maksamaton rahasumma toimeksiantajan myymistä tavaroista tai

3 Uudet ja muuttuneet ominaisuudet

Muutettu testiympäristön osoitteet beta -> rc

Beta poistettu käytöstä

Lisätty ohjeet aineiston toimituksesta zip-pakattuna.

Poistettu vanhentunut palvelu “Tilausvahvistukset ja muut kirjeet”

Tuki Eurooppalaiselle verkkolaskustandardille

Versio 3.20 muutokset:

• http-liikenteen tuki lopetettu

• tarkennettu tehtävien yksittäisen toimistuserän maksimikokoa

Versio 3.19 uudet ominaisuudet:

• accountrow-tagi lisätty payrow-tagin alle, jolloin tiliöintitiedot voidaan lisätä

• lisätty propertyrow arvot E2001 (sähkön lämmitysriippuvuus), SEN04

• payplan tagilla itselaskettu maksusuunnitelma

Versio 3.14 uusi tagi:

Uudet ja muuttuneet tagit:

• dataset: accountdate, vatlayout, contract, ovt

Versio 3.10 sisältää uusia ominaisuuksia:

• Laskujen ostopalvelu: voit nyt hakea laskujen ostopalvelua Ropo Financelta!

Uudet ja muuttuneet tagit:

• dataset: addressaddline3, error, origbillnum

• https://beta.ropo24.fi -osoite otettu käyttöön.

• https://www.ropo24.fi -osoite otetaan käyttöön 3.7.2017.

• https://www.trustpoint.fi sekä https://online.trustpoint.fi -osoitteet poistuvat

• https://beta2.trustpoint.fi jää toistaiseksi käyttöön.

Versio 3.04 sisältää uusia ominaisuuksia:

• JSON REST-API: Mahdollisuus käyttää laskutukseen JSON-muotoista dataa.

Versio 2.80 sisältää uusia ominaisuuksia:

• Ennakkomaksu: laskuttaja voi nyt lähettää ennakkomaksun tiedot, josta

Uudet ja muuttuneet tagit:

Versio 2.73 sisältää uusia ominaisuuksia:

• Rakennusalan työmaatunnisteet: sähköisissä laskuissa voidaan nyt siirtää

• Lisää räätälöintimahdollisuuksia: voit nyt muokata laskun ulkoasua ja perintää

Uudet ja muuttuneet tagit:

1. lisätty propertyrow-tagi ja sen alle tagit propname ja propvalue

2. lisätty xmldetailsrow-tagi ja sen alle tagit source, text, code, value

3. dataset-tagin alle lisätty tagit deliverymethod, deliveryterm

4. dataset-tagin ja payrow-tagien alle lisätty tagit TA0001, TA0002, TA0003

Versio 2.71 sisältää uusia ominaisuuksia:

• Kuluttajan e-laskut: voit nyt lähettää kuluttajille e-laskuja tarvitsematta muuttaa

Uudet ja muuttuneen tagit:

1. dataset-tagin alle lisätty tagit finance, deliverydate

Versio 2.70 sisältää uusia ominaisuuksia:

• Kassa-alennus: laskusta voidaan antaa esimerkiksi 2% alennus, jos velallinen

Uudet ja muuttuneet tagit:

1. dataset-tagin alle lisätty cashdiscountrow-tagi, jonka alla voi olla tagit

2. Tagit color ja printoperator eivät ole enää käytössä. Värikirjeiden lähettäminen

Versio 2.61 sisältää uusia ominaisuuksia:

• Vakiokorvaus: maksuviivästysdirektiivin 2011/7/EU perusteella yritysvelalliselta

Uudet ja muuttuneet tagit:

1. dataset-tagin alle lisätty tagit: noticefee, fixedfee

Versio 2.52 tuo uusia ominaisuuksia: