forumفتح موضوع جديد
فتح موضوع جديد

الوكالة بتقول لازم "ربط API" عشان نربط نظام الفواتير — يعني إيه ده وإيه اللي المفروض أطلبه منهم؟

BBeren K***خبير
المسمى الوظيفي
ممثل مركز الاتصال
قطاع
كيمياء
نوع المنظمة
نشاط فردي
تاريخ الانضمام
يونيو 2024
رسالة
93
#1

عندنا متجر إلكتروني في مدريد لبيع المكملات الغذائية والرياضية. بيجيلنا في المتوسط من 450 لـ 600 طلب شهرياً. لحد دلوقتي، الموظفين عندنا بيدخلوا المبيعات دي يدوي واحدة واحدة على برنامج المحاسبة والفواتير المحلي بتاعنا. بس مع زيادة الشغل، الموضوع بقى بياخد مننا 15 ساعة في الأسبوع على الأقل، وبدأت تظهر أخطاء كتير من الموظفين في الأرقام الضريبية أو العناوين.

لما اتكلمنا مع الوكالة اللي طورت الموقع، قالوا لازم نعمل "تكامل API للفواتير" في الباك إند للموقع. طلبوا 1.800 يورو للتركيب والإعداد، و150 يورو شهرياً صيانة عشان يفضل النظام شغال. عرض السعر فيه بس شوية اختصارات تقنية ومش فاهم بالضبط أنا بشتري إيه.

كصاحب عمل، عايز أفهم يعني إيه أصلاً ربط الـ API ده، وهل العرض ده سعره معقول، وإيه بنود المسؤولية والضمانات اللي لازم أضيفها في العقد؟ عشان لو النظام بكرة مطلعش فاتورة أو طلعها غلط ما ألبسش أنا في الحيط، إيه اللي المفروض أطلبه من الوكالة؟

UUğur Y***محارب قديم
المسمى الوظيفي
مدير عيادة
قطاع
خدمات تموين
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
مارس 2023
رسالة
253
الأكثر إفادة#2

الخلاصة: تكامل الـ API هو عبارة عن جسر رقمي بيخلي بيانات الطلبات على موقعك وبرنامج المحاسبة يتكلموا مع بعض تلقائياً وفي نفس اللحظة من غير أي تدخل بشري. في عرض الوكالة، مينفعش يكتفوا بكتابة الكود بس؛ لازم يكون مكتوب صراحة مسؤولياتهم عن معالجة الأخطاء، ونظام النسخ الاحتياطي، وسجلات العمليات (logging)، والتحديثات الخاصة بالقوانين والتشريعات.

بالنسبة لشغلك، العملية دي بتتقسم لـ 3 مراحل أساسية: 1) خريطة تدفق البيانات: نقل الاسم والرقم الضريبي وسعر المنتج ونسبة الـ KDV من الموقع للخانات الصح في برنامج المحاسبة بدون أخطاء. 2) آلية معالجة الأخطاء: لو سيرفر المحاسبة واقع أو النت فصل، الطلب ميروحش عليك، السيستم يحطه في قائمة انتظار ويطلع الفاتورة أول ما الاتصال يرجع. 3) سجلات العمليات: عشان تقدر ترجع في أي وقت وتشوف كل طلب ارتبط بانهي رقم فاتورة وإمتى.

من ناحية التكلفة، في السوق الإسباني، تكلفة 1.800 يورو للبرمجة المخصصة لربط API الفواتير بالمتجر الإلكتروني تعتبر سعر سوق معقول جداً. لكن 150 يورو شهرياً صيانة لمجرد مراقبة السيستم دي كتيرة. لازم يدخل ضمن مبلغ الصيانة ده تعديل الربط مجاناً لو برنامج المحاسبة نزل تحديث لإصداره، وضمان تدخل طارئ لمدة ساعتين شهرياً على الأقل.

لازم تحط الشرطين دول في العقد بالذات: الأول، ضمان عدم التكرار (idempotency) عشان ميتصدرش فاتورتين لنفس الطلب. الثاني، إشعار فوري يوصلك على الإيميل وعلى لوحة التحكم في حال فشل إصدار فاتورة لأي طلب.

