Odoo 19 Uimhreacha Doiciméad as Réimír, Bliain agus Áiritheoir – an modúl document_number_prefix_year agus an gaiste i gcás cruthú comhuaineach

Insíonn “AN26000001” níos mó ná “S00001”: Is tairiscint é, is ó 2026 é, agus is é an chéad cheann é. Teastaíonn ó go leor gnólachtaí, go háirithe iad siúd atá ag aistriú ó chóras níos sine go Odoo, a n-uimhreacha doiciméad a choinneáil díreach mar sin. Uimhríonn Odoo féin tairiscintí, orduithe agus nótaí seachadta le seichimh dá chuid féin (S00001, WH/OUT/00001, P00001) agus sonraisc leis an réimír iris agus an bhliain (INV/2026/00001).

Scríobh muid an modúl Document Numbering by Prefix and Year (document_number_prefix_year) d'Odoo 19 chuige sin. Tá sé ar fáil mar bhogearra saor faoin gceadúnas LGPL-3 ar GitHub:

github.com/Alex0176/odoo-document-number-prefix-year

Tuairim macánta ar dtús: Ní úsáidimid an modúl ag Biricon IT Services ar chor ar bith. Foilsímid é toisc go bhfuil sé críochnaithe, doiciméadaithe agus tástálacha leis, agus gur féidir leis obair a shábháil do dhaoine eile. An té a úsáideann é, ba cheart dó na codanna maidir le Teorainneacha agus Tástálacha a léamh.

An scéim uimhreacha

Tá trí chuid i ngach uimhir: réimír in aghaidh gach cineál doiciméid, an bhliain agus áiritheoir le líon seasta digit. Socraíonn tú an réimír, formáid na bliana (26 nó 2026) agus líon na ndigit in aghaidh gach cuideachta faoi Socruithe → Uimhriú doiciméad.

Láimhseáiltear tairiscintí, orduithe custaiméirí, sonraisc custaiméirí agus nótaí creidmheasa, nótaí seachadta, glacadh earraí agus orduithe ceannaigh. Níl sna réimíreacha san fhigiúr ach samplaí: AN, AU, RE, GU, LI, WE, BE. An té a fhágann réimír folamh, coinníonn sé uimhriú caighdeánach Odoo don chineál doiciméid sin. Ní dhéanann an modúl aon rud mar sin go dtí go socraíonn tú é.

Conas a iompraíonn na huimhreacha iad féin

• Nua gach bliain. Tosaíonn an t-áiritheoir arís ag 1 ag casadh na bliana.
• Leanúint tar éis uimhreacha allmhairithe. Cuardaíonn an modúl an uimhir is airde atá ann cheana den réimír agus den bhliain chéanna, is cuma cé chomh fada is atá sé. Má tá AN26119 ón seanchóras sa bhunachar sonraí, is é AN26000120 an chéad tairiscint eile. Is é sin an chúis a n-oireann an modúl d'aistrithe: Allmhairítear sean-doiciméid lena n-uimhreacha bunaidh, agus leanann doiciméid nua go gan scáth.
• Uimhir nua ordaithe le deimhniú. Faigheann tairiscint dheimhnithe, ar iarratas, uimhir ó sheicheamh na n-orduithe. Fanann uimhir na tairisceana sa réimse Uimhir tairisceana ar an ordú agus tá sí le feiceáil san fhoirm, sa liosta agus sa chuardach.
• Sonraisc agus iad á gcur sa leabhar. Faigheann sonraisc custaiméirí agus nótaí creidmheasa a n-uimhir nuair a chuirtear sa leabhar iad amháin, ní nuair a chruthaítear iad. Dá bhrí sin ní fhágann dréachtaí scriosta aon bhearna. Tagann an bhliain ó dháta an tsonraisc: Tugtar RE25… ar shonrasc ón 30.12.2025 a chuirtear sa leabhar ar an 2.1.2026.
• Fanann gach rud eile. Coinníonn sonraisc soláthraithe, íocaíochtaí, iontrálacha leabhair agus orduithe monaraíochta seichimh chaighdeánacha Odoo. Ní athscríobhtar ainmneacha atá ann cheana choíche, fiú má mhúchann tú an modúl arís.

