Panele girişDashboard

Sürat Public API

Gönderi oluşturma: POST /api/v1/shipments

PDF indirme: GET /api/v1/files/<token>

Sağlık: GET /api/health

Demo gönderi formu

Alanlar ShipmentInput ile uyumludur (camelCase). Ev/iş telefonu alanları SOAP’ta kullanılmaz; TelefonCep üzerinden otomatik doldurulur.

Kimlik ve önek

Webservis kullanıcısı ve referans öneki.

Kullanıcı adı / cari kodu (webservis). Varsayılan: CARIKODU.

Webservis şifresi. Aşağıdaki örnek JSON’da maskelenir.

Tam 3 karakter (A–Z, 0–9). Boş bırakılan referans üretiminde kullanılır.

Bu API yalnızca PDF yanıtı destekler.

Alıcı ve gönderi

Alıcı unvanı / ad soyad.

İsteğe bağlı birim / alt başlık.

Tam teslimat adresi.

Varsayılan demo: İSTANBUL / SANCAKTEPE.

Cep telefonu. XML’de ev/iş numaraları bu değerden türetilir.

İsteğe bağlı.

İsteğe bağlı alıcı kodu.

Örnek panelde kullanılan değer; gönderi tipine göre farklı kodlar tanımlı olabilir.

Ücret göndericiden tahsil edilir.

Kapıda tahsilat kullanılmıyorsa 0.

Kapıda ödeme tutarı (metin alanı).

Varsayılan taşıma şekli (örnek entegrasyon).

Alıcı adresine teslim.

Standart gönderi akışı.

Pazaryeri siparişi değil.

Boş bırakırsanız önizlemede örnek üretim (prefix + YYMMDD + rastgele rakamlar).

PDF’te aynı referansla 1/N … N/N sayfaları. Toplam desi/kg etikette adet ile çarpılır.

Pozitif ondalık (virgül veya nokta).

İsteğe bağlı ağırlık. Etiket özeti: 6.00 desi

Boş bırakılırsa API gövdesinde otomatik "Paket(adet)" yazılır (ör. Paket(2)).

İsteğe bağlı.

İsteğe bağlı.

İsteğe bağlı ek hizmet kodları / metni.

İsteğe bağlı sevk adresi.

İsteğe bağlı şube kodu.

Entegrasyon tanımlayıcısı.

İade gönderisi işaretçisi.

Etiket önizlemesi

Demo: Sürat SOAP çağrısı yok. PDF üst satırda cari kodu olarak yukarıdaki auth.id kullanılır.

Boşsa ortam değişkeni CARGO_PROVIDER_LABEL_NAME kullanılır.

Gerçek API Testi

Gerçek API ile en fazla 15 saniyede bir istek gönderilebilir.

API isteği simülasyonu

Aşağıdaki bloklar gerçek kod alanıdır; her biri için ayrı kopyalama kullanabilirsiniz.

İstek satırı
POST https://esurat.expressai.com.tr/api/v1/shipments

Tam alan adı için NEXT_PUBLIC_PUBLIC_BASE_URL tanımlayabilir veya tarayıcıda mevcut origin kullanılır.

Örnek gövde (auth.pw maskeli)
{
  "auth": {
    "id": "CARIKODU",
    "pw": "***"
  },
  "prefix": "TST",
  "responseType": "pdf",
  "shipments": [
    {
      "kisiKurum": "Demo Alıcı A.Ş.",
      "sahisBirim": "Bireysel",
      "aliciAdresi": "Örnek Mah. Kargo Sok. No:1 D:2",
      "il": "İSTANBUL",
      "ilce": "SANCAKTEPE",
      "telefonCep": "05321234567",
      "email": "",
      "aliciKodu": "",
      "kargoTuru": 3,
      "odemeTipi": 1,
      "irsaliyeSeriNo": "",
      "irsaliyeSiraNo": "",
      "referansNo": "",
      "adet": 2,
      "birimDesi": "3",
      "birimKg": "3",
      "kargoIcerigi": "Paket(2)",
      "kapidanOdemeTahsilatTipi": 0,
      "kapidanOdemeTutari": "",
      "ekHizmetler": "",
      "tasimaSekli": 1,
      "teslimSekli": 1,
      "sevkAdresi": "",
      "gonderiSekli": 1,
      "teslimSubeKodu": "",
      "pazaryerimi": 0,
      "entegrasyonFirmasi": "SelfIntegration",
      "iademi": false
    }
  ]
}