MMetin D***مشاركعضو المجتمع
تاريخ الانضمام
فبراير 2022
رسالة
406
#3

الـ API عامل زي مصافحة رقمية بين برنامجين، بس لو طرف فيهم حدّث نظامه، المصافحة دي بتبوظ. مينفعش بكرة برنامج الفواتير يغير متغير معين وتيجي الوكالة تقولك "ده شغل تطوير جديد وهندفعك عليه". لو هتدفع 150 يورو شهرياً، يبقى تحديثات الإصدارات لازم تكون مشمولة في المبلغ ده تماماً.

TTarık D***خبير
المسمى الوظيفي
مصدر
تاريخ الانضمام
سبتمبر 2023
رسالة
156
#4

15 ساعة شغل موظفين في الأسبوع يعني 60 ساعة في الشهر. لو حسبت تكلفة ساعة العمل والتأمينات الاجتماعية في إسبانيا، هتلاقي الإدخال اليدوي بيكلفك من 800 لـ 900 يورو شهرياً على الأقل. لو التكامل اشتغل صح، استثمار الـ 1.800 يورو هيرجعلك قيمته في شهرين ونصف.

GGürkan Ö***مشاركعضو المجتمع
تاريخ الانضمام
أغسطس 2024
رسالة
112
#5

قبل ما تمضي على أي حاجة، ادخل على الموقع الرسمي لبرنامج الفواتير اللي بتستعمله. أغلب البرامج المشهورة بتوفر أصلاً إضافات جاهزة ورسمية لمنصات التجارة الإلكترونية. لو في موديول جاهز هتتحل بـ 20-30 يورو شهرياً، ومش هتحتاج تخلي الوكالة تكتب كود من الصفر.

SSerkan U***مشارك
المسمى الوظيفي
رئيس الموقع
قطاع
تدريب
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
مايو 2025
رسالة
312
#6

موضوع الـ 150 يورو صيانة شهرية ده حركة وكالات معتادة؛ عايزين يعملوا السيستم مرة واحدة ويقعدوا يبعتولك فواتير كل شهر على الجاهز. خليك واضح معاهم في تفاصيل العرض واعرف بتاخد إيه بالظبط مقابل الـ 150 يورو دي في الشهور اللي مبيحصلش فيها أي مشكلة تقنية.

FFeyza S***مشاركعضو المجتمع
تاريخ الانضمام
أغسطس 2023
رسالة
251
#7

اطلب من الوكالة يكتبوا في المواصفات التقنية هل هيستخدموا webhooks ولا نظام cron بيشتغل على فترات. الـ webhooks بتطلع الفاتورة لحظياً. ولازم برضه يتم التحقق من الرقم الضريبي (VIES / NIF) وفلترته قبل ما يمر عبر الـ API.

HHüseyin T***مشاركعضو المجتمع
تاريخ الانضمام
يونيو 2025
رسالة
292
#8

إضافة بند الامتثال للائحة العامة لحماية البيانات الأوروبية (RGPD) في العقد ده إلزام قانوني. لأن بيانات هوية وعناوين العملاء هتتنقل بين السيرفرين، وبصفتهم معالج بيانات، لازم الوكالة تتحمل مسؤولية أي ثغرات أمنية ممكن تحصل.

BBurcu A***مشارك
المسمى الوظيفي
مدير العمليات التنفيذي
قطاع
مستحضرات تجميل
نوع المنظمة
وكيل إقليمي
تاريخ الانضمام
يناير 2022
رسالة
5

Doki · تطبيق الجوال · 2026

#9

كتابة 500 فاتورة يدوي في الشهر دي كابوس وضغط شغل رهيب. متقلقش من فلوس التركيب في الأول؛ لو عملت العقد صح وربطت النظام، هتعرف من أول أسبوع إن الموضوع يستاهل كل قرش وريحك من وجع الدماغ والوقت الضايع.

DDamla E***محارب قديم
المسمى الوظيفي
ممثل خدمة العملاء
قطاع
نقل بضائع
نوع المنظمة
وكالة بوتيك
تاريخ الانضمام
أغسطس 2024
رسالة
414
#10

