# أهلا بك
يرجى طلب العرض التوضيحي info@citssoft.com
يرجى زيارة البرنامج: https://hgreservation.com/pos/public/home

ودعم حل الفاتورة الإلكترونية الخاص بنا مع أي نوع من البرامج لتسهيل عملك مع تجميع ZATCA.

مرحبًا بكم في حل الفواتير الإلكترونية من CITSSOFT - حل الفواتير الإلكترونية المتوافق مع ZATCA والذي سيجعل عملك متوافقًا مع قواعد وأنظمة الفوترة الإلكترونية ZATCA للمرحلة الأولى والمرحلة الثانية

فلنبدأ معنا

للبدء ، يرجى إنشاء حساب في منصة CITSSOFT E-Invoicing بالضغط هنا.

1. أنشئ حسابًا بالحقول التالية:

- اسم
- بريد إلكتروني
- كلمة المرور
- تأكيد كلمة المرور

2. إنشاء مفتاح API

انتقل إلى قسم API وانقر فوق إنشاء مفتاح API

# توثيق API

عنوان URL الأساسي: https://einvoicing.citssoft.com/api

## Onboarding API:

URL: / التكامل / على متن الطائرة

الحقول المطلوبة:

- legal_registration_name: الاسم التجاري كما هو مسجل في الحكومة
- ضريبة القيمة المضافة: 15 رقم ضريبة القيمة المضافة للأعمال
- crn: رقم السجل التجاري للأعمال
- الصناعة: وصف صغير لنوع الصناعة أو shsop
- الموقع: العنوان أو الموقع في سطر واحد
- otp: رقم OTP المكون من 6 أرقام تم الحصول عليه من بوابة ZATCA ERAD

عينة CURL:

curl -X POST https://einvoicing.citssoft.com/api/integration/onboard \
- ح 'الإذن: '\
-h "نوع المحتوى: application / json" \
-د '{
"legal_registration_name": "CITSSOFT"،
"ضريبة القيمة المضافة": "312345678900003"،
"crn": "123456789"،
"صناعة": "متجر" ،
"الموقع": "citssoft.com" ،
"otp": 575757
} "

إخراج العينة:

{
lE9PQ == "،

"comp_secret": "7nNBCnRkSIi + rNipjsJxJNPYCVgFaa1HpbTzXYEQTco ="،
"comp_request_id": 1234567890123 ،


"prod_secret": "f9YRhopN / G7x0TECOY6nKSCHLNYlb5riAHSFPICo4qw ="،
"prod_request_id": 30368
}

## فاتورة API:

URL: / الفاتورة / المبسط الفاتورة - للفاتورة المبسطة (b2c)
URL: / فاتورة / أبسط كريدت - لإشعار دائن مبسط (b2c)
URL: / الفاتورة / المبسطة - لإشعار الخصم المبسط (b2c)
URL: / invoice / standardInvoice - للفاتورة القياسية (b2b)
URL: / invoice / standardCredit - للإشعار الدائن القياسي (b2b)
URL: / invoice / standardDebit - لملاحظة الخصم القياسية (b2b)

عينة CURL:

curl -X POST https://einvoicing.citssoft.com/api/invoice/simplifiedInvoice \
- ح 'الإذن: '\
-h "نوع المحتوى: application / json" \
-د '{

"prod_secret": "f9YRhopN / G7x0TECOY6nKSCHLNYlb5riAHSFPICo4qw ="،
"invoice_no": "0024"،
"issue_date_time": "2022-11-26 12:53:00"،
"icv": "10"،
"pih": "Fv64wF9voDs26nIUfPg + OvSy9w2gc0SMLapXZt68 + jg ="،
"المورد": {
"legal_registration_name": "CITSSOFT"،
"vat_no": "312345678900003" ،