Basit Kargo API

[
  {
    "name": "Aras Kargo",
    "code": "ARAS",
    "logo": "https://...logo/aras.png"
  },
  {
    "name": "Yurtiçi Kargo",
    "code": "YURTICI",
    "logo": "https://...logo/yurtici.png"
  }
]

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

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

[
  {
    "desiKg": 1,
    "handlerCode": "SURAT",
    "price": 87.93,
    "minDesiKg": null,
    "maxDesiKg": null,
    "cashOnDelivery": false,
    "creditCardOnDelivery": false,
    "codFee": null
  }
]

{
  "sender":    { "addressId": "adr-1" },
  "recipient": { "city": "İstanbul", "town": "Ataşehir" },
  "packages":  [ { "height": 10, "width": 15, "depth": 5, "weight": 1 } ],
  "paymentMethod": "ADVANCE",
  "cod": { "amount": 6000.00, "type": "CASH" },
  "includeUnavailable": true
}

curl -X POST "https://basitkargo.com/api/v2/quotes" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"recipient":{"city":"İstanbul"},"packages":[{"weight":1}]}'

{
  "calculatedAt": "2026-09-18T14:05:00",
  "currency": "TRY",
  "taxIncluded": true,
  "basis": {
    "totalDesiKg": 1,
    "pricingBasis": "IN_CITY",           // IN_CITY | INTERCITY | INTERCITY_ASSUMED
    "senderCity": "İstanbul",
    "recipientCity": "İstanbul",
    "firmAddressSource": "ADDRESS_ID",   // ORDER | ADDRESS_ID | CITY | DEFAULT_ADDRESS | NONE
    "orderId": null
  },
  "quotes": [
    {
      "handlerCode": "ARAS",
      "handler": "Aras Kargo",
      "logo": "https://...logo/aras.png",
      "available": true,
      "contract": "BASIT_KARGO",        // BASIT_KARGO | SELF
      "price": { "shipmentFee": 103.00, "codFee": 140.00, "extraServicesFee": 0, "paymentMethodFee": 0, "total": 243.00 },
      "estimatedDeliveryDays": 1,
      "pickupAddress": null,            // yalnız adresten toplama yapan firmalarda dolu
      "capabilities": { "cashOnDelivery": true, "creditCardOnDelivery": true, "maxCodAmount": 7000, "minDesiKg": 0, "maxDesiKg": 100 },
      "reasons": []
    },
    {
      "handlerCode": "PTT",
      "handler": "PTT Kargo",
      "logo": "https://...logo/ptt.png",
      "available": false,
      "contract": "BASIT_KARGO",
      "price": null,
      "capabilities": { "cashOnDelivery": true, "creditCardOnDelivery": true, "maxCodAmount": 5000, "minDesiKg": 0, "maxDesiKg": 30 },
      "reasons": [ { "code": "COD_AMOUNT_EXCEEDS_LIMIT", "message": "Kapıda ödeme tutarı kargo firmasının limitini aşıyor." } ]
    }
  ]
}

curl "https://basitkargo.com/api/v2/tariffs?handlerCodes=ARAS" \
  -H "Authorization: Bearer TOKEN" -H 'If-None-Match: "3f2a..."'

{
  "generatedAt": "2026-09-18T14:05:00",
  "currency": "TRY",
  "taxIncluded": true,
  "tariffs": [
    {
      "handlerCode": "ARAS",
      "handler": "Aras Kargo",
      "logo": "https://...logo/aras.png",
      "contract": "BASIT_KARGO",
      "capabilities": { "outgoing": true, "incoming": true, "paymentMethods": ["ADVANCE", "CASH", "RECIPIENT"], "cashOnDelivery": true, "creditCardOnDelivery": true, "maxCodAmount": 7000, "minDesiKg": 0, "maxDesiKg": 100 },
      "prices": [
        { "desi": 1, "inCityFee": 84.30, "fee": 98.80 },
        { "desi": 30, "inCityFee": 300.00, "fee": 360.00 },
        { "desi": 100, "inCityFee": 1414.50, "fee": 1490.50 }  // firmanın üst desi sınırına kadar tam fiyatlar
      ],
      "codFees": {
        "bands": [ { "min": 0, "max": 400, "fee": 20, "rangeText": "0 - 400 TL", "feeText": "20 TL" }, { "min": 6250, "max": 6999, "baseFee": 140, "rate": 0.015, "feeText": "140 TL + %1.5" } ],
        "creditCardCommissionPercent": 4.5
      },
      "extraServices": [ { "code": "SEND_SMS_TO_SENDER", "name": "Teslim Olunca Bana Bildirim Gelsin", "fee": 1 } ]
    },
    {
      "handlerCode": "SELF_ARAS",
      "handler": "Aras Kargo - KA",
      "contract": "SELF",        // kendi anlaşmanız: fiyat tablosu yok, ücreti kargo firması faturalandırır
      "prices": [],
      "codFees": null
    }
  ]
}

