البداية

مقدمة

تربط واجهة KWN البرمجية أنظمة الشركة — نظام تخطيط الموارد أو المتجر أو نقاط البيع أو برنامج شريك — بحسابها في KWN: مستندات المبيعات والمشتريات، وجهات الاتصال والمنتجات، والفواتير الإلكترونية المخلّصة لدى الهيئة الاتحادية للضرائب، وتقارير ضريبة القيمة المضافة.

ما الذي يمكنك فعله

• تخليص الفواتير الإلكترونية. أرسل فاتورة أصدرها نظامك؛ تمنحها KWN رقمًا وتحفظها في المبيعات وترسلها إلى الهيئة الاتحادية للضرائب عبر تاكس ستار، المزوّد المعتمد. الفوترة الإلكترونية
• إدارة المبيعات. عروض الأسعار وأوامر البيع والفواتير والإشعارات الدائنة، من المسودة حتى التخليص.
• إدارة المشتريات. طلبات عروض الأسعار وأوامر الشراء وفواتير المورّدين واستردادات المورّدين.
• مزامنة البيانات الأساسية. دفتر واحد لجهات الاتصال من عملاء ومورّدين، وقائمة المنتجات.
• قراءة الأرقام. إقرار ضريبة القيمة المضافة 201 وتقارير الأعمار، كما يحسبها التطبيق.

كيف تعمل

يحمل كل طلب مفتاحًا برمجيًا تنشئه الشركة من الإعدادات ← التكاملات ← مفاتيح الواجهة البرمجية. المفتاح يخص شركة واحدة، ولا يصل إلا إلى سجلاتها، ولا يفعل إلا ما تسمح به نطاقاته. الواجهة من نوع REST عبر HTTPS بأجسام JSON، وكل المبالغ بالدرهم الإماراتي.

Base URL   https://app.kwn.tax/api/v1

يُولَّد مرجع الواجهة من مستند OpenAPI 3.0 الذي تنشره الواجهة نفسها، فكل مسار وحقل ومثال فيه هو ما تجيب به الواجهة فعلًا.

من أين تبدأ

• البدء السريع: مفتاح، وأول طلب، وأول فاتورة إلكترونية في خمس دقائق.
• المصادقة والنطاقات: كيف يثبت المفتاح هويته وما يحق له.
• ربط نظام طرف ثالث: لشركات البرمجيات التي تربط حسابات عملائها في KWN.