واجهة برمجية للفواتير متعددة المستأجرين

لماذا حساب لكل بائع

في الفوترة الإلكترونية السعودية البائع هو المُصدر النظامي: رقمه الضريبي وتسلسل فواتيره وربطه بالهيئة له وحده. لذلك تحتاج المنصة التي تفوتر نيابة عن عدة بائعين منشأة في وندرفاتورة لكل بائع، لا حسابًا مشتركًا.

كيف يعمل اليوم

• لكل منشأة بائعة مفتاحها. المفتاح يحدد البائع، ولا شيء في الطلب يتجاوز ذلك.
• لكل منشأة ترقيمها بلا فجوات وعملاؤها ومنتجاتها ونسب ضريبتها.
• المعرّفات محصورة: معرّف عميل أو منتج أو نسبة ضريبة من منشأة أخرى يُعامل كغير معروف.
• باقة كل منشأة وحدودها تسري على فواتيرها هي.

قائمة تحقق للبنية

1. احفظ مفتاحًا لكل بائع، مشفرًا، بجوار سجل ذلك البائع.
2. اختر المفتاح من بائع الطلب، لا من مدخلات المستخدم أبدًا.
3. تحقق من الربط مرة واحدة بـ GET /ping الذي يعيد اسم المنشأة.
4. احفظ معرّفات وندرفاتورة (الفواتير والعملاء) مع البائع الذي تنتمي إليه.
5. عالج 401 لكل بائع على حدة: أُلغي مفتاح ذلك البائع أو انتهى (token_expired)، فاطلب منه إعادة الربط.
6. استخدم قيم external_reference فريدة داخل كل بائع، كرقم الطلب لديك.