BusDK Update

Riviselitteet säilyvät toistossa ja korjausrivit näkyvät tuloslaskelmalla oikein

5.4.2026 Toisto Tuloslaskelma bus journal assert match

Tämä korjaus osuu kohtaan, joka näkyy heti silloin kun samaa vientiä vertaillaan lähdeaineistoon tai raporttiin: yhteinen tositteen kuvaus ja rivikohtainen selite eivät enää mene sekaisin.

Samalla vuoden alun korjausrivit näkyvät tuloslaskelmalla oikeassa roolissaan, ja bus journal assert match saa oman tarkistuksen source-id-ryhmien lukumäärälle.

Tiiviisti

TL;DR

Riviselite säilyy nyt omana tietonaan myös toistossa.
Vuoden alun korjausrivit eivät enää katoa tuloslaskelmalta.
bus journal assert match osaa tarkistaa source-id-ryhmien määrän.

Riviselitteen korjaus kannattaa hahmottaa konkreettisen viennin kautta. Yksi ja sama tosite voi sisältää yhteisen kuvauksen, mutta riveillä on silti oma eri merkityksensä:

bus journal add \
  --date 2025-01-04 \
  --desc "Tuotu kuitti" \
  --debit '1000=24.00=Toimistotarvikkeet' \
  --credit '3000=24.00=Korttimaksu'

bus journal list \
  --format csv \
  --fields posting_date,account_id,debit,credit,voucher_description,row_description

posting_date,account_id,debit,credit,voucher_description,row_description
2025-01-04,1000,24.00,0.00,Tuotu kuitti,Toimistotarvikkeet
2025-01-04,3000,0.00,24.00,Tuotu kuitti,Korttimaksu

Olennaista on juuri se, että voucher_description ja row_description pysyvät erillään. Kun samaa aineistoa toistetaan tai listataan myöhemmin, rivit eivät enää palaa yhdeksi yleiseksi kuvaukseksi. Tämä helpottaa sekä tarkastusta että myöhempää jatkokäsittelyä. Lisää taustaa löytyy bus-journal-dokumentaatiosta.

Raporttipuolella muutos koski vuoden alun oikaisuja. Jos kirjauksissa käytetään lähdelajeja prior-year-correction tai opening-adjustment, niiden pitää näkyä tuloslaskelmalla korjausriveinä eikä tavallisena kuluvan kauden toimintana. Tämä näkyy erityisen hyvin silloin, kun vuoden alussa korjataan edellisen tilikauden saldoja mutta ei haluta sotkea juoksevan kauden tulosta.

Uusi source-id-ryhmien tarkistus täydentää samaa ajatusta toisesta suunnasta. Jos halutaan varmistaa, että tietylle tilille on syntynyt täsmälleen kaksi tietyn lähdetyypin ryhmää, sen voi nyt tarkistaa suoraan yhdellä komennolla:

bus journal assert match \
  distinct source-id count 1000 "receipt-split:demo:" 2

measure	scope	expected	observed	status
match-distinct-count	match=1000 receipt-split:demo: group_by=source-id distinct_count	2	2	pass

Tässä odotusarvo on lopun 2, ja observed 2 kertoo, että havaittu ryhmämäärä oli sama. Koska kyse on assert-komennosta, onnistunut tarkistus palauttaa exit-statuksen 0. Tarkempi syntaksi löytyy bus-journal-dokumentaatiosta.