الأدلة

قائمة التشغيل الفعلي

ما تتحقق منه قبل أن يتعامل تكاملك مع مستندات حقيقية لشركة.

• المفتاح محفوظ في مخزن أسرار على خادمك، لا في متصفح أو تطبيق أو مستودع شيفرة.
• لا يحمل المفتاح إلا النطاقات التي يحتاجها، ويؤكد GET /me أنه للشركة المتوقعة.
• كل طلب POST منشئ يرسل Idempotency-Key، ويُعاد استخدامه عند إعادة المحاولة.
• كل سجل تنشئه يحمل externalId الخاص بك، وتبحث عن السجلات به.
• تقرأ شيفرتك code في الرفض، وتلتزم بـ Retry-After مع 429، وتتوقف مع 401.
• تعمل المزامنة عبر updatedSince بتداخل صغير، لا بقراءة كل شيء.
• للفواتير الإلكترونية: eInvoicing.available قيمتها true، وبيانات الشركة مكتملة، وترسل expectedTotal، وتتابع كل فاتورة حتى CLEARED أو REJECTED.
• يعرف شخص في الشركة أن المفتاح موجود، وما الغرض منه، وكيف يُلغى.