UUID zinciri: her makbuz bir öncekine nasıl bağlanır
Her makbuzun UUID’si içeriğinin SHA-256 özetidir ve bu içerik aynı satış noktasından önceki makbuzun UUID’sini de kapsar; böylece makbuzlar, hiçbir halkası fark edilmeden kaybolamayan bir zincir oluşturur.
ETA’nın adımları: aynı satış noktasından önceki makbuzun UUID’si (ve iadede asıl makbuzun atfı) dahil her alanı ekleyin; makbuzun kendi UUID’sini boş bırakın; makbuzu tek satıra serileştirin; SHA-256 ile özetleyin; 32 baytı 64 onaltılık karaktere dönüştürün ve alana yazın.
Bir satış noktasının ilk makbuzunda previousUUID boştur; sonraki her makbuz öncülünün UUID’sini taşır. Eski bir makbuzda tek bir karakteri değiştirin, özeti değişir ve sonraki makbuzun kaydettiği değerle artık eşleşmez.
Reddedilen bir makbuz zinciri koparmaz: ETA’nın örneğinde R1 ile R3 arasındaki R2 reddedilir; yeni bir UUID ile R2* olarak düzeltilir, öncülü olarak R1’i korur, R2’yi gösteren bir referenceOldUUID ekler ve R3 olduğu gibi kalır.
JooDax’ta
HazırJooDax özeti bu adımlarla hesaplar ve makbuza yazar; testler özeti ve zinciri kapsar. Modül her satış noktasının son UUID’sini saklamaz; ne referenceOldUUID’yi ne de iade atfını oluşturur. Koddaki açıklama alanın boşaltılmasını doğrulanmamış sayar; oysa ETA’nın adımları bunu açıkça söyler.
crates/jdx-einvoice-eg/src/lib.rs; crates/jdx-einvoice-eg/src/tests.rs
Adımlar
- Aynı satış noktasından önceki makbuzun UUID’sini previousUUID’ye yazın (ilk makbuzda boş).
- uuid alanını boş bırakın.
- Makbuzu ETA’nın kurallarına göre tek satıra serileştirin.
- Metni SHA-256 ile özetleyin ve 64 onaltılık karaktere dönüştürün.
- Sonucu uuid alanına yazın ve sonraki makbuzun previousUUID değeri olarak saklayın.
Sorular ve yanıtlar
Zincirin ortasındaki bir makbuz reddedilirse ne olur?
Düzeltilir ve yeni bir UUID alır; öncülünü korur ve reddedilen makbuza bir referenceOldUUID ekler. Geçersiz kılınmış bir makbuza atıf yapan düzeltme 96 saat içinde, eşleşen atfı olmayan düzeltme ise 72 saat içinde kabul edilir; bir geç gönderim talebi kapsamındaysa bu süreler aranmaz.
İlgili sayfalar
İlgili kavramlar
- ETA’nın bir belgeyi kanonik serileştirmesiÖzetlemeden önce belge sabit kurallarla tek satırlık bir metne dönüşür: alan adları tırnak içinde büyük harfle, değerler olduğu gibi, dizi adı her öğeden önce.
- Çevrim dışı düzenleme ve 24 saatlik süreMakbuz yerel olarak düzenlenir ve denetlenir, ardından 24 saat içinde gönderilir; daha sonrası için geç gönderim talebi gerekir.
Kaynaklar
- Receipt Issuance FAQ — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Receipt v1.2 (v1.2) — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Document Serialization Approach — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
Kontrol tarihi: 4 Kasım 2026. JooDax’la ilgili her şey programların kendi kodundan alınmıştır.