Otopilot
Restoran, POS ve kuryeSatışta

Kurye/Kargo Entegrasyonu

Hazırlayan Son güncelleme:

Kısa özetRestoran POS sisteminizdeki veya sitenizdeki siparişi kurye firmanıza otomatik iletir, gönderim ve hata durumunu Telegram ile bildirir.

Kurulumu ekibimiz yapar. POS sağlayıcınızı ve kurye firmanızı seçersiniz; hesap yetkilerini siz verirsiniz. Her firma bağlantısı ayrı kurulum kalemidir.

Neler yapar

  • POS veya site siparişinden kuryeye aktarım
  • Firma başına kurulum
  • Sipariş kuyruğu ve yeniden deneme
  • Telegram ile durum bildirimi

Çalışma yeri

  • Kurulumu siz yapın

    Sizin sunucunuza veya hesabınıza kurulumu ekibimiz yapar. Gerekli erişimleri siz verirsiniz.

  • Bizde çalışsın

    Bot bizim sunucumuzda çalışır. Kurulum, güncelleme ve izleme bizde.

Platformlar

Restoran POS sistemi, Özel PHP sitesi, WooCommerce, Next.js / Node.js

Fiyata dahil

Temel, Standart destek, Zamanlı, Olay olunca

Hacim birimi: günde sipariş (Temel: 300)

Bir lisansla 1 kurulum

Bağlantı kurye firmasının resmi API'siyle ya da yazılı izniyle kurulur. Byersoft bağlantısı resmi API ile değil, sizin kendi Byersoft panel hesabınızın oturumuyla çalışır; Byersoft panelinde değişiklik olursa bağlantı bozulabilir ve güncelleme gerekebilir. Byersoft kullanım koşullarını kontrol etmek kullanıcının sorumluluğundadır.

Ne yapar?

Kurye/Kargo Entegrasyonu, restoranınızın kendi POS veya sipariş sistemindeki yeni paket siparişleri kendi kurye ya da kargo firması hesabınıza iletir. Adaptörlerle çalışır: POS tarafında webhook, klasöre bırakılan JSON dosyası veya SQLite veritabanı okunur; kurye tarafında firmanın resmi HTTP API'si ya da açık onayınızla Byersoft paneli kullanılır. Siparişler sunucunuzdaki bir kuyrukta tutulur, hata alan sipariş yeniden denenir ve isterseniz Telegram'a bildirim gider. Kurulumu ve firma başına yapılandırmayı ekibimiz yapar.

Kimin işine yarar?

  • Site veya POS siparişlerini kurye firmasına elle giren restoranlar
  • Kurye firması resmi API sunan ve siparişi otomatik iletmek isteyen işletmeler
  • Kendi sipariş sistemi webhook gönderebilen veya siparişi dosya ya da SQLite olarak tutan işletmeler
  • Byersoft paneli kullanan ve kendi hesabıyla otomatik kurye çağırmak isteyen restoranlar

Gereksinimler

  • Node.js 20 veya üstü (ek bağımlılık yoktur; sqlite adaptörü için npm install better-sqlite3)
  • Panelden alınan lisans anahtarı ve restoranınızın alan adı
  • POS veya sipariş sisteminizin webhook, JSON klasörü ya da SQLite erişimi
  • Kurye firmanızın resmi API adresi ve kendi API anahtarınız ya da Byersoft için kendi kullanıcı adı ve şifreniz
  • Sürekli çalışma için pm2 veya systemd kullanılabilen bir sunucu
  • Byersoft bağlantısı resmi API ile değil, sizin kendi Byersoft panel hesabınızın oturumuyla çalışır; Byersoft panelinde değişiklik olursa bağlantı bozulabilir ve güncelleme gerekebilir. Byersoft kullanım koşullarını kontrol etmek kullanıcının sorumluluğundadır.