An chuid chigilteach: Beirt úsáideoirí ag an am céanna

Is cosúil le rud simplí é leithdháileadh uimhreacha dá chuid féin: an uimhir is airde a aimsiú, a haon a chur léi. Ní mar sin atá sé a luaithe a chruthaíonn beirt úsáideoirí tairiscint ag an nóiméad céanna. Léann an bheirt “an uimhir is airde = 0”, tugann an bheirt AN26000001. Tá seichimh bunachair sonraí ag Odoo chuige sin dá seichimh féin. Ar uimhir a tógadh de láimh níl sé sin ann, agus do thairiscintí agus d'orduithe ceannaigh níl aon seiceáil uatha ar an ainm in Odoo ina theannta sin: Stóráiltear dhá dhoiciméad leis an uimhir chéanna go simplí.

Is é an cosaint is soiléire ná glas. Glacann an modúl glas den bhunachar sonraí (PostgreSQL Advisory Lock) in aghaidh gach cuideachta, réimír agus bliana, a choinníonn go dtí deireadh an idirbhirt. Fanann an dara húsáideoir go dtí go mbíonn an chéad cheann críochnaithe. Ach ní leor sin, agus fuair muid amach é trí thriail ar chóip den bhunachar sonraí táirgthe:

Oibríonn Odoo leis an leibhéal aonraithe REPEATABLE READ. Reoitear an staid bunachair sonraí a fheiceann idirbheart ag a chéad fhiosrú. Tá an staid sin ag úsáideoir B cheana, sula mbíonn A críochnaithe. Má fhanann B ansin leis an nglas agus má fhaigheann sé é, léann sé lena sheanstaid “an uimhir is airde = 0” agus tugann sé an uimhir den dara huair. Rialaigh an glas an t-ord, ach níor nuashonraigh sé an t-eolas.

Is é an réiteach ná dara léamh trí chónascadh bunachair sonraí ar leith, gearrshaolach a fheiceann na sraitheanna deimhnithe uile. Buaileann an luach is mó den dá cheann. Tá an chéad léamh fós riachtanach, mar is é amháin a bhfuil eolas aige ar uimhreacha a thug an t-idirbheart céanna cheana ach nár deimhníodh go fóill, mar shampla agus roinnt doiciméad á n-allmhairiú in aon iarraidh amháin.

Sheiceáil muid é seo le dhá idirbheart inar tharraing an dara ceann a staid go sonrach roimh commit an chéad cheann agus ansin d'fhan sé leis an nglas. Gan an dara léamh fuair an dá ordú an uimhir chéanna, leis fuair siad na huimhreacha 1 agus 2.

Tábhachtach don mheasúnú: Is seiceáil láimhe é an triail seo. Níl sé ina chuid de na tástálacha uathoibríocha, toisc go bhfuil dhá nasc bunachair sonraí fíor ag teastáil uaidh nach gcuireann timpeallacht tástála Odoo (aon idirbheart amháin in aghaidh gach tástála) ar fáil.

Cur i bhfeidhm teicniúil

Doiciméad	Pointe ceangail
Tairiscint	sale.order.create, nuair atá an t-ainm folamh, / nó New
Ordú custaiméara	sale.order.action_confirm, roimh an ngnáthdheimhniú
Sonrasc, nóta creidmheasa	account.move._set_next_sequence, glaoitear air nuair a chuirtear sa leabhar
Nóta seachadta, glacadh earraí	stock.picking.create de réir an chineáil oibríochta
Ordú ceannaigh	purchase.order.create

