OTP (رمز التسجيل من منصة فاتورة)
الـ OTP رمز لمرة وحدة يطلّعه صاحب المنشأة من منصة فاتورة عشان يسمح بتسجيل جهاز فوترة، صلاحيته ساعة، ويُرسل مع طلب شهادة الامتثال.
الـ OTP رمز لمرة وحدة يثبت إن المنشأة نفسها موافقة على تسجيل الجهاز. صاحب المنشأة يدخل منصة فاتورة (fatoora.zatca.gov.sa) بحسابه، ويختار تسجيل وحدة جديدة (Onboard new solution unit)، وينسخ الرمز.
وين يروح؟ في ترويسة اسمها otp على طلب شهادة الامتثال (POST /compliance)، وأيضاً على طلب تجديد شهادة الإنتاج (PATCH /production/csids). المنصة تطلّع لين 100 رمز مرة وحدة، وكل رمز صالح ساعة، فكل جهاز ياخذ رمز خاص فيه.
وش يغلط؟ الرمز ينتهي قبل ما يُستخدم، أو المطوّر يحاول يسجّل جهاز عن عميله بدون ما يطلب منه الرمز. الشهادة تطلع باسم المنشأة، فخطّط لهالخطوة مع أول عميل بدري. وعلى بوابة المطورين ما تحتاج OTP حقيقي: فيه قيمة تجريبية منشورة.
في ماثل ترسل otp في جسم POST /api/v1/onboarding، وعلى sandbox ماثل يستخدم القيمة التجريبية بنفسه. وإذا التاجر ما عنده مطوّر، رابط التفعيل يخليه يكتب الـ OTP من جواله.
مثال
{"environment":"simulation","otp":"123456","seller":{"vat_number":"3…3","legal_name_ar":"…","crn":"…",
"address":{"street":"…","building_number":"1234","district":"…","city":"الرياض","postal_code":"12211"}}}
أسئلة شائعة
كم مدة صلاحية الـ OTP؟
ساعة وحدة. المنصة تقدر تطلّع لين 100 رمز مرة وحدة، رمز لكل جهاز.
هل أحتاج OTP على بوابة المطورين؟
لا. بوابة المطورين تقبل قيمة تجريبية منشورة، وماثل يستخدمها تلقائي على sandbox.
هل أقدر أطلّع OTP عن عميلي؟
لا. الرمز يطلع من حساب المنشأة في منصة فاتورة، فلازم صاحب المنشأة يطلّعه ويعطيك إياه.
مصطلحات قريبة
- منصة فاتورة (Fatoora)
- شهادة الامتثال (Compliance CSID)
- شهادة الإنتاج (Production CSID)
- EGS (وحدة حل الفوترة الإلكترونية)
- بيئات زاتكا الثلاث (المطورين، المحاكاة، الإنتاج)
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API