واجهة DAVATEL API v1.9 للموزعين
أداة البحث عن الباقات والكتالوج وطلبات الاشتراك الكاملة ودراسات توفير الكهرباء والغاز. العقد الساري: 2026-09-14-COMERCIAL-PREPAGO-V6.
تحديث مهم لطلبات الاشتراك
تتحقق واجهة API من البيانات التشغيلية نفسها التي يتحقق منها نموذج DAVATEL. لا يُحفظ طلب اشتراك غير مكتمل: تُرجع HTTP 400 مع تحديد الحقل الناقص.
فردعامل مستقلشركةوجها بطاقة DNIIBAN إلزاميSIM/eSIM لكل خطوط الجوالالموافقتان الإلزاميتان (2)
MÁSMÓVIL وPEPEPHONE وJAZZTEL وSIMYO: تتطلب جميعها إيصالًا بنكيًا؛ ويضيف العامل المستقل إيصال اشتراك العمل المستقل؛ وتضيف الشركة CIF وغلاف أو أول صفحة من وثائق التأسيس والصفحة التي تذكر المدير. يجب إرسال صفحتي وثائق التأسيس كملفين منفصلين. في حالة الشركة، يجب أن يكون وجها بطاقة DNI خاصين بالمدير.
مشغلون جدد والسرية
يتضمن الكتالوج العام العروض السكنية المعتمدة من MÁSMÓVIL وPEPEPHONE وJAZZTEL وSIMYO. منذ V25، تشارك العروض الخاصة وBTL وعروض العملاء الحاليين أيضًا في API عندما تكون ظاهرة وسارية، مع الحفاظ على شروط الأهلية. يقبل Vodafone Mi Negocio Pro فقط EMPRESA مع نقل الرقم؛ ويقبل Lowi كلًا من PARTICULAR وAUTONOMO.
MOVISTAR ظاهر دون باقاتHUMANITY موحدعروض خاصة خاضعة للأهلية
كتالوج AVATEL محدّث
يُعرض AVATEL كمشغل واحد لجميع تغطياته. تتضمن API عرض Back to School/NOVA وCLICtv والباقات الإضافية الجديدة.
بحد أقصى 5 خطوط AVATELخطوط إضافية دون ترحيل البياناتCanal Local بسعر 5 €دفعات منفصلة لمرة واحدة
تُرجع كل باقة condiciones_publicas, vigencia_desde, vigencia_hasta, solo_cliente_nuevo, periodicidad_precio, max_lineas_cliente و gigas_acumulables. لا تظهر الباقات المنتهية. المنتجات التي تحتوي على periodicidad_precio=PAGO_UNICO لا تُضاف إلى الرسوم الشهرية.
مراجعة V7: الحد الأدنى لتكلفة الباقة
تُقارن مجموعات كاملة من إضافات الجوال والتلفزيون المتوافقة. يعطي الترتيب الأولوية لإجمالي الرسوم الحالية؛ وعند التعادل تُقدّم أقل رسوم عادية بعد العروض، ثم بقية معايير الحسم. تُحفظ قواعد البيانات لكل خط والحصص المشتركة وMULTISIM.
الحقول precio_total, precio_normal_total و fases_precio تحتفظ بصيغتها. لا تتغير المصادقة أو نقاط النهاية.
تحديث تجاري V13
تدعم عمليات البحث tipo_cliente. يُرجع السعر الحالي والمراحل حسب التاريخ والمنصات المختارة مع كل عرض. تُمثَّل حصة من 1 أو 2 أو 3 خدمات OTT باختيارات محددة متوافقة. لا تُستخدم الباقات السابقة لطلبات اشتراك جديدة في الباقات المجمعة.
fases_precio قد يتضمن desde_fecha و hasta_fecha (YYYY-MM-DD) عندما يكون للعرض تاريخ انتهاء ثابت. تُحفظ المراحل القديمة بالأشهر للباقات الأخرى. راجع دائمًا /order-requirements قبل عرض النموذج.
المصادقة
X-API-Key: dvt_live_... X-Davatel-Domain: www.tudominio.es
يجب عدم كشف المفتاح في JavaScript العام. استخدم خادمًا خلفيًا أو وكيلًا خاصًا بك.
نقاط النهاية v1
| الطريقة | المسار | الاستخدام |
|---|---|---|
| GET | /api/v1/status | الاتصال والإصدار والعقد. |
| GET | /api/v1/operators | المشغلون المتاحون للعامة. |
| GET | /api/v1/rate-types | أنواع الباقات للفلاتر. |
| GET | /api/v1/rates | كتالوج دون عمولات. |
| GET | /api/v1/rates/:id | تفاصيل باقة. |
| POST | /api/v1/rates/search | أداة البحث عن الباقات: السعر والخدمات. |
| GET | /api/v1/order-fields | حقول العميل والنظام. |
| POST | /api/v1/order-requirements | المتطلبات الدقيقة للاختيار. |
| POST | /api/v1/orders | إنشاء طلب اشتراك كامل. |
| GET | /api/v1/orders | عرض قائمة طلبات اشتراك الموزع. |
| GET | /api/v1/orders/:referencia | الاستعلام عن طلب اشتراك. |
مسار العمل الموصى به
- استعلم عن
/order-fields. - اختر باقة أو حزمة.
- استدعِ
/order-requirements. - اعرض الحقول المحددة كما هي.
- إرسال
/orders.
POST /api/v1/order-requirements
{
"tipo_cliente": "EMPRESA",
"tarifa_id": 2,
"productos": [{"tarifa_id":2,"cantidad":1}]
}حقول النظام الإلزامية
| الحقل | القاعدة |
|---|---|
tipo_cliente | PARTICULAR أو AUTONOMO أو EMPRESA. |
iban | إلزامي ويخضع للتحقق. |
fibra_misma_direccion | إلزامي إذا كانت الباقة الرئيسية تشمل الألياف البصرية. إذا كانت القيمة NO: العنوان والرمز البريدي والمدينة والمقاطعة. |
detalles_productos | الهاتف الثابت والجوال. يتطلب كل خط جوال النوع وSIM/ESIM. يتطلب نقل الرقم رقم الهاتف وtipo_origen (CONTRATO/PREPAGO)؛ وتتطلب PREPAGO أيضًا ICC للبطاقة الأصلية كنص. تتطلب عروض Vodafone/Lowi الجديدة operador_origen لكل عملية نقل رقم. |
aceptacion_privacidad_cliente | إلزامي. |
autorizacion_documentos_cliente | إلزامي. |
comunicaciones_comerciales_cliente | اختياري. |
dni_anverso و dni_reverso | إلزاميان. في حالة EMPRESA، يكونان للمدير. JPG أو PNG أو WEBP أو PDF، بحد أقصى 8 MB لكل ملف. |
recibo_bancario | إلزامي لدى MÁSMÓVIL وPEPEPHONE وJAZZTEL وSIMYO. |
recibo_autonomo | إلزامي للعامل المستقل لدى المشغلين الأربعة الجدد. |
cif_empresa | إلزامي عندما tipo_cliente=EMPRESA. |
escrituras_portada | غلاف أو أول صفحة من وثائق التأسيس، في ملف مستقل. إلزامي لـ EMPRESA لدى المشغلين الأربعة الجدد. |
escrituras_administrador | الصفحة التي تذكر المدير، في ملف آخر. إلزامي لـ EMPRESA لدى المشغلين الأربعة الجدد. |
مثال detalles_productos
[
{
"tarifa_id": 2,
"unidades": [
{
"moviles": [
{"tipo":"PORTABILIDAD","sim":"ESIM","numero":"600000000","tipo_origen":"PREPAGO","operador_origen":"Orange","icc":"8934000000000000001"}
]
}
]
},
{
"tarifa_id": 5,
"unidades": [
{"fijo":{"tipo":"NUEVO","numero":""}}
]
}
]القيم: NUEVO/PORTABILIDAD و SIM/ESIM.
مفاتيح العميل الثابتة
استخدم دائمًا campo_ID الذي يُرجعه /order-fields. الحقل القديم campo_14 يحتفظ بالمفتاح نفسه، لكن عنوانه الصحيح هو المقاطعة.
في حالة EMPRESA، يفسّر DAVATEL campo_3 باعتباره اسم الشركة، ولا يطلب أسماء العائلة، ويعرض campo_5 باعتباره CIF.
أخطاء تمنع الاشتراكات غير المكتملة
{"ok":false,"error":"validation_error","campo":"iban","mensaje":"Falta el campo obligatorio: IBAN"}
{"ok":false,"error":"validation_error","campo":"detalles_productos","mensaje":"Falta SIM/eSIM de la línea móvil 1 de CONECTA SENCILLO"}الكهرباء والغاز
يتيح الإصدار 1.9 إرسال الفواتير والاطلاع على الدراسة وتنزيل تقرير التوفير وتحديد أن العميل لا يرغب في الاشتراك أو إرسال طلب الاشتراك.
POST /api/v1/energy-studies · GET /api/v1/energy-studies · GET /api/v1/energy-studies/:referencia/report · POST /decline · POST /contract
التلفزيون والبث
لا تُجمع إضافات المشغل الخاصة إلا مع مشغلها. تلفزيون DAVATEL متوافق مع الجميع. لا تُعد Netflix وPrime Video وDisney Plus وMovistar Plus وHBO Max وSkyShowtime وDAZN Motor وDAZN Fútbol وDAZN Premium وFilmin وحدها تلفزيونًا خطيًا.
أمان المتصفح
المفتاح X-API-Key يبقى حصريًا على الخادم. يستخدم عنصر الواجهة وأداة الاختبار الوكيل الخاص المرفق، ولا يتلقيان المفتاح مطلقًا.
التوافق
consentimiento_rgpd لا يزال مقبولًا كاسم بديل للخصوصية، لكنه لا يحل محل تفويض المستندات. tarifa_ids يبقى متاحًا؛ يُنصح باستخدام productos. المفاتيح campo_ID لا تتغير.
تتحقق واجهة API مجددًا من المنتج الرئيسي وجميع الإضافات في order-requirements و orders. يجب الالتزام بقوائم «SOLO PARA TARIFAS» في وصف المنتج أو الشروط العامة؛ وتُرجع التركيبة غير المسموح بها HTTP 400 مع error=incompatible_tariff_combination.
ملفات التكامل
MIGRACION_A_API_V1_9.md · openapi-davatel-v1.yaml · DAVATEL_API.postman_collection.json · davatel-api-sdk.js · davatel-widget.js · PROXY_SEGURO_NODE.js