Odoo 19 Community: یەکخستنی ڕەشنووسی پسووڵەکان – مۆدیولی سەرچاوەکراوەی ئێمە Merge Draft Invoices

هەر کەسێک لە Odoo بە پشتبەستن بە داواکارییەکان، تیکەتەکانی پشتیوانی و تۆمارکردنی کات پسووڵە دەردەکات، ئەنجامەکە دەناسێت: لە کۆتایی مانگدا کڕیار بە جێی یەک پسووڵە، پێنج پسووڵە وەردەگرێت. هەر یەکەیان لە داواکارییەک یان تیکەتێکی جیاوازەوە هاتووە و هەموویان لە ڕووی کارەکەوە دروستن؛ بەڵام کڕیار هەر دەپرسێت ئایا ناکرێت هەموویان لە یەک بەڵگەدا بن.

لە Odoo 19 Community چارەسەرێکی گونجاو بۆ ئەم کێشەیە نییە. مۆدیولی ناسراوی OCA بە ناوی account_invoice_merge هێشتا بۆ Odoo 19 بڵاو نەکراوەتەوە، هەروەها کێشەکە بە شێوەیەک چارەسەر دەکات کە بۆ دابینکەرانی خزمەتگوزاری مەترسییەکی جدییە: ڕیزە هاوشێوەکان پێکەوە کۆ دەکرێنەوە و لە ئەنجامدا پەیوەندییان بە داواکاری، ئەرک و کاتی تۆمارکراوەوە لەدەست دەچێت.

بۆیە بۆ سیستەمی Odoo 19 Communityی خۆمان مۆدیولی Merge Draft Invoicesمان پەرەپێدا. چونکە ئەم کێشەیە تەنها هی ئێمە نییە، بەخۆڕایی و بە مۆڵەتنامەی ئازادی AGPL-3 لە GitHub بەردەستی دەخەین.

بۆ پڕۆژەکە لە GitHub:

Odoo 19 Merge Draft Invoices

بۆچی مۆدیولێکی تایبەت بە خۆمان لە جیاتی چارەسەری OCA؟

OCA ماوەیەکی زۆرە لە کۆگای OCA/account-invoicing چاودێری account_invoice_merge دەکات. تا کاتی نووسینی ئەم بابەتە، گواستنەوەی بۆ 19.0 هێشتا داواکارییەکی کراوەی تێکەڵکردنی کۆدە و وەک مۆدیول بڵاو نەکراوەتەوە.

بەڵام گرنگتر ئەوەیە کە ئەم دوو مۆدیولە کاری جیاواز دەکەن:

کۆکردنەوەی ڕیزە هاوشێوەکان جیاوازییە سەرەکییەکەیە. ڕیزێکی کۆکراوە تەنها دەتوانێت یەک سەرچاوەی هەبێت. هەرکات دوو ڕیز لە دوو داواکاریی جیاوازەوە هاوشێوە بن، پەیوەندیی نێوان پسووڵە و داواکاری، ئەرک و تۆماری کات لەدەست دەچێت. لە کۆمپانیایەکی خزمەتگوزاریدا کە پسووڵەکردن بە ڕێڕەوی تیکەت → تۆمارکردنی کات → پسووڵە ئەنجام دەدرێت، ئەمە واتە هەمان کاتژمێرەکان دوو جار دەخرێنە سەر حساب یان ون دەبن.

بۆیە مۆدیولەکەمان بە بنەڕەت هیچ ڕیزێک لەگەڵ یەکێکی تر کۆ ناکاتەوە. ژمارەی ڕیزەکانی پسووڵە یەکخراوەکە تەواو یەکسانە بە کۆی ڕیزەکانی سەرچاوەکانی.

هیچ کۆدێک لە مۆدیولی OCA وەرنەگیراوە. هەردوو مۆدیولەکە بە مۆڵەتنامەی AGPL-3 بەردەستن.

مۆدیولەکە چی دەکات

