ترحيل فردي لـ DAVATEL API

عقد تقديم الخدمة 2026-08-11 API v1.1

الهدف

يقوم هذا التحديث بمزامنة واجهة برمجة التطبيقات (API) مع نموذج DAVATEL الحالي. لتجنب التعديلات الجديدة لاحقًا، لا تحتفظ بنموذج ثابت: ارجع إلى الحقل الديناميكي ونقاط نهاية المتطلبات.

التدفق الذي يجب تنفيذه

GET /api/v1/order-fields
يقوم العميل باختيار الأسعار الرئيسية والإضافية.
POST /api/v1/order-requirements
عرض الحقول/المتطلبات التي تم إرجاعها بالضبط.
POST /api/v1/orders كما multipart/form-data.
احفظ referencia تم إرجاعه والاستعلام عنه GET /api/v1/orders/:referencia.

ضوابط إلزامية جديدة

نوع العميل: فرد أو شركة.
رقم الحساب المصرفي الدولي (IBAN): إلزامي ويخضع للتحقق.
الألياف: إذا كان الجهاز الرئيسي يتضمن أليافًا، فوضح ما إذا كان التثبيت يستخدم نفس العنوان؛ إذا كانت الإجابة لا، العنوان والرمز البريدي والمدينة والمقاطعة.
ثابت: جديد/قابلية النقل ورقم قابلية النقل.
كل جوال: جديد/قابلية النقل، ودائمًا بطاقة SIM/ESIM؛ إذا قابلية النقل، العدد الحالي.
تنطبق القواعد الثابتة/المتنقلة أيضًا على المنتجات الإضافية.
DNI أمامي وخلفي.
ترخيص/معالجة الخصوصية وترخيص البيانات/المستندات. موافقة تجارية اختيارية.

التوافق

المفاتيح campo_ID لا تتغير.
campo_14 يحتفظ بكلمة المرور الخاصة بك، ولكن العنوان الصحيح هو المقاطعة.
tarifa_ids لا يزال مقبولاً؛ فمن المستحسن productos.
consentimiento_rgpd يظل كاسم مستعار للخصوصية، لكنه لا يحل محله autorizacion_documentos_cliente.

مثال على تفاصيل المنتج

[
  {
    "tarifa_id": 2,
    "unidades": [
      {"moviles":[{"tipo":"PORTABILIDAD","sim":"ESIM","numero":"600000000"}]}
    ]
  }
]

التحقق قبل النشر

التسجيل بهاتف محمول جديد + بطاقة SIM.
التسجيل بقابلية الجوال + eSIM + الرقم.
بدون رقم IBAN، يجب إرجاع HTTP 400.
لا ينبغي أن تقوم بطاقة SIM/eSIM بإرجاع HTTP 400.
يجب أن تقوم إمكانية النقل بدون رقم بإرجاع HTTP 400.
الألياف الضوئية إلى عنوان آخر بدون مقاطعة يجب أن تُرجع HTTP 400.
يجب أن يُرجع التسجيل الناجح HTTP 201، referencia و contrato_version.
الاستعلام عن المرجع الذي تم إنشاؤه والتحقق من حالته.

التوثيق

بوابة المطور · أنظر أيضاً API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml ومجموعة Postman متضمنة في الحزمة الفنية.