> ## Documentation Index
> Fetch the complete documentation index at: https://help.kwentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تكامل Kwentra مع بوابة الفاتورة الإلكترونية لمصلحة الضرائب المصرية

> يرسل Kwentra فواتيرك بعد المغادرة إلى بوابة الفاتورة الإلكترونية لمصلحة الضرائب المصرية (ETA) تلقائياً. الإعداد والحالات وإعادة الإرسال والسجلات.

يرسل Kwentra فواتيرك بعد المغادرة إلى بوابة الفاتورة الإلكترونية لمصلحة الضرائب المصرية (ETA) تلقائياً.

### **ما هي بوابة الفاتورة الإلكترونية؟**

* بدأت مصلحة الضرائب المصرية تبادل الفواتير إلكترونياً في نوفمبر 2020.
* تتابع البوابة المبيعات بين الشركات (B2B) بتبادل بيانات الفواتير رقمياً.
* بدأت بفواتير B2B. تبعتها فواتير البيع للمستهلك (B2C).
* كل الفنادق الآن ملزمة بتقديم فواتيرها على البوابة.

يتصل Kwentra مباشرة بالبوابة الحكومية، مربوطاً بحسابك عليها. يرسل فواتيرك بعد المغادرة نيابةً عنك.

### **كيف يعمل**

1. يُسجَّل خروج الحجز.
2. ينشئ Kwentra الفوليو النهائي المتسلسل.
3. يرسله Kwentra إلى البوابة في أوقات ثابتة تختارها.

| **Where:** Front Office → Settings Gear Sign → Integrations → ETA |
| - |

#### **قبل التواصل مع دعم Kwentra**

تحتاج إلى:

* اسم مستخدم وكلمة مرور مسجّلين على [بوابة ETA](https://id.eta.gov.eg/).
* شريحة ETA (USB) ورمز PIN للبطاقة الذكية. يُستخدم الرمز لتوقيع الفواتير إلكترونياً.
* أكواد منتجاتك مسجّلة على البوابة من [صفحة استخدامات الأكواد](https://invoicing.eta.gov.eg/codeusages).

لتسجيل أكواد المنتجات، اضغط **bulk usages** في تلك الصفحة. نزّل القالب واملأ أكوادك. تعرض الصور أمثلة على أكواد المنتجات.

<img src="https://mintcdn.com/kwentra/_A00lzToQoxuud5b/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/0eef5d9cdc.png?fit=max&auto=format&n=_A00lzToQoxuud5b&q=85&s=82d66de4aafd022500b41a371b489f96" alt="صفحة bulk usages في بوابة ETA" width="1920" height="943" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/0eef5d9cdc.png" />

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/a2473d66c9.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=b8bbc7557078f23b17ce03db386afb1d" alt="أمثلة على أكواد المنتجات في بوابة ETA" width="1920" height="943" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/a2473d66c9.png" />

#### **ما يحتاجه دعم Kwentra منك**

1. [تطبيق Kwentra compliance companion](https://drive.google.com/file/d/1d3UmNxtm3Ffvdud0lPs11468Q84dxrXh/view?usp=sharing)، مثبّتاً على الكمبيوتر الذي يرفع الفواتير.
2. اسم المستخدم وكلمة المرور للمستخدم الذي يرسل الفواتير إلى البوابة.
3. رمز PIN للبطاقة الذكية المستخدم في التوقيع الإلكتروني.
4. Client ID وClient Secret 1 وClient Secret 2 من بوابتك.
5. كود الفرع وكود النشاط من بوابتك.
6. ملف Excel يربط أكواد المنتجات في البوابة بأقسام الإيراد في Kwentra.
7. رقم التسجيل الضريبي من البوابة.
8. عنوان فندقك، كما يظهر على البوابة تماماً.

ثم:

* جهّز وصول AnyDesk إلى الكمبيوتر الذي يرفع الفواتير.
* صِل الشريحة بذلك الكمبيوتر.
* اطلب من فريق الدعم العمل معك خطوة بخطوة حتى يعمل التكامل.

#### **ما الذي يُفشل الفاتورة؟**

عرّف كل موظفي الحجوزات والمكاتب الأمامية والحسابات المدينة بهذه القواعد. إذا أُهملت، تفشل الفواتير أو تصبح غير صالحة.

**ربط أكواد المنتجات (أكواد إيراد Kwentra بأكواد منتجات ETA)**

* إذا ربطت قسم إيراد بعد إنشاء الفوليو، لا يصل التغيير إلى ETA.
* إذا ربطت قسماً بكود منتج خاطئ، تصبح الفاتورة **Invalid**.

**ملفات النزلاء**

* املأ حقلاً واحداً على الأقل في قسم **Identification**. بدون ذلك لا يُنشأ الفوليو.
* للمصريين، يستخدم النظام ID Number، ثم Driver License، ثم Passport. تتحقق ETA من صحة الرقم.
* لغير المصريين، يستخدم النظام Passport، ثم ID Number، ثم Driver License. تتحقق ETA من وجود قيمة.
* لا يُنشأ فوليو بدون بيانات الملف. البيانات العشوائية تجعل الفوليو **Invalid**.

| قسم ملف النزيل | الحقول |
| - | - |
| Personal Info | Full Name, Nationality |
| Identification | ID Number, Passport ID, Driver's Licence |
| Contact Information | Address, City, Country, Zip Code |

**ملفات القنوات والشركات (منظمو الرحلات والشركات)**

* املأ الحقول أدناه حتى لو لم يكن بلد القناة مصر.
* إذا كان البلد مصر، يجب أن يطابق رقم التسجيل الضريبي الرقم الرسمي في مصر.
* لفواتير Paymaster، املأ بيانات أول فرع في ملف القناة.
* لفواتير حسابات المدينين، املأ بيانات فرع القناة المرتبط بالحساب المدين.

| قسم ملف القناة | الحقول |
| - | - |
| Branch Profile | Country, Address, City, VAT Number |

| **مهم:** تطلب ETA كل ما سبق. إذا نقص أي عنصر، يفشل رفع الفاتورة. |
| - |

#### **إرسال الفواتير الآن**

استخدم **Submit Invoice Data** في تطبيق Kwentra compliance companion. يرسل الفواتير الآن، دون انتظار موعد الرفع التالي.

<img src="https://mintcdn.com/kwentra/_A00lzToQoxuud5b/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/0c70decbb5.jpg?fit=max&auto=format&n=_A00lzToQoxuud5b&q=85&s=cee9cc7463dd20eaeeda64f77f3646ab" alt="Submit Invoice Data في تطبيق compliance companion" width="1920" height="1080" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/0c70decbb5.jpg" />

#### **استبعاد فواتير قبل إرسالها**

استخدم **Exclude Folio** على الفواتير المعلقة. تُتخطّى عندها في الرفع التالي.

| **Where:** Front Office → Settings Gear Sign → Integrations → ETA → Status |
| - |

1. ابحث عن الفواتير المعلقة.
2. حدّد الخانات في عمود **Exclude Folio**.
3. اضغط **Apply**.

تتغير الحالة من **Pending** إلى **Excluded**.

<img src="https://mintcdn.com/kwentra/_A00lzToQoxuud5b/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/2a7ad95c85.png?fit=max&auto=format&n=_A00lzToQoxuud5b&q=85&s=92211e971a21cb773d13fd67646c159c" alt="عمود Exclude Folio في شاشة ETA Status" width="1920" height="943" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/2a7ad95c85.png" />

#### **حالات الفاتورة**

| **الحالة** | **المعنى** |
| - | - |
| Pending | أُنشئت من المكاتب الأمامية أو الحسابات المدينة. تنتظر الرفع التالي. |
| Submitted | أُرسلت إلى البوابة. تنتظر رد البوابة. |
| Valid | قبلت البوابة الفاتورة. |
| Invalid | وجدت البوابة مشكلة في بيانات الفاتورة. راجع الفاتورة على البوابة لتعرف السبب. |
| Failed | لم تُرسَل بسبب خطأ في البيانات من جهة Kwentra. أصلحه، ثم أعد إرسالها في الرفع التالي. |
| Retrying | فاتورة فاشلة يُعاد إرسالها. يستمر النظام في المحاولة. إذا فشلت كل المحاولات، تعود إلى **Failed**. |
| Cancelled | أُلغيت مباشرة على البوابة. |
| Rejected | رفضها النزيل أو منظم الرحلات على البوابة. |
| Excluded | استبعدها أحد الموظفين، فلا تُرسَل إلى البوابة. |

## ***تحديث: 11 ديسمبر 2022***

### **إعادة إرسال الفواتير الفاشلة أو غير الصالحة**

اعرف مشكلة الفاتورة أولاً وأصلحها. ثم أعد إرسالها.

* الفواتير **Failed**: استخدم **Retry all failed on next interval**.
* الفواتير **Invalid**، أو التي حالتها فارغة: استخدم **Resend Folios**.

| **Where:** Front Office → Folios → Select Folios → Actions → Resend Folios |
| - |

1. حدّد الفوليوهات المطلوبة، في الخانات يسار **Reservation/Paymaster ID**.
2. اضغط **Actions**.
3. اضغط **Resend Folios**.

**ملاحظات مهمة**

* إذا أعدت إرسال فاتورة أُرسلت من قبل، تظهر الرسالة: "Folios already submitted will be automatically excluded from selection".
* هذه الخطوات تعمل فقط للفواتير **Invalid** أو التي حالتها فارغة.
* لا تعمل قبل أن تصلح المشكلة التي أفشلت الفاتورة.
* لا يتغير تاريخ الفاتورة عند إعادة الإرسال. تُحدَّث بيانات الفاتورة فقط.

<img src="https://mintcdn.com/kwentra/_A00lzToQoxuud5b/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/03b9e9b38b.png?fit=max&auto=format&n=_A00lzToQoxuud5b&q=85&s=99256cac359a2bac4c2bb5b6d75991a2" alt="Resend Folios في قائمة Actions للفوليوهات" width="1920" height="943" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/03b9e9b38b.png" />

### **اعرف سبب فشل الفاتورة: شاشة السجلات**

تعرض شاشة **Logs** الخاصة بـ ETA:

* هل قبلت بوابة ETA الفاتورة.
* سبب عدم صلاحية الفاتورة. لا تحتاج لفتح البوابة.

| **Where:** Front Office → Settings Gear Sign → Integrations → ETA → Logs |
| - |

<img src="https://mintcdn.com/kwentra/_A00lzToQoxuud5b/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/1601d48ed6.png?fit=max&auto=format&n=_A00lzToQoxuud5b&q=85&s=27e10923b9cf944dcc84d1a867e5c2e3" alt="شاشة سجلات ETA" width="1920" height="943" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/1601d48ed6.png" />

ابحث حسب:

* تاريخ ووقت البداية والنهاية.
* حالة الطلب. **200** أخضر (نجاح). أي رقم آخر خطأ.
* الوصف: قيد تسجيل دخول أو قيد إرسال فاتورة.
* رقم الفوليو: رقم الفوليو في Kwentra.

**أعمدة السجل**

| **العمود** | **المعنى** |
| - | - |
| Date/time | وقت إنشاء قيد السجل. |
| Description | قيد تسجيل دخول أو قيد إرسال فاتورة. |
| Request | ما أرسله Kwentra إلى ETA. |
| Response | ما ردّت به ETA: مقبولة أو غير صالحة. |
| Status | الأحمر خطأ. الأخضر صالح. |
| Folio numbers | رقم الفاتورة في ETA ورقم الفاتورة في Kwentra. |

**اعرف سبب عدم صلاحية الفاتورة**

عندما ترى قيد إرسال أحمر، اضغط رابط **Response**. يعرض الخطأ الخاص بتلك الفاتورة.

<video autoPlay loop muted playsInline className="w-full rounded-md" src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/d07e112a9f.mp4?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=17dd8fddb629191be8b3c3bc36b6f2e4" data-path="images/compliance-integrations/kwentra-egyptian-tax-authority-einvoicing-portal-integration/d07e112a9f.mp4" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.