راهنمای جامع اتصال به سامانه ملی فاکتور الکترونیک لهستان (Krajowy System e-Faktur - KSeF) در وبیتو
اجرای قانون سامانه ملی فاکتورهای الکترونیکی (Krajowy System e-Faktur یا به اختصار KSeF) توسط وزارت دارایی لهستان (Ministerstwo Finansów)، تحولی ساختاری و بنیادین در مدیریت مالیاتی و حسابداری کسبوکارهای فعال در لهستان ایجاد کرده است. بر اساس مقررات قانونی جدید، صدور فاکتورهای سنتی به صورت فایل PDF یا پرینت کاغذی برای مبادلات B2B منسوخ شده و تمامی فروشندگان ملزم هستند صورتحسابهای خود را به صورت سند ساختاریافته XML بر مبنای ساختار منطقی FA(2) مستقیماً به سرورهای مرکزی وزارت دارایی ارسال و تاییدیه رسمی دریافت کنند.
پلاگین رسمی KSeF E-Invoicing در وبیتو، فرآیند تبدیل صورتحساب سفارشهای فروشگاه به فرمت قانونی FA(2) XML، اعتبارسنجی الگوریتم Modulo-11 کد اقتصادی لهستان (NIP)، برقراری نشست امن دو مرحلهای (Authorisation Challenge)، و بایگانی شماره ۳۵ رقمی مرجع KSeF به همراه گواهی رسمی تحویل (UPO - Urzędowe Poświadczenie Odbioru) را به صورت کاملاً خودکار انجام میدهد.
۱. ارکان حقوقی و فنی سامانه KSeF در لهستان
شناخت الزامات کلیدی سامانه برای جلوگیری از جرایم سنگین مالیاتی ضروری است:
| مولفه سیستمی | الزامات قانونی و فنی سامانه KSeF | پیادهسازی در وبیتو |
|---|---|---|
| فرمت ساختار سند | استاندارد منطقی FA (2) مصوب وزارت دارایی | تولید خودکار سند XML با هدرها و تگهای مصوب |
| شناسه یکتای صورتحساب | شماره ۳۵ رقمی KSeF صادرشده توسط سرور مرکزی | استخراج و ثبت خودکار در تاریخچه سفارش |
| گواهی رسمی تحویل (UPO) | Urzędowe Poświadczenie Odbioru (سند معتبر دادگاهی) | تولید لینک مستقیم دانلود گواهی رسمی UPO |
| کد اقتصادی اشخاص (NIP) | شماره مالیاتی ۱۰ رقمی بر مبنای الگوریتم اعتبارسنجی Modulo-11 | اعتبارسنجی درونبرنامهای پیش از ارسال |
| تفکیک نرخهای مالیاتی | ۲۳٪ (استاندارد)، ۸٪، ۵٪، ۰٪، و معاف (zw) | تفکیک دقیق محاسبات مالیات در تگهای P_13 و P_14 |
| مشتریان حقیقی (B2C) | استفاده از برچسب قانونی <BrakID>1</BrakID> | تفکیک خودکار خرید شرکتی B2B از مشتری مصرفکننده |
۲. دیاگرام توالی احراز هویت و ارسال سند به سامانه مودیان لهستان
mermaidsequenceDiagram autonumber actor Admin as فروشگاه وبیتو participant Plugin as پلاگین KSeF وبیتو participant KSeF as سرور مرکزی وزارت دارایی (ksef.mf.gov.pl) participant Buyer as خریدار شرکتی (B2B) Admin->>Plugin: دستور صدور فاکتور رسمی سفارش Plugin->>Plugin: اعتبارسنجی کد NIP فروشنده و خریدار Plugin->>Plugin: تولید ساختار FA(2) XML با تفکیک مالیات Plugin->>KSeF: ۱. درخواست چالش امنیتی /online/Session/AuthorisationChallenge KSeF-->>Plugin: ارسال چالش با مهر زمانی Plugin->>KSeF: ۲. ثبت نشست با توکن محرمانه /online/Session/InitToken KSeF-->>Plugin: صدور توکن موقت نشست (SessionToken) Plugin->>KSeF: ۳. ارسال محموله XML صورتحساب /online/Invoice/Send KSeF-->>Plugin: تایید دریافت و صدور شناسه ۳۵ رقمی مرجع KSeF Plugin->>Admin: ذخیره شناسه KSeF و بایگانی سند Buyer->>KSeF: مشاهده و دانلود مستقیم فاکتور رسمی از کارپوشه ملی
۳. مدارک مورد نیاز و نحوه دریافت توکن KSeF
برای فعالسازی پلاگین در وبیتو:
- با استفاده از امضای دیجیتال معتبر (Profil Zaufany یا mObywatel یا گواهی الکترونیک مهر سازمانی) به پرتال مودیان وزارت دارایی لهستان به نشانی
ksef.mf.gov.plوارد شوید. - در بخش Tokeny (Tokens)، یک توکن مجوز با دسترسی صدور و ارسال فاکتور (
Wystawianie faktur) ایجاد کنید.
تنظیمات پلاگین در پنل وبیتو:
| عنوان فیلد | کلید فنی | الزامی؟ | توضیحات و راهنما | نمونه مقدار |
|---|---|---|---|---|
| کد مالیاتی فروشنده (NIP) | sellerNip | بله | کد ۱۰ رقمی بدون خط تیره ثبتشده در اداره مالیات | 5252344078 |
| توکن احراز هویت KSeF | authorizationToken | بله | توکن امنیتی تولیدشده در پرتال Aplikacja Podatnika | sec_ksef_token_abc123 |
| محیط سامانه | environment | بله | انتخاب بین test (آزمایشی)، demo (پیشتولید)، یا prod (سامانه زنده) | test / prod |
| نرخ پیشفرض مالیات VAT | defaultVatRate | خیر | نرخ پایه مالیات بر ارزش افزوده در لهستان (معمولاً ۲۳٪) | 23 / 8 / 5 / 0 / zw |
| ارسال خودکار پس از پرداخت | autoTransmitOnOrderPaid | خیر | صدور و ارسال آنی فاکتور به محض پرداخت موفق سفارش | true / false |
۴. جدول رفع خطاها و کدهای وضعیت سامane KSeF
| کد وضعیت / خطا | علت بروز خطا | اقدام اصلاحی در وبیتو |
|---|---|---|
415 / INVALID_NIP | کد مالیاتی فروشنده یا خریدار با الگوریتم Modulo-11 سازگار نیست. | بررسی صحت ۱۰ رقم کد NIP در مشخصات شرکت خریدار. |
400 / SCHEMA_ERROR | مقادیر جمع جبری اقلام یا مالیات با جمع کل فاکتور انطباق ندارد. | وبیتو به صورت خودکار گرد کردن ریال/زلوتی را با دقت دو رقم اعشار انجام میدهد. |
430 / DUPLICATE_NUMBER | فاکتوری با همین شماره سریال قبلاً در سال مالی جاری ثبت شده است. | سیستم شمارهگذاری فاکتورهای وبیتو ترتیبی و غیرتکراری است. |
SESSION_EXPIRED | اعتبار نشست ارتباطی منقضی شده است. | پلاگین وبیتو چالش امنیتی جدید دریافت و نشست را خودکار تجدید میکند. |