ZATCA ই-ইনভয়েস QR (সৌদি FATOORA)
সৌদি আরবের ZATCA (যাকাত, কর ও শুল্ক কর্তৃপক্ষ) রাজ্যে জারি প্রতিটি ট্যাক্স ইনভয়েসে QR বাধ্যতামূলক করে। ফেজ 1 হল সরলীকৃত TLV; ফেজ 2 FATOORA প্ল্যাটফর্মের সাথে একীভূতকরণের মাধ্যমে ক্রিপ্টোগ্রাফিক সিলিং যোগ করে। অ-সম্মত ইনভয়েস ক্রেতার অ্যাকাউন্টিং সফ্টওয়্যার প্রত্যাখ্যান করে এবং VAT দাবির জন্য অবৈধ।
ক্যানোনিক্যাল স্পেক:ZATCA ই-ইনভয়েসিং রেজোলিউশন ও বাস্তবায়ন বিধিমালা, 2026 পর্যন্ত বর্তমান।
ফেজ 1 (জেনারেশন): 4 ডিসেম্বর 2021 থেকে কার্যকর। VAT-নিবন্ধিত সকল ব্যবসা QR সহ ডিজিটাল ইনভয়েস ইস্যু করতে বাধ্য।
ফেজ 2 (ইন্টিগ্রেশন): 1 জানুয়ারি 2023 থেকে ব্যবসার আকার অনুযায়ী তরঙ্গে চালু হচ্ছে। স্ট্যান্ডার্ড ইনভয়েসের জন্য ডিজিটাল স্বাক্ষর + ZATCA ক্লিয়ারেন্স এবং সরলীকৃত ইনভয়েসের জন্য রিয়েল-টাইম রিপোর্টিং যোগ করে।
ফেজ 1 (জেনারেশন): 4 ডিসেম্বর 2021 থেকে কার্যকর। VAT-নিবন্ধিত সকল ব্যবসা QR সহ ডিজিটাল ইনভয়েস ইস্যু করতে বাধ্য।
ফেজ 2 (ইন্টিগ্রেশন): 1 জানুয়ারি 2023 থেকে ব্যবসার আকার অনুযায়ী তরঙ্গে চালু হচ্ছে। স্ট্যান্ডার্ড ইনভয়েসের জন্য ডিজিটাল স্বাক্ষর + ZATCA ক্লিয়ারেন্স এবং সরলীকৃত ইনভয়েসের জন্য রিয়েল-টাইম রিপোর্টিং যোগ করে।
এটি কী
QR একটি Base64 স্ট্রিং এনকোড করে। একটি নির্দিষ্ট ক্রমে 5টি বাধ্যতামূলক ক্ষেত্র সহ একটি বাইনারি TLV সিকোয়েন্স পেতে Base64 ডিকোড করুন:
| ট্যাগ | ক্ষেত্র | ধরন | নোট |
|---|---|---|---|
01 | বিক্রেতার নাম | UTF-8 স্ট্রিং | বিক্রেতার বাণিজ্যিক নাম। আরবি ও লাতিন উভয়ই গ্রহণযোগ্য। |
02 | VAT নিবন্ধন নম্বর | 15 অঙ্ক | সৌদি সত্তার জন্য 3 দিয়ে শুরু। ফরম্যাট: 3XXXXXXXXXXXXX3। |
03 | ইনভয়েস টাইমস্ট্যাম্প | ISO 8601 | যেমন 2026-04-18T10:30:00Z। টাইমজোন অন্তর্ভুক্ত করতে হবে। |
04 | ইনভয়েস মোট (VAT সহ) | দশমিক স্ট্রিং | যেমন 115.00। মুদ্রা অন্তর্নিহিতভাবে SAR। |
05 | VAT পরিমাণ | দশমিক স্ট্রিং | যেমন 15.00। বর্তমানে 15% স্ট্যান্ডার্ড রেট। |
06 | ইনভয়েস হ্যাশ (ফেজ 2) | Base64 SHA-256 | ক্যানোনিক্যাল ইনভয়েস XML-এর SHA-256। |
07 | ডিজিটাল স্বাক্ষর (ফেজ 2) | Base64 | বিক্রেতার CSID সার্টিফিকেট ব্যবহার করে ইনভয়েস হ্যাশের উপর ECDSA। |
08 | পাবলিক কী (ফেজ 2) | Base64 X.509 | বিক্রেতার ECDSA পাবলিক কী (CSID থেকে)। |
09 | ZATCA স্ট্যাম্প (ফেজ 2) | Base64 | ZATCA-এর কাউন্টারসিগনেচার। ZATCA ক্লিয়ারেন্সের পরে কেবল উপস্থিত। |
প্রতিটি TLV রেকর্ড হল 1টি ট্যাগ বাইট + 1টি দৈর্ঘ্য বাইট + <দৈর্ঘ্য> মান বাইট। পুরো সিকোয়েন্সটি তখন QR পেলোড হওয়ার জন্য Base64-এনকোড করা হয়।
ফেজ 1 (সরলীকৃত) বনাম ফেজ 2 (ইন্টিগ্রেশন)
| দিক | ফেজ 1 | ফেজ 2 |
|---|---|---|
| QR বিষয়বস্তু | শুধু ট্যাগ 01–05 | ট্যাগ 01–05 এর সাথে 06, 07, 08, ঐচ্ছিকভাবে 09 |
| ZATCA ইন্টিগ্রেশন | কিছু নেই, অফলাইন | সরলীকৃত ইনভয়েসের জন্য রিয়েল-টাইম API, স্ট্যান্ডার্ড ইনভয়েসের জন্য ক্লিয়ারেন্স ফ্লো |
| সার্টিফিকেট প্রয়োজন | না | হ্যাঁ, ZATCA কর্তৃক জারি CSID (ক্রিপ্টোগ্রাফিক স্ট্যাম্প আইডেন্টিফায়ার) |
| কার্যকর তারিখ | 2021-12-04 (সব ব্যবসা) | 2023-01-01 (রাজস্ব অনুযায়ী তরঙ্গে) |
| ইনভয়েস সুযোগ | B2C (সরলীকৃত) + B2B (স্ট্যান্ডার্ড) | B2C সরলীকৃত: রিয়েল-টাইম রিপোর্ট। B2B স্ট্যান্ডার্ড: ইস্যুর আগে ক্লিয়ারেন্স (প্রি-ভ্যালিডেশন)। |
ক্যানোনিক্যাল টেস্ট ভেক্টর
উদাহরণ TLV (Base64-এর আগে):
01 0A "Acme Saudi" 02 0F "300000000000003" 03 14 "2026-04-18T10:30:00Z" 04 06 "115.00" 05 05 "15.00"Base64 এনকোডিংয়ের পরে:
AQpBY21lIFNhdWRpAg8zMDAwMDAwMDAwMDAwMDMDFDIwMjYtMDQtMThUMTA6MzA6MDBaBAYxMTUuMDAFBTE1LjAw| কেস | ইনপুট | Base64 প্রিফিক্স |
|---|---|---|
| ফেজ 1, ন্যূনতম সরলীকৃত | seller=Acme Saudi | AQpBY21lIFNhdWRp... |
| আরবি বিক্রেতার নাম | seller=شركة أكمي | Base64-এর আগে TLV-এর ভেতরে বিক্রেতার নাম UTF-8-এনকোড করা। |
| ফেজ 2 স্ট্যান্ডার্ড ইনভয়েস | উপরের সব কিছুর সাথে hash=<SHA-256 Base64> | অনেক দীর্ঘ Base64। ডিকোডারদের অবশ্যই 05-এর পরে অতিরিক্ত ট্যাগ সহ্য করতে হবে। |
সাধারণ সমস্যা
- VAT নম্বরের দৈর্ঘ্য। ZATCA VAT নম্বর ঠিক 15 অঙ্কের,
3দিয়ে শুরু ও শেষ হয়। অন্য কিছু ইনভয়েস-ইনজেস্টশন পার্শ্বে বৈধতা ব্যর্থ করে। - টাইমজোন ছাড়া টাইমস্ট্যাম্প। স্পেক একটি স্পষ্ট জোন সহ ISO 8601 প্রয়োজন (
Zঅথবা+03:00)। নেইভ-লোকাল টাইমস্ট্যাম্প প্রত্যাখ্যাত। - এনকোডিং ক্রম। TLV ক্ষেত্রগুলি ট্যাগ-নম্বর ক্রমে (01, 02, 03, 04, 05, …) উপস্থিত হতে হবে। পুনরায় অর্ডার করলে QR সফলভাবে ডিকোড হয় কিন্তু কিছু যাচাইকারী এটিকে নন-ক্যানোনিক্যাল হিসেবে চিহ্নিত করে।
- দশমিক ফরম্যাট। ইনভয়েস মোট এবং VAT পরিমাণ ডট-দশমিক (
115.00) ব্যবহার করে, কমা-দশমিক (115,00) নয়। হাজারের বিভাজকও নেই। - মুদ্রা অন্তর্নিহিতভাবে SAR। বিদেশী মুদ্রার ইনভয়েস QR ক্ষেত্রের জন্য এখনও SAR-এ রূপান্তরিত হয়। অন্তর্নিহিত XML মূল মুদ্রা বহন করতে পারে; QR করে না।
- ফেজ 2 ক্লিয়ারেন্স ব্যর্থতা। ZATCA-এর ক্লিয়ারেন্স API-তে জমা দেওয়া একটি স্ট্যান্ডার্ড ইনভয়েস প্রত্যাখ্যাত হতে পারে (খারাপ CSID, ত্রুটিপূর্ণ XML, ভুল ট্যাক্স গণনা)। ক্লিয়ার না হওয়া পর্যন্ত ইনভয়েস আইনগতভাবে অবৈধ। এক্সপোনেনশিয়াল ব্যাক-অফ সহ একটি রিট্রি লুপ রাখুন; ক্লিয়ারেন্স সফল না হওয়া পর্যন্ত ইনভয়েস ইস্যু করবেন না।
- CSID সার্টিফিকেট রোটেশন। ফেজ 2 CSIDs মেয়াদোত্তীর্ণ হয় (সাধারণত 1 বছর)। আপনার ই-ইনভয়েসিং স্ট্যাকে একটি নবায়ন চেক তৈরি করুন নয়তো হঠাৎ ইনভয়েস ইস্যু করতে পারবেন না।
স্ক্যানার সামঞ্জস্যতা
| রিডার | সমর্থন | নোট |
|---|---|---|
| ZATCA FATOORA অ্যাপ | নেটিভ | অফিসিয়াল মন্ত্রণালয় অ্যাপ; ZATCA PKI-এর বিরুদ্ধে ফেজ 2 স্বাক্ষর যাচাই করে। |
| সৌদি অ্যাকাউন্টিং সফ্টওয়্যার (SAP B1, Oracle, Microsoft Dynamics) | নেটিভ (2023 পরবর্তী) | স্থানীয়করণ করা সৌদি বিল্ডে AP পাইপলাইনে ZATCA পার্সিং আছে। |
| iOS ক্যামেরা | রাও Base64 | ট্যাক্স ইনভয়েস হিসেবে স্বীকৃত নয়। ব্যবহারকারীকে FATOORA অ্যাপ খুলতে হবে। |
| Android ক্যামেরা / Google Lens | রাও Base64 | একই, কোনো নেটিভ পার্সিং নেই। |
| তৃতীয়-পক্ষ অডিট টুল (PwC, KPMG, Deloitte Saudi ইউনিট) | নেটিভ | অডিট-টেকনোলজি স্যুট ফেজ 2 স্বাক্ষর পার্স + যাচাই করে। |
আরও দেখুন
- /zatca-saudi-einvoice-qr-code/, জেনারেটর।
- /standards/, মানদণ্ড সূচকে ফিরে যান।
- ZATCA ডেভেলপার পোর্টাল, কর্তৃত্বপূর্ণ সম্পদ এবং FATOORA স্যান্ডবক্স।