Fatura ve HKS

Yasal belge ve künye

Fatura, sipariş teslim edildikten sonra üretilir. HKS bildirimi fatura öncesinde elden geldiğince denenir; başarısızlık faturayı tek başına durdurmak zorunda değildir (kodda best-effort).

Ne zaman kesilir?

OrderInvoiceService her gün 07:00’de (İstanbul) son teslim tarihi uygun alıcılar için fatura üretimini tarar. Operasyon ayrıca sipariş veya tarih aralığıyla da tetikleyebilir.

Aynı siparişe ikinci kez fatura gömülmez: belgede invoice alanı doluysa atlanır. Üretim sırasında kullanıcı kilidi (MurLock) alınır.

Üretim sırası

Adres kontrolü

Alıcının fatura adresinde vergi / kimlik / daire / doğum tarihi gibi alanlar doğrulanır. Eksik bilgi CRM problem tipi ile de işaretlenebilir.

HKS

Sipariş kalemleri HKS ürünüyse stok çıkış bildirimi kurulur, HKS API’ye gönderilir, kalan miktar künye no ile güncellenmeye çalışılır. Yanıt kalemin hksNotifications dizisine yazılır.

İzibiz

Kalemler e-belge satırına çevrilir. HKS’li ürünlerde ilgili profil seçilir. İzibiz belge numarası InvoiceSequence tablosundan (tip + önek + yıl) ilerler.

Kayıt

Mongo invoices belgesi oluşur. Siparişin içine kısa invoice özeti (belge no, UUID, tarih, tutar, vergi) gömülür. Gerekirse cari hareket yazılır.

Gelen tedarikçi faturası

İzibiz gelen kutusu platformInvoices koleksiyonuna yazılır. stockProcessed / stockNotApplicable bayrakları stok girişine bağlanıp bağlanmadığını gösterir. Web kancası izibiz yolundadır ve herkese açıktır (sağlayıcı çağrısı).

HKS’nin diğer yüzü

HKS yalnız fatura anında değildir:

Ürün kartında ProductHks kodları
Depo ve coğrafyada hksCode
Eski stok girişinde hksRaw
HksInvoiceTracker ile künye arama sayacı
21:30 cron’u stok ön bildirimi

HKS ürün tipi ve şube sorguları HksService üzerindendir; ayrı bir HTTP denetleyicisi yoktur.

Şema: Cari ve fatura numarası, Cari ve fatura (Mongo).