Azərbaycan e-qaimə Elektron Fakturalaşdırma
Dövlət Vergi Xidmətinin elektron qaimə-faktura (e-qaimə) XML-ini yaradın, VÖEN-i yoxlayın, 18% ƏDV tətbiq edin, öz açarınızla imzalayın və öz portal məlumatlarınızla ötürün - BYOK.
Dövlət Vergi Xidmətinin e-qaiməsi üçün
Azərbaycan Respublikasında ƏDV qeydiyyatında olan vergi ödəyiciləri B2B və B2G təchizatları üçün strukturlaşdırılmış elektron qaimə-fakturanı (e-qaimə-faktura) Dövlət Vergi Xidmətinin e-faktura portalı vasitəsilə, rəqəmsal imza ilə təsdiqlənmiş şəkildə təqdim etməlidirlər. Bu modul Odoo müştəri fakturasını uyğun e-qaimə XML sənədinə çevirir, onu sənədləşdirilmiş biznes qaydalarına uyğun yoxlayır, öz imzalama açarınızla möhürləyir və əl ilə yükləmək üçün imzalanmış faylı hazırlayır (rəsmi dəstəklənən üsul). Uyğun endpoint-i olan hesablar üçün təcrübi/doğrulanmamış API ötürülmə rejimi də var - Azərbaycan rəsmi maşın-maşın e-qaimə API-si dərc etmədiyi üçün fayl rejimi tövsiyə olunan standartdır.
VÖEN yoxlaması
Şirkət və tərəfdaşlarda 10 rəqəmli VÖEN-in (Vergi Ödəyicisinin Eyniləşdirmə Nömrəsi) struktur yoxlaması: rəqəm sayı, aparıcı-sıfıra davamlı saxlama və hüquqi-status markeri (1 = hüquqi şəxs, 2 = fiziki şəxs). Hüquqi status avtomatik müəyyən edilir və axtarış üçün saxlanılır.
Düzgün Azərbaycan ƏDV-si
Yalnız qanuni Azərbaycan dərəcələri tətbiq edilir - 18% standart, ixrac və beynəlxalq daşımalar üçün 0% və azad edilmiş təchizatlar. Hər hansı başqa dərəcə rədd edilir, beləliklə e-qaimə heç vaxt uydurma 5% və ya 10% dərəcəsi daşıya bilməz. Bütün məbləğlər AZN-də dəqiq onluq hesabla hesablanır.
Kanonik e-qaimə XML
Satıcı və alıcı blokları (ad, ünvan, VÖEN), başlıq (unikal nömrə, verilmə tarixi, valyuta), hər mal üçün bir sətir (təsvir, miqdar, vahid qiymət, xalis, ƏDV kodu/dərəcəsi/məbləği, ümumi), dərəcə üzrə ƏDV xülasəsi və sənəd yekunları ilə deterministik XML. Kredit qaimələri orijinal fakturaya istinad edir.
BYOK rəqəmsal imza
Sənəd öz şəxsi açarınızla (PEM) RSA-SHA256 imzası, üstəlik SHA-256 dijesti ilə möhürlənir. Biz sertifikat orqanı deyilik və heç vaxt məlumatları birləşdirmirik - portalda əvəzində Asan İmza ilə imzaladığınızda, yükləmək üçün imzasız kanonik XML hazırlanır.
İmzalanmış fayl və (təcrübi) portal ötürülməsi
Əsas və rəsmi olaraq dəstəklənən üsul: imzalanmış e-qaimə XML faylını hazırlayın və Dövlət Vergi Xidmətinin e-faktura portalına əl ilə yükləyin. API ilə birbaşa ötürülmə TƏCRÜBİ və DOĞRULANMAMIŞDIR: Dövlət Vergi Xidməti rəsmi maşın-maşın (machine-to-machine) e-qaimə API-si dərc etməyib, ona görə bu rejim yalnız hesabınıza verilmiş uyğun bir endpoint-i özünüz təyin etdikdə işləyir. Hər iki halda tam sorğu/cavab ötürmə jurnalı və status sorğu cron-u mövcuddur.
Toplu ixrac
Bir çox müştəri fakturasını seçin və onların e-qaimə sənədlərini bir əməliyyatda yaradın (və ya yaradıb təqdim edin), imzalanmış XML fayllarının ZIP arxivini hər faktura üzrə nəticə xülasəsi ilə yükləyin.
Nə yaradılır
| Sahə | Təfərrüat |
|---|---|
| Sənəd növləri | Faktura və kredit qaiməsi (orijinal-faktura istinadı ilə) |
| ƏDV kodları | S (18%), Z (0% ixrac / beynəlxalq daşıma), E (azad) |
| Valyuta | AZN, xarici valyuta istifadə olunduqda xəbərdarlıq ilə |
| Tərəflər | Satıcı və alıcı adı, ünvanı, şəhəri, ölkəsi və VÖEN-i |
| Möhür | SHA-256 dijesti + ixtiyari RSA-SHA256 imzası (BYOK) |
| Ötürülmə | Portal API (BYOK məlumatları) və ya əl ilə yükləmə üçün imzalanmış fayl |
Biznes qaydalarının yoxlanması
E-qaimə yaradılmadan və ya təqdim edilmədən əvvəl, qatlı qaydalar dəsti uyğunsuz sənədləri bloklayır: mövcud faktura nömrəsi və verilmə tarixi, struktur baxımından düzgün satıcı VÖEN-i, B2B təchizatlar üçün alıcı VÖEN-i, ən azı bir sətir, yalnız qanuni ƏDV kodları və sətirlər, ƏDV ara-yekunları ilə sənəd yekunları arasında tam riyazi uyğunluq. Hər tapıntı sabit kod daşıyır ki, fakturanı tez düzəldəsiniz.
Məlumatın məxfiliyi
Portal məlumatlarınız və imzalama açarlarınız yalnız öz verilənlər bazanızda saxlanılır və yalnız öz e-qaimə sənədlərinizi konfiqurasiya etdiyiniz portala imzalamaq və ötürmək üçün istifadə olunur. Heç bir şey başqa yerə göndərilmir.
Odoo 18 və 19 ilə uyğundur, Community və Enterprise. Yalnız standart Mühasibatlıq tətbiqini tələb edir.
English
Azerbaijan e-qaime Electronic Invoicing
VAT-registered taxpayers in the Republic of Azerbaijan must issue the structured electronic invoice (e-qaime-faktura) for B2B and B2G supplies through the State Tax Service e-invoice portal, authorised with a digital signature. This module turns an Odoo customer invoice into a compliant e-qaime XML document, validates it against the documented business rules, seals it with your own signing key, and produces the signed file for manual upload to the portal (the officially supported route). An experimental, unverified API transmission mode is also included for accounts that expose a compatible endpoint: Azerbaijan has not published an official machine-to-machine e-qaime API, so file mode is the recommended default.
VOEN, VAT & canonical XML
10-digit VOEN structural validation with legal-status marker. Only the legal Azerbaijan rates are emitted - 18% standard, 0% for exports/international transport, and exempt; any other rate is rejected. Deterministic e-qaime XML with seller/buyer blocks, per-line detail, per-rate VAT summary and credit-note references, all in AZN.
BYOK signature, transmission & batch
RSA-SHA256 signature with your own PEM key plus a SHA-256 digest (or unsigned canonical XML for Asan Imza). BYOK portal transmission with a transport log and status-poll cron, plus a batch export to a ZIP of signed XML. A layered business-rule validator blocks non-compliant documents. Odoo 18 and 19, Community and Enterprise.
Screenshots
Export E Qaim
Portal Connections
Update date: 2026-07-02