VATMesh
اطلب وصولًا تجريبيًا افتح حسابًا
محتوى هذه الصفحة متاح بالفرنسية فقط حتى الآن. أما التنقل والنماذج وتذييل الصفحة فمترجمة بالفعل.
🇪🇬
القانون 206/2020 — المادة 5Law 206/2020 — Article 5

دليل التكامل مع SDK
مصلحة الضرائب المصرية (ETA) Egyptian Tax Authority
ETA SDK Integration Guide

كل ما تحتاج لمعرفته للتكامل مع منظومة الفاتورة الإلكترونية — من التسجيل حتى الإرسال الفعلي Everything you need to integrate with Egypt's e-invoicing platform — from registration to live submission

ETA API v1.0 UUID v4 e-Signature X.509 2026

# خطوات الإعداد والتسجيل في منظومة ETA ETA Onboarding Steps

وفقاً للمادة الخامسة من القانون رقم 206 لسنة 2020، يلزم التسجيل في منظومة الفاتورة الإلكترونية قبل إصدار أي فاتورة. إليك الخطوات الكاملة: Under Article 5 of Law 206/2020, taxpayers must register with the e-invoicing system before issuing any invoice. Here are the complete steps:

1

التسجيل في بوابة ETARegister on the ETA Portal

سجّل على invoicing.eta.gov.eg باستخدام رقمك الضريبي (TIN) المكوّن من 9 أرقام. يجب حضور الممثل القانوني مع صورة بطاقته الوطنية. Register at invoicing.eta.gov.eg using your 9-digit Tax Identification Number. The legal representative must present a national ID copy.

2

الحصول على شهادة التوقيع الإلكترونيObtain an e-Signature Certificate

احصل على شهادة توقيع إلكتروني معتمدة من مزود معتمد (MiSR أو Egypt Trust). يجب أن تكون متوافقة مع معيار X.509 v3 وصالحة لعام على الأقل. تُستخدم بخوارزمية RS256 أو ES256. Obtain an accredited e-signature certificate from an approved provider (MiSR or Egypt Trust). Must be X.509 v3 compliant, valid for at least one year, used with RS256 or ES256.

3

إنشاء بيانات اعتماد APIGenerate API Client Credentials

من لوحة تحكم ETA، أنشئ Client ID وClient Secret لاستخدامهما في OAuth 2.0. From the ETA dashboard, generate your Client ID and Client Secret for OAuth 2.0 authentication.

4

المصادقة والحصول على Access TokenAuthenticate & Obtain Access Token

POST https://id.eta.gov.eg/connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
5

إرسال الفواتير عبر APISubmit Invoices via API

نقطة نهاية الإرسال في بيئة الإنتاج: Production submission endpoint:

POST https://api.invoicing.eta.gov.eg/api/v1/documentsubmissions

# هيكل الفاتورة — UUID v4 وبنية JSON Invoice Structure — UUID v4 & JSON Schema

كل فاتورة إلكترونية يجب أن تحتوي على معرّف فريد UUID v4 يتم توليده من جانب المُصدِر. فيما يلي البنية الأساسية لمستند الفاتورة: Every e-invoice must contain a unique UUID v4 identifier generated by the issuer. Below is the core document structure: 

{
  "issuer": { "type": "B", "id": "123456789", "name": "شركة الأمثلة",
    "address": { "country": "EG", "governate": "Cairo", "regionCity": "Nasr City",
      "street": "26 July Corridor", "buildingNumber": "1", "branchID": "0" } },
  "receiver": { "type": "B", "id": "987654321", "name": "شركة العميل",
    "address": { "country": "EG" } },
  "documentType": "I",
  "documentTypeVersion": "1.0",
  "dateTimeIssued": "2026-09-12T17:10:00Z",
  "taxpayerActivityCode": "4711",
  "internalID": "INV-2026-0001",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "invoiceLines": [{
    "description": "خدمات استشارية", "itemType": "GS1",
    "itemCode": "10000010", "unitType": "EA", "quantity": 1,
    "unitValue": { "currencySold": "EGP", "amountEGP": 10000.00 },
    "taxableItems": [{ "taxType": "T1", "amount": 1400.00,
      "subType": "V009", "rate": 14 }]
  }],
  "totalAmount": 11400.00,
  "taxTotals": [{ "taxType": "T1", "amount": 1400.00 }],
  "signatures": [{ "signatureType": "I", "value": "BASE64_SIGNATURE_HERE" }]
}

# دورة حياة الفاتورة الإلكترونية Invoice Submission Lifecycle

SUBMITTED
مُرسَلInitial
→
VALID
صالحAccepted
→
INVALID
مرفوضRejected
→
CANCELLED
ملغيCancelled
SUBMITTED

الحالة الأولية — تجري ETA التحقق من صحة البيانات.Initial state — ETA is performing validation checks.

VALID

الفاتورة مقبولة وسارية قانونياً. يمكن الاعتراض خلال 7 أيام.Invoice accepted and legally valid. Receiver can reject within 7 days.

INVALID

رُفضت بسبب خطأ. يجب التصحيح وإعادة الإرسال كمستند جديد.Rejected due to errors. Correct and resubmit as a new document.

CANCELLED

تم الإلغاء من قِبل المُصدِر. لا يمكن الإلغاء بعد 24 ساعة من القبول.Cancelled by issuer. Cancellation not allowed after 24 hours from acceptance.

🔐 متطلبات التوقيع الإلكتروني🔐 e-Signature Certificate Requirements

المعيارStandard
X.509 v3 PKI
الخوارزميةAlgorithm
RS256 / ES256 (SHA-2)
مزودو الخدمة المعتمدونApproved Providers
MiSR, Egypt Trust, Nasser Social Bank
صلاحية الشهادةCertificate Validity
سنة واحدة كحد أدنىMinimum 1 year

# 🧮 أداة التحقق من TRN وتوليد نموذج UUID 🧮 TRN Validator + UUID Invoice Generator

أدخل رقمك الضريبي (9 أرقام) للتحقق من صحته وعرض نموذج JSON جاهز للإرسال. Enter your 9-digit Tax Registration Number to validate it and generate a sample UUID invoice JSON.

🚀

ابدأ مع VATMesh اليومGet Started with VATMesh Today

وفّر وقتك وتوافق تلقائياً مع متطلبات مصلحة الضرائب المصرية. VATMesh يتولى عنك كل تفاصيل التكامل مع ETA. Save time and stay automatically compliant with ETA requirements. VATMesh handles all ETA integration details for you.

ابدأ مجاناً — Solo EGStart Free — Solo EG بوابة ETA الرسمية ↗Official ETA Portal ↗

القانون 206/2020 — المادة الخامسة | api.invoicing.eta.gov.eg