Kargo bilgilerini sorgulama

Akifast uygulaması, kullanıcı adresini seçtikten sonra, o adrese gönderim yapacak kargo seçeneklerini sormak için üye iş yerine bir istek atar. İsteğin atılacağı URL bilgisi üye iş yeri tarafından ödeme oturumu oluşturulurken gönderilen query_shipping_option_url parametresiyle belirlenir. Akifast, aşağıda listenen parametrelerle üye iş yerinin verdiği query_shipping_option_url’e POST isteği atar.

İstek Parametreleri ve Açıklamaları

Parametre	Tip	Açıklama
order_id	string	Üye iş yeri tarafındaki sipariş numarası
session_token	string	Üye iş yerinin aldığı ödeme oturumu anahtarı
basket_id	string	Sepet kimlik numarası
shipping_address.name	string	Adres sahibinin adı
shipping_address.surname	string	Adres sahibinin soyadı
shipping_address.phone_number	string	Adres sahibinin telefon numarası
shipping_address.postal_code	string	Posta kodu
shipping_address.notes	string	Adres bilgisindeki not
shipping_address.company_name	string	Kurumsal bir adres ise şirket adı
shipping_address.address_title	string	Adres açıklaması
shipping_address.tax_no	string	Kurumsal bir adresse vergi numarası
shipping_address.tax_office	string	Kurumsal bir adresse vergi dairesi
shipping_address.is_default	boolean	Varsayılan adres belirteci
shipping_address.line	string	Adres bilgisi.
shipping_address.address_type	string	Adres tipi (CUSTOMER, RETAIL_STORE)
shipping_address.country.name	string	Ülke adı
shipping_address.country.code	string	Ülke kodu
shipping_address.city.name	string	Şehir adı
shipping_address.city.code	string	Şehir kodu
shipping_address.town.name	string	İlçe adı
shipping_address.town.code	string	İlçe kodu
shipping_address.district.name	string	İlçe Adı
shipping_address.status	string	Adresin durumu
shipping_address.hash_data	string	Adresin tekil hash kodu
billing_address.name	string	Adres sahibinin adı
billing_address.surname	string	Adres sahibinin soyadı
billing_address.phone_number	string	Adres sahibinin telefon numarası
billing_address.postal_code	string	Posta kodu
billing_address.notes	string	Adres bilgisindeki not
billing_address.company_name	string	Kurumsal bir adres ise şirket adı
billing_address.address_title	string	Adres açıklaması
billing_address.tax_no	string	Kurumsal bir adresse vergi numarası
billing_address.tax_office	string	Kurumsal bir adresse vergi dairesi
billing_address.is_default	boolean	Varsayılan adres belirteci
billing_address.line	string	Adres bilgisi.
billing_address.address_type	string	Adres tipi (CUSTOMER, RETAIL_STORE)
billing_address.country.name	string	Ülke adı
billing_address.country.code	string	Ülke kodu
billing_address.city.name	string	Şehir adı
billing_address.city.code	string	Şehir kodu
billing_address.town.name	string	İlçe adı
billing_address.town.code	string	İlçe kodu
billing_address.district.name	string	İlçe Adı
billing_address.status	string	Adresin durumu
billing_address.hash_data	string	Adresin tekil hash kodu
conversation_id	string	Özel iletişim kimlik numarası

Beklenen Dönüş Değerleri ve Açıklamaları

Dönüş Değeri	Tip	Açıklama
count	string	kargo seçeneklerinin sayısı.
shipping_options[0].description	string	kargo seçeneğinin açıklaması.
shipping_options[0].logo_url	string	kargo firmasına ait resmin url.
shipping_options[0].name	string	kargo firmasına ait isim.
shipping_options[0].key	string	kargo firmasının akinon keyi.
shipping_options[0].shipping_amount	bigdecimal	kargo tutarı.

Örnek İstek:

{
  "session_token":"e7d624f0-c842-4826-a344-8c05cc6d6114",
  "transaction_token":"JGmhG9bOro82/84JdjAWNflDH2dynHsckkrpRRO9pc73NLwSSe5+dzHa9JxdpIBKnWtAEfGhaYpFGrEoBQJlyg==",
  "shipping_address":{
      "name":"John",
      "surname":"Doe",
      "phone_number":"905557778899",
      "postal_code":"",
      "notes":null,
      "company_name":"",
      "address_title":"Geçerli Adres",
      "tax_no":"",
      "tax_office":"",
      "is_default":true,
      "line":"Veliefendi Sok. Nalcılar apt. No:21 D:5",
      "address_type":"CUSTOMER",
      "country":{
        "name":"Türkiye",
        "code":"TR"
      },
      "city":{
        "name":"İSTANBUL",
        "code":"ISTANBUL"
      },
      "town":{
        "name":"ZEYTİNBURNU",
        "code":"ISTANBUL_ZEYTINBURNU"
      },
      "district":{
        "name":"SÜMER MAH",
        "code":"91769948"
      },
      "status":"ACTIVE",
      "hash_data":"A84A1D591AF1CF028091547F125A9EA4FCAADFBE502B6760B8A35363F1F6D2CE"
  },
  "billing_address":{
      "name":"John",
      "surname":"Doe",
      "phone_number":"905557778899",
      "postal_code":"",
      "notes":null,
      "company_name":"",
      "address_title":"Geçerli Adres",
      "tax_no":"",
      "tax_office":"",
      "is_default":true,
      "line":"Veliefendi Sok. Nalcılar apt. No:21 D:5",
      "address_type":"CUSTOMER",
      "country":{
        "name":"Türkiye",
        "code":"TR"
      },
      "city":{
        "name":"İSTANBUL",
        "code":"ISTANBUL"
      },
      "town":{
        "name":"ZEYTİNBURNU",
        "code":"ISTANBUL_ZEYTINBURNU"
      },
      "district":{
        "name":"SÜMER MAH",
        "code":"91769948"
      },
      "status":"ACTIVE",
      "hash_data":"A84A1D591AF1CF028091547F125A9EA4FCAADFBE502B6760B8A35363F1F6D2CE"
  }
}

Örnek Cevap:

{
    "count": 2,
    "shipping_options": [
        {
            "description": "Hızlı Teslimat",
            "logo_url": "https://client-demo.sandbox.akifast.com/logos/hizliteslimat.png",
            "name": "Yurtiçi Kargo",
            "key": "12",
            "shipping_amount": 9.9
        },
        {
            "description": "Standart Teslimat",
            "logo_url": "https://client-demo.sandbox.akifast.com/logos/aras.png",
            "name": "Aras Kargo",
            "key": "13",
            "shipping_amount": 0
        }
    ]
}