{
  "id": "888-6AR-OUP",
  "barcode": null,
  "type": "OUTGOING",
  "status": "NEW",
  "validationFailed": false,
  "createdTime": "2023-01-01T15:41:47.755"
}

{
  "handlerCode": "SURAT",
  "type": "OUTGOING",              // OUTGOING veya INCOMING (varsayılan: OUTGOING)
  "content": {
    "name": "Test Sipariş",
    "code": "#123456",
    "packages": [{ "height": 10, "width": 15, "depth": 5, "weight": 1 }]
  },
  "client": {
    "name": "Test Alıcı",
    "phone": "5555555555",
    "email": "musteri@ornek.com",   // opsiyonel — müşteri e-posta adresi
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah."
  },
  "collect": 100,
  "addressId": "adres-id",       // opsiyonel, kayıtlı gönderici adres ID
  "brandId": "brand-id"       // opsiyonel, mağaza marka/profil ID
}

curl "https://basitkargo.com/api/v2/order/888-6AR-OUP/fee" \
  -H "Authorization: Bearer TOKEN"

[
  {
    "handlerCode": "HEPSIJET",
    "handler": "HepsiJET",
    "handlerLogo": "hepsijet.png",
    "pickupAddress": "Koşuyolu Mah. No:1 Kadıköy/İstanbul",  // sadece adresten toplama yapan firmalarda
    "fee": 84.90,
    "codFee": 12.50,  // kapıda ödemeli değilse 0 döner
    "duration": 2,      // tahmini teslim süresi (gün)
    "disabled": false   // her zaman false (kapalı firmalar listelenmez)
  },
  {
    "handlerCode": "SURAT",
    "handler": "Sürat Kargo",
    "handlerLogo": "surat.png",
    "pickupAddress": null,  // adresten toplama yapmayan firmalarda null
    "fee": 89.90,
    "codFee": 8.50,
    "duration": 2,
    "disabled": false
  }
]

{
  "id": "888-6AR-OUP",
  "barcode": "1234567890",
  "type": "OUTGOING",
  "status": "READY_TO_SHIP",
  "shipmentInfo": {
    "handler": { "name": "Sürat Kargo", "code": "SURAT" },
    "handlerShipmentCode": null
  },
  "priceInfo": { "paymentMethod": "ADVANCE", "shipmentFee": 89.90, "totalCost": 89.90 },
  "orderTotal": 349.90,
  "orderPaymentType": "COLLECT_ON_DELIVERY",
  "orderPaymentStatus": null,   // kapıda ödemede daima null
  "codInfo": { "collectOnDelivery": true, "type": "CASH", "amount": 349.90, "collectionStatus": "COLLECTION_PENDING", "collectionStatusText": "Tahsilat Bekleniyor", "releaseDate": null }
}

{
  "startDate": "2024-01-01T00:00:00",
  "endDate": "2024-12-31T23:59:59",
  "statusList": ["READY_TO_SHIP", "SHIPPED"],
  "handlerCode": "MNG",
  "sortBy": "CREATED_TIME",
  "page": 0,
  "size": 50
}

[
  { "id": 1, "name": "Adana" },
  { "id": 2, "name": "Adıyaman" }
]

95

{
  "accountType": "CORPORATE",
  "accountTypeLabel": "Kurumsal Hesap",
  "taxExempt": false,
  "taxExemptionExpiresAt": null,
  "status": "WRONG_DOCUMENT",
  "statusLabel": "Hatalı Belge",
  "approved": false,
  "approvedAt": null,
  "lastDocumentUploadedAt": "2026-09-04T14:12:00",
  "wrongDocumentReason": "TAX_CERTIFICATE_OUTDATED",
  "wrongDocumentReasonLabel": "Vergi Levhası Güncel Değil",
  "wrongDocumentAt": "2026-09-05T10:30:00",
  "summary": "Hatalı belge: yüklenen belge kabul edilmedi; bildirilen neden: Vergi Levhası Güncel Değil (05.09.2026). Düzeltilmiş belgenin panelden veya mobil uygulamadan yeniden yüklenmesi gerekiyor."
}

