الشركاء والحسابات - OneClickDz Flexy API

الإتاحة

تُعيد GET /v3/bills/partners مُدخلًا واحدًا لكل مُصدِر فاتورة مع status واحدة: ACTIVE أو UNAVAILABLE.

curl https://api.oneclickdz.com/v3/bills/partners \
  -H "X-Access-Token: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "ADE": { "status": "ACTIVE" },
    "AADL": { "status": "ACTIVE" },
    "SONELGAZ": { "status": "ACTIVE" },
    "SEAAL": { "status": "ACTIVE" },
    "SEOR": { "status": "ACTIVE" },
    "Algérie Télécom": { "status": "UNAVAILABLE" }
  },
  "meta": { "timestamp": "2026-09-20T10:15:32.194Z" },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

يُجيب مُصدِر الفاتورة ذو الحالة UNAVAILABLE بالخطأ 503 PARTNER_UNAVAILABLE على discover وpay. اقرأ هذه الخريطة عند بناء أداة اختيار مُصدِر الفاتورة وأخفِ ما هو غير متاح؛ إذ تتغيّر الإتاحة دون إشعار مسبق.

يرى مفتاح الإنتاج الإتاحة الفعلية. أما مفتاح Sandbox فيرى جميع مُصدِري الفواتير بالحالة ACTIVE، لأن طلبات Sandbox لا تصل أبدًا إلى مُصدِر الفاتورة.

اسم الشريك

قيمة partner هي المفتاح الدقيق من الخريطة أعلاه. يُكتب Algérie Télécom بعلامات النبر وبمسافة؛ وأي كتابة أخرى تُرفض بالخطأ 400 ERR_VALIDATION.

الكائن account

يحتوي account على معرّف واحد فقط، ويجب أن يكون المعرّف الذي يفهمه مُصدِر الفاتورة. الجدول أدناه هو القائمة الكاملة.

الشريك	`account`	أين يجده العميل
`ADE`	`{ "electronic_payment_key": "…" }`	Clé de paiement électronique على فاتورة المياه، 25 حرفًا
`SONELGAZ`	`{ "sonelgaz": { "invoice_number", "amount_without_stamp", "ebb_key" } }`	Numéro de facture وmontant hors timbre وclé EBB على فاتورة الكهرباء/الغاز
`SEAAL`	`{ "seaal": { "code_client", "code_contrat" } }`	Code client وcode contrat على فاتورة المياه من SEAAL
`AADL`	`{ "aadl": { "codeloc" } }`	Code logement الخاص بملف السكن لدى AADL
`SEOR`	`{ "seor": { "contrat", "facture" } }`	N° Contrat وN° Facture على فاتورة المياه من SEOR
`Algérie Télécom`	`{ "phone_number": "…" }`	رقم الهاتف الثابت

ADE

{
  "partner": "ADE",
  "account": { "electronic_payment_key": "0123456789012345678901234" },
  "ref": "disc-20260920-0001"
}

يتكوّن electronic_payment_key من 25 حرفًا بالضبط. يحدّد كل مفتاح فاتورة واحدة.

SONELGAZ

{
  "partner": "SONELGAZ",
  "account": {
    "sonelgaz": {
      "invoice_number": "313260119713",
      "amount_without_stamp": "28491.72",
      "ebb_key": "169"
    }
  },
  "ref": "disc-20260920-0002"
}

الحقول الثلاثة كلها سلاسل نصية إلزامية، تُنسخ كما هي مطبوعة على الفاتورة. amount_without_stamp هو المبلغ قبل الطابع الجبائي، مع استخدام النقطة فاصلًا عشريًا. يتحقّق مُصدِر الفاتورة من القيم الثلاث معًا؛ وأي عدم تطابق يُنهي الاكتشاف بالرمز INVALID_ACCOUNT.

SEAAL

{
  "partner": "SEAAL",
  "account": { "seaal": { "code_client": "100001", "code_contrat": "446563" } },
  "ref": "disc-20260920-0003"
}

يتكوّن code_client من 2 إلى 6 أحرف أبجدية رقمية، وcode_contrat من 2 إلى 10 أرقام. كلاهما إلزامي. قد يتضمّن حساب SEAAL عدة فواتير فصلية غير مدفوعة؛ ويُعيدها الاكتشاف جميعًا.

