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 standart gönderim işlemleri için kullanılır.

PTT Standart 2

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

Sürat Kargo

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

Hepsijet - KRG

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

Kolay Gelsin

Standart gönderim, etiket yazdırma ve adresten alım (kurye çağır) özelliği ile kolaylık sağlar.

UPS Kargo

Standart gönderim ve takip kodu desteği mevcuttur.

Parametreler

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

Örnek Kod

Node.js

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

PHP

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.kargomucuz.com/v1/shipments/providers?type=standart');
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: Aktif kargo sağlayıcıları başarıyla getirildi.

{
  "status": true,
  "message": "Kargo servis sağlayıcılar getirildi.",
  "payload": {
    "data": [
      {
        "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:34:16.221Z",
          "created": "2025-08-18T21:34:16.221Z"
        },
        "isActive": true,
        "_id": "68a39c58ef4188b3428d3412",
        "private": false,
        "providerServiceCode": "surat_standart_2",
        "providerEntity": "surat",
        "providerType": "standart",
        "title": "Surat Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 26,
        "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>",
        "assignedUsers": [],
        "showLabelButton": false
      },
      {
        "others": {
          "updated": "2025-09-03T19:52:16.337Z",
          "created": "2025-09-03T19:52:16.337Z"
        },
        "isActive": true,
        "_id": "68b89c70c8dd9346ae2799ce",
        "private": false,
        "providerServiceCode": "ups_standart_2",
        "providerEntity": "ups",
        "providerType": "standart",
        "title": "UPS Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 30,
        "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>",
        "assignedUsers": [],
        "showLabelButton": false
      },
      {
        "others": {
          "updated": "2026-02-06T12:16:49.965Z",
          "created": "2026-02-06T12:16:49.966Z"
        },
        "isActive": true,
        "_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://kolaygelsin.com/assets/icons/kg-logo.svg",
        "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,
        "assignedUsers": []
      },
      {
        "others": {
          "updated": "2026-03-07T11:04:37.348Z",
          "created": "2026-03-07T11:04:37.348Z"
        },
        "isActive": true,
        "_id": "69ac0645ed5533e82dfdaf09",
        "private": false,
        "providerServiceCode": "yurtici_standart_2",
        "providerEntity": "yurtici",
        "providerType": "standart",
        "title": "Yurtiçi Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 40,
        "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>",
        "assignedUsers": [],
        "showLabelButton": false
      },
      {
        "others": {
          "updated": "2026-06-09T21:25:01.452Z",
          "created": "2026-06-09T21:25:01.452Z"
        },
        "_id": "6a2884ad8e896f7bfbee7a5a",
        "private": false,
        "isActive": true,
        "assignedUsers": [],
        "providerServiceCode": "hepsijet_standart_3",
        "providerEntity": "hepsijet",
        "providerType": "standart",
        "title": "Hepsijet - KRG",
        "instructionTextHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>Kargomucuz.com</b>'dan kabul edilecektir. İşbirliğiniz için teşekkürler!</p>",
        "barcodePrefix": "",
        "barcodeSourceField": "shipmentReferenceCode",
        "maxDesiNumber": 40,
        "addedAmountAfterMaxDesiOrKg": 10,
        "addedPercentageAfterReturnedShipment": 50,
        "currency": "try",
        "imageUrl": "https://vectorseek.com/wp-content/uploads/2024/05/HepsiJET-Kurumsal-Logo-Vector.svg-.png",
        "featureCodes": [
          102
        ],
        "showLabelButton": true,
        "__v": 0
      }
    ],
    "totalCount": 6
  },
  "code": 200
}