Genel Bakış¶

Sistem Mimarisi¶

MuditaPOS, yemek sipariş platformları ile sizin sisteminiz arasında köprü görevi gören yüksek performanslı bir entegrasyon katmanıdır.

flowchart TB
    subgraph Platformlar
        G[Getir]
        Y[Yemeksepeti]
        T[Trendyol GO]
        MG[Migros Yemek]
        ST[SepetTakip]
    end

    subgraph MuditaPOS
        WH[Webhook Receiver]
        PR[Provider Parser]
        NM[Normalizer]
        DB[(PostgreSQL)]
        RD[(Redis)]
        WD[Webhook Dispatcher]
        SD[Status Dispatcher]
    end

    subgraph Sizin Sisteminiz
        API[Webhook Endpoint]
        SA[Status API Çağrısı]
    end

    G -->|POST| WH
    Y -->|POST| WH
    T -->|Poll| WH
    MG -->|POST| WH
    ST -->|POST| WH

    WH --> PR --> NM --> DB
    NM --> WD -->|HTTP POST + 3x Retry| API
    SA -->|POST /internal/orders/status| SD
    SD -->|API Call| G
    SD -->|API Call| Y
    SD -->|API Call| T

Temel Kavramlar¶

Customer (Müşteri)¶

Sisteme kayıtlı olan sizin firmanız. Her müşteriye benzersiz API Key ve API Secret verilir.

Integration (Entegrasyon)¶

Bir müşterinin belirli bir platform ile bağlantısı. Örneğin: "Acme Restoran → Getir" veya "Acme Restoran → Yemeksepeti". Her entegrasyon platform tarafındaki restaurantId, vendorId gibi kimlik bilgilerini içerir.

Webhook¶

Platform'dan gelen siparişin sizin sisteminize iletilmesi. MuditaPOS siparişi normalize eder ve sizin tanımladığınız URL'ye POST olarak gönderir.

Status Update¶

Sizin sisteminizden platforma geri bildirim. Örneğin: "Sipariş onaylandı", "Kurye yola çıktı", "Teslim edildi".

Veri Akışı¶

Platform → MuditaPOS'a sipariş webhook'u gönderir
MuditaPOS → Siparişi normalize eder ve veritabanına kaydeder
MuditaPOS → Sizin webhook URL'nize POST ile iletir
Başarısız ise → 3 kez retry eder, hala başarısız ise Telegram bildirimi gönderir
Siz → Sipariş durumunu değiştirdiğinizde Status API'yi çağırırsınız
MuditaPOS → İlgili platforma durum güncellemesini gönderir

Ortamlar¶

Ortam	Base URL	Kullanım
Stage	`https://stage.pos.muditakurye.com.tr`	Test ve geliştirme
Production	`https://pos.muditakurye.com.tr`	Canlı sipariş akışı

Stage Ortamı

Stage ortamında yapılan işlemler gerçek sipariş oluşturmaz. Test payload'ları ile güvenle deneme yapabilirsiniz.