Adım adım kurulum ve kullanım

  1. 1Kurulum talebinde POS sisteminizi, kurye firmanızı ve erişim bilgilerini yalnız talep ekranı üzerinden iletin.
  2. 2Ayar dosyası oluşturulur: cp config.example.json config.json
  3. 3Gizli değerler ortam değişkeni olarak verilir: BOT_LICENSE_KEY, POS_WEBHOOK_SECRET (en az 16 karakter), COURIER_API_TOKEN; Byersoft için courier.username ve courier.password alanlarında env: biçimi kullanılır.
  4. 4README'deki Sorumluluk bölümü okunup consent.terms_accepted değeri true yapılır; bu onay olmadan köprü çalışmaz.
  5. 5pos.type olarak webhook, jsondir veya sqlite seçilir ve ilgili alanlar doldurulur.
  6. 6courier.type olarak http (resmi API) veya byersoft seçilir; byersoft için ayrıca consent.own_account_session değeri true yapılır.
  7. 7Lisans ve adaptörler doğrulanır: node src/index.mjs check
  8. 8İlk günler run.dry_run değeri true bırakılır; siparişler kuyruğa alınır ama kuryeye gönderilmez, kayıtta KURU görünür. Tek geçiş için node src/index.mjs once kullanılabilir.
  9. 9Sonuçlar doğruysa run.dry_run false yapılır.
  10. 10Sürekli çalışma başlatılır: pm2 start src/index.mjs --name kurye-kopru -- run (veya systemd servisi).
  11. 11Testler çalıştırılabilir: npm test (sahte lisans, sahte POS ve sahte kuryeyle, ağ kullanmadan).

Ayarlar ve anlamları

license.key / license.domain
Lisans anahtarı ve lisanslı alan adı; her başlangıçta doğrulanır.
consent.terms_accepted
Kullanım şartlarını kabul ettiğinizi gösterir; true değilse köprü başlamaz.
consent.own_account_session
Byersoft adaptörünün kendi hesabınızın oturumuyla çalışmasına açık onay; true değilse Byersoft adaptörü kurulmaz.
pos.type
webhook, jsondir veya sqlite.
pos.host / pos.port / pos.path / pos.secret
Webhook dinleme adresi (varsayılan 127.0.0.1:8787/orders) ve HMAC-SHA256 imza sırrı (en az 16 karakter).
pos.dir
jsondir adaptöründe siparişlerin bırakıldığı klasör; okunan dosyalar islenen/ altına taşınır.
pos.file / pos.query / pos.mark_query / pos.map
sqlite adaptöründe veritabanı dosyası, yeni siparişleri seçen sorgu, isteğe bağlı işaretleme sorgusu ve sütun eşlemesi.
courier.type
http, byersoft veya fake (test).
courier.url / courier.headers / courier.body / courier.success_field
http adaptöründe https adresi, API anahtarlı başlıklar, {{phone}} {{address}} {{total}} gibi alanlarla gövde şablonu ve başarıyı gösteren yanıt alanı.
filter.delivery_types
Yalnız listedeki teslim türlerindeki siparişler kuyruğa alınır; boşsa hepsi alınır.
notify.telegram.bot_token / notify.telegram.chat_id
Kendi Telegram botunuzla gönderim ve başarısızlık bildirimleri.
run.poll_ms
Döngü aralığı (varsayılan 10000 ms).
run.max_attempts
Hata alan siparişin en fazla deneme sayısı (varsayılan 5); sonra failed işaretlenir.
run.dry_run
true ise siparişler kuryeye gönderilmez, yalnız kayda yazılır.

Sınırlar ve yapamadıkları

  • Günlük satış raporu özelliği pakette yoktur; bildirimler yalnız tek tek sipariş gönderimi ve başarısızlık için Telegram'a gider.
  • Sürekli çalışma (run) kipinde her döngü aralığında kuyruktan bir sipariş kuryeye iletilir; varsayılan 10 saniyelik aralıkta yoğun saatlerde sıra oluşabilir.
  • Byersoft bağlantısı resmi API ile değil, sizin kendi Byersoft panel hesabınızın oturumuyla çalışır; Byersoft panelinde değişiklik olursa bağlantı bozulabilir ve güncelleme gerekebilir. Byersoft kullanım koşullarını kontrol etmek kullanıcının sorumluluğundadır.
  • Webhook adaptörü varsayılan olarak yalnız 127.0.0.1 üzerinde dinler; dışarıdaki bir sistemden sipariş almak için host ayarı veya ters vekil gerekir.
  • Kuyruk tek süreç için tasarlanmış dosya tabanlı bir yapıdır (data/orders.json); aynı klasörle iki kopya çalıştırılmamalıdır.
  • filter.delivery_types yalnız siparişte deliveryType alanı varsa uygulanır; sqlite adaptörü bu alanı doldurmaz, bu durumda süzme sorgunun içinde yapılmalıdır.

