واجهة برمجية للمطوّرين
برامجكم تقرأ محاسبة وزنة
مفتاح API وطلبات قراءة، فتصل معطياتكم المحاسبية إلى برنامج التصرّف أو لوحة القيادة أو أداة التسيير. دون إعادة إدخال.
راسلونا على info@wazna.tn
BASE=https://votre-adresse-wazna/api/public/v1
curl -X GET "$BASE/dossiers/{dossierId}/balance?date=2026-09-30" \
-H "Authorization: Bearer wzk_live_7Hq2…"
HTTP/1.1 200 OK
{
"date": "2026-09-30",
"exerciceId": "00000000-0000-4000-8000-000000000001",
"elements": [
{ "compte": "401", "libelleCompte": "Fournisseurs",
"debitMillimes": 12500000, "creditMillimes": 18750000,
"soldeMillimes": -6250000 },
{ "compte": "532", "libelleCompte": "Banques",
"debitMillimes": 48300000, "creditMillimes": 31120500,
"soldeMillimes": 17179500 }
],
"curseurSuivant": null
}لماذا الواجهة
ما تربحونه
لا إعادة إدخال
تقرأ أدواتكم الكتابات والميزان والحرفاء مباشرة. لا تصدير ولا استيراد يدوي بعد اليوم.
أرقام محيّنة
تقرؤون الكتابات المصادق عليها لحظة الطلب، لا ملفًّا أُرسل الأسبوع الماضي.
المكتب يبقى صاحب القرار
مسؤول المكتب يُنشئ المفتاح ويختار الملفّات المفتوحة، ويمكنه إلغاؤه في أيّ وقت.
كيف يعمل
ثلاث خطوات
- 1
مسؤول المكتب يُنشئ المفتاح في وزنة
يختار الملفّات، وإن شاء عناوين IP المسموح بها.
- 2
تستدعون الواجهة للقراءة
طلبات GET، والمفتاح في الترويسة Authorization: Bearer.
- 3
تصل معطياتكم إلى أداتكم
أجوبة JSON، والمبالغ بالمليم، جاهزة لبرنامجكم أو للوحة القيادة.
الموارد
ما يمكنكم قراءته
المسار الأساسي :
https://votre-adresse-wazna/api/public/v1| المورد | المسار |
|---|---|
| الملفّات | GET /dossiers |
| بطاقة الملفّ | GET /dossiers/{dossierId} |
| المخطّط المحاسبي | GET /dossiers/{dossierId}/plan-comptable |
| الكتابات المصادق عليها | GET /dossiers/{dossierId}/ecritures |
| دفتر الأستاذ | GET /dossiers/{dossierId}/grand-livre |
| الميزان في تاريخ | GET /dossiers/{dossierId}/balance?date=… |
| الحرفاء والمزوّدون | GET /dossiers/{dossierId}/tiers |
| الفواتير المقروءة | GET /dossiers/{dossierId}/factures |
| الآجال الجبائية | GET /dossiers/{dossierId}/echeances |
مثال
الميزان في تاريخ معيّن، بطلب واحد
BASE=https://votre-adresse-wazna/api/public/v1
curl -X GET "$BASE/dossiers/{dossierId}/balance?date=2026-09-30" \
-H "Authorization: Bearer wzk_live_7Hq2…"
HTTP/1.1 200 OK
{
"date": "2026-09-30",
"exerciceId": "00000000-0000-4000-8000-000000000001",
"elements": [
{ "compte": "401", "libelleCompte": "Fournisseurs",
"debitMillimes": 12500000, "creditMillimes": 18750000,
"soldeMillimes": -6250000 },
{ "compte": "532", "libelleCompte": "Banques",
"debitMillimes": 48300000, "creditMillimes": 31120500,
"soldeMillimes": 17179500 }
],
"curseurSuivant": null
}يمرّ المفتاح في الترويسة، ولا يوضع أبدًا في العنوان. المبالغ أعداد صحيحة بالمليم: 1 190,000 دينار تُكتب 1190000.
الأمان
مفتاح تحت المراقبة
قراءة فقط
لا توجد إلّا طريقة GET. الواجهة لا تُنشئ شيئًا ولا تعدّل ولا تحذف.
محدود
يمكن حصر المفتاح في ملفّات معيّنة وفي عناوين IP معيّنة.
له تاريخ انتهاء وقابل للإلغاء
ينتهي بعد سنة على الأكثر، ويُلغى في أيّ وقت.
مسجَّل
كلّ طلب يُسجَّل في السجلّ.
معزول
كلّ مكتب لا يرى إلّا معطياته.
أسئلة شائعة
أسئلة شائعة
من يُنشئ مفتاح API؟
مسؤول المكتب، داخل وزنة. يختار ما يمكن للمفتاح قراءته ويمكنه إلغاؤه في أيّ وقت.
هل يمكن الكتابة في وزنة عبر الواجهة؟
لا. النفاذ للقراءة فقط: طلبات GET لا غير.
هل يرى المفتاح كلّ الملفّات؟
فقط الملفّات التي فتحها المسؤول. ويمكن أيضًا حصره في عناوين IP معيّنة.
ما مدّة صلاحية المفتاح؟
سنة على الأكثر، ويمكن إلغاؤه قبل ذلك في أيّ وقت.
بأيّ صيغة تصل المعطيات؟
بصيغة JSON. المبالغ أعداد صحيحة بالمليم، والتواريخ بصيغة AAAA-MM-JJ.