Johdanto
Odoossa tiedot järjestetään malleihin — ne kertovat, miten liiketoiminnan numerot ja merkinnät säilytetään tietokannassa. Myyntitilauksista laskuihin ja kirjanpidon tapahtumiin kaikki taloustieto asuu mallien riveinä.
Sekä sovellusasiantuntijan että kehittäjän täytyy ymmärtää Odoon mallit: ne muodostavat järjestelmän datarakenteen ytimen. Mallit määrittelevät kentät, tietosuhteet ja sen liiketoimintalogiikan, jonka päälle raportit ja prosessit rakentuvat.
Tässä artikkelissa keskitytään yhteen Odoon kirjanpidon tärkeimmistä malleista: account.move.line. Jos rakennat raportteja, kytket ulkoisia järjestelmiä tai määrittelet reskontran ja täsmäytyksen toimintaa, työskentelet tämän mallin kanssa.
Mikä on account.move.line -malli
account.move.line kuvaa yksittäistä kirjanpidon rivimerkintää — yhden debetin tai kreditiin. Kirjanpidon kannalta rivit muodostavat yhdessä tasapainoisen liikkeen: debetien summa on yhtä suuri kuin kreditien summa.
Mallia käyttää kirjanpitomoduuli ja se on account.move -mallin alirakenne. account.move edustaa koko tositetta (laskuja, ostolaskuja, pankkitapahtumia, manuaalisia päiväkirjamerkintöjä) ja jokaisella tositteella on yksi tai useampi rivimerkintä.
Mallin perusrakenne löytyy account‑moduulista, mutta muut moduulit laajentavat sitä perintämekanismilla. Myyntimoduuli lisää laskurivien tietoja, ostomoduuli lisää ostolaskujen kenttiä ja analyyttinen kirjanpito lisää jakautumia — kukin moduuli täydentää ydintä tarpeen mukaan ilman päällekkäisyyttä.
Mallin keskeiset kentät
Seuraavaksi käydään läpi ne kentät, joita käytät eniten account.move.line -rivin kanssa työskennellessäsi. Kun ymmärrät näiden merkityksen, kirjanpitomerkintöjen käsittely ja raportointi sujuvat oikein.
1. name
Tyyppi: Char. Rivin otsikko tai kuvaus. Näkyy tositeraporteissa ja listanäkymissä. Laskuriveillä arvo tulee usein tuotteesta tai käyttäjän antamasta kuvauksesta.
2. move_id
Tyyppi: Many2one (account.move). Yhdistää rivin sen emätositteeseen. Jokainen rivi kuuluu täsmälleen yhteen moveen — tämä on mallin pääsuhde.
3. account_id
Tyyppi: Many2one (account.account). Tilitili, jolle rivi kohdistetaan. Pakollinen kenttä; tilin on oltava käytettävissä (ei view tai suljettu). Tällä kentällä ryhmitellään ja raportoidaan tilikarttatasolla.
4. debit
Tyyppi: Float. Debet‑summa. Oletusarvo 0.0. Yhdellä rivillä on joko debet tai kredit, ei molempia. Debetit kasvattavat varoja ja kuluja.
5. credit
Tyyppi: Float. Kredit‑summa. Oletusarvo 0.0. Kreditit kasvattavat velkoja, omaa pääomaa ja tuottoja. Tositteen debetien ja kreditien summien tulee täsmätä.
6. balance
Tyyppi: Float (laskettu). debit minus credit. Ilmaisee rivin nettovaikutuksen; positiivinen debeteille, negatiivinen krediteille. Käytetään raportoinnissa ja täsmäytyksissä.
7. partner_id
Tyyppi: Many2one (res.partner). Asiakas, toimittaja tai muu osapuoli, johon rivi liittyy. Tarpeellinen myynti‑ ja ostoreskontran sekä ikääntymisraporttien ja täsmäytysten kannalta.
8. date
Tyyppi: Date. Rivin kirjauspäivä. Usein periytyy emätositteesta. Merkittävä sulkemisajankohdan, tilikausien ja raportoinnin kannalta.
9. date_maturity
Tyyppi: Date. Eräpäivä. Tärkeä myynti‑ ja ostoreskontrassa, vaikuttaa erä‑ ja maksuajastuksiin sekä ikääntymisraportteihin.
10. currency_id
Tyyppi: Many2one (res.currency). Rivin valuutta. Voi poiketa yhtiön valuutasta monivaluuttalisissä merkinnöissä.
11. amount_currency
Tyyppi: Float. Summa rivin valuutassa. Kun kappale on muussa valuutassa, tämä kenttä yhdessä currency_id:n kanssa mahdollistaa monivaluuttakirjanpidon.
12. quantity
Tyyppi: Float. Valinnainen määräkenttä. Käytetään tuoteriveillä laskuissa ja ostolaskuissa; hyödyllinen määräpohjaiseen raportointiin ja yksikköhinnan laskemiseen.
13. product_id
Tyyppi: Many2one (product.product). Riville liitetty tuote. Täytetään automaattisesti myynti‑ tai ostotilauksista ja laskuriveistä.
14. product_uom_id
Tyyppi: Many2one (uom.uom). Mittayksikkö määrälle. Tarvitaan tuotteen määrien näyttöön ja konversioon.
15. price_unit
Tyyppi: Float. Yksikköhinta. Käytetään yhdessä quantityn kanssa laskuissa ja ostolaskuissa määrän ja summan laskemiseen.
16. tax_ids
Tyyppi: Many2many (account.tax). Riville sovelletut verot. Odoo voi luoda erillisiä verorivejä veron määrän kirjaamiseksi; tärkeä ALV‑laskelmissa.
17. tax_line_id
Tyyppi: Many2one (account.tax). Viittaa veroon, joka on synnyttänyt kyseisen verorivin. Erottaa verorivit tavallisista tiliriveistä.
18. analytic_account_id
Tyyppi: Many2one (account.analytic.account). Analyyttinen tili kustannus‑ ja tulosseurannassa. Käytetään, kun analyyttinen kirjanpito on käytössä.
19. analytic_distribution
Tyyppi: Json tai Text. Tallentaa jaon useille analyyttisille tileille. Uudemmissa Odoo‑versioissa korvaa yksittäisen analytic_account_id:n, kun käytössä on analyyttiset suunnitelmat.
20. ref
Tyyppi: Char. Usein periytyy emätositteesta. Ulkoinen viite tai memo; näkyy raporteissa ja auttaa täsmäytyksessä.
21. narration
Tyyppi: Text. Sisäinen muistiinpano tai selite, joka yleensä periytyy emätositteesta. Ei oletusarvoisesti tulostu asiakkaille suunnattuihin dokumentteihin.
22. journal_id
Tyyppi: Many2one (account.journal). Tositteen päiväkirja. Käytetään päiväkirjakohtaiseen suodatukseen ja raportointiin.
23. company_id
Tyyppi: Many2one (res.company). Yhtiö, johon rivi kuuluu. Moniyritysympäristössä rivi kuuluu aina yhteen yhtiöön, mikä vaikuttaa näkyvyyteen ja konsolidointiin.
24. reconciled
Tyyppi: Boolean. kertoo, onko rivi täysin täsmäytetty. Hyödyllinen suodatuksessa, kun etsit auki olevia saamisia tai velkoja.
25. full_reconcile_id
Tyyppi: Many2one (account.full.reconcile). Linkittää kaikki yhdessä tapahtuneen täsmäytyksen rivit. Mahdollistaa täsmäytysryhmien jäljityksen.
26. payment_id
Tyyppi: Many2one (account.payment). Maksutapahtumaan liittyvä linkki. Käytetään laskujen ja maksujen välisten täsmäytysten yhteydessä.
27. statement_id
Tyyppi: Many2one (account.bank.statement). Linkki pankkitilin tositteeseen. Merkittävä pankkitilien täsmäytyksessä.
28. statement_line_id
Tyyppi: Many2one (account.bank.statement.line). Linkki tarkkaan pankkitapahtumariviin. Käytetään, kun yhdistetään tositteita pankkitapahtumiin.
29. display_type
Tyyppi: Selection. Arvot kuten 'line_section' tai 'line_note' mahdollistavat otsikot ja huomautusrivit tositteessa. Näillä riveillä ei ole debet‑ tai kredit‑arvoa, ne ovat vain esitystä varten.
30. create_date
Tyyppi: Datetime. Tallenna milloin rivi luotiin. Odoo huolehtii tästä automaattisesti; hyödyllinen auditoinnissa.
31. write_date
Tyyppi: Datetime. Tallenna viimeisin muokkausaika. Automaattinen; auttaa muutosten seurannassa.
Miten tätä mallia käytetään liiketoimintaprosesseissa
1. Asiakaslaskutus
Kun lasku vahvistetaan, Odoo luo account.move.line -rivit: myyntituotot kirjautuvat tuotto‑tileille ja saamisrivit asiakkaan saamisille. Verorivit syntyvät jokaisesta sovellettavasta verosta. partner_id sitoo rivin asiakkaaseen ikääntymisraportin ja täsmäytysten varten.
2. Ostolaskut
Ostolaskut tuottavat rivejä menoille, vähennettävälle ALV:lle ja ostovelkoihin. Riveillä on account_id, debet tai kredit ja partner_id. Rakenne vastaa asiakaslaskuja, mutta tilatyypit eroavat.
3. Pankkitilien täsmäytys
Pankkirivit yhdistetään boekkiriveihin statement_line_id:n kautta. Täsmäytyksessä Odoo linkittää rivit full_reconcile_id:llä, ja reconciled‑kenttä muuttuu Trueksi kun täsmäys on tehty.
4. Manuaaliset päiväkirjamerkinnät
Käyttäjät voivat luoda manuaalisia tositteita, joissa on useita rivejä. Jokaisella rivillä on tili, debet tai kredit ja tarvittaessa partner. Odoo vaatii, että debetit ja kreditit täsmäävät ennen tositteen kirjaamista.
5. Analyyttinen ja kustannuslaskenta
Jos analyyttinen kirjanpito on käytössä, rivit kantavat analytic_account_id:n tai analytic_distributionin. Raportit ryhmittelevät näiden mukaan näyttääksesi kustannukset ja tuotot projekteittain, osastoittain tai muilla liiketoiminnan dimensioilla.
Miten kehittäjät laajentavat mallia
Kehittäjät laajentavat account.move.line -mallia eri tavoilla. Odoon malliperintä on yleisin menetelmä lisätä kenttiä, logiikkaa tai rajoituksia.
Malliperintä
Käytä _inherit = 'account.move.line' laajentaaksesi mallia. Voit lisätä uusia kenttiä, ylikirjoittaa metodeja tai lisätä validointeja. Perintä pitää muutokset erillisessä moduulissa ja helpottaa päivityksiä.
Kenttien lisääminen
Lisää uusia kenttiä perityssä mallissa oikeilla tyypeillä: Char, Many2one, Boolean, Integer, Text, Selection. Huomioi yritysriippuvat kentät moniyrityksessä ja mieti laskettujen kenttien riippuvuudet huolellisesti.
Python‑laajennukset
Ylikirjoita metodeja kuten create, write tai unlink lisälogiikkaa varten ja kutsu aina super() alkuperäisen toiminnallisuuden säilyttämiseksi. Varo, ettet riko debet=kredit -vaatimusta. Nämä metodit ovat myös integraatioiden pääsisäänkäyntiä.
Odoo Studio
Odoo Studiolla voit lisätä kenttiä ilman koodia — hyvä nopeisiin muokkauksiin kuten lisäetiketit tai tagit. Monimutkaisemmissa sääntöissä ja täsmäytyksissä kustomoitu moduuli on kuitenkin usein kestävämpi ratkaisu.
Parhaat käytännöt
- Älä luo tai muokkaa rivimerkintöjä suoraan ilman, että käytät emätositteen APIa. Lisääminen moveen (esim. line_ids:n kautta) varmistaa, että Odoo suorittaa kaikki tarkistukset ja ylläpitää datan eheyttä.
- Raportteja rakentaessa suodata move_id.state = 'posted' — näin draft‑ ja perutut tositteet eivät vääristä tuloksia.
- Käytä oikeantyyppistä account_id:tä (receivable, payable jne.), jotta reskontra, ikääntyminen ja täsmäytys toimivat odotetusti.
- Kun integroit API:n kautta, luo ensin move ja lisää sitten rivit. Varmista, että debetit ja kreditit ovat tasapainossa ennen tositteen kirjaamista.
- Oman kentän lisäämisessä käytä x_‑ tai moduulin omaa etuliitettä, jotta vältyt yhteensopivuusongelmilta tulevissa Odoo‑versioissa.
Yleisimmät virheet
- Pitä kerrallaan sekä debit että credit asetettuna samalla rivillä. Yhdellä rivillä tulisi olla vain toinen arvoista.
- Älä luo epätasapainossa olevia tositteita — debetien ja kreditien summien pitää olla yhtä suuret. Odoo estää epätasapainoisen tositteen kirjaamisen.
- Älä muokkaa kirjattuja rivejä suorilla muutoksilla; käytä kumoamis‑ tai oikaisuprosessia. Kirjatut merkinnät korjataan uusilla tositteilla.
- Älä jätä partner_id:tä pois saamisissa tai veloissa. Puuttuva partner heikentää ikääntymisraportteja ja estää täsmäytyksen toiminnan oikein.
- Älä ylikirjoita ydintoiminnallisuutta kutsumatta super():a — se voi rikkoa täsmäytyksiä, lukituksia tai muiden moduulien odotuksia.
Yhteenveto
account.move.line on kirjanpidon selkäranka Odoossa — siihen tallentuvat kaikki debetit ja kreditit laskuista, ostoista ja päiväkirjatapahtumista. Mallin kenttien ja laajennustapojen ymmärtäminen auttaa mukauttamaan ja yhdistämään Odoon oikein.
Oli roolisi sitten toiminnallinen asiantuntija tai kehittäjä, hyvä ymmärrys account.move.line -mallista säästää aikaa ja ehkäisee kalliita virheitä toteutuksissa ja integraatioissa.
Tarvitsetko apua Odoo‑käyttöönotossa?
Dasolo auttaa yrityksiä Odoon käyttöönotossa, kustomoinnissa ja optimoinnissa. Erikoisosaamistamme ovat API‑integraatiot ja räätälöity kehitys — tiimillämme on vankka kokemus Odoon tietomallista ja erityisesti account.move.line‑rakenteesta.
Tarvitsetko apua Odoo‑projektissa, kustomimoduulissa tai integraatiossa? Olemme valmiina tukemaan sinua. Varaa demo keskustellaksesi projektistasi.