Sık karşılaşılan sorunlar ve çözümleri

Kullanım şartları onaylanmadı (consent.terms_accepted=true) mesajı.

README Sorumluluk bölümünü okuyup config.json içinde consent.terms_accepted değerini true yapın.

pos.secret en az 16 karakter olmalı hatası.

POS_WEBHOOK_SECRET ortam değişkenine en az 16 karakterlik bir sır verin ve aynı sırrı POS tarafındaki imzada kullanın.

POS sistemi webhook isteğine 401 yanıtı alıyor.

İstek gövdesi HMAC-SHA256 ile imzalanıp X-Signature: sha256=... başlığında gönderilmelidir; sırrın iki tarafta aynı olduğunu kontrol edin. 422 yanıtı siparişte id, phone, address veya sayısal total alanının eksik olduğunu gösterir.

kurye API HTTP 4xx veya kurye API başarısız yanıt hatası.

courier.url, API anahtarı ve courier.success_field alanını firmanın belgesine göre kontrol edin; sipariş run.max_attempts kez yeniden denenir.

Byersoft girişi başarısız (HTTP ...) hatası.

Kullanıcı adı ve şifreyi panelde deneyin; consent.own_account_session değerinin true olduğunu ve courier.url adresinin https ile başladığını kontrol edin.

Sipariş N denemede kuryeye iletilemedi; elle girin bildirimi.

Siparişi kurye paneline elle girin, kayıttaki hata mesajıyla birlikte bize destek talebi açın.

Güncelleme ve destek

Bu ürünün kurulumunu ekibimiz yapar; POS ve kurye firması bağlantısı firma başına ayrı yapılandırma kalemidir ve yeni bir POS veya kurye adaptörü yazılması kurulum hizmetinin parçasıdır. Standart destek dahildir, iş günlerinde yanıt veririz; Öncelikli destek ayrıca eklenebilir. Süreli lisansta güncellemeler lisans süresince, ömür boyu lisansta 12 ay boyunca sunulur. POS ve kurye firmalarının sözleşme ve kullanım koşullarına uymak sizin sorumluluğunuzdadır.

Sık sorulan sorular

Müşteri bilgileri size gelir mi?

Hayır. Ad, telefon ve adres yalnız sizin sunucunuzda işlenir ve yalnız sizin kurye firmanıza gönderilir. Lisans doğrulamasında yalnız anahtar, ürün kodu, alan adı ve sürüm gönderilir.

Kurye firmamın API'si yoksa ne olur?

Öncelikli yol resmi API'dir. Byersoft için panel oturumuyla çalışan bir adaptör vardır ve yalnız kendi hesabınızla, açık onayınızla etkinleşir. Diğer firmalar için kurulum sırasında birlikte değerlendiririz.

Gönderim başarısız olursa sipariş kaybolur mu?

Hayır. Sipariş kuyrukta kalır, run.max_attempts kez denenir; hepsi başarısız olursa failed işaretlenir ve Telegram ayarlıysa elle girmeniz için bildirim gelir.

Canlıya almadan önce deneyebilir miyim?

Evet. run.dry_run true iken siparişler kuyruğa alınır ama kuryeye gönderilmez; kayıtta KURU satırı görünür.

Kurye/Kargo Entegrasyonu hangi platformlarda çalışır?

Desteklenen platformlar: Restoran POS sistemi, Özel PHP sitesi, WooCommerce, Next.js / Node.js.

Kurye/Kargo Entegrasyonu nerede çalışır, nasıl teslim edilir?

Kurulumu siz yapın: Sizin sunucunuza veya hesabınıza kurulumu ekibimiz yapar. Gerekli erişimleri siz verirsiniz. Bizde çalışsın: Bot bizim sunucumuzda çalışır. Kurulum, güncelleme ve izleme bizde.

Bir lisansla kaç kurulum yapabilirim?

Bir lisansla 1 kurulum yapabilirsiniz. Lisans anahtarınız hesabınızdaki Lisanslarım sayfasında görünür.

Memnun kalmazsam iade alabilir miyim?

7 gün iade: Ödeme tarihinden itibaren 7 gün içinde gerekçe göstermeden iade isteyebilirsiniz.