AADL

{
  "partner": "AADL",
  "account": { "aadl": { "codeloc": "1112223334" } },
  "ref": "disc-20260920-0004"
}

يتكوّن codeloc من 6 إلى 20 رقمًا.تُصدر AADL إشعارًا إجماليًا واحدًا لكل ملف سكن. تُدرج المتأخرات ضمن هذا المبلغ الواحد ولا يمكن دفعها بشكل منفصل.

SEOR

{
  "partner": "SEOR",
  "account": { "seor": { "contrat": "100001", "facture": "00102026S000000001" } },
  "ref": "disc-20260920-0006"
}

يتكوّن contrat من 1 إلى 6 أرقام؛ تطبعه الفاتورة بمسافة (284 932) وتُتجاهل المسافات. ويتكوّن facture من 18 حرفًا أو رقمًا. كلاهما إلزامي.SEOR (مياه وهران) فاتورة واحدة: يُعيد الاكتشاف الفاتورة التي أرسلتها بالضبط. لا تستطيع SEOR التمييز بين زوج خاطئ وفاتورة مدفوعة مسبقًا في الوكالة، لذا يعني INVALID_ACCOUNT لدى SEOR «معلومات غير صحيحة أو فاتورة مدفوعة مسبقًا».

Algérie Télécom

{
  "partner": "Algérie Télécom",
  "account": { "phone_number": "023456789" },
  "ref": "disc-20260920-0005"
}

phone_number هو رقم هاتف ثابت من 9 أرقام: 0، ثم 2 أو 3 أو 4، ثم 7 أرقام. لا تُقبل أرقام الهاتف المحمول.

ما تُعيده الواجهة

تُعيد كل معاملة المعرّف ضمن account، بشكل مسطّح، بمفتاح يختلف باختلاف الشريك:

الشريك	`account` في الاستجابات
`ADE`	`{ "reference": "<electronic_payment_key>" }`
`SONELGAZ`	`{ "contractNumber": "<invoice_number>" }`
`SEAAL`	`{ "codeClient": "<code_client>" }`
`AADL`	`{ "codeloc": "<codeloc>" }`
`SEOR`	`{ "facture": "<facture>" }`
`Algérie Télécom`	`{ "phoneNumber": "<phone_number>" }`

هذه المفاتيح للإخراج فقط. استخدم صيغ الطلب المذكورة أعلاه عند الإرسال.

التكاملات المنجزة قبل هذه الصفحة تُرسل reference (ADE) أو phoneNumber (Algérie Télécom) كمعرّف. كلاهما ما زال مقبولًا ويُحوَّل إلى electronic_payment_key وphone_number؛ أما التكاملات الجديدة فعليها استخدام الصيغ أعلاه.

أخطاء التحقّق

الخطأ	HTTP	السبب
`ERR_VALIDATION`	400	شريك غير معروف، أو حقل مفقود، أو صيغة خاطئة، أو أكثر من معرّف واحد. يسرد `details` كل مشكلة.
`INVALID_ACCOUNT`	400	في Sandbox فقط: حسابات الاختبار غير الصالحة تُجيب فورًا. في الإنتاج يظهر المعرّف المرفوض على المعاملة.

لا يُنشئ الرمز 400 أي معاملة أبدًا. عندما يكون المعرّف سليم الصيغة لكن مُصدِر الفاتورة لا يتعرّف عليه، يُقبل الاكتشاف ثم ينتهي لاحقًا بالحالة FAILED مع error.code = INVALID_ACCOUNT (راجع اكتشاف الفواتير).

التالي: اكتشاف الفواتير

بدء عملية اكتشاف وقراءة الفواتير

​الإتاحة

​اسم الشريك

​الكائن account

​ADE

​SONELGAZ

​SEAAL

​AADL

​SEOR

​Algérie Télécom

​ما تُعيده الواجهة

​أخطاء التحقّق

التالي: اكتشاف الفواتير

الإتاحة

اسم الشريك

الكائن account

ADE

SONELGAZ

SEAAL

AADL

SEOR

Algérie Télécom

ما تُعيده الواجهة

أخطاء التحقّق