# شرح حساب تكلفة الشراء وتحديث سعر المنتج — الفاتورة 1386

هذا المستند يشرح تدفق السعر في إنشاء وتعديل فاتورة الشراء، وكيفية توزيع المصاريف الإضافية والعملات على تكلفة المنتجات، ثم تحديث سعر الشراء الافتراضي الذي يظهر في نافذة المنتج ضمن `/products`. كما يطبق الشرح على الفاتورة `/purchases/1386/edit` الموجودة في قاعدة البيانات وقت الفحص.

> الفحص كان للقراءة فقط. لم تُعدّل الفاتورة أو المنتجات.

## الملخص التنفيذي

- الفاتورة 1386 موجودة وحالتها `received`.
- عملة الفاتورة USD، وسعر صرف الفاتورة المحفوظ هو **55 EGP لكل 1 USD**.
- العملة الأساسية للنشاط هي EGP.
- خانات «المصاريف الإضافية» التقليدية الأربع قيمتها صفر.
- يوجد مصروفان مخصصان: جمارك بقيمة **12,375 EGP**، وشحن دولي بقيمة **225 USD**. كلاهما مضبوط على طريقة `product`، لذلك يحمّلان على تكلفة المنتجات.
- حوّل النظام المصروفين إلى **24,750 EGP = 450 USD بسعر الفاتورة**، ثم وزعهما على المنتجات.
- تكلفة كل منتج بعد تحميل المصروفات (قبل ضريبة الصنف) ضُربت في سعر الصرف 55 لتحديث `default_purchase_price` بالـ EGP.
- توجد ملاحظة بيانات: إجمالي السطور الأصلية المحسوب من الأسعار المحفوظة هو **394.74 USD**، بينما `total_before_tax` في رأس الفاتورة **450 USD**. الأسعار النهائية المحفوظة تكشف أن التوزيع العملي للمصاريف تم على أساس 394.74 USD.

## المصطلحات والحقول

| المصطلح / الحقل | المعنى |
|---|---|
| العملة الأساسية | عملة النشاط في إعدادات النظام. في هذا السجل هي EGP (معرّف العملة 35). |
| عملة الفاتورة | العملة التي أُدخلت بها أسعار فاتورة الشراء. في هذا السجل USD (معرّف 2). |
| سعر صرف الفاتورة `exchange_rate` | عدد وحدات العملة الأساسية لكل وحدة من عملة الفاتورة. في السجل: 55 EGP/USD. |
| `pp_without_discount` | سعر الوحدة قبل الخصم. |
| `purchase_price` | تكلفة الوحدة قبل ضريبة الصنف؛ في السجل هي التكلفة التي تشمل الخصم والمصاريف الموزعة. |
| `item_tax` | ضريبة الصنف لكل وحدة. |
| `purchase_price_inc_tax` | تكلفة الوحدة شاملة ضريبة الصنف. |
| `default_purchase_price` | سعر الشراء الافتراضي المخزن على متغير المنتج، ويُحدّث هنا بالعملة الأساسية ومن دون ضريبة الصنف. |
| المصاريف التقليدية 1–4 | خانات «المصاريف الإضافية» القديمة في رأس فاتورة الشراء. قيمها في هذه الفاتورة صفر. |
| CPE / مصاريف الشراء المخصصة | خانات المصروفات المخصصة، حتى 6 مصروفات، لكل منها عملة وطريقة حساب (`product` أو `expense`). |

## تدفق إنشاء الفاتورة

1. يقرأ النظام `currency_id` و`exchange_rate` من الفاتورة. أسعار الشراء تُفك من تنسيق العرض وتبقى بعملة الفاتورة؛ في هذه الحالة USD.
2. تُنشأ أسطر الشراء، وفيها السعر قبل الخصم، نسبة الخصم، تكلفة الوحدة قبل ضريبة الصنف، ضريبة الصنف، والتكلفة شاملة الضريبة.
3. يحفظ النظام لقطة للسعر قبل توزيع المصاريف في `purchase_price_before_expense` و`purchase_price_inc_tax_before_expense` حتى يستطيع عرض السعر الأصلي عند التعديل ومنع تراكم المصروف على السعر.
4. يحوّل النظام كل مصروف مخصص إلى العملة الأساسية ويحفظ المبلغ المحوّل في `cpe_amount_egp_N` وسعر التحويل في `cpe_rate_N`.
5. المصروف ذو الطريقة `product` يوزع على أسطر الأصناف بالتناسب مع قيمة كل سطر الأصلية قبل الضريبة. الزيادة الموزعة تضاف إلى `purchase_price` وإلى `purchase_price_inc_tax`.
6. المصروف ذو الطريقة `expense` لا يضاف إلى أسعار المنتجات؛ يضاف إلى إجمالي الفاتورة فقط.
7. عند حالة `received`، يحدّث النظام أسعار الشراء الافتراضية للمنتجات من `purchase_price` النهائي بعد تحويله إلى العملة الأساسية.

## تدفق تعديل الفاتورة

عند فتح شاشة التعديل، يستعيد المتحكم قيم السعر قبل المصاريف من حقول اللقطة إذا كانت موجودة. لذلك تعرض الشاشة أساس السعر الأصلي بدل السعر المحمّل بالمصاريف. عند الحفظ:

1. يعاد بناء السعر بعد الخصم من سعر ما قبل الخصم والخصم وضريبة الصنف.
2. تُحسب المصاريف المخصصة من جديد، وتُحوّل بالأسعار المسجلة للفاتورة/العملة.
3. يعاد توزيع المصروفات على أسطر المنتجات بحسب قيمها الأصلية الجديدة.
4. يحفظ السعر النهائي، ثم يحدث `default_purchase_price` إذا كانت حالة الفاتورة `received`.

الغرض من لقطة «قبل المصاريف» وإعادة بناء السعر في التعديل هو تفادي إضافة نفس المصروف مرة ثانية في كل مرة تُعدّل فيها الفاتورة.

## معادلات التحويل والتوزيع

### تحويل المصروف إلى العملة الأساسية

لكل مصروف مخصص:

```text
المصروف بالعملة الأساسية = قيمة المصروف بعملته × سعر تحويل عملته إلى العملة الأساسية
```

القواعد التي يطبقها النظام عند تسجيل المصروف:

- إذا كانت عملة المصروف هي العملة الأساسية: سعر التحويل = 1.
- إذا كانت عملة المصروف هي عملة الفاتورة: سعر التحويل = `exchange_rate` المحفوظ على الفاتورة.
- إذا كانت عملة المصروف عملة أجنبية أخرى: يستخدم سعر الصرف المخزن لتلك العملة في جدول العملات.

### حصة كل سطر من المصروفات التي تُحمّل على المنتجات

```text
قيمة السطر الأصلية = الكمية × سعر الوحدة الأصلي قبل ضريبة الصنف
نسبة السطر = قيمة السطر الأصلية ÷ مجموع قيم الأسطر الأصلية
حصة السطر من المصروف = إجمالي المصروف المحوّل للأساس × نسبة السطر
الزيادة لكل وحدة بعملة الفاتورة = حصة السطر ÷ الكمية ÷ exchange_rate
```

تضاف الزيادة لكل وحدة إلى `purchase_price` وإلى `purchase_price_inc_tax`. ضريبة الصنف الأصلية لا يعاد حسابها على الزيادة داخل هذا المسار؛ الزيادة نفسها تضاف للقيمتين.

### تحديث سعر المنتج الافتراضي

```text
default_purchase_price بالعملة الأساسية
    = purchase_price النهائي قبل ضريبة الصنف × exchange_rate
```

هذا التحديث لا يتم إلا عندما تكون حالة الشراء `received` في المسارات التي تستدعي تحديث السعر الافتراضي.

## تطبيق على السجل الحقيقي 1386

### رأس الفاتورة

| الحقل | القيمة المسجلة |
|---|---:|
| رقم الفاتورة | 1386 |
| النوع والحالة | `purchase` / `received` |
| عملة الفاتورة | USD |
| العملة الأساسية | EGP |
| سعر الصرف على الفاتورة | 55 EGP لكل USD |
| `total_before_tax` | 450.00 USD |
| الخصم | ثابت، 30.00 USD |
| ضريبة الفاتورة | 0.00 USD |
| الشحن في رأس الفاتورة | 0.00 USD |
| `final_total` المسجل | 870.00 USD |
| المصاريف التقليدية 1–4 | صفر |

### المصاريف المخصصة

| الاسم | قيمة المصروف | العملة | سعر التحويل المحفوظ | المقابل الأساسي المحفوظ | الطريقة |
|---|---:|---|---:|---:|---|
| جمارك | 12,375.00 | EGP | 1 | 12,375.00 EGP | `product` |
| شحن دولي | 225.00 | USD | 55 | 12,375.00 EGP | `product` |
| **الإجمالي** | — | — | — | **24,750.00 EGP** | كلاهما يحمّل على المنتجات |

وبعملة الفاتورة:

```text
12,375 EGP ÷ 55 = 225 USD
225 USD × 55 = 12,375 EGP
إجمالي المصاريف = 24,750 EGP = 450 USD بسعر الفاتورة
```

### المنتجات وأسعارها المسجلة

القيم التالية مقروءة من أسطر الشراء في قاعدة البيانات. الكمية لكل سطر وحدة واحدة.

| المنتج | السعر الأصلي قبل المصاريف وقبل الضريبة | ضريبة الصنف | سعر الوحدة النهائي قبل الضريبة | السعر النهائي شامل ضريبة الصنف | سعر المنتج الافتراضي بالـ EGP |
|---|---:|---:|---:|---:|---:|
| test - anas 1 | 87.72 USD | 12.28 USD | 187.72 USD | 200.00 USD | 10,324.60 EGP |
| test - anas 2 | 131.58 USD | 18.42 USD | 281.58 USD | 300.00 USD | 15,486.90 EGP |
| test - anas 3 | 175.44 USD | 24.56 USD | 375.44 USD | 400.00 USD | 20,649.20 EGP |

تحويل أسعار المنتج الافتراضية مطابق للقيم المحفوظة:

```text
187.72 × 55 = 10,324.60 EGP
281.58 × 55 = 15,486.90 EGP
375.44 × 55 = 20,649.20 EGP
```

### إعادة بناء توزيع المصروفات من الأسعار المحفوظة

مجموع أسعار الأسطر الأصلية المحفوظة هو:

```text
87.72 + 131.58 + 175.44 = 394.74 USD
```

الزيادات النهائية على الأسطر هي:

```text
187.72 − 87.72 = 100.00 USD
281.58 − 131.58 = 150.00 USD
375.44 − 175.44 = 200.00 USD
إجمالي الزيادة = 450.00 USD = 24,750 EGP
```

وهذه الزيادات تتبع نسب الأسعار الأصلية بدقة تقريبًا:

```text
100 ÷ 450 = 22.2222%
150 ÷ 450 = 33.3333%
200 ÷ 450 = 44.4444%
```

أي أن النظام حمّل كل سطر بحصة تتناسب مع قيمته الأصلية من مجموع الأسطر 394.74 USD. مثال المنتج الأول:

```text
نسبة المنتج الأول = 87.72 ÷ 394.74 ≈ 22.2222%
حصة المصروف = 450 USD × 22.2222% = 100 USD
تكلفة الوحدة النهائية = 87.72 + 100 = 187.72 USD قبل ضريبة الصنف
سعر المنتج الأساسي = 187.72 × 55 = 10,324.60 EGP
```

## الحالات المطلوبة بحسب عملة المصاريف

افترض أن العملة الأساسية EGP، وعملة الفاتورة USD، وسعر صرف الفاتورة 55 EGP/USD. إذا كانت المصاريف من نوع `product`، فهذه طريقة التعامل معها:

### جميع المصاريف بالعملة الأساسية

مثال: جمارك 1,000 EGP، وشحن 500 EGP.

```text
الإجمالي الأساسي = 1,000 + 500 = 1,500 EGP
المكافئ بعملة الفاتورة = 1,500 ÷ 55 ≈ 27.2727 USD
```

يوزع النظام قيمة 1,500 EGP على المنتجات وفق نسبة كل سطر؛ ثم يحول حصة الوحدة إلى USD لإضافتها إلى سعر السطر المعروض بعملة الفاتورة. وعند تحديث سعر المنتج يحول التكلفة النهائية مرة أخرى إلى EGP بسعر صرف الفاتورة.

### جزء بالأساس وجزء بعملة الفاتورة

مثال: 1,000 EGP جمارك + 20 USD شحن.

```text
1,000 EGP + (20 USD × 55) = 2,100 EGP
المكافئ بعملة الفاتورة = 2,100 ÷ 55 = 38.1818 USD تقريبًا
```

يوزع مجموع 2,100 EGP على أسطر المنتجات بحسب نسب قيمها الأصلية.

### جميع المصاريف بعملة الفاتورة

مثال: 40 USD رسوم.

```text
40 USD × 55 = 2,200 EGP
```

يوزع النظام ما يعادل 2,200 EGP على المنتجات، ثم يضيف حصة كل وحدة لسعرها بعملة الفاتورة. تكلفة المنتج الافتراضية تُحفظ لاحقًا بالـ EGP.

### المصروف بعملة أجنبية ثالثة

إذا كانت الفاتورة USD والمصروف EUR مثلًا، لا يستخدم النظام سعر USD للـ EUR؛ يسجل سعر العملة الثالثة المخزن في جدول العملات، ثم يحول الناتج إلى العملة الأساسية. بعد ذلك يحسب المكافئ بعملة الفاتورة لقيمة إجمالي الفاتورة عند الحاجة.

