Basit Kargo - Uygun Fiyatlarla Kargo Gönderin

Yetkilendirme

Basit Kargo API'lerini kullanmak için, öncelikle panelden giriş yaparak ayarlar sayfasından API Token üretmeniz gerekiyor. İsteklerinizde "Authorization" başlığı içinde "Bearer" tokeni olarak belirtmeniz gerekmektedir.

Örnek:

                                                        
Authorization: Bearer {token}

Aktif Kargo Firmalarını Listeleme

Aktif kargo firmalarının listesini görüntülemek için, bu servisi kullanabilirsiniz.

Method: GET URL: https://basitkargo.com/api/handlers

Servis örnek Cevap

                                                            
[
    {
      "name": "MNG Kargo",
      "code": "MNG",
      "logo": "https://cdn.basitkargo.com/logo/mng.png"
    },
    {
      "name": "Yurtiçi Kargo",
      "code": "YURTICI",
      "logo": "https://cdn.basitkargo.com/logo/yurtici.png"
    }
]

Kargo Bilgisi Ekleme

Kargo bilgilerinizi eklemek ve daha sonra kargo kodu oluşturmak için, bu servisi kullanabilirsiniz.

Method: POST URL: https://basitkargo.com/api/v2/order

Servis Örnek İstek (Payload)

                                                            
{
  "content": {
    "name": "Test Sipariş",
    "code": "#123456",
    "items": [
      {
        "name": "Ürün Adı",
        "code": "STK32",
        "quantity": "1"
      }
    ],
    "packages": [
      {
        "height": 10,
        "width": 15,
        "depth": 5,
        "weight": 1
      }
    ]
  },
  "client": {
    "name": "Test Alıcı",
    "phone": "5555555555",
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah."
  },
  "collect": 100 // kapıda ödeme tutarı
}

Servis Örnek Cevap

                                                            
{
    "id": "888-6AR-OUP",
    "barcode": null,
    "type": "OUTGOING",
    "status": "NEW",
    "validationFailed": false,
    "validationFailedMessage": null,
    "createdTime": "2023-01-01T15:41:47.7553603",
    "updatedTime": "2023-01-01T15:41:47.7633629",
    "content": {
        "name": "Test Ürün",
        "code": "#123456",
        "packages": [
            {
                "height": 10,
                "width": 15,
                "depth": 5,
                "weight": 1,
                "kgDesi": 1
            }
        ],
        "totalDesiKg": 1
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Test Alıcı",
        "phone": "5555555555",
        "city": "İstanbul",
        "town": "Kadıköy",
        "address": "Koşuyolu Mah."
    },
    "shipmentInfo": {
        "handler": null,
        "handlerShipmentCode": null,
        "handlerShipmentTrackingLink": "",
        "handlerDesi": null,
        "lastState": null,
        "shippedTime": null,
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 0,
        "extraFee": null,
        "totalCost": 0
    },
    "traces": []
}

Kargo Bilgisi Ekleme Ve Kargo Kodu Alma

Kargo bilgilerinizi eklemek ve belirttiğiniz kargo firması için kargo kodu almak için bu servisi kullanabilirsiniz.

Method: POST URL: https://basitkargo.com/api/v2/order/barcode

Servis Örnek İstek (Payload)

                                                            
{
  "handlerCode": "SURAT",
  "content": {
    "name": "Test Sipariş",
    "code": "#123456",
    "items": [
      {
        "name": "Ürün Adı",
        "code": "STK32",
        "quantity": "1"
      }
    ],
    "packages": [
      {
        "height": 10,
        "width": 15,
        "depth": 5,
        "weight": 1
      }
    ]
  },
  "client": {
    "name": "Test Alıcı",
    "phone": "5555555555",
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah."
  }
}

Servis Örnek Cevap

                                                            
{
    "id": "999-UA7-DEI",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "READY_TO_SHIP",
    "validationFailed": false,
    "validationFailedMessage": null,
    "createdTime": "2023-02-01T15:52:14.0849441",
    "updatedTime": "2023-02-01T15:52:14.1609697",
    "content": {
        "name": "Test Ürün",
        "code": "#123456",
        "packages": [
            {
                "height": 10,
                "width": 15,
                "depth": 5,
                "weight": 1,
                "kgDesi": 1
            }
        ],
        "totalDesiKg": 1
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Test Alıcı",
        "phone": "5555555555",
        "city": "İstanbul",
        "town": "Kadıköy",
        "address": "Koşuyolu Mah."
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": null,
        "handlerShipmentTrackingLink": "",
        "handlerDesi": null,
        "lastState": null,
        "shippedTime": null,
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 41.99,
        "extraFee": null,
        "totalCost": 41.99
    },
    "traces": []
}

Kargo Bilgisi Sorgulama (ID ile)

Bu servisi kullanarak kargo id ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/{id}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Bilgisi Sorgulama (Barkod No ile)

Bu servisi kullanarak barkod no ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/barcode/{barkod}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Bilgisi Sorgulama (Kargo Firması Takip No ile)

Bu servisi kullanarak kargo firması takip no ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/handler-shipment-code/{code}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Barkod İptal Etme (Barkod No ile)

Bu servisi kullanarak kargo şubesine teslim edilmemiş kargoları iptal edebilirsiniz.

Method: DELETE URL: https://basitkargo.com/api/order/barcode/{barkod}

İade Kodu Oluşturma (Barkod numarası ile)

Bu servisi kullanarak teslim edilmiş kargolarınız için iade kodu alabilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/return/barcode/{barcode}

Desi/Kg Bilgisi İle Fiyat Listeleme

