সৌদি আরবের জন্য ধাপে ধাপে ই-ইনভয়েসিং ইন্টিগ্রেশন ফ্রেমওয়ার্ক
সর্বশেষ আপডেট: ৩০ মার্চ, ২০২৬
ZATCA (জাকাত, ট্যাক্স ও কাস্টমস কর্তৃপক্ষ) ফেজ ২ সৌদি আরবের সকল ট্যাক্সেবল ব্যবসাকে ইলেকট্রনিক ইনভয়েসিংয়ের জন্য তাদের সিস্টেম একীভূত করতে বাধ্য করে। এই বিস্তৃত গাইডে CSD সার্টিফিকেট থেকে এপিআই ইন্টিগ্রেশন পর্যন্ত সবকিছু কভার করা হয়েছে।
আপনার POS সিস্টেম লিঙ্ক করতে ZATCA ফাতুরা পোর্টালের মাধ্যমে CSR জেনারেট করুন।
بدء الربط: إنشاء طلب توقيع الشهادة (CSR) من خلال بوابة فاتورة لربط نظامك.
UUID, হ্যাশ এবং QR কোড সহ UBL 2.1 XML ফরম্যাটে ইনভয়েস তৈরি করতে হবে।
إنشاء ملف XML: يجب إنشاء الفواتير بتنسيق UBL 2.1 بما في ذلك الـ UUID والهاش والرمز.
QR অবশ্যই Base64 এনকোডেড TLV হতে হবে। আপনার QR এনকোডিং যাচাই করতে আমাদের হোম পেজ টুল ব্যবহার করুন।
معايير الرمز: يجب أن يكون الرمز مشفرًا بتنسيق Base64 TLV. استخدم أدواتنا للفحص.
সমস্ত সরলীকৃত ট্যাক্স ইনভয়েস জারির ২৪ ঘণ্টার মধ্যে রিপোর্ট করতে হবে।
الإبلاغ اللحظي: يجب الإبلاغ عن جميع الفواتير الضريبية المبسطة في غضون 24 ساعة.
ফেজ ২ হল বাধ্যতামূলক ইন্টিগ্রেশন পর্যায় যেখানে ট্যাক্সপেয়ারদের তাদের সিস্টেম সরাসরি ZATCA-এর ফাতুরা পোর্টালের সাথে API-এর মাধ্যমে সংযুক্ত করতে হবে। ফেজ ১-এর বিপরীতে (যেখানে শুধু ইনভয়েসে QR কোড প্রয়োজন ছিল), ফেজ ২-এর জন্য রিয়েল-টাইম বা প্রায়-রিয়েল-টাইমে ইনভয়েস ডেটা জমা দিতে হবে।
ফেজ ২-এর জন্য CSD সার্টিফিকেট বাধ্যতামূলক। এটি ইনভয়েসের ডিজিটাল স্বাক্ষর এবং ক্রিপ্টোগ্রাফিক স্ট্যাম্পিং সক্ষম করে। আপনাকে এটি Geotrust বা Digicert-এর মতো ZATCA-অনুমোদিত প্রদানকারীদের কাছ থেকে নিতে হবে।
সমস্ত ইনভয়েস প্রমিত UBL 2.1 XML ফরম্যাটে তৈরি করতে হবে। এতে বিক্রেতা/ক্রেতার বিবরণ, লাইন আইটেম, ভ্যাট পরিমাণ এবং ক্রিপ্টোগ্রাফিক স্ট্যাম্পের জন্য নির্দিষ্ট ফিল্ড অন্তর্ভুক্ত থাকে।
QR কোডে অবশ্যই TLV ফরম্যাটে এনকোডেড এবং তারপর Base64 এনকোডেড একটি ক্রিপ্টোগ্রাফিক স্ট্যাম্প থাকতে হবে। এতে বিক্রেতার নাম, TRN, টাইমস্ট্যাম্প, ইনভয়েস টোটাল, ভ্যাট পরিমাণ এবং ডিজিটাল স্বাক্ষর অন্তর্ভুক্ত থাকে।
ক্লিয়ারেন্স মডেল (B2B): ক্রেতা ইনভয়েস পাওয়ার আগে ZATCA দ্বারা রিয়েল-টাইম ভ্যালিডেশন। রিপোর্টিং মডেল (B2C): ইস্যুর ২৪ ঘণ্টার মধ্যে জমা দিন। আপনার লেনদেনের ধরন অনুযায়ী নির্বাচন করুন।
ধাপ ১: ZATCA ফাতুরা পোর্টালে নিবন্ধন করুন। ধাপ ২: CSR জেনারেট করুন এবং CSD সার্টিফিকেট প্রাপ্ত করুন। ধাপ ৩: এপিআই ক্রেডেনশিয়াল জেনারেট করুন। ধাপ ৪: UBL 2.1 ফরম্যাটে XML জেনারেশন বাস্তবায়ন করুন। ধাপ ৫: TLV এনকোডিং সহ QR কোড জেনারেশন বাস্তবায়ন করুন। ধাপ ৬: ZATCA স্যান্ডবক্সে সব এপিআই পরীক্ষা করুন। ধাপ ৭: প্রোডাকশন অ্যাক্সেসের জন্য আবেদন করুন। ধাপ ৮: ক্লিয়ারেন্স বা রিপোর্টিং মডেল নিয়ে লাইভ যান।
| Endpoint Name | URL | Method |
|---|---|---|
| ক্লিয়ারেন্স (B2B) | https://api.fatoora.zatca.gov.sa/api/v1/invoice/clearance | POST |
| রিপোর্টিং (B2C) | https://api.fatoora.zatca.gov.sa/api/v1/invoice/reporting | POST |
| CSR জেনারেশন | https://api.fatoora.zatca.gov.sa/api/v1/csr | POST |
| কমপ্লায়েন্স চেক | https://sandbox.fatoora.zatca.gov.sa/api/v1/compliance | POST |
A: সময়সীমা ব্যবসার আয় অনুযায়ী পরিবর্তিত হয়। বড় ট্যাক্সপেয়ারদের (SAR ৩ মিলিয়নের বেশি) আগের সময়সীমা থাকে। ছোট ও মাঝারি ব্যবসার জন্য সময়সীমা বর্ধিত। আপনার নির্দিষ্ট তারিখের জন্য ZATCA পোর্টাল চেক করুন।
A: হ্যাঁ, যদি না আপনার POS প্রদানকারী বিল্ট-ইন ZATCA ইন্টিগ্রেশন অফার করে। এপিআই ডেভেলপমেন্টের জন্য PHP, REST API, XML জেনারেশন এবং ক্রিপ্টোগ্রাফিতে টেকনিক্যাল দক্ষতা প্রয়োজন।
A: না। বিনামূল্যের SSL সার্টিফিকেট (যেমন Let's Encrypt) গ্রহণযোগ্য নয়। আপনাকে Geotrust বা Digicert-এর মতো ZATCA-অনুমোদিত প্রদানকারীদের কাছ থেকে অর্থপ্রদত্ত CSD সার্টিফিকেট কিনতে হবে।
A: ZATCA ৫০,০০০ SAR পর্যন্ত জরিমানা আরোপ করতে পারে এবং আপনার ই-ইনভয়েসিং সুবিধা স্থগিত করতে পারে। আপনার ব্যবসা কমপ্লায়েন্ট ই-ইনভয়েস ইস্যু করতে পারবে না।
A: সাধারণত অনুমোদিত প্রদানকারীর কাছে প্রয়োজনীয় নথি জমা দেওয়ার পরে ৫-১০ কার্যদিবস। আপনার ইন্টিগ্রেশন ডেডলাইনের আগে পরিকল্পনা করুন।
A: ZATCA https://sandbox.fatoora.zatca.gov.sa-এ একটি স্যান্ডবক্স (সিমুলেশন) পরিবেশ প্রদান করে। লাইভে যাওয়ার আগে সব এপিআই কল পরীক্ষা করুন।