[
  {
    "id": "abc-123",
    "name": "Marka Adı",
    "status": "APPROVED",
    "logo": "https://...",
    "website": "https://...",
    "instagram": "@marka",
    "createdAt": "2024-01-15T10:30:00"
  }
]

{
  "id": "abc-123",
  "status": "WAITING_APPROVAL",
  "name": "Marka Adı",
  "logo": null,
  "website": "https://www.ornek.com",
  "instagram": "@marka",
  "createdAt": "2026-08-17T10:30:00"
}

[
  {
    "id": "xyz-456",
    "name": "Depo Adresi",
    "phone": "5551234567",
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah.",
    "type": "SHIPPING",
    "createdTime": "2024-01-15T10:30:00"
  }
]

{
  "id": "xyz-456",
  "name": "Depo Adresi",
  "phone": "5551234567",
  "city": "İstanbul",
  "town": "Kadıköy",
  "address": "Koşuyolu Mah. Örnek Sok. No:1",
  "type": "SHIPPING",
  "createdTime": "2026-08-17T10:30:00"
}

[
  {
    "slug": "kapida-odeme",
    "title": "Kapıda ödeme nasıl çalışır?",
    "summary": "Kapıda Ödeme ayarlarından IBAN ile aktif edilir; ...",
    "body": "Kapıda ödemeyi panelde ..."
  }
]

curl -X POST "https://basitkargo.com/api/customer/search" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search":"Ahmet"}'

{
  "currentPage": 1,
  "pageSize": 20,
  "totalPage": 1,
  "totalNumberOfItems": 2,
  "items": [
    {
      "id": 1234,
      "name": "Ahmet Yılmaz",
      "phone": "5551234567",
      "city": "İstanbul",
      "town": "Kadıköy",
      "address": "Koşuyolu Mah. Örnek Sok. No:1 D:3",
      "orderCount": 7,
      "totalSpending": 2340.00,
      "lastOrderDate": "2026-08-12T16:41:09"
    }
  ]
}

{
  "id": 1234,
  "name": "Ahmet Yılmaz",
  "phone": "5551234567",
  "city": "İstanbul",
  "town": "Kadıköy",
  "address": "Koşuyolu Mah. Örnek Sok. No:1 D:3"
}

{
  "id": 1234,
  "name": "Ahmet Yılmaz",
  "phone": "5551234567",
  "city": "İstanbul",
  "town": "Kadıköy",
  "address": "Fenerbahçe Mah. Yeni Sok. No:5"
}

{
  "id": "XXX-XXX-XXX",
  "orderNumber": "#123456",
  "orderId": "987654321",
  "barcode": "1234567890",
  "status": "SHIPPED",
  "handler": { "name": "Aras Kargo", "code": "ARAS" },
  "handlerShipmentCode": "1234567890"
}

{
  "id": "101-DM2-XYD",
  "barcode": "1234567890",
  "status": "DELIVERED",
  "content": {
    "name": "Ekran Kartı",
    "packages": [{ "height": 25, "width": 10, "depth": 20, "weight": 1 }],
    "totalDesiKg": 2.00
  },
  "sender": { "name": "Gönderici", "phone": "444" },
  "recipient": { "name": "Alıcı", "city": "Yalova", "town": "Merkez" },
  "shipmentInfo": {
    "handler": { "name": "MNG Kargo", "code": "MNG" },
    "handlerShipmentCode": "1234567890",
    "lastState": "Teslim Edildi"
  },
  "priceInfo": { "shipmentFee": 29.93, "totalCost": 29.93 },
  "orderTotal": 349.90,
  "orderPaymentType": "COLLECT_ON_DELIVERY",
  "orderPaymentStatus": null,
  "codInfo": { "collectOnDelivery": true, "type": "CASH", "amount": 349.90, "fee": 12.50, "collectionStatus": "COLLECTED", "collectionStatusText": "Tahsil Edildi, Bakiyenize Aktarılacak", "releaseDate": "2022-08-24" },
  "traces": [
    { "status": "Teslim Edildi", "time": "2022-08-17T18:10:10", "location": "YALOVA" },
    { "status": "Dağıtıma Çıktı", "time": "2022-08-17T12:37:35", "location": "YALOVA" }
  ]
}