لە دیمەنی لیستی پسوولەکان دوو یان زیاتر ڕەشنووس نیشانە بکە، لە مینیوی کردارەکان یەکخستنی پسوولە ڕەشنووسەکان هەڵبژێرە – یاریدەدەرێک هەڵبژاردن و پشکنینەکان و هەڵبژاردنەکانی پسوولە سەرچاوەکان نیشان دەدات. دوای پشتڕاستکردنەوە ڕاستەوخۆ دەچیتە سەر پسوولە نوێیەکە.

پێش یەکخستن، مۆدیولەکە هەموو ئەم خاڵانە بە یەکجار دەپشکنێت، بۆ ئەوەی دوای چارەسەرکردنی هەر هەڵەیەک، تازە هەڵەی دواتر دەرنەکەوێت:

• لانیکەم دوو پسووڵە هەڵبژێردرابن
• هەموویان لە دۆخی ڕەشنووسدا بن
• هیچیان پێشتر لە ژمێریاریدا تۆمار نەکرابێت (بەڵگەیەک کە بۆ دۆخی ڕەشنووس گەڕێندراوەتەوە، مێژووی تۆمارکردنەکەی دەپارێزێت و ڕەت دەکرێتەوە)
• هیچیان پێشتر یەک نەخرابێت
• هەموویان پسووڵە، پسووڵەی دابینکەر، بەڵگەی کەمکردنەوەی قەرز یان وەسڵ بن؛ تەنها تۆماری ژمێریاری نەبن
• لایەنی مامەڵە، جۆری بەڵگە، کۆمپانیا، دراو و ڕۆژنامەی ژمێریارییان یەکسان بێت

جیاوازی لە مەرجی پارەدان، ڕێکخستنی باج، ناونیشانی گەیاندن، هەژماری بانکی یان فرۆشیار ڕێگری ناکات. ڕێنیشاندەرەکە ئاگاداری دەدات و بەهای کۆنترین پسووڵەی هەڵبژێردراو وەردەگرێت.

چی دەپارێزرێت

بنەمای مۆدیولەکە ئەوەیە کە هەر پەیوەندییەکی ڕیزی پسووڵە بە سەرچاوەکەیەوە هەیە، لە پسووڵە نوێیەکەشدا بمێنێتەوە:

ڕیزەکانی باج، مەرجەکانی پارەدان، خڕکردنەوە و داشکاندنی پارەدانی پێشوەخت کۆپی ناکرێن؛ Odoo لەسەر بنەمای ناوەڕۆکەکە دووبارە هەژماریان دەکاتەوە. کەواتە پسووڵە یەکخراوەکە بۆ هەر ڕێژەیەکی باج یەک ڕیزی باجی هەیە، نەک بۆ هەر سەرچاوەیەک. پسووڵەکە بەبێ ژمارە و وەک ڕەشنووس دروست دەکرێت؛ خودی یەکخستن هیچ ژمارەیەکی بەڵگە بەکار ناهێنێت.

سەردێڕەکان: کڕیار دەبینێت هەر ڕیزێک لە کوێوە هاتووە

ئەم تایبەتمەندییە لە کاری ڕۆژانەدا جیاوازی دروست دەکات. مۆدیولەکە لە سەرووی ڕیزەکانی هەر پسووڵەیەکی سەرچاوەدا ڕیزێکی بەش زیاد دەکات؛ هەمان توخم کە خودی Odoo بۆ بەشی «پێشەکییەکان» بەکاری دەهێنێت:

BE10181                                     <- سەردێڕ
  22,500 x کاتژمێری تەکنیککار        3.577,50
                    کۆی بەش 3.577,50
BE10182 · تیکەت: HT00219                   <- سەردێڕ
   3,000 x کاتژمێری تەکنیککار          477,00
                    کۆی بەش   477,00
                      بڕی پوختە 4.054,50

سەردێڕەکە لەسەر ئەو بەڵگەیە چاپ دەکرێت کە کڕیار وەریدەگرێت، و ڕاپۆرتی ستانداردی پسووڵەی Odoo خۆی کۆی هەر بەشێک زیاد دەکات. بەمەش کڕیار دەبینێت تێچووی هەر بەشێک چەند بووە.

