بوابة الربط البرمجي (REST API & SDK) لإصدار فواتير زاتكا من منصتك أو متجرك

// 1. إرسال الفاتورة من منصتك أو متجرك الإلكتروني إلى بوابة تمكين:
$response = Http::withHeaders([
    'X-API-KEY'    => env('TAMKEEN_API_KEY'),
    'X-API-SECRET' => env('TAMKEEN_API_SECRET'),
])->post('https://account.tmken.sa/api/v1/invoices', [
    'reference_id'  => 'ORD-9051',
    'invoice_type'  => 'simplified',
    'customer_name' => 'عبدالله العتيبي',
    'items' => [
        ['name' => 'باقة اشتراك سنوي', 'quantity' => 1, 'unit_price' => 1000.00, 'vat_rate' => 15.0]
    ]
])->json();

// 2. استلام رابط الفاتورة الموقّع (Signed PDF URL) وكود الـ QR فوراً في نفس اللحظة:
$pdfUrl        = $response['data']['downloads']['pdf_url'];
$invoiceNumber = $response['data']['invoice_number'];
$qrCodeBase64  = $response['data']['zatca']['qr_code'];