Geliştirici

Kullandığınız yazılımı bırakmadan bağlanın.

Ticimax, İdeaSoft, T-Soft, Logo, kendi yazdığınız program — fark etmez. Ürününüzü yazarsınız, siparişinizi çekersiniz, kargoladığınızı bildirirsiniz. Üç uç, bir anahtar.

Bağlanmanın üç yolu

Hepsi aynı yere çıkar. Yazılım geliştiricisi olmayan satıcı ilk ikisini kullanır; kendi sistemi olan firma üçüncüsünü seçer.

Dosya

Excel veya CSV listenizi yüklersiniz. Sütun eşlemesini bir kez yaparsınız, sonraki yüklemeler aynı eşlemeyi kullanır.

XML bağlantısı

E-ticaret altyapınızın ürün XML adresini verirsiniz; ürün, fiyat ve stok belirli aralıklarla kendiliğinden güncellenir. Yaygın 16 altyapı için hazır şablon vardır.

API

Kendi sisteminiz yazıyorsa doğrudan bağlanırsınız. Aşağıdaki belgelendirme bunun içindir.

1. Anahtarınızı alın

Hesabınıza girin, sağ üstteki adınıza tıklayın, Tercihlerim → MobilSoft API bölümünden API anahtarı üret deyin. Anahtar yalnız bir kez gösterilir; kaybederseniz yenisini üretirsiniz.

Anahtarınız yalnız aşağıdaki uçlara yeter — başka hiçbir yere erişemez. Sunucu tarafında saklayın, tarayıcıya koymayın.

2. İlk isteğinizi atın

Bağlantının kurulduğunu doğrulayan uç:

curl https://firmaniz.mobilsoft.net/api/v1/durum \
  -H "Authorization: Bearer ANAHTARINIZ"

{
  "ok": true,
  "surum": "v1",
  "veri": { "baglanti": "tamam", "hesap": "Firmanız A.Ş." }
}

Her yanıt bu zarfla gelir. ok doğruysa veri, yanlışsa hata alanına bakarsınız — ayrıştırıcınızı bir kez yazarsınız.

3. Uçlar

POST /api/v1/urunler

Ürün ekler veya günceller. Eşleştirme stok kodu ile yapılır: aynı stok kodu ikinci kez gelirse ürün güncellenir, yenisi açılmaz.

{
  "urunler": [
    { "stok_kodu": "ABC-100", "ad": "Ürün adı", "fiyat": 349.90,
      "barkod": "8690000000001", "aciklama": "İsteğe bağlı" }
  ]
}

Tek istekte en fazla 200 ürün. Yeni üründe ad zorunludur; güncellemede yalnız değişen alanı göndermeniz yeter.

POST /api/v1/stok

Stok miktarını bildirdiğiniz değere eşitler — fark değil, mutlak miktar. Bir istek kaybolursa bir sonraki tur yine doğruyu yazar.

{ "stoklar": [ { "stok_kodu": "ABC-100", "miktar": 42 } ] }

GET /api/v1/siparisler

Siparişleri çeker. En son çektiğiniz siparişin zamanını saklayın ve bir dahaki turda tarihten olarak gönderin; sıralama tarihe göre artandır, böylece hiçbir sipariş atlanmaz.

GET /api/v1/siparisler?tarihten=2026-08-12T00:00:00&sayfa=1&adet=200

Yanıtta müşteri, teslimat adresi, kalemler ve tutarlar bulunur.

POST /api/v1/siparisler/REFERANS/durum

Kargoladığınızı bildirirsiniz. Takip numarası müşterinin siparişine işlenir.

{ "durum": "kargolandi", "kargo_firma": "Aras", "takip_no": "1234567890" }

Durum değerleri: hazirlaniyor · kargolandi · teslim · iptal

Hatalar

Hata da sözleşmenin parçasıdır; kodlar değişmez, mesaj metni değişebilir.

`gecersiz_json`	Gövde okunamadı
`bos_istek`	Beklenen dizi gelmedi
`cok_kayit`	Tek istekte 200'den fazla kayıt
`bulunamadi`	Sipariş veya ürün yok
`depo_yok`	Hesapta tanımlı depo yok
`gecersiz_tarih`	`tarihten` ISO 8601 değil

Toplu yazımlarda tek bir hatalı satır diğerlerini düşürmez: yanıt kaç kaydın işlendiğini ve hangi satırların neden atlandığını söyler.

Sürüm sözü

/api/v1 sözleşmesi bozulmaz. Kırıcı bir değişiklik gerekirse /api/v2 açılır ve v1 çalışmaya devam eder. Entegrasyonunuz, bizim iç düzenlememiz yüzünden bir sabah durmayacak.

Hesabınız yoksa önce onu açın.

Ücretsiz. Kurulum ve sunucu gerekmez; anahtarı hesabınızın içinden alırsınız.

Ücretsiz hesap aç