Entegrasyonlar ve API

OptiRoutes hangi entegrasyonları sunuyor?

Siparişleri dosyadan, FTP'den ya da SFTP'den yüklemek

En basit entegrasyon, sisteminizin zaten dışa aktardığı dosyadır. Siparişler ekranında Teslimatları yükle bir Excel veya CSV dosyasını okur; her sistem alanını — adres, müşteri adı, sipariş numarası, miktar vb. — sütun adınızla bir kez eşleştirirsiniz ve sonraki her dosya aynı şekilde yüklenir. Sabit genişlikli bir TXT dosyası için sütun adları yerine karakter konumlarını verirsiniz. Satırlar açıklamalardaki bir işaret kelimesiyle atlanabilir, ikinci bir işaret adresin yerine geçebilir; mevcut bir sipariş numarasının güncellenmesine ya da yeni olarak eklenmesine siz karar verirsiniz.

İnsan müdahalesini ortadan kaldırmak için ayarlarda bir otomatik yükleme yöntemi seçin:

• OptiRoutes dosya sunucusu — sisteminiz tarihle adlandırılan günlük dosyayı FTP sunucusunda ya da şifreli SFTP sunucusunda şirketinizin klasörüne bırakır.
• Kendi FTP sunucunuz — OptiRoutes verdiğiniz kullanıcıyla bağlanır ve bugünün tarihiyle adlandırılan ya da en son güncellenen dosyayı yükler.
• Otomatik içe ve dışa aktarma — siparişler kendiliğinden yüklenir ve rotalar da planlanır; hiçbir tıklama gerekmez.
• Files API — yazılımınız sipariş dosyasını HTTPS üzerinden yükler; aşağıda anlatılmıştır.

Müşteriler ekranında müşteri numarası, adı, adresi, durak süresi ve açılış ve kapanış saatlerini içeren bir Excel veya CSV dosyası, müşterileri ve zaman aralıklarını oluşturur ya da günceller.

Files API: siparişler içeri, POD'lar ve raporlar dışarı

OptiRoutes'taki her şirketin kendine ait özel bir dosya klasörü vardır: yüklediği siparişler, fotoğrafları ve imzalarıyla imzalı irsaliyeler, rota aktarımları ve gün sonu raporları. Files API, sistemlerinizin arada bir FTP sunucusu olmadan bu klasörü doğrudan HTTPS üzerinden okuyup yazmasını sağlar. Şirketin yöneticisi Ayarlar → API ve dosyalar bölümünde FTP ile API arasında geçiş yapar ve anahtarları orada oluşturur — destek talebine gerek yoktur; yeni şirketler doğrudan API ile başlar.

Çağrılar; anahtarın kontrolünü, bir klasörün listelenmesini, indirmeyi, yüklemeyi (dosya başına 50 MB'a kadar) ve yüklediğiniz dosyaların silinmesini, bir günün POD dosyalarının sipariş ve türe göre listelenmesini ve bir günün tüm POD dosyalarının tek bir ZIP olarak indirilmesini kapsar. Kılavuz Python, C# ve Node.js kod örnekleri ile sunucunuzdaki bir klasörü şirket klasörüyle senkronize tutan bir PowerShell betiği içerir — böylece FTP'ye alışkın bir ekip aynı şekilde çalışmaya devam edebilir. Files API kılavuzunu okuyun.

API anahtarları nasıl güvence altına alınıyor?

• En az yetki — her anahtar yalnızca ihtiyaç duyduğu izinleri alır: yalnızca imzalı POD'lar, tüm dosyaları okuma ya da siparişleri ve gelen kutusu dosyalarını yükleme.
• İzin verilen adresler — bir anahtar sunucunuzun sabit IP adresleriyle sınırlanabilir.
• Süre sonu ve yenileme — bir anahtarın süresi belirli bir gün sayısından sonra dolabilir; yeni bir anahtar oluşturun, geçiş yapın, ardından kesinti olmadan eskisini iptal edin.
• Anında iptal — iptal edilen bir anahtar 30 saniye içinde çalışmayı durdurur.
• Denetim — her çağrı saat, adres, dosya ve yanıtla birlikte günlüğe kaydedilir ve yöneticiye gösterilir.
• Güvenli saklama — OptiRoutes her anahtarın yalnızca SHA-256 parmak izini tutar; bağlantılar TLS 1.2 veya üzeriyle HTTPS üzerinden yapılır ve bir anahtar yalnızca kendi şirketinin klasörüne erişir.

Sınırlar: anahtar başına dakikada 300 istek, dosya başına 50 MB, şirket başına 20 aktif anahtar ve tek bir klasör listesinde en fazla 5.000 kayıt.

Raporlar ve veri gönderme API'si

Raporlama araçları ve ERP bağlayıcıları için api-users.optiroutes.com adresindeki ayrı bir API, şirketinizin verilerini raporlar halinde sunar ve gönderilen verileri kabul eder. OptiRoutes tarafından şirketiniz için verilen tek bir adres ve tek bir token tüm çağrıları kapsar. Belgeler sayfasında token'ınızı yapıştırarak size hangi raporların açık olduğunu ve hesabınızın sütun eşleştirmesini görebilirsiniz: API belgelerini okuyun.

İki gönderme çağrısı ters yönde çalışır: sipariş göndermek günün sipariş dosyasını yazar ve otomatik yüklemeyi başlatır; sürücü, hat ve araç göndermek ise bir filo dosyası gibi filonun tamamını değiştirir. Gönderilen sürücü listesi filonun tamamı sayıldığı için yalnızca değişiklikleri değil, her zaman tüm sürücüleri gönderin.

Rota aktarımı ve webhook'lar

Rota aktarımı, işaretli rotaları CSV, XLSX, XML, JSON ya da sabit genişlikli TXT biçiminde yazar. Bir sütunlar tablosu hangi alanların hangi başlıkla çıkacağını belirler; sipariş dosyanızın orijinal sütunları eklenebilir ve ürün yönetimiyle ikinci bir dosya her ürünü listeler. Aktarımlar bilgisayarınıza, FTP sunucunuza ya da şirket klasörüne gidebilir; JSON ile aktarım bir web adresine de gönderilebilir; gönderim başarısız olursa sistem bir kez daha dener.

Her teslimat gerçekleştiği anda bilgi almak için sürücü uygulaması ayarlarında teslimat raporları adresini doldurun: sürücülerin yaptığı her teslimat raporu oraya da gönderilir; böylece başka bir sisteminiz kendiliğinden güncellenir.

E-posta, ödemeler, haritalar ve mesajlaşma

• E-posta — imzalı irsaliyeler bir Google uygulama şifresiyle kendi Gmail hesabınızdan gider; gün sonu palet raporu gibi raporlar rapor e-postanıza gider; ödeme yapan müşteriler makbuzları, sürücüler de teslim onaylarını kasadan alır.
• Ödemeler — bakiye yüklemeleri güvenli bir Stripe ödeme sayfasında ödenir; otomatik bakiye yükleme için isteğe bağlı olarak kart kaydedilebilir.
• Adresler ve haritalar — adresler Google önerilerinden seçilir ve planlamadan önce haritada doğrulanır.
• Navigasyon — sürücü uygulaması her durağı adres ya da tam koordinatla Waze'e, iPhone'da ise Apple Haritalar'a aktarır.
• SMS ve WhatsApp — müşterilere varış mesajları ve takip bağlantıları, yöneticilere uyarılar, taşeronlara hatlar ve sürücülere WhatsApp üzerinden rota görselleri.

Sıkça sorulan sorular