Bu servis ile desi/kg bilgisi kullanarak fiyat bilgilerini listeleyebilirsiniz.

Method: GET URL: https://basitkargo.com/api/handlers/fee/desiKg/5

Servis örnek Cevap

                                                            
[
    {
        "desiKg": 5,
        "handlerCode": "MNG",
        "price": 25.54
    },
    {
        "desiKg": 5,
        "handlerCode": "YURTICI",
        "price": 25.54
    }
]

Paket Bilgileri İle Fiyat Listeleme

Bu servis ile kargo paket bilgilerini kullanarak fiyat bilgilerini listeleyebilirsiniz.

Method: POST URL: https://basitkargo.com/api/handlers/fee/packages

Servis Örnek İstek (Payload)

                                                            
[
    {
        "height": "10",
        "width": "15",
        "depth": "5",
        "weight": "1"
    }
]

Servis örnek Cevap

                                                            
[
    {
        "desiKg": 1,
        "handlerCode": "MNG",
        "price": 15.54
    },
    {
        "desiKg": 1,
        "handlerCode": "YURTICI",
        "price": 15.54
    }
]

Şehir Listeleme

Bu servis ile şehir listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/country/90/cities

Servis örnek Cevap

                                                            
[
  {
    "id": 1,
    "name": "Adana"
  },
  {
    "id": 2,
    "name": "Adıyaman"
  },
  {
    "id": 3,
    "name": "Afyonkarahisar"
  },
  {
    "id": 4,
    "name": "Ağrı"
  }
]

İlçe Listeleme

Bu servis ile şehirlere ait ilçe listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/city/{id}/towns

Servis örnek Cevap

                                                            
[
  {
    "id": 1154,
    "name": "Atabey"
  },
  {
    "id": 1297,
    "name": "Eğirdir"
  },
  {
    "id": 1341,
    "name": "Gelendost"
  }
]

Köy/Mahalle Listeleme

Bu servis ile ilçelere ait köy/mahalle listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/city/{cityName}/town/{townName}/neigborhoods Method: GET URL: https://basitkargo.com/api/city/Isparta/town/Eğirdir/neigborhoods

Servis örnek Cevap

                                                            
{
  "Gökçehöyük": [
    "Cumhuriyet",
    "Hürriyet",
    "İstiklal",
    "Zafer"
  ],
  "Baklan": [

  ],
  "Ağılköy": [
    "Harmanyeri"
  ],
  "Sipahiler": [
    "Erenler",
    "Merkez"
  ],
  "Eyüpler": [
    "Hacıramazanlar",
    "Çiftlik"
  ],
  "Mahmatlar": [

  ],
  "Merkez": [
    "Altınkum",
    "Ağa",
    "Bağbuyan",
    "Bağlar",
    "Camii",
    "Demirkapı",
    "Hacışeyh",
    "Hamam",
    "İmaret",
    "İstasyon",
    "Kale",
    "Katip",
    "Kızılçubuk",
    "Konya Bucağı",
    "Kubbeli",
    "Menderes",
    "Pınar Pazarı",
    "Poyraz",
    "Sanayi",
    "Sekibağ",
    "Seydim",
    "Yazla",
    "Yeni",
    "Yeşilada"
  ],
  "Yılgıncak": [

  ],
  "Aşağı Gökdere": [

  ],
  "Akdoğan": [
    "Karşıyaka"
  ],
  "Bademli": [

  ],
  "Havutlu": [

  ],
  "Tepeli": [

  ],
  "Balkırı": [

  ],
  "Bağören": [

  ],
  "Yukarı Gökdere": [

  ],
  "Sarıidris": [
    "Ağa",
    "Dere",
    "Hürriyet",
    "İstiklal"
  ],
  "Pazarköy": [
    "Aşağı",
    "Yeni",
    "Yukarı"
  ],
  "Haymana": [
    "Cirbeli",
    "Deniz Altı",
    "Koca Cesme"
  ],
  "Beydere": [
    "Merkez",
    "Sahil"
  ],
  "Barla": [
    "Akmescit",
    "Baş",
    "Boyalı",
    "Camikebir",
    "Pazar",
    "Yeni",
    "Yokuşbaşı"
  ],
  "Yuvalı": [
    "Bahçıvan",
    "Yelliler"
  ],
  "Sorkuncak": [

  ],
  "Sevinçbey": [
    "Beşevler"
  ],
  "Göktaş": [

  ],
  "Serpil": [
    "Çaltı Arası"
  ],
  "Bağıcık": [

  ],
  "Akpınar": [

  ],
  "Bağıllı": [

  ],
  "Kırıntı": [

  ],
  "Çay": [

  ]
}

Yetkilendirme

Örnek:

Aktif Kargo Firmalarını Listeleme

Servis örnek Cevap

Kargo Bilgisi Ekleme

Servis Örnek İstek (Payload)

Servis Örnek Cevap

Kargo Bilgisi Ekleme Ve Kargo Kodu Alma

Servis Örnek İstek (Payload)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (ID ile)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (Barkod No ile)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (Kargo Firması Takip No ile)

Servis Örnek Cevap

Kargo Barkod İptal Etme (Barkod No ile)

İade Kodu Oluşturma (Barkod numarası ile)

Desi/Kg Bilgisi İle Fiyat Listeleme

Servis örnek Cevap

Paket Bilgileri İle Fiyat Listeleme

Servis Örnek İstek (Payload)

Servis örnek Cevap

Şehir Listeleme

Servis örnek Cevap

İlçe Listeleme

Servis örnek Cevap

Köy/Mahalle Listeleme

Servis örnek Cevap

Başlıklar

Hakkımızda