ناونیشانەکە لەو زانیارییانە پێک دەهێنرێت کە بەڕاستی لە سەرچاوەکەدا هەن:

1. داواکارییەکان، ڕاستەوخۆ لە بەستەرەکانی ڕیزەکانەوە؛ بەمەش ناوەکان تەواو وردن. ئەگەر بەستەری داواکاری نەبێت، دەقی ئازادی invoice_origin بەکار دەهێنرێت
2. تیکەتەکان، لە ڕێگەی تۆمارکردنی کاتەوە دەدۆزرێنەوە و بە شێوەی تیکەت: HT00219 یان تیکەتەکان: … نیشان دەدرێن؛ تا پێنج دانە، لەگەڵ «و N دانەی تر»
3. ئەگەر هیچکامیان نەبێت: ژمارەی پسووڵەی سەرچاوە، پاشان ئاماژەکەی
4. ئەگەر هیچ زانیارییەک نەبێت: ناونیشانی گشتیی «ڕیزی زیاتر»، بۆ ئەوەی ڕیزەکانی سەرچاوەیەک بێ هیچ نیشانەیەک لە بەشی سەرەوەدا تێکەڵ نەبن

ئەوەی نییە، وەلا دەنرێت و لەخۆوە دروست ناکرێت. تیکەتەکە بە ژمارەی خۆی چاپ دەکرێت؛ ژمارەی helpdesk_mgmt، ticket_refی Enterprise یان ناوی پیشاندانی مۆدێلەکە، هەرگیز بە ناسنامەی بنکەدراوەکە چاپ ناکرێت.

سەردێڕەکان بە زمانی کڕیار دەنووسرێن، هەروەک Odoo لە دروستکردنی پسووڵە لە داواکارییەکاندا دەیکات. Chatter بە زمانی بەکارهێنەر دەمێنێتەوە.

سەردێڕ هیچ بەرهەم، بڕ، نرخ، باج، هەژمار یان دابەشکردنی ناوەندەکانی تێچووی تێدا نییە. ناتوانێت کاریگەری لەسەر کۆی بڕەکان، بنەمای باج یان ژمێریاریی تێچوو هەبێت. ئەگەر سەردێڕەکان لە ڕێنیشاندەرەکەدا ناچالاک بکرێن، تەواو هەمان پسووڵە بەدەست دێت کە بەبێ ئەم تایبەتمەندییە دروست دەبوو؛ تاقیکردنەوەیەک هەردوو ئەنجامەکە تا ئاستی سەنت بەراورد دەکات.

چی بەسەر پسووڵە سەرچاوەکاندا دێت

ڕێنیشاندەرەکە سێ هەڵبژاردە پێشکەش دەکات:

• هەڵوەشاندنەوە (بنەڕەتی، پێشنیارکراو). هەڵوەشاندنەوەی ڕەشنووس هیچ کاریگەرییەکی ژمێریاری نییە: نە ژمارەی بەڵگە هەیە، نە تۆماری ژمێریاری. پسووڵەکان وەک بەڵگەی هەڵوەشاوە لەگەڵ Chatter و بەستەری پسووڵە نوێیەکە لە بنکەدراوەدا دەمێننەوە. qty_invoiced لە داواکاریی فرۆشتندا بەڵگە هەڵوەشاوەکان پشتگوێ دەخات و هیچ شتێک دوو جار ناژمێردرێت. ئەم هەڵبژاردەیە تەنانەت شەش مانگیش دواتر هەر ئاسانە بەدواداچوونی بۆ بکرێت.
• سڕینەوە. گەڕانەوەی نییە. Chatter و ئاماژەی گەڕانەوە لەگەڵ تۆمارەکە دەمرن؛ تەنیا پەیامەکەی سەر پسوولە نوێیەکە دەمێنێت. بەسوودە بۆ ڕەشنووسە فڕێدراوەکان کە کەس نایەوێت جارێکی تر ببینێت.
• هێشتنەوە وەک ڕەشنووس. سەرچاوەکان بە کراوەیی دەمێننەوە. لەم دۆخەدا داواکارییەکانی فرۆشتنیان سەرچاوە و پسووڵە نوێیەکە بە پسووڵەکراو دادەنێن؛ کارەکە وەک ئەوە دەردەکەوێت دوو جار حساب کرابێت، تا کەسێک بە دەست ڕەشنووسەکان ڕێک بخاتەوە. ئەمە بۆ ئەو حاڵەتە دەگمەنەیە کە پێش بڕیاردان دەتەوێت بەراورد بکەیت. تاقیکردنەوەیەک بە وردی ئەم دووجار ژماردنە تۆمار دەکات، بۆ ئەوەی کەس پێی سەرسام نەبێت.

