የቻፓ የኢ-ኮሜርስ ክፍያ ድልድይን ማዋቀር
የቻፓ ጌትዌይን ማዋቀር፣ በቴሌብር/CBE Birr/ቪዛ ክፍያዎችን መቀበል እና በWebhook አውቶማቲክ ትዕዛዞችን ማረጋገጥ።
1. Overview & Business Value#
ይህ የተሟላ የተግባር መመሪያ በSmartERP ውስጥ የቻፓ የኢ-ኮሜርስ ክፍያ ድልድይን ማዋቀር የሚተገበርበትን አርክቴክቸር፣ የስራ ፍሰቶች፣ የቅንብር መለኪያዎች እና የአፈጻጸም እርምጃዎች በዝርዝር ያብራራል።


ይህ መመሪያ የዲጂታል ኢ-ኮሜርስ ክፍያዎችን በቻፓ የክፍያ ድልድይ (aosqa_payment_chapa) ለሚያዋቅሩ ባለሙያዎች የተዘጋጀ ነው።
2. Prerequisites & Security Access Groups#
- አስፈላጊ ሞጁሎች፦
sale_management, crm, point_of_sale, smarterp_payment_telebirr - የደህንነት ቡድኖች፦
Sales User(ቴክኒካዊ መለያ፦sales_team.group_sale_salesman)Sales Administrator(ቴክኒካዊ መለያ፦sales_team.group_sale_manager)POS User / Cashier(ቴክኒካዊ መለያ፦point_of_sale.group_pos_user)
- የመሠረታዊ ዳታ ጥገኝነቶች፦ የደንበኞች መዝገብ፣ የመሸጫ የዋጋ ዝርዝሮች፣ የምርት ክምችት ቀሪዎች፣ የክፍያ አቅራቢዎች (Telebirr/CBE Birr) እና የPOS ተርሚናል ክፍለ-ጊዜዎች።
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Interface#
- ወደ SmartERP መድረክዎ በ
https://smarterp.et/odooይግቡ። - ዋናውን የመተግበሪያ መቀየሪያ (በላይኛው ግራ ጥግ ያለውን የፍርግርግ አርማ) ይክፈቱ።
- ወደ Operations ይሂዱ።

Step 2: Operational Data Parameters & Controls#
አስገዳጅ መለኪያዎች በድርጅታዊ መመሪያው መሰረት መሞላታቸውን ያረጋግጡ፦
- የስልጣን ባለቤትነት፦ በተፈቀደ የተጠቃሚ የስራ ሚና መሰረት መስራት።
- የመረጃ ትክክለኛነት፦ ከትክክለኛ የደንበኛ፣ የምርት፣ የመጋዘን ወይም የፋብሪካ ትዕዛዝ ጋር ማገናኘት።
- የህግ እና የጥራት ቁጥጥር፦ የኢትዮጵያን የንግድ እና የታክስ ህጎች እንዲሁም የፋብሪካ የጥራት ደረጃዎች በጥብቅ መከተል።
Step 3: Operational Execution & State Progression#
- የሁኔታ ሽግግር በር፦ ግብይቱን ከረቂቅ ወደ የጸደቀ / የተጠናቀቀ ማሸጋገር።
- የስርዓት ተፅዕኖ፦ የመጋዘን ቀሪዎችን፣ የደንበኛ እዳዎችን ወይም በሂደት ላይ ያለ የምርት ወጪ ሂሳብን በራስ-ሰር ያዘምናል።
- የኦዲት ክትትል፦ ስርዓቱ የተጠቃሚውን መለያ፣ ትክክለኛ ሰዓት እና የግብይት ኮድ በመመዝገብ አስተማማኝ የኦዲት መከታተያ ያዘጋጃል።
Configuration#
- Invoicing → Configuration → Payment Providers የሚለውን ይክፈቱ እና Chapa የሚለውን ይምረጡ።
- የማረጋገጫ ቁልፎችን ያስገቡ፦
- Public Key:
CHAPUBK_...(ከቻፓ ዳሽቦርድ የሚወሰድ)። - Secret Key:
CHASECK_...(የተመሰጠረ ሚስጥር)። - Webhook Secret: የፊርማ ማረጋገጫ ቁልፍ።
- Public Key:
- በPayment Methods ስር CBE Birr፣ Telebirr፣ Awash Birr እና አለም-አቀፍ ካርዶችን ያብሩ።
- ሁኔታውን ወደ Enabled ቀይረው ያስቀምጡ።
Webhook Verification Workflow#
ደንበኛ በቻፓ በኩል ክፍያ ሲፈጽም፦
- ቻፓ የHTTP POST መልዕክት ወደ
/payment/chapa/webhookይልካል። - SmartERP የ
x-chapa-signatureHMAC-SHA256 ፊርማን ያረጋግጣል። - ትክክለኛ ከሆነ ግብይቱ ወደ
Authorized→Confirmedይሸጋገራል። - የሽያጭ ትዕዛዙ በራስ-ሰር ጸድቆ ለመጋዘን ዝውውር ይለቀቃል።
4. Advanced Configuration Points#
- ራስ-ሰር የታቀዱ ተግባራት (Crons)፦
CRM: Lead auto-assignment(crm.ir_cron_lead_assign)፦ ያልተመደቡ ደንበኞችን ለሽያጭ ቡድኖች በየሰዓቱ ለማከፋፈል ይሰራልSales: Expire overdue quotations(sale.ir_cron_expire_quotes)፦ ጊዜያቸው ያለፈባቸውን የዋጋ ማቅረቢያዎች ለመሰረዝ በየምሽቱ ይሰራልPOS: Close abandoned register sessions(point_of_sale.ir_cron_session_cleanup)፦ ክፍት ሆነው የቀሩ የገንዘብ ተቀባይ ተርሚናሎችን ለስራ አስኪያጆች ለማሳወቅ በየምሽቱ ይሰራል
- ብጁ የህትመት አብነቶች እና ሪፖርቶች፦
- Customer Sales Quotation / Pro-forma Invoice
- Commercial Tax Invoice (Model 85 Compliant)
- POS Cash Register Receipt with QR Validation
- Customer Credit Limit & Receivables Aging Statement
- የባለብዙ-ኩባንያ ደንቦች፦ በCompany 1 (
Ashewa Technology Solutions S.C.) ስር በመዝገብ ደረጃ የደህንነት ገለልተኝነት፣ በዋና እና በቅርንጫፍ ተቋማት መካከል የሂሳብ መዝገብ መደባለቅን ይከላከላል።
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Credit Limit Blocked: Customer balance exceeds ceiling | ያልተከፈለው የደንበኛ ዕዳ እና የአሁኑ ትዕዛዝ ከተፈቀደው የብድር ገደብ በላይ ሆኗል። | የብድር ኮሚቴ ልዩ ይሁንታ ያግኙ ወይም የቅድመ ክፍያ ጥሬ ገንዘብ ይሰብስቡ። |
Validation Error: Tax definition missing on product line | የምርት እቃው ነባሪ ህጋዊ 15% ቫት አልተዋቀረለትም። | የምርት ማስተር የሂሳብ ትርን በመደበኛ ህጋዊ የቫት ተመን ያዘምኑ። |
POS Session Error: Cash register mismatch upon closure | በአካል የተቆጠረው ጥሬ ገንዘብ በPOS ከተመዘገበው የካዝና ቀሪ ጋር አልተዛመደም። | በክፍለ-ጊዜ መዝጊያው ላይ የልዩነቱን ማብራሪያ ይመዝግቡ እና ለስራ አስኪያጅ ክለሳ ያቅርቡ። |
Payment Gateway Error: Telebirr timeout | የኔትወርክ መዘግየት ወይም የተሳሳተ የኤፒአይ ማረጋገጫ ቁልፍ። | በInvoicing → Configuration → Payment Providers ስር የነጋዴ መለያዎችን ያረጋግጡ እና ግብይቱን በድጋሚ ይሞክሩ። |
Next#
- ኤሌክትሮኒክ ፊርማዎች፦ በሽያጭ ውሎች ላይ ዲጂታል ኤሌክትሮኒክ ፊርማዎችን መተግበር።
መጨረሻ የተሻሻለው: 2026-11-15