3. Genel resim — Fırsat POS Partner API

İki tür iş var: bir kez yapılan kurulum ve her kuponda tekrarlanan kasa akışı.

A. Tek seferlik kurulum (önce POS firması için, sonra her işletme için):

Fırsat size client_id ve client_secret ile POS header id'nizi verir.
İşletme Fırsat Patron uygulamasından eşleştirme kodu alır ve sizin "Fırsat'ı bağla" ekranınıza yazar.
POS'unuz POST /connections/claim gönderir, connectionId ve şube listesini alır.
connectionId'yi saklar, bizim şubelerimizi kendi şubelerinizle eşlersiniz.

 Fırsat                               Sizin POS'unuz                         İşletme
   |  kimlik bilgileri + X-Firsat-Pos   |                                      |
   |----------------------------------->|                                      |
   |                                    |                                      |
   |                                    |   "Fırsat'ı bağla" ekranı            |
   |                                    |<---- eşleştirme kodunu yazar --------|  (Fırsat Patron uygulamasından okur)
   |  POST /connections/claim           |                                      |
   |<-----------------------------------|                                      |
   |  connectionId + şubeler            |                                      |
   |----------------------------------->|  connectionId'yi saklar,             |
   |                                    |  şubelerimizi kendininkilerle eşler  |

B. Kasada her kupon: önizleme, fişe yazma, onay ve fişi kapatma (bölüm 7).

 Müşteri      Kasiyer / Sizin POS'unuz                                     Fırsat
    | kodu gösterir   |                                                  |
    |---------------->|  POST /redemptions/preview {branchId, code}      |
    |                 |------------------------------------------------->|
    |                 |  state=valid, previewId, lines, saleUnit         |
    |                 |<-------------------------------------------------|
    |                 |  (kasiyere kuponun ne olduğunu gösterir)         |
    |                 |  satırları + indirimi açık fişe ekler            |
    |                 |  POST /redemptions {previewId, ...}              |
    |                 |   + Idempotency-Key                              |
    |                 |------------------------------------------------->|
    |                 |  makbuz (redemptionId)                           |
    |                 |<-------------------------------------------------|
    |                 |  kasiyer Fırsat'ın payını "Fırsat" ödeme         |
    |                 |  tipiyle kapatır (saleUnit veya daha azı: 7.3)   |
    | kalanı öder     |  (müşteri ayrıca sipariş verdiyse)               |

Fırsat'a yalnızca önizleme ve onay adımlarında istek gider; fişe yazma ve kapatma tamamen sizin POS'unuzda olur.