أنشئ إيصالاً منظماً مع الإجماليات المفصلة
حوّل بيانات الشراء إلى إيصال متسق من دون إعادة بناء الحسابات والتنسيق في كل تطبيق. أدخل اسم التاجر وبنداً واحداً على الأقل وطريقة الدفع. تحسب الأداة المجاميع الفرعية والضرائب والإجمالي، ثم تمنح الإيصال رقماً ثابتاً. يمكن حفظ JSON الناتج أو عرضه أو ربطه بطلب أو تمريره إلى مسار مستندات آخر.
شغّل الأداة مجانًا
جهّز بيانات الإيصال كاملة
أدخل اسم التاجر كما ينبغي أن يظهر، ثم أضف كل منتج أو خدمة في بند مستقل. يحتاج كل بند إلى وصف وكمية وسعر وحدة. تدعم الكميات الكسور، ولذلك تلائم السلع المقاسة والساعات والوزن والمسافة. أضف معدل الضريبة للبند الخاضع لها فقط. استخدم وصفاً صالحاً للعرض لطريقة الدفع، مثل النقد أو التحويل أو بطاقة محجوبة الأرقام، ولا ترسل بيانات دفع سرية كاملة. العملة اختيارية وقيمتها الافتراضية USD. تجعل الأوصاف الموجزة وبيانات الدفع المحمية السجل واضحاً ومناسباً للحفظ. يجب تقديم بند واحد على الأقل، إذ لا يمكن لعملية شراء فارغة أن تنتج إيصالاً مفيداً.
افهم الحسابات ورقم الإيصال
تحول الأداة كل سعر إلى وحدات العملة الصغرى قبل ضربه في الكمية، فتتجنب أخطاء الفاصلة العائمة. يُقرّب المجموع الفرعي لكل بند ثم تُحسب ضريبته. يجمع المجموع الفرعي العام مجاميع البنود، وتجمع الضريبة الكلية ضرائبها، ويضم الإجمالي النهائي القيمتين. يطابق مبلغ الدفع ذلك الإجمالي دائماً. يُشتق رقم الإيصال من البيانات الموحّدة، ولذلك يعيد الطلب المطابق الرقم نفسه، مما يفيد في إعادة المحاولة وكشف التكرار. لكنه ليس تسلسلاً ضريبياً رسمياً ولا تصريحاً حكومياً ولا رقماً محاسبياً تفرضه الأنظمة. ينبغي للمؤسسات إدارة أرقامها النظامية المطلوبة بصورة مستقلة.
ادمج المستند المنظم في سير العمل
تفصل الاستجابة بين الهوية والتاجر والبنود المحسوبة والدفع والمجاميع. يسهّل ذلك عرض إيصال للطباعة أو حفظ شراء موحّد أو ملء رسالة أو تغذية مولّد PDF. احفظ الاستجابة مع الطلب الأصلي لتيسير المطابقة لاحقاً. يصلح الرقم الثابت مرجعاً عملياً، لكن يجب أن تفرض قاعدة البيانات قواعد التفرد والصلاحيات الخاصة بها. تُرفض المدخلات الناقصة أو غير الصحيحة بوضوح ولا تُخترع لها قيم. لا تستخدم الأداة شبكة أو تخزيناً أو التاريخ الحالي أو العشوائية، ولذلك تبقى النتائج قابلة للتكرار. تبلغ تكلفة كل طلب $0.002، وتناسب الأداة مسارات المعاملات الصغيرة التي تحتاج إلى بيانات إيصال متوقعة.
حالات الاستخدام
أنشئ إيصال طلب
حوّل بنود الشراء ووصف الدفع المحجوب إلى سجل متسق للحفظ أو العرض.
حضّر بيانات PDF
احسب البنود والمجاميع بدقة قبل تمرير البيانات المنظمة إلى عارض PDF.
وحّد المبيعات اليدوية
حوّل مدخلات نقطة البيع أو الإدارة إلى مخطط متوقع للمطابقة ودعم العملاء.
الأسئلة الشائعة
ما التكلفة؟
تبلغ تكلفة كل طلب API مقدار $0.002.
هل يمكن إنشاء إيصال بلا بنود؟
لا. يلزم بند واحد على الأقل، وتؤدي القائمة الفارغة إلى خطأ إدخال غير صالح.
كيف تُحسب الضرائب؟
تُحسب ضريبة كل بند من مجموعه الفرعي المقرّب، ثم تُجمع ضرائب البنود.
هل رقم الإيصال عشوائي؟
لا. يُشتق من البيانات الموحّدة، ولذلك تنتج المدخلات المتطابقة الرقم نفسه.
هل ينشئ هذا فاتورة ضريبية نظامية؟
لا. تقع مسؤولية متطلبات الترقيم والتسجيل والإفصاح المحلية على المستخدم.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة 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"}'const res = await fetch("https://api.kit.forhosting.com/doc/receipt-generate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"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"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/receipt-generate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"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 = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/receipt-generate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"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 = json_decode($res, true);body := bytes.NewBufferString(`{"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"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/receipt-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"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 فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_mb | 25 |
max_pages | 200 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |