ForHosting KIT · المستندات وملفات PDF

أنشئ إيصالاً منظماً مع الإجماليات المفصلة

حوّل بيانات الشراء إلى إيصال متسق من دون إعادة بناء الحسابات والتنسيق في كل تطبيق. أدخل اسم التاجر وبنداً واحداً على الأقل وطريقة الدفع. تحسب الأداة المجاميع الفرعية والضرائب والإجمالي، ثم تمنح الإيصال رقماً ثابتاً. يمكن حفظ JSON الناتج أو عرضه أو ربطه بطلب أو تمريره إلى مسار مستندات آخر.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

جهّز بيانات الإيصال كاملة

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

افهم الحسابات ورقم الإيصال

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

ادمج المستند المنظم في سير العمل

تفصل الاستجابة بين الهوية والتاجر والبنود المحسوبة والدفع والمجاميع. يسهّل ذلك عرض إيصال للطباعة أو حفظ شراء موحّد أو ملء رسالة أو تغذية مولّد PDF. احفظ الاستجابة مع الطلب الأصلي لتيسير المطابقة لاحقاً. يصلح الرقم الثابت مرجعاً عملياً، لكن يجب أن تفرض قاعدة البيانات قواعد التفرد والصلاحيات الخاصة بها. تُرفض المدخلات الناقصة أو غير الصحيحة بوضوح ولا تُخترع لها قيم. لا تستخدم الأداة شبكة أو تخزيناً أو التاريخ الحالي أو العشوائية، ولذلك تبقى النتائج قابلة للتكرار. تبلغ تكلفة كل طلب $0.002، وتناسب الأداة مسارات المعاملات الصغيرة التي تحتاج إلى بيانات إيصال متوقعة.

أنشئ إيصال طلب

حوّل بنود الشراء ووصف الدفع المحجوب إلى سجل متسق للحفظ أو العرض.

حضّر بيانات PDF

احسب البنود والمجاميع بدقة قبل تمرير البيانات المنظمة إلى عارض PDF.

وحّد المبيعات اليدوية

حوّل مدخلات نقطة البيع أو الإدارة إلى مخطط متوقع للمطابقة ودعم العملاء.

ما التكلفة؟

تبلغ تكلفة كل طلب API مقدار $0.002.

هل يمكن إنشاء إيصال بلا بنود؟

لا. يلزم بند واحد على الأقل، وتؤدي القائمة الفارغة إلى خطأ إدخال غير صالح.

كيف تُحسب الضرائب؟

تُحسب ضريبة كل بند من مجموعه الفرعي المقرّب، ثم تُجمع ضرائب البنود.

هل رقم الإيصال عشوائي؟

لا. يُشتق من البيانات الموحّدة، ولذلك تنتج المدخلات المتطابقة الرقم نفسه.

هل ينشئ هذا فاتورة ضريبية نظامية؟

لا. تقع مسؤولية متطلبات الترقيم والتسجيل والإفصاح المحلية على المستخدم.

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

POSThttps://api.kit.forhosting.com/doc/receipt-generate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

curl -X POST https://api.kit.forhosting.com/doc/receipt-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"merchant_name":"Northwind Coffee","line_items":[{"description":"Cappuccino","quantity":2,"unit_price":4.5,"tax_rate":8.25},{"description":"Blueberry muffin","quantity":1,"unit_price":3.25}],"payment_method":"Visa ending 4242"}'
{
  "merchant_name": "Northwind Coffee",
  "line_items": [
    {
      "description": "Cappuccino",
      "quantity": 2,
      "unit_price": 4.5,
      "tax_rate": 8.25
    },
    {
      "description": "Blueberry muffin",
      "quantity": 1,
      "unit_price": 3.25
    }
  ],
  "payment_method": "Visa ending 4242"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.receipt_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

max_mb25
max_pages200
HTTPالرمزالمعنى
401unauthorizedمفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
402insufficient_balanceرصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
404unknown_typeنوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
429rate_limitedتجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←