Servis Referansı

NAKLİYECİLER WEB SERVİSİ

API Dokümantasyonu - Programcı Kılavuzu

Bu sayfa, yüklenen dokümandan dönüştürülmüş responsive HTML API referansıdır.

Endpoint-

WSDLhttps://apislv.solventas.com.tr/NakliyecilerWebService.asmx?WSDL

Metot Sayısı8

Metotları İncele Ana Dökümana Dön

Erişim Bilgileri

API Endpoint	apislv.solventas.com.tr
Protokol	SOAP 1.1 / SOAP 1.2
Veri Formatı	XML
Karakter Seti	UTF-8
Güvenlik	HTTPS + Token Tabanlı
WSDL URL	https://apislv.solventas.com.tr/NakliyecilerWebService.asmx?WSDL

Kimlik Doğrulama

Tüm API çağrılarında kimlik doğrulama gereklidir. Aşağıdaki parametreler standart olarak kullanılır:

Parametre	Tip	Açıklama
Token	string	Oturum kimlik doğrulama token'ı
Key	string	API erişim güvenlik anahtarı
ICustomerNumber	string	Müşteri numarası boş gönderilmelidir. boş gönderilmelidir.

Standart Yanıt Yapısı

Tüm API metotları aşağıdaki standart yanıt yapısını döndürür (TResult):

Alan	Tip	Açıklama
Success	boolean	İşlem başarı durumu (true/false)
ErrorCode	int	Hata kodu (0 = başarılı)
Message	string	İşlem mesajı veya hata açıklaması
ReturnData	string	Dönen veri (XML formatında)
ReturnDatas	Array	Çoklu veri dönüşü
OldToken	string	Eski token değeri
NewToken	string	Yeni token değeri (yenilenmişse)
ResultCommand	string	Sonuç komutu

API Metotları

4.1 Taşıyıcı Listeleri

ShipperProductList

SOAP / XML

Açıklama: Taşıyıcı ürün listesi

Dönüş: Ürün listesi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ShipperProductList xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <ICustomerNumber>...</ICustomerNumber>
    </ShipperProductList>
  </soap:Body>
</soap:Envelope>

ShipperCustomerList

SOAP / XML

Açıklama: Taşıyıcı müşteri listesi

Dönüş: Müşteri listesi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ShipperCustomerList xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <ICustomerNumber>...</ICustomerNumber>
    </ShipperCustomerList>
  </soap:Body>
</soap:Envelope>

ShipperDispatchCustomerList

SOAP / XML

Açıklama: Taşıyıcı sevk müşteri listesi

Dönüş: Sevk müşteri listesi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ShipperDispatchCustomerList xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <ICustomerNumber>...</ICustomerNumber>
    </ShipperDispatchCustomerList>
  </soap:Body>
</soap:Envelope>

OpenShipperList

SOAP / XML

Açıklama: Açık taşıyıcı listesi

Dönüş: Açık taşıyıcı listesi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
OwnerType	string	Hayır	Sahip tipi
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <OpenShipperList xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <OwnerType>...</OwnerType>
      <ICustomerNumber>...</ICustomerNumber>
    </OpenShipperList>
  </soap:Body>
</soap:Envelope>

4.2 Taşıma Siparişleri

TransportOrderDetailList

SOAP / XML

Açıklama: Taşıma sipariş detay listesi

Dönüş: Sipariş detay listesi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
OwnerType	string	Hayır	Sahip tipi
ProductCode	string	Hayır	Ürün kodu
TransferredCustomerCode	string	Hayır	Transfer edilen müşteri kodu
WorkOrderState	string	Hayır	İş emri durumu
StartDate	string	Hayır	Başlangıç tarihi
EndDate	string	Hayır	Bitiş tarihi
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TransportOrderDetailList xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <OwnerType>...</OwnerType>
      <ProductCode>...</ProductCode>
      <TransferredCustomerCode>...</TransferredCustomerCode>
      <WorkOrderState>...</WorkOrderState>
      <StartDate>...</StartDate>
      <EndDate>...</EndDate>
      <!-- diğer parametreler -->
    </TransportOrderDetailList>
  </soap:Body>
</soap:Envelope>

AddShipperOrder

SOAP / XML

Açıklama: Taşıyıcı siparişi ekleme