• Áiritheoir. Aimsíonn slonn rialta (^<Stamm>([0-9]{1,15})$, tá an Stamm (bonn) maisctha) an uimhir is airde in aghaidh gach cuideachta, ainmneacha gan cuideachta san áireamh.
• Sonraisc. Scríobhann _set_next_sequence an t-ainm agus glaonn sé ar _compute_split_sequence, ionas go bhfanann loighic seicheamh Odoo (réimír, uimhir, aithint bliana don chéad sonrasc eile den iris) comhsheasmhach.
• Socruithe. Léirítear réimsí na cuideachta document_number_* in res.config.settings. Diúltaíonn na socruithe do réimíreacha a bhfuil spás nó digit ag an deireadh iontu.
• Aistriúchán. Tá aistriúchán Gearmáinise san áireamh.

Suiteáil agus socrú

1. Cuir an fillteán document_number_prefix_year i gcosán na dtáthán.
2. Nuashonraigh liosta na n-aipeanna, suiteáil an modúl. Is réamhriachtanais iad Díolacháin, Ceannach, Stoc agus Cuntasaíocht.
3. Faoi Socruithe → Uimhriú doiciméad cuir isteach réimíreacha, formáid bliana agus líon digit.
4. Bain triail as ar chóip ar dtús. Ní féidir uimhir doiciméid a chur ar ais go huathoibríoch ina dhiaidh sin, agus i gcás sonraisc tá dualgas coinneála agus seiceála ceangailte leis an uimhir.

Teorainneacha

• Uimhrítear tairiscintí nuair a chruthaítear iad. Fágann tairiscintí scriosta nó cealaithe bearnaí. Is amhlaidh é do gach ordú custaiméara a chruthaíonn modúl eile: Ciseáin siopadóireachta an siopa gréasáin (website_sale) is orduithe iad i stádas Tairiscint agus úsáideann siad uimhir amháin an ceann. Is sonraisc agus nótaí creidmheasa amháin atá gan bhearna, toisc go n-uimhrítear iad nuair a chuirtear sa leabhar iad.
• Ná hathraigh an fhormáid bliana le linn na hoibríochta. Leis an Stamm AN26 léann an modúl AN2026000001 atá ann cheana mar áiritheoir 26000001. Socraigh an fhormáid roimh an chéad doiciméad.
• Áiritheoir 15 digit ar a mhéad. Déantar sraitheanna digit níos faide tar éis an Stamm a neamhaird agus an uimhir is airde á cuardach.
• Gan sraitheanna ar leith in aghaidh gach iris nó stórais. Is ann don áiritheoir in aghaidh gach cuideachta, réimír agus bliana. Roinneann roinnt irisí díolacháin an t-áiritheoir sonraisc.
• Ní fhéadfaidh spás a bheith i réimíreacha agus ní fhéadfaidh digit a bheith ag a ndeireadh, nó ní féidir réimír, bliain agus áiritheoir a scaradh a thuilleadh.
• Láimhseáiltear na cineálacha doiciméad ainmnithe amháin.

Tástálacha

Tá deich dtástáil uathoibrithe sa mhodúl. Seiceálann siad:

• Tairiscint agus deimhniú: uimhir tairisceana agus ordaithe, coinneáil uimhir na tairisceana
• Leanúint ag comhaireamh tar éis uimhir allmhairithe (AN26119 → AN26000120)
• gan athuimhriú ina dhiaidh sin ar dhoiciméid atá ann cheana
• Sonrasc, nóta creidmheasa agus casadh na bliana de réir dháta an tsonraisc
• Ordú ceannaigh agus nótaí seachadta
• réimír fholamh: fanann gnáthuimhir Odoo
• bliain cheithre dhigit
• Réimír le carachtair speisialta
• roinnt uimhreacha in aon idirbheart amháin
• déantar sraitheanna digit an-fhada a neamhaird

Glao:

odoo-bin -d <Testdatenbank> -i document_number_prefix_year --test-enable --test-tags=/document_number_prefix_year --stop-after-init