سنوورەکان – ئەو کارانەی مۆدیولەکە بە ئەنقەست ئەنجامیان نادات

تکایە پێش بەکارهێنان لە سیستەمی کاری ڕاستەقینەدا بیخوێننەوە:

• تەنها ڕەشنووسەکان. پسووڵە تۆمارکراوەکانی ژمێریاری یەک ناخرێن. ئەمە پێویستی بە بەڵگەی گەڕاندنەوەی بڕ هەیە، پرۆسەی کۆپیکردن نییە.
• ئەو ڕەشنووسانە ڕەت دەکرێنەوە کە پێشتر تۆماری ژمێریارییان بۆ کراوە و دواتر گەڕێندراونەتەوە. ئەوان ژمارە و مێژووی تۆمارکردنیان هەیە؛ شاردنەوەی ئەمانە لە بەڵگەیەکی تردا نابێت بە کردارێکی بەکۆمەڵ و بێ ئاگادارکردنەوە ئەنجام بدرێت.
• یەکخستن لە نێوان لایەنەکانی مامەڵە، دراو، کۆمپانیا یان ڕۆژنامە جیاوازەکاندا ناکرێت. بۆ ئەمانە هیچ بەهایەکی تاکی گونجاو نییە؛ بۆیە مۆدیولەکە لە جیاتی خەمڵاندن ڕەتی دەکاتەوە.
• payment_reference ناگوازرێتەوە. ئاماژە ڕێکخراوەکانی پارەدان بەڵگەیەک دەناسێننەوە؛ پێکەوەنووسینی دوو دانەیان لە بانکدا لەگەڵ هیچ تۆمارێک ناگونجێت. پسووڵە نوێیەکە لە کاتی تۆمارکردنی ژمێریاریدا ئاماژەی تایبەت بە خۆی وەردەگرێت.
• ڕیزەکانی پێشەکی وەک هەر ڕیزێکی تر کۆپی دەکرێن. ئەگەر سەرچاوەکان ڕیزی پێشەکیی مۆدیولی saleیان تێدا بێت، پێویستە ئەنجامەکە پێش تۆمارکردنی ژمێریاری بپشکنرێت.
• تەنها timesheet_invoice_id بە شێوەی خۆکار دووبارە دەبەسترێتەوە. هەر مۆدێلێکی تر کە بە Many2one بە account.move بەستراوەتەوە (خولە تایبەتەکانی پسووڵەکردن، بەستەرەکانی بەشداری، ناردنەکانی EDI)، هەر ئاماژە بە سەرچاوەکە دەکات. بۆ ئەمە هووکی _merge_draft_relink هەیە.
• ڕیزە هاوشێوەکان کۆ ناکرێنەوە؛ بە ئەنقەست. ئەگەر پسووڵەیەکی کورت و پوخت دەوێت، ئەم مۆدیولە بۆت گونجاو نییە، چونکە ئەو کارە بە بهای لەدەستدانی بەستەرەکانی سەرچاوە تەواو دەبێت.
• سەردێڕەکان تەنها یەک جار، لە کاتی یەکخستندا دروست دەکرێن. دواتر ڕیزی ئاسایی بەشن: دەکرێت دەستکاری یان بسڕدرێنەوە، و ئەگەر دواتر ناوی داواکاری یان تیکەت بگۆڕدرێت، نوێ ناکرێنەوە.
• سەردێڕێک تیکەتەکانی تەواوی پسووڵەی سەرچاوە ناو دەبات، نەک تیکەتەکانی هەر ڕیزێک بە جیا.