> ملاحظة: عند اختيار `expense` بدل `product`، قيمة المصروف لا تضاف إلى أسعار المنتجات في أي من الحالات أعلاه؛ تدخل في حساب إجمالي الفاتورة فقط.

## كيف تظهر النتيجة في نافذة المنتج؟

نافذة تفاصيل المنتج في `/products` تعرض سعر الشراء الافتراضي قبل ضريبة الصنف، وتعرض سعرًا شاملًا للضريبة منفصلًا:

- `default_purchase_price`: السعر الأساسي النهائي قبل ضريبة الصنف. تحدّث في هذه الفاتورة إلى 10,324.60 و15,486.90 و20,649.20 EGP.
- `dpp_inc_tax`: السعر الافتراضي شامل ضريبة المنتج، ويحسبه النظام من سعر الشراء الافتراضي ونسبة ضريبة المنتج المسجلة على المنتج. لا يساوي بالضرورة تحويل `purchase_price_inc_tax` من سطر هذه الفاتورة، لأن تحديث الافتراضي يأخذ `purchase_price` قبل ضريبة الصنف.
- عرض العملة الأجنبية: نافذة المنتج تجلب أحدث سطر شراء مستلم بعملة أجنبية لكل متغير منتج، وتعرض سعر السطر وسعر صرف تلك الفاتورة بجوار السعر الأساسي. هذا عرض مرجعي من أحدث فاتورة أجنبية، أما سعر الشراء الافتراضي المخزن فيبقى بالعملة الأساسية.

## ملاحظات تدقيق على الفاتورة 1386

### 1. إجمالي السطور لا يطابق `total_before_tax`

من أسعار السطور الأصلية المحفوظة:

```text
مجموع السطور = 87.72 + 131.58 + 175.44 = 394.74 USD
```

لكن رأس الفاتورة يسجل:

```text
total_before_tax = 450 USD
الفرق = 450 − 394.74 = 55.26 USD
```

كما أن رأس الفاتورة يسجل خصمًا ثابتًا قدره 30 USD، لكن حقول `pp_without_discount` وأسعار «قبل المصاريف» لا تُظهر خصمًا موزعًا؛ نسبة الخصم لكل سطر 0%. لذلك بيانات الرأس والسطور لا تتصالح حسابيًا بالكامل.

### 2. `final_total` لا يتطابق مع إعادة جمع الحقول الظاهرة

بحسب الحقول التقليدية الظاهرة في رأس الفاتورة، وقبل أي تعامل إضافي مع المصروفات المخصصة:

```text
450 − 30 + 0 ضريبة + 0 شحن + 0 مصاريف تقليدية = 420 USD
```

أما `final_total` المسجل فهو 870 USD، أي أعلى بـ **450 USD**، وهو يساوي مجموع المصاريف المخصصة بعد تحويلها إلى USD بسعر الفاتورة. هذا يتفق مع أن المصاريف المخصصة أُضيفت إلى إجمالي الفاتورة مرة واحدة.

لكن عند استخدام أسعار صرف العملات الحالية في جدول العملات، USD مخزن بسعر 51.3749، في حين أن الفاتورة تحتفظ بسعر 55. لحساب هذه الفاتورة، النظام يستخدم سعر الفاتورة 55 للمصروف المسجل بعملة الفاتورة؛ وتحديث سعر المنتج كذلك يستخدم 55.

### 3. إجمالي الزيادات الموزعة يساوي مجموع المصاريف المخصصة

الزيادة على أسعار المنتجات قبل الضريبة هي 450 USD، أي 24,750 EGP. هذا يطابق مجموع المصروفين المحولين إلى EGP. لا توجد مصاريف تقليدية إضافية محملة على هذه الأسعار.

## خلاصة عملية

في الفاتورة 1386، المصروفان «جمارك» و«شحن دولي» كلاهما من طريقة `product`، فتم تحويلهما إلى EGP ثم توزيع ما يعادلهما على المنتجات بحسب قيمة كل سطر الأصلية. ارتفعت تكلفة المنتجات قبل ضريبة الصنف بمجموع 450 USD. ولأن الفاتورة مستلمة، حُولت الأسعار النهائية بسعر الفاتورة 55 إلى EGP وتحدثت أسعار الشراء الافتراضية في نافذة المنتج.

إذا كان الهدف مراجعة صحة إجمالي الفاتورة، فتحتاج هذه الفاتورة إلى تفسير فرق **55.26 USD** بين مجموع أسعار السطور الأصلية وإجمالي رأس الفاتورة، وكذلك التحقق من سبب تسجيل خصم 30 USD في الرأس مع أن أسطر الشراء لا تعرض خصمًا مطبقًا. لم تُجر أي تسوية على السجل.
