هذا المتصفح غير مدعوم. يرجى استخدام متصفح أحدث.
الربط مع متجرك في سلة غير مفعل حاليا. تأكد من تفعيل وتسجيل الدخول في حسابك لدينا، وتثبيت تطبيق "فرس للفوترة" في متجر تطبيقات سلة.
سيظهر مفتاح API الخاص بك هنا عند تسجيل الدخول.
الارتباط بالواجهة البرمجية لـ فرس للفوترة سهل، واضح، ومباشر. الواجهة تمكنك من طلب تصدير فاتورة جديدة وإرسالها للعميل، والحصول على رابط مباشر للفاتورة.
كل ما عليك هو الاتصال برابط الواجهة باستخدام طريقة POST عبر بروتوكول HTTPS مع إرفاق مفتاح API الخاص بك. إرسال واستقبال البيانات عبر الواجهة يتم عن طريق صيغة JSON. (إذا كانت المصطلحات السابقة غير واضحة، نقترح في البداية البحث عن موضوع الربط مع الواجهات البرمجية عبر الويب، لتعلم ومعرفة أساسياتها.)
حاليا نقوم بتوفير خدمة تصدير الفواتير عن طريق الرابط التالي: https://faras.io/api_newinvoice
We always expect a POST JSON request (over https only) with at least an API key provided. A JSON response will always return to you with either a result or an error with explanation.
https://faras.io/api_newinvoice
Use this endpoint to generate a new invoice, and retrieve a URL of the invoice. Request parameters Marked with (*) are required.
Key
* [string] : Your API key. Error will be returned if you don't provide a valid keyProducts
[List] list of json objects, Each with the following structure: ProductName
[String],Quantity
[Integer] , Price
[Float] . At least one product (object) must be provided.
Customer
[object] : with the following: Name *
[String],
PhoneNumber
[Integer]
ID
[String],
Email
[String],
TestMode
[integer] A flag indicates whether the request is in test or live mode. default is 1 (test).
Error_code
: Options are:0
: No errors,
1
: Error exists. error_msg
has the details.
Error_msg
: If error/warning exists, the explanation is provided here.InvoiceURL
: URL of the generated invoice
InvoicePDFURL
: URL of the generated invoice in PDF format
/api_newinvoice/
//request
{'Key': 'your-api-key',
'Products': [{'ProductName': 'طاولة طعام',
'Quantity': 4, 'Price': 55.5}], 'Customer': {'Name': 'سامي محمد',
'PhoneNumber': 966555555555, 'ID': 45886, 'Email':
'test@example.com'}, 'TestMode': 1}
//response
{'Error_code': 0, 'Error_msg': '',
'InvoiceURL': 'https://faras.io/inv/VvAr5Zg',
'InvoicePDFURL': 'https://faras.io/i/VvAr5Zg.pdf'}