دامەزراندن لە Odoo 19 Community

دامەزراندنەکە وەک هەر مۆدیولێکی زیادەی ئاسایی Odoo ئەنجام دەدرێت:

1. بوخچەی مۆدیولەکە بۆ یەکێک لە ڕێڕەوە ڕێکخراوەکانی Addons کۆپی بکەن.
2. لیستی ئەپەکان لە Odoo نوێ بکەنەوە.
3. مۆدیولی account_invoice_merge_draft دابمەزرێنن.

مۆدیولەکە تەنها پشت بە account دەبەستێت. هەموو ئەو زانیارییانەی سەبارەت بە sale، purchase، project، hr_timesheet، sale_timesheet یان مۆدیولێکی پشتیوانی پێویستی پێیە، لە کاتی کارکردندا دەدۆزرێنەوە؛ بۆیە لە بنکەدراوەیەکی تایبەت بە پسووڵەکردنیشدا دادەمەزرێت و کار دەکات.

پاشان: ژمێریاری → کڕیاران → پسووڵەکان (یان دابینکەران → پسووڵەکان)، دوو یان زیاتر ڕەشنووس هەڵبژێرن، لیستی ئایکۆنی چەرخەدەنە → یەکخستنی ڕەشنووسی پسووڵەکان. ئەم کردارە بۆ هەموو بەکارهێنەرانی گرووپی حسابکردن / پسووڵەکردن بەردەستە.

ئەوانەی لە وەشانێکی پێشووی مۆدیولەکەوە نوێ دەکەنەوە، پێویستە یەک جار بە -u account_invoice_merge_draft --i18n-overwrite نوێکردنەوەکە ئەنجام بدەن، بۆ ئەوەی ناونیشانی گۆڕدراوی خانەکان لە وەرگێڕانی ئەڵمانییشدا نوێ بکرێنەوە. دامەزراندنی نوێ پێویستی بە ئەم هەنگاوە نییە.

بۆ پەرەپێدەران: API و هووکەکان

دەکرێت یەکخستن لە کۆدی تایبەت بە خۆشتانەوە بانگ بکرێت:

python

merged = draft_moves.merge_draft_moves(
    extra_vals={"invoice_date": date(2026, 3, 31), "ref": "Q1"},
    source_handling="cancel",   # "delete" یان "keep"
    add_source_sections=True,   # ناونیشانەکان; ستاندارد True
)

ئەگەر هەڵبژێردراوەکان شیاوی یەکخستن نەبن، merge_draft_moves هەڵەیەکی UserError لەگەڵ هەموو هۆکارەکانی ڕەتکردنەوە دروست دەکات. _merge_draft_get_errors() هەمان هۆکارەکان بە شێوەی لیست و بەبێ Exception دەگەڕێنێتەوە.

ئەگەر بەستەری گەڕانەوەی تایبەت بە خۆتان بۆ account.move هەیە، _merge_draft_relink دووبارە پێناسە بکەن:

python

class AccountMove(models.Model):
    _inherit = "account.move"

    def _merge_draft_relink(self, new_move):
        super()._merge_draft_relink(new_move)
        if "my_move_id" not in self.env["my.model"]._fields:
            return
        self.env["my.model"].search([("my_move_id", "in", self.ids)]).write(
            {"my_move_id": new_move.id}
        )

ئەگەر بەستەری گەڕانەوەتان لەسەر ڕیزی پسووڵەکە هەیە، هەر پێویستتان بە ئەم مۆدیولە نییە: هووکی تایبەتی Odoo بە ناوی account.move.line._copy_data_extend_business_fields بەسە، و خانەکە لە یەکخستن، هەڵوەشاندنەوە و دووبارەکردنەوەدا بە هەمان شێوە دەگوازرێتەوە. بۆ مۆدیولەکانی تری پشتیوانی یان دەربڕینێکی جیاوازی سەردێڕەکان، _merge_draft_get_source_tickets() و _merge_draft_section_name() هەن.

پێش بەکارهێنان لەسەر داتای کاری ڕاستەقینە تاقی کراوەتەوە

48 تاقیکردنەوە ئەمانە دەگرنەوە: دۆخە تێکەڵەکان؛ لایەنە جیاوازەکانی مامەڵە، دراو و جۆری بەڵگە؛ ڕیزەکان لەگەڵ یان بەبێ داواکاریی فرۆشتن یان کڕین؛ باج، بەش و تێبینییەکان؛ دابەشکردنی ناوەندەکانی تێچوو؛ دووبارەبەستنەوەی تۆمارەکانی کات؛ هەر سێ هەڵبژاردەکەی پسووڵە سەرچاوەکان؛ ڕێنیشاندەرەکە و سەردێڕەکان. هەروەها ئەوە دەپشکنن کە سەردێڕەکان بە بنەڕەت چالاکن، ناچالاککردنیان ئەنجامی پێشوو تا ئاستی سەنت دووبارە دروست دەکاتەوە، سەردێڕ هیچ بڕ یان هەژمارێکی تێدا نییە، ڕیزەکانی هەر سەرچاوەیەک پێکەوە دەمێننەوە، و تیکەتەکە بە ژمارەی خۆی دەردەکەوێت و هەرگیز بە ناسنامەی بنکەدراوە نیشان نادرێت.

داتای تاقیکردنەوە لەسەر بنەمای پلانی هەژمارە هەبووەکەی کۆمپانیای چالاک دروست دەکرێت، لە جیاتی AccountTestInvoicingCommon؛ ئەم یارمەتیدەرە زۆرجار لە بنکەدراوە گوازراوەکانی سیستەمی کاری ڕاستەقینەدا دەست پێ ناکات، لە کاتێکدا مۆدیولەکە دەبێت بە تایبەتی لەسەر هەمان ئەو بنکەدراوانە کار بکات.

odoo-bin -d <db> -u account_invoice_merge_draft --test-enable \
         --test-tags /account_invoice_merge_draft --stop-after-init

وەک هەر زیادکراوێکی بواری ژمێریاری، پێشنیار دەکەین سەرەتا دامەزراندنەکە لە ژینگەیەکی تاقیکردنەوەدا بە کۆپییەک لە بنکەدراوەی خۆتان بپشکنن.

بەخۆڕایی و سەرچاوەکراوە بۆ کۆمەڵگەی Odoo

ئێمە لە Biricon IT Services GmbH سەرەتا چارەسەرەکان بۆ پێداویستییە دیاریکراوەکانی کاری خۆمان پەرەپێدەدەین. ئەگەر لێی مۆدیولێک دروست بێت کە بە گشتی بەکار دێت، نامانەوێت تەنها لە یەک سیستەمدا بیشارینەوە.

بۆیە Merge Draft Invoices وەک پڕۆژەیەکی سەرچاوەکراوە بەخۆڕایی بەردەستە. دەکرێت کۆدی سەرچاوەکە ببینرێت، بپشکنرێت، بگونجێنرێت و لە چوارچێوەی مۆڵەتنامەی AGPL-3دا زیاتر پەرەی پێ بدرێت.

ئامانجمان دروستکردنی کورتترین پسووڵە نەبوو؛ بەڵکو پسووڵەیەک بوو کە تەنانەت ساڵێکیش دواتر هێشتا بتوانرێت هەر ڕیزێکی بگەڕێندرێتەوە بۆ داواکاری، تیکەت و تۆماری کاتەکەی.

پڕۆژە، کۆدی سەرچاوە و بەشداریکردن

کۆدی تەواوی سەرچاوە، ڕێنماییەکانی دامەزراندن و بەڵگەنامە تەکنیکییەکان لە GitHub بەردەستن:

کردنەوەی Odoo 19 Merge Draft Invoices لە GitHub

بە ئەزموونی بەکارهێنانی ڕاستەقینە، ڕاپۆرتی هەڵەکان، پێشنیاری باشترکردن و بەشدارییەکانی کۆمەڵگەی Odoo خۆشحاڵ دەبین.

بەخۆڕایی. ئاسان بۆ بەدواداچوون. سەرچاوەکراوە. بۆ Odoo 19 Community.