# سكان تو بيل | ScanToBill

> منصة ذكاء اصطناعي لاستخراج بيانات المستندات التجارية. ارفع فواتيرك أو إيصالاتك أو سجلاتك التجارية وشهاداتك الضريبية واستلم JSON منظماً فوراً.
>
> AI-powered business document extraction platform. Upload invoices, receipts, commercial registers, VAT certificates, and other documents — receive structured JSON instantly.

---

## الملخص بالعربية

### ما هو سكان تو بيل؟
سكان تو بيل منصة OCR بالذكاء الاصطناعي متخصصة في استخراج البيانات من المستندات التجارية العربية والإنجليزية. تحوّل الصور وملفات PDF إلى JSON منظم في أقل من ثانيتين.

### أنواع المستندات المدعومة
- الفواتير (عربية وإنجليزية، فواتير ضريبية، فواتير VAT)
- إيصالات نقاط البيع
- السجلات التجارية السعودية
- شهادات ضريبة القيمة المضافة
- بطاقات العنوان الوطني
- أوامر الشراء

### القدرات الرئيسية
- استخراج JSON منظم من الفواتير والمستندات التجارية
- دعم أصلي للعربية مع اكتشاف RTL التلقائي
- درجات ثقة لكل حقل مستخرج
- توجيه ذكي لمزودي OCR (Mindee وGoogle Cloud Document AI)
- REST API مع مواصفات OpenAPI على /api/v1/openapi.json
- خادم MCP (Model Context Protocol) على /api/mcp للتكامل المباشر مع عملاء الذكاء الاصطناعي
- Webhooks لأحداث الاستخراج والفوترة الفورية
- معالجة دفعية حتى 50 مستنداً في طلب واحد

### الأسعار (بالريال السعودي)
ثلاث باقات شهرية حسب حجم الاستخدام:
- باقة 100 فاتورة: 100 فاتورة/شهر — 32.34 ريال/شهر
- باقة 500 فاتورة: 500 فاتورة/شهر — 161.72 ريال/شهر (الأكثر طلباً)
- باقة 1,000 فاتورة: 1,000 فاتورة/شهر — 323.44 ريال/شهر (تشمل المعالجة الدفعية ومفاتيح API متعددة)

يبدأ كل حساب جديد بفترة تجريبية مجانية (20 استخراجاً/شهر) دون بطاقة ائتمانية.

### اللغات المدعومة
- العربية (ar) — دعم أصلي RTL، مُحسَّن لسوق الخليج العربي
- الإنجليزية (en)
- المستندات متعددة اللغات (كشف تلقائي)
- الفرنسية (fr) — عبر Google Cloud Document AI
- الإسبانية (es) — عبر Google Cloud Document AI

### بدء التكامل السريع
POST /api/invoice/extract مع header: Authorization: Bearer <api_key>

طرق الإدخال:
1. رفع ملف: multipart/form-data حقل "file" (JPEG، PNG، WebP، PDF — حتى 15 MB)
2. Base64: application/json حقل "image_base64"
3. URL: application/json حقل "image_url" (رابط عام)

معامل اختياري: "document_type" (invoice | receipt | commercial_register | vat_certificate | national_address | purchase_order)

### تكامل MCP لعملاء الذكاء الاصطناعي
GET /api/mcp — بيان الخادم وقائمة الأدوات
POST /api/mcp/tools/call — تنفيذ أداة (يتطلب Bearer API key)

أدوات MCP المتاحة:
- extract_document: استخراج البيانات من مستند على رابط URL عام. معامل document_type اختياري: auto | inventory | general | pos (الافتراضي: auto)
- list_extractions: قائمة الاستخراجات السابقة مع فلاتر اختيارية
- get_extraction: بيانات تعريفية لاستخراج محدد بواسطة ID

### تثبيت Claude Desktop / npx
npx @sajlha_sa/mcp-server --api-key ocr_sk_YOUR_KEY

أضف إلى claude_desktop_config.json:
  {
    "mcpServers": {
      "scantobill": {
        "command": "npx",
        "args": ["-y", "@sajlha_sa/mcp-server", "--api-key", "ocr_sk_YOUR_KEY"]
      }
    }
  }

---

## English Summary

### What is ScanToBill?
ScanToBill is an AI-powered OCR platform specialising in Arabic and English business document data extraction. It converts images and PDFs to structured JSON in under 2 seconds.

### Supported document types
- Invoices (Arabic and English, tax invoices, VAT invoices)
- Receipts / POS
- Saudi commercial registers
- VAT certificates
- National address cards
- Purchase orders

### Core capabilities
- Structured JSON extraction from invoices and business documents
- Native Arabic support with automatic RTL detection
- Per-field confidence scores for every extracted value
- Intelligent provider routing: Mindee and Google Cloud Document AI
- REST API with full OpenAPI spec at /api/v1/openapi.json
- MCP (Model Context Protocol) server at /api/mcp for direct AI agent integration
- Webhooks for real-time extraction and billing events
- Batch processing up to 50 documents per job

### Pricing (Saudi Riyal)
Three monthly plans sized by volume:
- 100 Invoices: 100 invoices/month — 32.34 SAR/month (≈ $9)
- 500 Invoices: 500 invoices/month — 161.72 SAR/month (≈ $43) — most popular
- 1,000 Invoices: 1,000 invoices/month — 323.44 SAR/month (≈ $86) — includes batch processing and multiple API keys

New accounts start with a free trial (20 extractions/month) — no credit card required.

### Supported languages
- Arabic (ar) — native RTL support, optimised for GCC market
- English (en)
- Mixed Arabic/English documents (detected automatically)
- French (fr) — via Google Cloud Document AI
- Spanish (es) — via Google Cloud Document AI

### API quick start
POST /api/invoice/extract with Authorization: Bearer <api_key> header.

Input methods:
1. File upload: multipart/form-data with field "file" (JPEG, PNG, WebP, PDF — max 15 MB)
2. Base64: application/json with field "image_base64"
3. URL: application/json with field "image_url" (public URL)

Optional: include "document_type" field (invoice | receipt | commercial_register | vat_certificate | national_address | purchase_order). Default: invoice.

### Response schema
Successful extractions return JSON with:
- invoice_number, date, due_date
- vendor: { name, address, phone, email, vat_number, website }
- customer: { name, address, phone, email, customer_id, vat_number }
- line_items: [{ description, quantity, unit_price, discount, total, product_code }]
- subtotal, tax_amount, tax_rate, discount, grand_total, currency
- purchase_order, payment_term
- language_detected (ar | en | mixed | null)
- provider_used
- confidence scores per field

### Authentication
All API requests require an Authorization: Bearer <api_key> header.
API keys are created in the dashboard at /keys. Keys are prefixed with "ocr_sk_".

### Docs
- API reference (interactive): /docs
- OpenAPI spec (JSON): /api/v1/openapi.json
- OpenAPI spec (YAML): /api/v1/openapi.yaml
- MCP server manifest: /api/mcp