Document Description

Document Description

/ e-Government Program (Yesser)
SERVICE NAME / Version 1.0
Page 1 / 23

Confidential MSB

This document (either in whole or in part) cannot be modified or
reproduced without the prior written permission of the MOMRA

Page 1 / 25

/ MOMRA Services Bus (MSB)
Projects Follow-up Services
Consumer Integration Guide /

Document Description

Document Titleوصف الخدمات الإلكترونية الخاصة بوزارة الشئون البلدية والقروية

Document version1.6.1

Document StatusFinal

Versions

Version / Date / Description of changes made
1.0 / July 14,2015 / Document creation
1.5 / Nov 16,2016
1.6 / Jan 26, 2017
1.6.1 / Feb 08,2017

Document Validation

Version / Author / Review by / Date / Status
1.0 / Mohamed Omar / Mostafa Mahmoud / July 14,2015 / 1.0
1.5 / Mostafa Mahmoud / Gamal Fadul / Nov 16 , 2016 / 1.5
1.6 / Mostafa mahmoud / Jan 26, 2017 / 1.6
1.6.1 / Mostafa mahmoud / Feb 08,2017 / 1.6.1

Table of Contents

Contents

1.Introduction

2.Details Momra Service Operations

2.1.Ins_Prj_Contract_Info

Operations Description

2.2.Ins_Prj_Contract_Transaction

Operations Description

2.3.Ins_Prj_Invoice_Deduction

Operations Description

2.4.Ins_Prj_Invoice_Info

Operations Description

2.5.Ins_Prj_Invoice_Payment

Operations Description

2.6.Ins_Prj_Contract_Progress

Operations Description

2.7.Ins_Prj_Expected_Contract

Operations Description

2.8.Upd_Prj_Contract_Info

Operations Description

2.9.Upd_Prj_Contract_Transaction

Operations Description

2.10.Upd_Prj_Invoice_Deduction

Operations Description

2.11.Upd_Prj_Invoice_Info

Operations Description

2.12.Upd_Prj_Invoice_Payment

Operations Description

2.13.Upd_Prj_Expected_Contract

Operations Description

2.14.Upd_Prj_Contract_Progress

Operations Description

2.15.Error Messages

1. Introduction

The purpose of this document is to descript the web service offerings consisting of high level functionality, web service input parameters and return values.

The document also will assist in managing the business expectations and specifications for the web services provided by Momra to Municipalities and the needed service to be provided to MOMRA.

The intended audience of this document is Projects Follow-up Service consumers and web service client developers.

2. Details Momra Service Operations

2.1. Ins_Prj_Contract_Info

Operations Description

