Multinet Entegrasyonu

Sekmeler: Durum, Yükleme Planları, İşlemler, Kart Eşleştirme; yöneticiler için ayrıca Hesaplar ve Sözleşme ve Denetim.

Akış

1. Kart eşleştir: çalışanı Multinet kartıyla eşleştirin. Kart referansı metindir; baş sıfırlar korunur. "Yemek kartı listesinden doğrula" ile Yemek Kartı ekranındaki kartlar toplu eşleştirilir.
2. Plan hazırla: bir yemek kartı siparişinden yükleme planı çıkarın. Plana alınamayan çalışanlar (kart eşleşmesi yok, pasif, tutar geçersiz, sınır aşıldı…) neden kodlarıyla özetlenir.
3. Onaya gönder: taslak plan Onay Kutusuna düşer. Onaylanan plan değişmez.
4. Kuyruk ve işçi: onaylanan plan gönderim kuyruğuna girer; zamanlanmış işçi sağlayıcıya gönderir.
5. Sonuç ve mutabakat: işlem sorgulanır, sağlayıcı raporuyla satır satır karşılaştırılır; sonuç İşlemler sekmesinde görünür.

Durumların anlamı

• Onaylandı (kuyrukta): gönderim sırasını bekliyor.
• Sağlayıcıda bekliyor: sağlayıcı kabul etti, sonucu henüz bildirmedi.
• Sonuç belirsiz: gönderildi ama yanıt alınamadı. Otomatik yeniden gönderilmez (çift yükleme olmasın); işlem sorgulanır, sonuç netleşene kadar bekler.
• Doğrulanıyor: sağlayıcı raporuyla mutabakat sürüyor.
• İnceleme gerekli: sonuç otomatik karara bağlanamadı; yönetici Operatör kararı verir (sonuç, gerekçe, kanıt referansı; kısmi sonuçta satır satır karar).
• Başarılı / Kısmi / Başarısız: işlem kapandı. Başarısız ya da kısmi işlem için Düzeltme planı açılabilir.

Gerçek Multinet sürücüsü neden kapalı?

Multinet'in kurumsal işveren API sözleşmesi (belge, kimlik bilgileri, hata kataloğu) henüz yok. Belge gelip yazılı olarak teyit edilene kadar gerçek sürücü kapalıdır: kayıtlı bilgiler tamamlansa bile gönderim hazır sayılmaz. Hesap kartındaki engel rozetleri tam olarak neyin eksik olduğunu söyler.

Multinet'ten gereken bilgiler

Hesaplar ve Sözleşme sekmesinde, hesabın Sözleşme bölümünde her satır için Dolu / Eksik rozeti görünür.

• Kurumsal işveren API sözleşmesinin belge sürümü ve tarihi; belgenin SHA-256 özeti; sözleşmeyi Multinet adına teyit eden ekip ya da kişi.
• Aktarım protokolü (REST/JSON, SOAP/XML ya da dosya); test ve canlı ortam HTTPS adresleri.
• Kimlik doğrulama yöntemi ve token yenileme kuralı; Multinet'in tahsis ettiği kimlik bilgilerinin adları ve kapsamı (işveren / şirket / ürün bazında yetkilendirme, erişim iptali).
• İstek imzası ve yanıt doğrulama kuralı (alan sırası, algoritma, test vektörleri) ya da "yok".
• İşlem şemaları: personel / kart envanteri, yükleme siparişi gönderme, istemci referansıyla sorgu (yanıt kaybında akıbet; "bulunamadı"nın kesinleşme kuralı), satır sonuçları, mutabakat / işlem raporu.
• İdempotency desteği, kapsamı, saklama süresi ve aynı anahtar + farklı gövde davranışı.
• Hata kataloğu: HTTP + iş hata kodları, kesin ret / belirsiz ayrımı, 429 ve Retry-After.
• Toplu işlem sınırları; sipariş kabulü, finansman ve kartta kullanılabilir bakiye ilişkisi; webhook (varsa imza, olay kimliği, tekrar ve sıra kuralı).
• Sandbox kabul testlerinin geçtiği ve canlıya geçişin yazılı onaylandığı bilgisi.

Kimlik bilgilerinin değerleri Kimlik bilgileri sekmesinden güvenli kasaya yazılır; yalnız "tanımlı / tanımlı değil" görünür, değer bir daha okunamaz.