بخش ایجنت ام سی پی به استور فرانت اضافه شداطلاعات بیشتر ←

راهنمای جامع اتصال به سامانه ملی فاکتور الکترونیک لهستان (Krajowy System e-Faktur - KSeF) در وبیتو

۲۹ شهریور ۱۴۰۵


راهنمای جامع اتصال به سامانه ملی فاکتور الکترونیک لهستان (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 از مشتری مصرف‌کننده

۲. دیاگرام توالی احراز هویت و ارسال سند به سامانه مودیان لهستان

mermaid
sequenceDiagram
    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

برای فعال‌سازی پلاگین در وبیتو:

  1. با استفاده از امضای دیجیتال معتبر (Profil Zaufany یا mObywatel یا گواهی الکترونیک مهر سازمانی) به پرتال مودیان وزارت دارایی لهستان به نشانی ksef.mf.gov.pl وارد شوید.
  2. در بخش Tokeny (Tokens)، یک توکن مجوز با دسترسی صدور و ارسال فاکتور (Wystawianie faktur) ایجاد کنید.

تنظیمات پلاگین در پنل وبیتو:

عنوان فیلدکلید فنیالزامی؟توضیحات و راهنمانمونه مقدار
کد مالیاتی فروشنده (NIP)sellerNipبلهکد ۱۰ رقمی بدون خط تیره ثبت‌شده در اداره مالیات5252344078
توکن احراز هویت KSeFauthorizationTokenبلهتوکن امنیتی تولیدشده در پرتال Aplikacja Podatnikasec_ksef_token_abc123
محیط سامانهenvironmentبلهانتخاب بین test (آزمایشی)، demo (پیش‌تولید)، یا prod (سامانه زنده)test / prod
نرخ پیش‌فرض مالیات VATdefaultVatRateخیرنرخ پایه مالیات بر ارزش افزوده در لهستان (معمولاً ۲۳٪)23 / 8 / 5 / 0 / zw
ارسال خودکار پس از پرداختautoTransmitOnOrderPaidخیرصدور و ارسال آنی فاکتور به محض پرداخت موفق سفارشtrue / false

۴. جدول رفع خطاها و کدهای وضعیت سامane KSeF

کد وضعیت / خطاعلت بروز خطااقدام اصلاحی در وبیتو
415 / INVALID_NIPکد مالیاتی فروشنده یا خریدار با الگوریتم Modulo-11 سازگار نیست.بررسی صحت ۱۰ رقم کد NIP در مشخصات شرکت خریدار.
400 / SCHEMA_ERRORمقادیر جمع جبری اقلام یا مالیات با جمع کل فاکتور انطباق ندارد.وبیتو به صورت خودکار گرد کردن ریال/زلوتی را با دقت دو رقم اعشار انجام می‌دهد.
430 / DUPLICATE_NUMBERفاکتوری با همین شماره سریال قبلاً در سال مالی جاری ثبت شده است.سیستم شماره‌گذاری فاکتورهای وبیتو ترتیبی و غیرتکراری است.
SESSION_EXPIREDاعتبار نشست ارتباطی منقضی شده است.پلاگین وبیتو چالش امنیتی جدید دریافت و نشست را خودکار تجدید می‌کند.