Kargo Sağlayıcıları

Açıklama

GET /v1/shipments/providers

Sisteme entegre tüm aktif kargo firmalarının detaylı bilgilerini döner.

Kargo Sağlayıcıları ve Kullanım Amaçları

Aşağıda sistemimizde bulunan kargo sağlayıcılarının desteklediği özellikler ve kullanım alanları listelenmiştir:

Yurtiçi Kargo

Sadece normal gönderim işlemleri için kullanılır.

PTT Standart 2

Normal gönderim, kapıda ödeme, kredi kartı ve nakit kullanımını destekler.

Sürat Kargo

Normal gönderim, kapıda ödeme, kredi kartı ve nakit kullanımını destekler.

Hepsijet 3

Normal gönderim ve nakit kullanımı. Adresten alım (kurye çağır) özelliği mevcuttur.

Kolay Gelsin

Normal gönderim ve adresten alım (kurye çağır) özelliği ile kolaylık sağlar.

UPS Kargo

Normal gönderim ve adresten alım (kurye çağır) desteği mevcuttur.

PTT Sabit Fiyatlı

Alıcı ödemeli ve şubeden ödemeli gönderimler için idealdir.

Parametreler

Parametre	Konum	Tip	Açıklama	Varsayılan	Örnek
Authorization *	header	string	Bearer Yetkilendirme Tokeni (Örn: Bearer eyJhb...)	-	`Bearer <TOKEN>`
feature-codes *	query	string		-	`-`
type	query	string	Kargo sağlayıcılarını providerType'a göre filtreler. 'fixed_price' veya 'standart' değerlerini alabilir.	-	`standart`

fetch('https://api.kargomucuz.com/v1/shipments/providers', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <YOUR_TOKEN>'
  }
})
.then(response => response.json())
.then(data => console.log(data));

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.kargomucuz.com/v1/shipments/providers');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'Authorization: Bearer <YOUR_TOKEN>';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
echo $result;

Yanıtlar

200: Başarılı kimlik doğrulaması sonrası dönen yanıt.

{
  "status": true,
  "message": "Kargo servis sağlayıcılar getirildi.",
  "payload": {
    "data": [
      {
        "others": {
          "updated": "2024-10-18T23:34:26.883Z",
          "created": "2024-10-18T23:34:26.883Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "showLabelButton": false,
        "_id": "6712f0820c3b87b34ff3cb33",
        "private": false,
        "providerEntity": "ptt",
        "providerType": "fixed_price",
        "providerServiceCode": "ptt_fixed_price",
        "title": "PTT Sabit Fiyatlı Kargo",
        "maxDesiNumber": 31,
        "addedAmountAfterMaxDesiOrKg": 10,
        "currency": "try",
        "imageUrl": "https://upload.wikimedia.org/wikipedia/tr/a/a7/Ptt_yenilogo.png",
        "__v": 0,
        "featureCodes": [
          101,
          102
        ],
        "addedAmountAfterReturnedShipment": 0,
        "addedPercentageAfterReturnedShipment": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>Kargomucuz.com</b>'ten kabul edilecektir. İşbirliğiniz için teşekkürler!</p>"
      },
      {
        "others": {
          "updated": "2025-08-18T21:30:31.693Z",
          "created": "2025-08-18T21:30:31.693Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "showLabelButton": false,
        "_id": "68a39b77ef4188b3428d3336",
        "private": false,
        "providerServiceCode": "ptt_standart_2",
        "providerEntity": "ptt",
        "providerType": "standart",
        "title": "PTT Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 30,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://upload.wikimedia.org/wikipedia/tr/a/a7/Ptt_yenilogo.png",
        "featureCodes": [
          102
        ],
        "__v": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>COM2HOME</b>'dan kabul edilecektir. İşbirliğiniz için teşekkürler!</p>"
      },
      {
        "others": {
          "updated": "2025-08-18T21:33:01.748Z",
          "created": "2025-08-18T21:33:01.749Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "_id": "68a39c0def4188b3428d3400",
        "private": false,
        "providerServiceCode": "hepsijet_standart_2",
        "providerEntity": "hepsijet",
        "providerType": "standart",
        "title": "Hepsijet Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 10,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://vectorseek.com/wp-content/uploads/2024/05/HepsiJET-Kurumsal-Logo-Vector.svg-.png",
        "featureCodes": [],
        "__v": 0,
        "barcodePrefix": "ADO",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>ADOREL LOJİSTİK</b>'ten kabul edilecektir. İşbirliğiniz için teşekkürler!</p>",
        "showLabelButton": true
      },
      {
        "others": {
          "updated": "2025-08-18T21:34:16.221Z",
          "created": "2025-08-18T21:34:16.221Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "showLabelButton": false,
        "_id": "68a39c58ef4188b3428d3412",
        "private": false,
        "providerServiceCode": "surat_standart_2",
        "providerEntity": "surat",
        "providerType": "standart",
        "title": "Surat Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 24,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://www.suratkargo.com.tr/assets/images/logo.png",
        "featureCodes": [
          102
        ],
        "__v": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından<b> STOCADO</b>'dan kabul edilecektir. İşbirliğiniz için teşekkürler!</p>"
      },
      {
        "others": {
          "updated": "2025-09-03T19:52:16.337Z",
          "created": "2025-09-03T19:52:16.337Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "showLabelButton": false,
        "_id": "68b89c70c8dd9346ae2799ce",
        "private": false,
        "providerServiceCode": "ups_standart_2",
        "providerEntity": "ups",
        "providerType": "standart",
        "title": "UPS Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 20,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://w7.pngwing.com/pngs/487/604/png-transparent-united-parcel-service-logo-the-ups-store-cargo-mail-business-label-text-trademark.png",
        "featureCodes": [],
        "__v": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentTrackingCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>ADOREL LOJİSTİK</b>'ten kabul edilecektir. İşbirliğiniz için teşekkürler!</p>"
      },
      {
        "others": {
          "updated": "2026-02-06T12:16:49.965Z",
          "created": "2026-02-06T12:16:49.966Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "_id": "6985dbb1a4a45a36f5be229e",
        "private": false,
        "providerServiceCode": "kolaygelsin_standart_2",
        "providerEntity": "kolaygelsin",
        "providerType": "standart",
        "title": "KOLAYGELSİN Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 26,
        "addedPercentageAfterReturnedShipment": 40,
        "currency": "try",
        "imageUrl": "https://developer.kolaygelsin.com/logo.0f38437e8c3363c5a580.png",
        "featureCodes": [],
        "__v": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>ADOREL LOJİSTİK</b>'ten kabul edilecektir. İşbirliğiniz için teşekkürler!</p>",
        "showLabelButton": true
      },
      {
        "others": {
          "updated": "2026-03-07T11:04:37.348Z",
          "created": "2026-03-07T11:04:37.348Z"
        },
        "isActive": true,
        "assignedUsers": [],
        "showLabelButton": false,
        "_id": "69ac0645ed5533e82dfdaf09",
        "private": false,
        "providerServiceCode": "yurtici_standart_2",
        "providerEntity": "yurtici",
        "providerType": "standart",
        "title": "Yurtiçi Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 36,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://vectorseek.com/wp-content/uploads/2023/10/Yurtici-Kargo-Logo-Vector.svg-.png",
        "featureCodes": [],
        "__v": 0,
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>NEOGEN MAKİNE İNŞAAT</b>'tan kabul edilecektir. İşbirliğiniz için teşekkürler!</p>"
      }
    ],
    "totalCount": 7
  },
  "code": 500
}