“AN26000001” ji “S00001” bêtir dibêje: Ew pêşniyarek e, ji 2026 tê, û ew a yekem e. Gelek şirket, bi taybetî yên ku ji pergaleke kevn derbasî Odoo dibin, dixwazin hejmarên belgeyên xwe tam bi vî rengî bihêlin. Odoo bi xwe pêşniyar, ferman û nameyên radestkirinê bi rêzeyên xwe (S00001, WH/OUT/00001, P00001) û fatûreyan bi pêşgira jurnalê û salê (INV/2026/00001) hejmar dike.
Me ji bo vê modûla Document Numbering by Prefix and Year (document_number_prefix_year) ji bo Odoo 19 nivîsand. Ew wekî nermalava azad di bin lîsansa LGPL-3 de li GitHub heye:
github.com/Alex0176/odoo-document-number-prefix-year
Pêşî nirxandineke rast: Em modûlê li Biricon IT Services bi kar naynin. Em wê diweşînin ji ber ku temam e, bi belgekirin e û bi test hatiye pêşkêş kirin, û dikare ji yên din re xebatê biparêze. Kesê ku wê bi kar tîne, divê beşên derbarê Sînoran û Test bixwîne.
Şemaya hejmaran
Her hejmar ji sê beşan pêk tê: pêşgirek ji bo her cureya belgeyê, sal û jimarvanek bi hejmareke sabît a reqeman. Pêşgir, formata salê (26 an 2026) û hejmara reqeman hûn ji bo her şirketê di bin Mîheng → Hejmarkirina belgeyan de saz dikin.
Pêşniyar, fermanên xerîdaran, fatûreyên xerîdaran û nameyên krediyê, nameyên radestkirinê, wergirtinên mal û fermanên kirînê têne birêvebirin. Pêşgirên di wêneyê de tenê nimûne ne: AN, AU, RE, GU, LI, WE, BE. Kesê ku pêşgirekê vala bihêle, ji bo wê cureya belgeyê hejmarkirina standard a Odoo diparêze. Ji ber vê yekê modûl ti tişt nake heya ku hûn wê mîheng nekin.
Hejmar çawa tevdigerin
- Her sal ji nû ve. Jimarvan bi guhertina salê dîsa ji 1 dest pê dike.
- Piştî hejmarên importkirî berdewam dike. Modûl hejmara herî bilind a heyî ya heman pêşgir û salê dibîne, çi dirêj be çi nebe. Heke ji pergala kevn
AN26119di databaseyê de be, pêşniyara piştî wêAN26000120e. Sedema ku modûl ji bo derbasbûnê hêja ye ev e: Belgeyên kevn bi hejmarên xwe yên eslî têne import kirin, û belgeyên nû bêyî qelş lê girêdidin. - Hejmara fermanê ya nû dema erêkirinê. Pêşniyareke erêkirî, heke bê xwestin, hejmarekê ji rêzeya fermanan distîne. Hejmara pêşniyarê di qada Hejmara pêşniyarê ya li ser fermanê de dimîne û di form, lîste û lêgerînê de tê dîtin.
- Fatûre dema tomarkirinê. Fatûreyên xerîdaran û nameyên krediyê hejmara xwe tenê dema tomarkirinê distînin, ne dema afirandinê. Pêşnivîsên jêbirî ji ber vê yekê qelşekê nahêlin. Sal ji dîroka fatûreyê tê: Fatûreyek ji 30.12.2025, ku di 2.1.2026 de tê tomarkirin,
RE25…tê gotin. - Her tiştê din dimîne. Fatûreyên dabînkaran, dayîn, tomarên hesabê û fermanên hilberînê rêzeyên standard ên Odoo diparêzin. Navên heyî qet ji nû ve nayên nivîsandin, tewra ku hûn modûlê dîsa vegirin jî.
Beşa hesas: Du bikarhêner di heman demê de
Hejmarkirineke xwe hêsan xuya dike: hejmara herî bilind bibîne, yekê lê zêde bike. Dema du bikarhêner di heman kêliyê de pêşniyarekê diafirînin ew ne hêsan e. Herdu “hejmara herî bilind = 0” dixwînin, herdu AN26000001 didin. Odoo ji bo rêzeyên xwe sequence yên databaseyê heye. Di hejmareke xwe-avakirî de ev kêm e, û ji bo pêşniyar û fermanên kirînê di Odoo de herwiha kontrola yekanetiyê li ser navê tune: Du belgeyên bi heman hejmarê bi hêsanî têne tomarkirin.
Parastina herî nêzîk qefl e. Modûl ji bo her şirket, pêşgir û salê qeflekê databaseyê (PostgreSQL Advisory Lock) digire, ku heya dawiya danûstandinê dimîne. Bikarhênerê duyem li bendê dimîne heya ku yê yekem biqede. Lê ev bes nîne, û me ew bi ceribandineke li ser kopiyeke databaseya berhemdar dît:
Odoo bi asta îzolasyonê REPEATABLE READ dixebite. Rewşa databaseyê ya ku danûstandinek dibîne di pirsa yekem de tê qeşandin. Bikarhêner B vê rewşê berê heye, berî ku A biqede. Heke B piştre li benda qeflê bimîne û wê bistîne, ew bi rewşa xwe ya kevn “hejmara herî bilind = 0” dixwîne û hejmarê cara duyem dide. Qefl rêzê rêk xist, lê zanîn nû nekir.
Çareserî xwendineke duyem bi riya gihîştineke databaseyê ya xwe ya kurt-dem e, ku hemû rêzên jixwe erêkirî dibîne. Nirxa mezintir ji herdu serdikeve. Xwendina yekem hê pêwîst e, ji ber ku tenê ew hejmarên ku heman danûstandin berê daye lê hê erê nekiriye dizane, mînak di importa çend belgeyan de bi carekê.
Me ev bi du danûstandinan kontrol kir, ku di wan de ya duyem bi delîl berî commit a ya yekem rewşa xwe girtiye û paşê li benda qeflê maye. Bêyî xwendina duyem herdu ferman heman hejmar girtin, bi wê re hejmarên 1 û 2.
Girîng ji bo nirxandinê: Ev ceribandin kontrolek bi destan e. Ew beşek ji testên otomatîk nîne, ji ber ku ji bo wê du girêdanên databaseyê yên rastîn pêwîst in, ku jîngeha testê ya Odoo (ji bo her testê danûstandineke yekane) peyda nake.
Pêkanîna teknîkî
| Belge | Xala girêdanê |
|---|---|
| Pêşniyar | sale.order.create, gava nav vala, / an New be |
| Fermana xerîdar | sale.order.action_confirm, berî erêkirina standard |
| Fatûre, name ya krediyê | account.move._set_next_sequence, dema tomarkirinê tê gazîkirin |
| Name ya radestkirinê, wergirtina mal | stock.picking.create li gorî cureya operasyonê |
| Fermana kirînê | purchase.order.create |
- Jimarvan. Hejmara herî bilind ji aliyê îfadeyeke birêkûpêk ve tê dîtin (
^<Stamm>([0-9]{1,15})$, stam tê maskekirin) ji bo her şirketê, navên bêyî şirket jî tê de. - Fatûre.
_set_next_sequencenavê dinivîse û_compute_split_sequencegazî dike, da ku mantiqa rêzeyê ya Odoo (pêşgir, hejmar, naskirina salê ji bo fatûreya paşîn a jurnalê) lihevhatî bimîne. - Mîheng. Qadên şirketê
document_number_*dires.config.settingsde têne neynikkirin. Mîheng pêşgirên bi valahî an bi reqemek di dawiyê de red dikin. - Wergera. Wergera almanî tê de ye.
Sazkirin û mîhengkirin
- Peldanka
document_number_prefix_yeartêxin riya addons. - Lîsteya sepanan nû bikin, modûlê saz bikin. Pêşmercên Firotin, Kirîn, Embar û Hesabdarî ne.
- Di bin Mîheng → Hejmarkirina belgeyan de pêşgir, formata salê û hejmara reqeman têkevin.
- Pêşî li ser kopiyekê biceribînin. Hejmara belgeyekê paşê bixweber nayê vegerandin, û di fatûreyan de erkê parastin û kontrolê bi hejmarê ve girêdayî ye.
Sînoran
- Pêşniyar dema afirandinê têne hejmarkirin. Pêşniyarên jêbirî an betalkirî qelş dihêlin. Heman tişt ji bo her fermana xerîdar ku modûleke din diafirîne derbasdar e: selikên kirînê yên webshop (
website_sale) ferman in di rewşa Pêşniyar de û her yek hejmarekê bikar tîne. Tenê fatûre û nameyên krediyê bê qelş in, ji ber ku dema tomarkirinê têne hejmarkirin. - Formata salê di xebata domdar de neguherînin. Bi stama
AN26modûlAN2026000001a heyî wekî jimarvana26000001dixwîne. Formatê berî belgeya yekem diyar bikin. - Jimarvan herî zêde 15 reqem. Rêzeyên reqeman ên dirêjtir piştî stamê di lêgerîna hejmara herî bilind de têne paşguh kirin.
- Rêzeyên cuda ji bo her jurnal an embarê tune. Jimarvan ji bo her şirket, pêşgir û salê derbasdar e. Çend jurnalên firotinê jimarvana fatûreyê parve dikin.
- Pêşgir nabe ku valahî tê de hebe û nabe ku bi reqemekî biqede, wekî din pêşgir, sal û jimarvan êdî nayên ji hev veqetandin.
- Tenê cureyên belgeyan ên navkirî têne birêvebirin.
Test
Modûl deh testên otomatîk tîne. Ew kontrol dikin:
- Pêşniyar û erêkirin: hejmara pêşniyar û fermanê, parastina hejmara pêşniyarê
- Berdewamkirina jimartinê piştî hejmareke importkirî (
AN26119→AN26000120) - hejmarkirina dubare ya belgeyên heyî nayê kirin
- Fatûre, name ya krediyê û guhertina salê li gorî dîroka fatûreyê
- Fermana kirînê û nameyên radestkirinê
- pêşgira vala: hejmara standard a Odoo dimîne
- salê çar-reqemî
- pêşgir bi tîpên taybet
- çend hejmar di yek danûstandinê de
- rêzeyên reqeman ên pir dirêj têne paşguh kirin
Bangkirin:
odoo-bin -d <Testdatenbank> -i document_number_prefix_year --test-enable --test-tags=/document_number_prefix_year --stop-after-initTest bi danûstandinên asayî dimeşin. Tevgera di afirandina hevdemî ya ji aliyê du bikarhêneran de ne beşek ji wan e, ew wekî li jor hatiye vegotin bi destan li ser kopiyeke databaseyê hatiye kontrolkirin. Kesê ku modûlê di pergaleke bi gelek bikarhênerên hevdemî de bi kar tîne, divê vê ceribandinê li ser databaseya xwe dubare bike.
Nîşeya hiqûqî derbarê hejmara fatûreyê
Fatûre li gorî § 11 UStG divê hejmareke pêşketî hilgirin, ku ji bo naskirina fatûreyê carekê tê dayîn. Modûl fatûreyan dema tomarkirinê û bi jimarvana xwe ji bo her pêşgir û salê hejmar dike, ku bi vê re li hev tê. Gelo mîhenga we ya taybet (çend jurnal, nameyên krediyê bi pêşgira xwe, guhertina salê) daxwazên şêwirmendê weyê bacê pêk tîne, divê hûn bi wî re zelal bikin. Ev nivîs şêwirmendiya hiqûqî nîne.
Pirsên pir tên pirsîn
Çima tenê rêzeyên Odoo neguherînin?
Ji bo fatûreyan ev bi riya pêşgira jurnalê dibe. Lê ji bo pêşniyar, ferman, nameyên radestkirinê û fermanên kirînê şemayeke hevpar ji pêşgir, sal û jimarvan bi guhertina salê tune, û jimarvan hejmarên kevn ên importkirî nas nake. Modûl li wir dest pê dike.
Gelo hejmarkirina heyî li ser tê nivîsandin?
Na. Modûl tenê hejmarên nû dide. Navên berê tomarkirî neguhertî dimînin, di vegirtinê de jî.
Ez wê çawa dîsa vedigirim?
Pêşgira cureya belgeyê vala bikin. Wê demê Odoo dîsa bi xwe wê hejmar dike. Jêbirina sazkirinê jî hejmarên dayî nagûherîne.
Gelo hûn bi xwe wê bi kar tînin?
Na. Li cem me hejmarên standard ên Odoo dixebitin. Me modûl bi testên otomatîk û ceribandina destan a vegotî kontrol kir, lê ne di xebateke domdar de bi gelek bikarhêneran.
Gelo bi Odoo 17 an 18 dixebite?
Me ew tenê bi Odoo 19.0 Community testkiriye. Ji bo guhertoyên din dibe ku li hev bê an na, me kontrol nekiriye.
Di bin kîjan lîsansê de ye?
Di bin LGPL-3 de. Çewtî û başkirin wekî Issue li depoya GitHub bi xêr hatine.
Piştgirî ji Biricon IT Services
Em sazkirinên Odoo ji bo karsaziyên biçûk û navîn digirin ser xwe: ji destpêkirinê, adaptasyon û koçberiyan heya xebata domdar. Heke hûn dixwazin di derbasbûnê de hejmarên belgeyên xwe biparêzin, hejmarkirinê di bin bar de bidin kontrolkirin an jî modûleke mîna vê bi ewlehî têxin nimûneya xwe ya berhemdar, em bi dilxweşî alîkarî dikin. Pêşxistinên din ên xwe: Firmenbuch û kontrolkirina navnîşanan ji bo xerîdarên Avusturyayî, Setên hilberan di pêşniyarê de wekî beş û Web RBL, lîsteya astengkirinê ji bo trafîka êrîşê.
Rewş: 3ê mijdara 2026. Guhertoya modûlê 19.0.1.0.0. Hemû hejmarên di nimûne û wêneyan de bi azadî hatine hilbijartin.