Söyle Gelir Geliştiriciler

Söyle Gelir entegrasyonları

Söyle Gelir siparişlerini kendi yazılımınıza bağlayın: siparişleri POS'unuza ya da kurye yazılımınıza anında alın, onaylayın, hazırlayın, kuryeye verin ve teslim edin. Bu belgeler REST API'yi ve sipariş bildirimlerini (webhook) anlatır.

Bütün istekler HTTPS üzerinden JSON ile yapılır. Tutarlar kuruş cinsinden tam sayıdır, tarihler ISO 8601 biçimindedir.

Üç entegrasyon yolu

Kim Ne alır Nasıl bağlanır Kullandığı API
İşletmenin kendi yazılımı İşletmenin bütün siparişleri İşletme panelinde kendi API anahtarını oluşturur İşletme ve POS API
POS firması Bağlı işletmenin bütün siparişleri, geldiği an Söyle Gelir firmayı ekler; işletme panelinden firmayı seçer, iki anahtar oluşur İşletme ve POS API
Kurye firması Bağlı işletmenin onaylanan teslimat siparişleri Söyle Gelir firmayı ekler; işletme panelinden firmayı seçer, iki anahtar oluşur Kurye API

POS ve kurye firmaları Getir, Yemeksepeti ve Trendyol entegrasyonlarındaki düzenle çalışır: firmanın Söyle Gelir'de hesap açmasına gerek yoktur, işletmenin verdiği API anahtarı ve gizli anahtar ile bağlanır. Her işletme için ayrı bir anahtar çifti vardır.

Firma olarak başvuru

POS ya da kurye yazılımınızı Söyle Gelir işletmelerine açmak için https://soylegelir.com üzerindeki iletişim kanallarından ya da [email protected] adresinden bize yazın. Şu bilgiler gerekir:

  • Firma adı ve türü (POS ya da kurye firması)
  • Bildirimlerin gönderileceği HTTPS adresi (webhook; isterseniz yalnız API'den çekerek de çalışabilirsiniz)
  • Teknik yetkilinin adı, e-postası ve telefonu

Firmanız eklendikten sonra Söyle Gelir'deki bütün işletmeler sizi kendi panellerinde seçebilir.

İşletme olarak firmanızı bağlama

  1. İşletme panelinde Ayarlar › API ve entegrasyon sayfasını açın.
  2. Firma bağla düğmesine basın ve listeden çalıştığınız firmayı seçin.
  3. Ekranda API anahtarı (sgk_…) ve gizli anahtar (sgs_…) görünür. Gizli anahtar yalnız bu anda bir kez gösterilir: ikisini de firmanıza güvenli bir yoldan iletin.
  4. Firma anahtarları kendi sistemine girdiği anda siparişleriniz ona gelmeye başlar. Aynı sayfada bağlantının durumunu ve firmanın son istek zamanını görürsünüz.
  5. Anahtarlar sızdıysa Anahtarları yenile ile ikisini de değiştirin; firmayla çalışmayı bıraktığınızda Bağlantıyı kaldır deyin.

Her türden bir firma bağlanır: bir POS firması ve bir kurye firması. Başka bir kurye firmasına geçmek için önce mevcut bağlantıyı kaldırın.

Kendi yazılımınızı bağlıyorsanız aynı sayfada API anahtarı oluştur ile işletme anahtarınızı alın ve isterseniz Webhook adresi tanımlayın.

Sipariş akışı

POS firması

  1. Müşteri sipariş verir → POS'a order.placed bildirimi gider.
  2. POS siparişi onaylar ya da reddeder: POST /api/v1/merchant/orders/{number}/accept.
  3. POS hazırlanıyor ve hazır adımlarını işler: POST /api/v1/merchant/orders/{number}/status.
  4. Her durum değişikliğinde POS'a order.status.changed gider.

Kurye firması

  1. İşletme teslimat siparişini onaylar → sipariş kurye firmasına geçer, firmaya order.assigned gider (adres, müşteri, kapıda alınacak tutar dahil).
  2. Firma kuryesini bildirir ve konumunu gönderir; müşteri kuryesini haritada izler.
  3. Kurye siparişi teslim alır, müşterinin teslim kodu ile teslim eder.
  4. Kurye bulunamazsa firma siparişi işletmeye geri verebilir.

Sonraki adımlar