Dönüş: Oluşturulan sipariş numarası

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
OwnerType	string	Hayır	Sahip tipi
WorkOrderDate	string	Hayır	İş emri tarihi
DispatchOrderNo	int	Evet	Sevk emri numarası
AssignmentOfShipperNo	int	Evet	Taşıyıcı atama numarası
ProductCode	string	Hayır	Ürün kodu
VehicleNo	string	Hayır	Araç numarası
DriverNo	string	Hayır	Sürücü numarası
Quantity	float	Evet	Miktar
SupervisorCode	string	Hayır	Gözetmen kodu
DownloadDate	string	Hayır	İndirme tarihi
DownloadAddress	string	Hayır	İndirme adresi
FillingChamber	string	Hayır	Dolum kamerası
Relevance	string	Hayır	İlişki
DownloadType	string	Hayır	İndirme tipi
TowCarNo	string	Hayır	Çekici numarası
LoadFullWeight	int	Evet	Yüklü tam ağırlık
PackageCode	string	Hayır	Paket kodu
PackageQuantity	int	Evet	Paket miktarı
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddShipperOrder xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <OwnerType>...</OwnerType>
      <WorkOrderDate>...</WorkOrderDate>
      <DispatchOrderNo>...</DispatchOrderNo>
      <AssignmentOfShipperNo>...</AssignmentOfShipperNo>
      <ProductCode>...</ProductCode>
      <VehicleNo>...</VehicleNo>
      <!-- diğer parametreler -->
    </AddShipperOrder>
  </soap:Body>
</soap:Envelope>

CancelShipperOrder

SOAP / XML

Açıklama: Taşıyıcı siparişi iptali

Dönüş: İptal durumu

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Oturum token'ı
Key	string	Evet	Güvenlik anahtarı
OwnerType	string	Hayır	Sahip tipi
WorkOrderNo	int	Evet	İş emri numarası
ICustomerNumber	string	Hayır	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CancelShipperOrder xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <OwnerType>...</OwnerType>
      <WorkOrderNo>...</WorkOrderNo>
      <ICustomerNumber>...</ICustomerNumber>
    </CancelShipperOrder>
  </soap:Body>
</soap:Envelope>

4.3 Diğer Metotlar

HelloWorld

SOAP / XML

Açıklama: Test metodu

Dönüş: Test mesajı

Parametreler

Tablo bilgisi bulunamadı.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <HelloWorld xmlns="http://tempuri.org/">
    </HelloWorld>
  </soap:Body>
</soap:Envelope>

Veri Tipleri

Veri Tipi	Açıklama
string	Metin verisi. Maksimum uzunluk API metoduna göre değişir.
int	Tam sayı. 32-bit işaretli tam sayı değeri.
float	Ondalık sayı. 32-bit kayan noktalı sayı.
boolean	Mantıksal değer. true veya false değeri alır.
Array	Dizi tipi. Çoklu veri içeren liste yapısı.
DateTime	Tarih ve saat. YYYY-MM-DD HH:MM:SS formatında.

Hata Kodları

Hata Kodu	Açıklama
0	İşlem başarılı
1	Geçersiz kullanıcı adı veya şifre
2	Geçersiz token
3	Token süresi dolmuş
4	Erişim yetkisi yok
5	Geçersiz parametre
6	Kayıt bulunamadı
7	İşlem başarısız
8	Veritabanı hatası
9	Sistem hatası
10	Geçersiz tarih formatı
11	Zorunlu parametre eksik
99	Bilinmeyen hata

Notlar ve Uyarılar

1. Tüm tarih parametreleri YYYY-MM-DD formatında gönderilmelidir.

2. Token parametresi GetToken metodu ile alınan oturum anahtarıdır.

3. Key parametresi API erişim güvenlik anahtarıdır.

4. ICustomerNumber parametresi isteğe bağlıdır, belirtilmezse oturum açan kullanıcının müşterisi kullanılır.

5. OwnerType parametresi genellikle 'M' (Müşteri) veya 'S' (Sistem) değerlerini alır.

6. WorkOrderState parametresi sipariş durumunu belirtir (Açık, Kapalı, vb.).

7. Tüm metotlar SOAP 1.1 ve SOAP 1.2 protokollerini destekler.

8. API çağrılarında HTTPS protokolü kullanılmalıdır.

9. Bu servis taşıyıcılar (nakliyeciler) için özel olarak tasarlanmıştır.

10. AddShipperOrder metodu yeni bir taşıyıcı siparişi oluşturur.

11. CancelShipperOrder metodu mevcut bir siparişi iptal eder.

12. TransportOrderDetailList metodu sipariş detaylarını tarih aralığına göre listeler.