Operation name / Contract Information
تسجيل بيانات العقود
Inputs
Contract Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_CONTRACTOR_NAME / string / اسم المقاول / N
P_CONTRACTOR_REGNO / string / رقم السجل التجاري للمقاول / N
P_CONTRACT_ASIGN_DATE / string / تاريخ توقيع العقد )YYYYMMDD( / N
P_CONTRACT_AVALUE / Decimal / اجمالي المنصرف الفعلي / Y
P_CONTRACT_END_DATE / string / تاريخ نهاية العقد )YYYYMMDD( / N
P_CONTRACT_NAME / string / اسم القعد / N
P_CONTRACT_STATUS_ID / enum / رمز حالة العقد / N / مغلق / 201 / Closed
موقوف / 202 / stopped
ملغى / 203 / cancelled
جارى / 602 / progress
P_CONTRACT_PERIOD / Decimal / مدة العقد بالأيام / N
P_CONTRACT_START_DATE / string / تاريخ استلام الموقع )YYYYMMDD( / N
P_CONTRACT_UPD_VAL / Decimal / قيمة الاعمال الاضافية (رفع/خفض) / Y
P_CONTRACT_VALUE / Decimal / قيمة العقد / N
P_CONTRACT_VAL_AFTRUPD / Decimal / قيمة العقد بعد التعديل / Y
P_CONTRACT_WORK_PER / Decimal / نسبة الانجاز الفعلي - التراكمية / Y
P_CONTRACT_WORK_VAL / Decimal / قيمة الانجاز الفعلي / Y
P_DEBIT_TVALUE / Decimal / اجمالي المتبقي على العقد / Y
P_DEDUCTION_TVALUE / Decimal / اجمالي الحسميات / Y
P_INVOICE_NVALUE / Decimal / اجمالي صافي المستخلصات / Y
P_INVOICE_TVALUE / Decimal / اجمالي قيمة المستخلصات / Y
P_NOTE / string / البيان / Y
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_S_ID_FIN / String / رقم الجهة الفرعية بالنظام المالي / N
P_Actexec_Date / String / تاريخ بدء التنفيذ الفعل / Y
P_Expstrt_Date / String / التاريخ المتوقع للبدء / Y
P_Initial_Delivery_Date / String / تاريخ الاستلام الابتدئي / Y
P_Final_Delivery_Date / String / تاريخ الاستلام النهائي / Y
P_Contract_Saving_Amount / Number / قيمة الوفر في العقد / Y
P_Supervision_Name / String / جهه الاشراف / Y
P_Eterm_Prvw_Date / String / تاريخ معاينة نهاية المدة / Y
P_Contract_Prd_Aftrupd / Number / مدة العقد بعد التعديل / Y
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / Y
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.2. Ins_Prj_Contract_Transaction

Operations Description

Operation name / Contract Transaction
تسجيل بيانات العمليات علي العقود (الاضافة أو الخفض)
Inputs
Transaction Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_CONTRACT_VAL_AFTRUPD / Decimal / قيمة العقد بعد التعديل / Y
P_DECISION_DATE / string / تاريخ القرار(YYYYMMDD) / Y
P_DECISION_NO / string / رقم القرار / Y
P_NOTE / string / البيان / Y
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_TRANS_ID / String / رقم الحركة بالجهة / N
P_SITE_M_ID_FIN / string / رمز الجهة الرئيسة / N
P_SITE_S_ID_FIN / string / رمز الجهة الفرعية / N
P_Val_Trans_Typeid / enum / نوع حركة الاعمال الاضافية لقيمة العقد / Y / Rais / 301 / رفع
Down / 302 / خفض
P_Val_Trans_Amt / Decimal / قيمة الحركة / N
P_Prd_Trans_Typeid / enum / نوع حركة الاعمال الاضافية لمدة العقد / Y / Rais / 301 / رفع
Down / 302 / خفض
P_Prd_Trans_Days / Number / المدة بالأيام / Y
P_Contract_Prd_Aftrupd / Number / مدة العقد بعد التعديل / Y
P_TRANS_DATE / string / تاريخ الحركة (YYYYMMDD) / Y
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.3. Ins_Prj_Invoice_Deduction

Operations Description

Operation name / Invoice Deduction
تسجيل بيانات حسميات المستخلصات
Inputs
Invoice Deduction Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_DEDUCTION_DATE / string / تاريخ الحسم (YYYYMMDD) / N
P_DEDUCTION_DESCR / string / البيان / Y
P_DEDUCTION_VALUE / Decimal / قيمة الحسم / N
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_DEDUCTION_ID / string / رقم الحسمية بالجهة / N
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_Deduction_Type_Id / Number / رمز الحسمية / N / 801 جزاءات وغرامات
802 غرامة تأخير
803 تكاليف اشراف
804 غياب عماله
805 نقص معدات
806 عدم تواجد مراقب
807 عدم تواجد مهندس
808 سوء اداء
809 سوء مصنعيه
810 ايرادات اخرى
811 تخفيض بموجب عطاء للمقاول
812 حسم مقابل دفعة مقدمة
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_S_ID_FIN / string / رقم الجهة الفرعية بالنظام المالي / N
P_CREATED_BY / string / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / String / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.4. Ins_Prj_Invoice_Info

Operations Description

Operation name / Invoice Information
تسجيل بيانات المستخلصات
Inputs
Invoice Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_ACUM_WORK_PER / Number / نسبة انجاز الاعمال المنفذة التراكمية / Y
P_ACUM_WORK_VAL / Number / قيمة انجاز الاعمال المنفذة التراكمية / N
P_INVOICE_AVALUE / Number / قيمة المنصرف الفعلي / Y
P_INVOICE_DATE / string / تاريخ تقديم المستخلص (YYYYMMDD) / N
P_INVOICE_DESCR / string / البيان / Y
P_INVOICE_NVALUE / Number / صافي المستخلص / N
P_INVOICE_REMAIN / Number / قيمة المؤجل / Y
P_INVOICE_TDEDUCT / Number / اجمالي الحسميات / N
P_INVOICE_TYPE_ID / enum / رمز نوع المستخلص / N / جارى / 401 / Current
ختامى / 402 / Final
دفعه مقدمة / 403 / advancedPay
P_INVOICE_VALUE / Number / قيمة المستخلص / N
P_INVOICE_WORK_PER / Number / نسبة انجاز الاعمال المنفذة للمستخلص الحالي / Y
P_INVOICE_WORK_VAL / Number / قيمة انجاز الاعمال المنفذة للمستخلص الحالي / Y
P_Project_Id / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد / N
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_SITE_WARID_DATE / string / تاريخ وارد المستخلص بالأمانة (YYYYMMDD) / Y
P_SITE_WARID_NO / string / رقم وارد المستخلص بالأمانة / Y
P_Site_M_Id_Fin / string / رقم الجهة الرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / string / رقم الجهة الفرعية بالنظام المالي / N
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.5. Ins_Prj_Invoice_Payment

Operations Description

Operation name / Invoice Payment
تسجيل بيانات أوامر الصرف
Inputs
Invoice_Payment Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_MOF_ORDER_DATE / string / تاريخ أمر الدفع (YYYYMMDD) / Y
P_MOF_ORDER_NO / string / رقم أمر الدفع / Y
P_NOTES / string / البيان / Y
P_PAYMENT_AMOUNT / Number / مبلغ أمر الصرف / N
P_PAYMENT_Flag / enum / حالة أمر الدفع / N / تم صرفه للمقاول / 1 / disbursed
لم يتم صرفه للمقاول / 2 / NOT_disbursed
P_PAYMENT_ORDER_DATE / string / تاريخ أمر الصرف بالجهة (YYYYMMDD) / N
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_PAYMENT_ID / string / رقم أمر الصرف بالجهة / N
P_SITE_S_ID_FIN / string / رقم الجهة الفرعية بالنظام المالي / N
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Result Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.6. Ins_Prj_Contract_Progress

Operations Description

Operation name / Contract Progress
تسجيل حركات نسب الانجاز
Inputs
Contract_Progress Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_Project_Id / string / رقم المشروع / N
P_Site_M_Id_Fin / string / رقم الجهةالرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / string / رقم الجهة الفرعية بالنظام المالى / N
P_Site_Contract_Id / string / رقم العقد بالجهة / N
P_Site_Progress_Id / String / مرجع الانجاز بالجهة / N
P_Progress_Date / String / تاريخ تسجيل حركة نسبة الانجاز / N
P_Work_Prcnt / Number / نسبة انجاز الاعمال المنفذه التراكمية / N
P_Work_Value / Number / قيمة انجاز الاعمال المنفذه التراكمية / Y
P_Note / string / البيان / Y
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Result Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.7. Ins_Prj_Expected_Contract

Operations Description

Operation name / Expected Contract
تسجيل بيانات العقد المتوقع (الطرح والترسية)
Inputs
Contract_Expected Object
Parameter Name / Data Type / Description / NULL / Note
P_Project_Id / string / رقم المشروع / N
P_Site_M_Id_Fin / string / رقم الجهة الرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / String / رقم الجهة الفرعية بالنظام المالي / N
P_Exp_Site_Contract_No / String / رقم العقد المتوقع بالجهة / N
P_Exp_Cont_Name / String / اسم العقد المتوقع / N
P_Exp_Cont_Value / Number / القيمة المتوقعة للعقد / N
P_Process_Stage_Id / enum / رقم المرحلة الحالية للعقد / N / تحت الدراسة / 1001 / Understudy
تحت الطرح / 1002 / UnderTar7
تحت الترسية / 1003 / UnderTarsy
عقد مبرم / 1004 / Contract
P_Study_End_Date / String / تاريخ نهاية الدراسة
(YYYYMMDD) / Y
P_Offers_Opening_Date / String / تاريخ فتح المظاريف
(YYYYMMDD) / Y
P_Offers_Count / number / عدد العطاءات المقدمة في حالة مرحلة العقد هي الترسية / Y
P_Tarsia_Flag / Number / مؤشر الترسية / Y / تم الترسية / 1 / Tarsia
تم الالغاء / 2 / Cancelled
P_Tarsia_Letter_No / String / رقم خطاب الترسية / Y
P_Tarsia_Date / String / تاريخ الترسية
(YYYYMMDD) / Y
P_Expropriation_Flag / number / مؤ شر نوع العقد / N / متوقع / 1 / Expected
نزع ملكية / 2 / Naz3Melkia
P_Decision_Rstart_No / String / رقم طلب إصدار قرار البدء في نزع الملكية / Y
P_Decision_Rstart_Date / string / تاريخ إصدار قرار البدء في نزع الملكية
(YYYYMMDD) / Y
P_Decision_Start_No / String / رقم قرار البدء في نزع الملكية / Y
P_Announce_Date / String / تاريخ الإعلان في أم القرى
(YYYYMMDD) / Y
P_Exp_Cont_Status / Number / حالة العقد المتوقع / Y / سارى / 1 / Sare
موقوف / 2 / Stopped
ملغى / 3 / Canceled
P_Note / String / البيان / Y
P_CREATED_BY / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Result Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.8. Upd_Prj_Contract_Info

Operations Description

Operation name / Update Contract Information
تحديث بيانات العقود
Inputs
Contract Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_CONTRACTOR_NAME / string / اسم المقاول / N
P_CONTRACTOR_REGNO / string / رقم السجل التجاري للمقاول / N
P_CONTRACT_ASIGN_DATE / string / تاريخ توقيع العقد )YYYYMMDD( / N
P_CONTRACT_AVALUE / Number / اجمالي المنصرف الفعلي / Y
P_CONTRACT_END_DATE / string / تاريخ نهاية العقد )YYYYMMDD( / N
P_CONTRACT_NAME / string / اسم القعد / N
P_CONTRACT_STATUS_ID / enum / رمز حالة العقد / N / مغلق / 201 / Closed
موقوف / 202 / stopped
ملغى / 203 / cancelled
جارى / 602 / progress
P_CONTRACT_PERIOD / Number / مدة العقد بالأيام / N
P_CONTRACT_START_DATE / string / تاريخ استلام الموقع )YYYYMMDD( / N
P_CONTRACT_UPD_VAL / Number / قيمة الاعمال الاضافية (رفع/خفض) / Y
P_CONTRACT_VALUE / Number / قيمة العقد / Y
P_CONTRACT_VAL_AFTRUPD / Number / قيمة العقد بعد التعديل / Y
P_CONTRACT_WORK_PER / Number / نسبة الانجاز الفعلي - التراكمية / Y
P_CONTRACT_WORK_VAL / Number / قيمة الانجاز الفعلي / Y
P_DEBIT_TVALUE / Number / اجمالي المتبقي على العقد / Y
P_DEDUCTION_TVALUE / Number / اجمالي الحسميات / Y
P_INVOICE_NVALUE / Number / اجمالي صافي المستخلصات / Y
P_INVOICE_TVALUE / Number / اجمالي قيمة المستخلصات / Y
P_NOTE / string / البيان / Y
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_S_ID_FIN / string / رقم الجهة الفرعية بالنظام المالي / N
P_Actexec_Date / String / تاريخ بدء التنفيذ الفعلي / Y
P_Expstrt_Date / String / التاريخ المتوقع للبدء / Y
P_Initial_Delivery_Date / String / تاريخ الاستلام الإبتدائى / Y
P_Final_Delivery_Date / String / تاريخ الاستلام النهائي / Y
P_Contract_Saving_Amount / Number / قيمة الوفر في العقد / Y
P_Supervision_Name / String / جهه الاشراف / Y
P_Eterm_Prvw_Date / String / تاريخ معاينة نهاية المدة / Y
P_Contract_Prd_Aftrupd / Number / مدة العقد بعد التعديل / Y
P_UPDATED_BY / Number / رمز المستخدم المحدث للسجل / Y
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.9. Upd_Prj_Contract_Transaction

Operations Description

Operation name / Update Contract Transaction
تحديث بيانات العمليات علي العقود (الاضافة أو الخفض)
Inputs
Transaction Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_CONTRACT_VAL_AFTRUPD / Number / قيمة العقد بعد التعديل / Y
P_DECISION_DATE / string / تاريخ القرار (YYYYMMDD) / N
P_DECISION_NO / string / رقم القرار / N
P_NOTE / string / البيان / Y
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_M_ID_FIN / string / رمز الجهة الرئيسة / N
P_SITE_S_ID_FIN / string / رمز الجهة الفرعية / N
P_SITE_TRANS_ID / string / رقم الحركة بالجهة / N
P_Val_Trans_Amt / Number / قيمة الحركة / Y
P_TRANS_DATE / string / تاريخ الحركة (YYYYMMDD) / N
P_Val_Trans_Typeid / enum / نوع حركة الاعمال الاضافية لقيمة العقد / Y / Rais / 301 / رفع
Down / 302 / خفض
P_Prd_Trans_Typeid / enum / نوع حركة الاعمال الاضافية لمدة العقد / Y / Rais / 301 / رفع
Down / 302 / خفض
P_Prd_Trans_Days / Number / المدة بالأيام / Y
P_Contract_Prd_Aftrupd / Number / مدة العقد بعد التعديل / Y
P_UPDATED_BY / Number / رمز المستخدم المحدث للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تحديث البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تحديث السجل

2.10. Upd_Prj_Invoice_Deduction

Operations Description

Operation name / Update Invoice Deduction
تحديث بيانات حسميات المستخلصات
Inputs
Invoice_Deduction Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_DEDUCTION_DATE / string / تاريخ الحسم (YYYYMMDD) / N
P_DEDUCTION_DESCR / string / البيان / Y
P_DEDUCTION_VALUE / Decimal / قيمة الحسم / N
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_DEDUCTION_ID / string / رقم الحسمية بالجهة / N
P_Deduction_Type_Id / Number / رمز الحسمية / N / 801 جزاءات وغرامات
802 غرامة تأخير
803 تكاليف اشراف
804 غياب عماله
805 نقص معدات
806 عدم تواجد مراقب
807 عدم تواجد مهندس
808 سوء اداء
809 سوء مصنعيه
810 ايرادات اخرى
811 تخفيض بموجب عطاء للمقاول
812 حسم مقابل دفعة مقدمة
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_S_ID_FIN / string / رقم الجهة الفرعية بالنظام المالي / N
P_UPDATED_BY / Number / رمز المستخدم المحدث للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.11. Upd_Prj_Invoice_Info

Operations Description

Operation name / Update Invoice Information
تحديث بيانات المستخلصات
Inputs
Invoice Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_ACUM_WORK_PER / Number / نسبة انجاز الاعمال المنفذة التراكمية / Y
P_ACUM_WORK_VAL / Number / قيمة انجاز الاعمال المنفذة التراكمية / Y
P_INVOICE_AVALUE / Number / قيمة المنصرف الفعلي / Y
P_INVOICE_DATE / string / تاريخ تقديم المستخلص (YYYYMMDD) / N
P_INVOICE_DESCR / string / البيان / Y
P_INVOICE_NVALUE / Number / صافي المستخلص / Y
P_INVOICE_REMAIN / Number / قيمة المؤجل / Y
P_INVOICE_TDEDUCT / Number / اجمالي الحسميات / Y
P_INVOICE_TYPE_ID / enum / رمز نوع المستخلص / N / جارى / 401 / Current
ختامى / 402 / Final
دفعه مقدمة / 403 / advancedPay
P_INVOICE_VALUE / Number / قيمة المستخلص / N
P_INVOICE_WORK_PER / Number / نسبة انجاز الاعمال المنفذة للمستخلص الحالي / Y
P_INVOICE_WORK_VAL / Number / قيمة انجاز الاعمال المنفذة للمستخلص الحالي / Y
P_Project_Id / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد / N
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_SITE_WARID_DATE / string / تاريخ وارد المستخلص بالأمانة (YYYYMMDD) / Y
P_SITE_WARID_NO / string / رقم وارد المستخلص بالجهة / Y
P_Site_M_Id_Fin / string / رقم الجهة الرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / string / رقم الجهة الفرعية بالنظام المالي / N
P_UPDATED_BY / Number / رمز المستخدم المحدث للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / Number / في حال تم ارجاع قيمة (1) هذا يعني تم تحديث البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تحديث السجل
Invoice Information object

2.12. Upd_Prj_Invoice_Payment

Operations Description

Operation name / Invoice Payment
تحديث بيانات أوامر الصرف
Inputs
Invoice_Payment Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_MOF_ORDER_DATE / string / تاريخ أمر الدفع (YYYYMMDD) / Y
P_MOF_ORDER_NO / string / رقم أمر الدفع / Y
P_NOTES / string / البيان / Y
P_PAYMENT_AMOUNT / Number / مبلغ أمر الصرف / N
P_PAYMENT_Flag / enum / حالة أمر الدفع / N / تم صرفه للمقاول / 1 / disbursed
لم يتم صرفه للمقاول / 2 / NOT_disbursed
P_PAYMENT_ORDER_DATE / string / تاريخ أمر الصرف بالجهة (YYYMMDD) / N
P_PROJECT_ID / string / رقم المشروع / N
P_SITE_CONTRACT_ID / string / رقم العقد بالجهة / N
P_SITE_INVOICE_ID / string / رقم المستخلص بالجهة / N
P_SITE_M_ID_FIN / string / رقم الجهة الرئيسة بالنظام المالي / N
P_SITE_PAYMENT_ID / string / رقم أمر الصرف بالجهة / N
P_SITE_S_ID_FIN / string / رقم الجهة الفرعية بالنظام المالي / N
P_UPDATED_BY / Number / رمز المستخدم المحدث للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تحديث البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تحديث السجل

2.13. Upd_Prj_Expected_Contract

Operations Description

Operation name / Expected Contract
تحديث بيانات العقد المتوقع (الطرح والترسية)
Inputs
Contract_Expected Object
Parameter Name / Data Type / Description / NULL / Note
P_Project_Id / string / رقم المشروع / N
P_Site_M_Id_Fin / string / رقم الجهة الرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / String / رقم الجهة الفرعية بالنظام المالي / N
P_Exp_Site_Contract_No / String / رقم العقد المتوقع بالجهة / N
P_Exp_Cont_Name / String / اسم العقد المتوقع / N
P_Exp_Cont_Value / Number / القيمة المتوقعة للعقد / N
P_Process_Stage_Id / enum / رقم المرحلة الحالية للعقد / N / حت الدراسة / 1001 / Understudy
تحت الطرح / 1002 / UnderTar7
تحت الترسية / 1003 / UnderTarsy
عقد مبرم / 1004 / Contract
P_Study_End_Date / String / تاريخ نهاية الدراسة
(YYYYMMDD) / Y
P_Offers_Opening_Date / String / تاريخ فتح المظاريف
(YYYYMMDD) / Y
P_Offers_Count / number / عدد العطاءات المقدمة في حالة مرحلة العقد هي الترسية / Y
P_Tarsia_Flag / Number / مؤشر الترسية / Y / تم الترسية / 1 / Tarsia
تم الالغاء / 2 / Cancelled
P_Tarsia_Letter_No / String / رقم خطاب الترسية / Y
P_Tarsia_Date / String / تاريخ الترسية
(YYYYMMDD) / Y
P_Expropriation_Flag / number / مؤ شر نوع العقد / N / متوقع / 1 / Expected
نزع ملكية / 2 / Naz3Melkia
P_Decision_Rstart_No / String / رقم طلب إصدار قرار البدء في نزع الملكية / Y
P_Decision_Rstart_Date / string / تاريخ إصدار قرار البدء في نزع الملكية
(YYYYMMDD) / Y
P_Decision_Start_No / String / رقم قرار البدء في نزع الملكية / Y
P_Announce_Date / String / تاريخ الإعلان في أم القرى
(YYYYMMDD) / Y
P_Exp_Cont_Status / Number / حالة العقد المتوقع / Y / سارى / 1 / Sare
موقوف / 2 / Stopped
ملغى / 3 / Canceled
P_Contractor_Regno / String / رقم السجل التجاري للمقاول / Y
P_Contractor_Name / String / اسم المقاول / Y
P_Contract_Asign_Date / String / تاريخ توقيع العقد
(YYYYMMDD) / Y
P_Constract_End_Date / String / تاريخ إنتهاء العقد
(YYYYMMDD) / Y
P_Decision_Start_Date / string / تاريخ قرار البدء في نزع الملكية
(YYYYMMDD) / Y
P_Associated_Cont_Id / Number / رقم العقد المبرم المرتبط بالدراسة / Y
P_Associated_Fin_Year / Number / السنة المالية للعقد المبرم المرتبط بالدراسة / Y
P_Note / String / البيان / Y
P_Updated_By / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Return Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.14. Upd_Prj_Contract_Progress

Operations Description

Operation name / Contract Progress
تحديث إنجاز ما تم بالعقد
Inputs
Contract_Progress Object
Parameter Name / Data Type / Description / NULL / Note
P_FIN_YEAR / Number / السنة المالية - (YYYY) / N
P_Project_Id / string / رقم المشروع / N
P_Site_M_Id_Fin / string / رقم الجهةالرئيسة بالنظام المالي / N
P_Site_S_Id_Fin / string / رقم الجهة الفرعية بالنظام المالى / N
P_Site_Contract_Id / string / رقم العقد بالجهة / N
P_Site_Progress_Id / String / مرجع الانجاز بالجهة / N
P_Progress_Date / String / تاريخ تسجيل حركة نسبة الانجاز
(YYYYMMDD) / N
P_Work_Prcnt / Number / نسبة انجاز الاعمال المنفذه التراكمية / N
P_Work_Value / Number / قيمة انجاز الاعمال المنفذه التراكمية / Y
P_Note / string / البيان / Y
P_Updated_By / Number / رمز المستخدم المنشئ للسجل / N
Outputs
Parameter Name / Data Type / Description / Note
Result Value / string / في حال تم ارجاع قيمة (1) هذا يعني تم تسجيل البيانات بشكل صحيح فيما عدا ذلك فيعني عدم تسجيل السجل

2.15. Error Messages

قائمة رسائل الخطأ الخاصة بقاعدة بيانات المشاريع المركزية: -

م / الفئة / رمز الخطأ / وصف الخطأ
1 / العقود المبرمة / 999 / تمت العملية بنجاح
1001 / يوجد حقل/حقول اجبارية (Not Null) لم يتم إدخالها.
1002 / رقم المشروع غير صحيح.
1003 / رمز الأمانة/البلدية غير صحيح.
1004 / المشروع لا يتبع للأمانة/البلدية.
1005 / العقد ليس ضمن عقود الباب الرابع.
1006 / رمز المستخدم غير صحيح.
1007 / المستخدم لا يتبع للأمانة/البلدية.
1008 / رمز حالة العقد غير صحيح.
1009 / تم ادخال العقد مسبقاً.
1010 / رقم العقد غير موجود.
1011 / قيمة العقد يجب أن تكون أكبر من الصفر
1012 / صيغة تاريخ توقيع العقد غير صحيحة يجب ان تكون الصيغة(YYYYMMDD)
1013 / صيغة تاريخ بداية العقد غير صحيحة يجب ان تكون الصيغة(YYYYMMDD)
1014 / صيغة تاريخ نهاية العقد غير صحيحة يجب ان تكون الصيغة(YYYYMMDD)
1015 / صيغة تاريخ الاستلام الابتدائي غير صحيحة يجب ان تكون الصيغة(YYYYMMDD)
1016 / يجب ادخال تفاصيل حركات الخفض أو الرفع الخاصة بالعقد.
2 / أوامر التغيير -الخفض والرفع / 2001 / تم ادخال أمر التغيير مسبقاً.
2002 / رمز حالة أمر التغيير غير صحيح.
2003 / نوع أمر التغيير الخاص بقيمة العقد غير صحيح.
2004 / نوع أمر التغيير الخاص بمدة العقد غير صحيح.
2005 / رقم أمر التغيير غير موجود
2006 / يجب ادخال نوع أمر تغيير واحد على الأقل.
2007 / القيمة في أمر التغيير يجب أن تكون أكبر من الصفر.
2008 / المدة في أمر التغيير يجب أن تكون أكبر من الصفر.
3 / المستخلصات / 3001 / تم ادخال المستخلص مسبقاً.
3002 / رمز حالة المستخلص غير صحيح.
3003 / رمز نوع المستخلص غير صحيح.
3004 / رقم المستخلص غير موجود.
3005 / قيمة المستخلص يجب أن تكون أكبر من الصفر
4 / الحسميات / 4001 / تم ادخال الحسمية مسبقاً.
4002 / رمز حالة الحسمية غير صحيح.
4003 / رمز نوع الحسمية غير صحيح.
4004 / رقم الحسمية غير موجود.
4005 / قيمة الحسمية يجب أن تكون أكبر من الصفر
5 / أوامر الصرف / 5001 / تم ادخال أمر الصرف مسبقاً.
5002 / رمز حالة أمر الصرف غير صحيح.
5003 / رقم أمر الصرف غير موجود
5004 / قيمة أمر الصرف يجب أن تكون أكبر من الصفر
6 / العقود المتوقعة -الطرح والترسية / 6001 / تم ادخال العقد المتوقع مسبقاً.
6002 / رمز المرحلة الحالية للعقد غير صحيح.
6003 / رقم العقد المتوقع غير موجود
6004 / قيمة العقد المتوقع يجب أن تكون أكبر من الصفر
7 / حركات نسب الانجاز / 7001 / تم ادخال حركة الإنجاز مسبقاً.
7002 / رقم حركة الإنجاز غير موجود
7003 / نسبة حركة الانجاز يجب أن تكون أكبر من الصفر
8 / المرفقات / 8001 / رمز نوع المرفق غير صحيح.

Confidential MSB

This document (either in whole or in part) cannot be modified or
reproduced without the prior written permission of the MOMRA

Page 1 / 25