Entegrasyon Kılavuzu

Saha ile POS entegrasyonunuzu geliştirdikten sonra tamamlamanız gereken adımlar.

Bu kılavuz, POS entegrasyon geliştirmenizi tamamladıktan sonra Saha ile canlıya geçmek için izlemeniz gereken adımları özetlemektedir.

Entegrasyon Süreci

Yerel Olarak Geliştirin ve Test Edin

SPI Spesifikasyonu'nu takip ederek API uygulamanızı oluşturun. Tüm uç noktaları yerel olarak test etmek için sağlanan Postman koleksiyonu'nu kullanın:

GET /products - Ürünleri senkronize et
POST /orders - Sipariş oluştur
GET /orders/{id} - Sipariş durumunu al
POST /orders/{id}/cancel - Siparişi iptal et
GET /locations - Konumları al

Tüm uç noktaların beklenen yanıtları döndürdüğünden ve uç durumları düzgün şekilde işlediğinden emin olun.

API'nizi Deploy Edin

API'nizi aşağıdaki gereksinimleri karşılayan, herkesin erişebileceği bir sunucuya deploy edin:

Gereksinim	Açıklama
HTTPS	API'niz HTTPS üzerinden sunulmalıdır. Self-signed sertifikalar kabul edilmez.
Erişilebilirlik	Sunucunuz güvenilir sipariş işleme sağlamak için yüksek erişilebilirliğe sahip olmalıdır.
Yanıt Süresi	Uç noktalar makul süre limitleri içinde yanıt vermelidir (< 5 saniye).

Bizimle İletişime Geçin

API'niz deploy edilip hazır olduğunda, aşağıdaki bilgilerle bizimle iletişime geçin:

Base URL: API'nizin kök URL'i (örn. https://api.your-pos.com/saha/v1)
Auth Header Name: Kimlik doğrulama için başlık anahtarı (örn. Authorization, X-API-Key)
Auth Header Value: Başlık için gizli değer (örn. Bearer your-secret-token)
Client ID Header (gerekiyorsa): İstemci tanımlama için ek başlık
Default Language: Çevrilebilir alanlar için tercih ettiğiniz dil kodu (varsayılan: en)
Default Currency: Tercih ettiğiniz para birimi kodu (varsayılan: TRY)

Staging Ortamı Testi

Entegrasyon detaylarınızı aldıktan sonra:

Entegrasyonunuzu sistemimizle test etmeniz için size staging kimlik bilgileri sağlayacağız
Tam sipariş akışını test edebilirsiniz: ürün senkronizasyonu → sipariş oluşturma → durum güncellemeleri → robot gönderimi
Siparişlerin POS sisteminizde doğru şekilde göründüğünü doğrulayın
Sipariş iptalleri ve hata işleme gibi uç durumları test edin

Test Süresi

Staging testleri sırasında acele etmeyin. Bu, canlıya geçmeden önce sorunları tespit edip düzeltmek için en iyi fırsattır.

Production Onayı

Staging testleri başarılı olduktan sonra:

Entegrasyonunuzu production hazırlığı için inceleyeceğiz
Onay üzerine, entegrasyonunuzu production ortamı için etkinleştireceğiz
Canlıya geçmek için production kimlik bilgilerini alacaksınız

Kontrol Listesi

Bizimle iletişime geçmeden önce aşağıdakileri tamamladığınızdan emin olun:

Tüm gerekli uç noktalar uygulandı
API, HTTPS ile deploy edildi
Tüm uç noktalar Postman koleksiyonu ile test edildi
Uygun hata işleme ve yanıt kodları
Sipariş durumu güncellemeleri doğru çalışıyor
Ürün senkronizasyonu tüm gerekli alanları içeriyor

Destek

Entegrasyon sürecinde sorularınız varsa, lütfen geliştirici destek ekibimizle iletişime geçin. Saha ile başarılı bir şekilde entegre olmanıza yardımcı olmak için buradayız.

İçindekiler