ما كُتب هنا يطابق تماماً ما عشناه. لا تترددوا في السؤال، فالسائل يدفع ثمناً أقل دائماً.

إذا حصلت على ثلاث إجابات مختلفة حول موضوع ما، فالسؤال طرح بشكل خاطئ. أتمنى أن يفيدك هذا.

İİbrahim Y***خبير
المسمى الوظيفي
مدير مشاريع
قطاع
ورق
نوع المنظمة
وكالة بوتيك
تاريخ الانضمام
يناير 2023
رسالة
120
#11

عندنا نفس المشكلة. القرار المتسرع يصبح قراراً يُصحح بعد ستة أشهر.

الحلول التي تنجح على نطاق صغير تنهار عند التوسع، تعلمت هذا متأخراً. هذا كل شيء، أرجو المعذرة إذا أطالت.

EEmre B***مشارك
المسمى الوظيفي
موظف إدخال بيانات
قطاع
الإعلانات والترويج
نوع المنظمة
سلسلة متاجر
تاريخ الانضمام
سبتمبر 2024
رسالة
24
#12

هذا العنوان مؤرشف. تقرير التقدم الأسبوعي المكتوب أكثر فائدة من السؤال المستمر عن المواعيد.

بالتوفيق.

MMert Ş***مشارك
المسمى الوظيفي
مدير علاقات العملاء
قطاع
تجارة تجزئة
نوع المنظمة
وكيل إقليمي
تاريخ الانضمام
مايو 2025
رسالة
195
#13

لهذا النهج ثمن، لكنه لا يُناقش. اسألوا من أعد العرض ومن سينفذ العمل.

عندما نتخذ قرارات دون قياس، نعود لنفس النقطة دائماً. بالطبع يختلف الأمر إذا كانت حالتك مختلفة.

GGürkan Y***مشاركعضو المجتمع
تاريخ الانضمام
يوليو 2023
رسالة
8
#14

شكرًا جزيلاً، سأجربها اليوم.

FFurkan K***عضو جديد
المسمى الوظيفي
خبير اختبار
قطاع
خدمات تموين
نوع المنظمة
شركة بـ 120 موظف
تاريخ الانضمام
سبتمبر 2026
رسالة
258
#15

صحيح.

HHavva B***مشاركعضو المجتمع
تاريخ الانضمام
ديسمبر 2023
رسالة
4
#16

أنا أيضًا أوافق على هذا الرأي. كل من يستعجل في تكامل API في تطوير الويب يتعثر في نفس النقطة.

ÖÖzge T***مشارك
المسمى الوظيفي
فني مراقبة الجودة
قطاع
مجوهرات
نوع المنظمة
ورشة تصنيع
تاريخ الانضمام
فبراير 2023
رسالة
193
#17

هناك نقطة أثارت فضولي. الكود بدون وثائق تثبيت لا يُعتبر ملكك حتى لو كان بين يديك.

أكثر ما أهدر وقتنا كان عدم وضوح من يتخذ القرار. هذا كل شيء، أرجو المعذرة إذا أطالت.

PPolat A***مشاركعضو المجتمع
تاريخ الانضمام
أبريل 2023
رسالة
413
#18

صحيح نظرياً، لكنه لا يسير هكذا عملياً. محاولة فعل هذا بمفردك هي أغلى الطرق.

مثبت بالتجربة.

EEsra A***مشارك
المسمى الوظيفي
فني صيانة
قطاع
الخدمات الصحية
نوع المنظمة
شركة بـ 120 موظف
تاريخ الانضمام
ديسمبر 2025
رسالة
9
#19

تم الحفظ. إذا لم تقم بصياغة هذا كتابيًا من البداية، فستنشأ خلافات لاحقًا.

إذا كتبت النتيجة هنا، فستفيد الآخرين أيضاً.

PPınar K***مشاركعضو المجتمع
تاريخ الانضمام
فبراير 2026
رسالة
17
#20

أحسنت، بارك الله في جهدك. عند اتخاذ القرار، اكتب أسوأ سيناريو أيضًا، وليس الأفضل فقط.

اكتبوا إذا كانت لديكم أسئلة، سأجيب قدر استطاعتي.

اكتب رداً