Ritheann na tástálacha le gnáthidirbhearta. Níl an t-iompar nuair a chruthaíonn beirt úsáideoirí ag an am céanna ina measc, seiceáladh é de láimh ar chóip bhunachair sonraí mar a thuairiscítear thuas. An té a úsáideann an modúl i gcóras a bhfuil go leor úsáideoirí comhuaineacha ann, ba cheart dó an triail seo a athdhéanamh ar a bhunachar sonraí féin.

Nóta dlíthiúil maidir le huimhir an tsonraisc

Ní mór uimhir leanúnach a bheith ar shonraisc de réir § 11 UStG, a thugtar uair amháin chun an sonrasc a aithint. Uimhríonn an modúl sonraisc nuair a chuirtear sa leabhar iad agus le háiritheoir dá chuid féin in aghaidh gach réimíre agus bliana, rud a oireann leis sin. An gcomhlíonann do shocrú ar leith (roinnt irisí, nótaí creidmheasa le réimír dá gcuid féin, casadh na bliana) ceanglais do chomhairleora cánach, caithfidh tú é sin a shoiléiriú leis. Ní comhairle dlí é an t-alt seo.

Ceisteanna Coitianta

Cén fáth nach ndéantar seichimh Odoo a oiriúnú go simplí?

Do shonraisc is féidir sin tríd an réimír iris. Ach do thairiscintí, orduithe, nótaí seachadta agus orduithe ceannaigh níl aon scéim choiteann réimíre, bliana agus áiritheora le casadh bliana ann, agus ní aithníonn an t-áiritheoir seanuimhreacha allmhairithe. Sin an áit a dtosaíonn an modúl.

An scríobhtar thar uimhriú atá ann cheana?

Ní scríobhtar. Ní thugann an modúl ach uimhreacha nua. Fanann ainmneacha atá stóráilte cheana gan athrú, fiú nuair a mhúchtar é.

Conas a mhúchaim arís é?

Folmhaigh réimír an chineáil doiciméid. Ansin uimhríonn Odoo é arís é féin. Ní athraíonn díshuiteáil uimhreacha tugtha ach an oiread.

An úsáideann sibh féin é?

Ní úsáidimid. Ritheann gnáthuimhreacha Odoo ar ár gcóras. Sheiceáil muid an modúl leis na tástálacha uathoibrithe agus an triail láimhe a thuairiscítear, ach ní in oibríocht bheo le go leor úsáideoirí.

An ritheann sé le Odoo 17 nó 18?

Níor thástáil muid é ach le Odoo 19.0 Community. I gcás leaganacha eile, d'fhéadfadh sé oiriúnú nó gan oiriúnú, níor sheiceáil muid é.

Faoi cén cheadúnas atá sé?

Faoi LGPL-3. Tá fáilte roimh earráidí agus feabhsúcháin mar issue sa stórlann GitHub a fháil.

Tacaíocht ó Biricon IT Services

Cothaímid suiteálacha Odoo do ghnólachtaí beaga agus meánmhéide: ón tabhairt isteach trí oiriúnuithe agus aistrithe go dtí an oibríocht leanúnach. Más mian leat do chuid uimhreacha doiciméad a chaomhnú le linn aistrithe, an leithdháileadh uimhreacha a sheiceáil faoi ualach nó modúl mar seo a thabhairt go sábháilte isteach i do thimpeallacht tháirgthe, cuirfimid lámh chabhrach leat le pléisiúr. Forbairtí eile dár gcuid féin: Firmenbuch agus seiceáil seoltaí do chustaiméirí Ostaracha, Tacair táirgí sa tairiscint mar rannán agus Web RBL, an liosta bloctha do thrácht ionsaithe.

Téigh i dteagmháil linn anois

Staid ar an 3 Samhain 2026. Leagan modúil 19.0.1.0.0. Tá na huimhreacha go léir sna samplaí agus sna figiúirí roghnaithe go saor.