E-Ticaret API Dokümanı

Genel Bilgi

Tüm korumalı endpointlerde X-Api-Key header değeri gönderilmelidir. ApiKey hangi firmaya aitse API sadece o firmanın verileriyle işlem yapar.

Base URL

https://eticaretapi.takipsa.com

Ortak Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

JSON Doküman

GET https://eticaretapi.takipsa.com/ApiDokuman/DokumanJson

Not: Örneklerdeki ApiKey değeri temsildir. Her firmaya özel üretilen gerçek ApiKey kullanılmalıdır.

GET API Durum Kontrolü

https://eticaretapi.takipsa.com/Eticaret/Ping

ApiKey geçerli mi ve API çalışıyor mu kontrol eder.

ApiKey Gerekli: Evet

Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Response JSON

{
  "success": true,
  "message": "E-ticaret API çalışıyor.",
  "firmaId": 1
}

GET Ürün Listesi

https://eticaretapi.takipsa.com/Eticaret/UrunListesi?search=&page=1&pageSize=50&onlyWebProducts=false

ApiKey'e bağlı FirmaID için ürün listesini getirir.

ApiKey Gerekli: Evet

Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Parametreler

Parametre	Tip	Zorunlu	Açıklama
search	string	Hayır	Ürün adı, stok kodu, barkod, marka veya kategori araması.
page	int	Hayır	Sayfa numarası. Varsayılan: 1
pageSize	int	Hayır	Sayfa başına kayıt sayısı. Varsayılan: 50, maksimum: 500
onlyWebProducts	bool	Hayır	true gönderilirse sadece web/e-ticaret görünümündeki ürünler gelir.

Response JSON

{
  "TotalCount": 125,
  "Page": 1,
  "PageSize": 50,
  "Items": [
    {
      "ID": 15,
      "StokKodu": "STK-001",
      "Barkod": "8690000000001",
      "UrunAdi": "Test Ürün",
      "StoktaKalan": 25.000000,
      "SatishFiyat": 150.000000,
      "KDV": 20,
      "Birimi": "ADET",
      "Kategori": "Genel",
      "Marka": "Marka",
      "Fotograf": "",
      "Aciklama": "",
      "StokList": true,
      "WebGorunumu": true
    }
  ]
}

GET Ürün Detay

https://eticaretapi.takipsa.com/Eticaret/UrunDetay?id=15

Belirtilen ürün ID değerine göre ürün detayını getirir. Sadece ApiKey'e bağlı firmaya ait ürün döner.

ApiKey Gerekli: Evet

Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Parametreler

Parametre	Tip	Zorunlu	Açıklama
id	int	Evet	Stok tablosundaki ürün ID değeri.

Response JSON

{
  "ID": 15,
  "StokKodu": "STK-001",
  "Barkod": "8690000000001",
  "UrunAdi": "Test Ürün",
  "StoktaKalan": 25.000000,
  "SatishFiyat": 150.000000,
  "KDV": 20,
  "Birimi": "ADET",
  "Kategori": "Genel",
  "Marka": "Marka",
  "Fotograf": "",
  "Aciklama": "",
  "StokList": true,
  "WebGorunumu": true
}

GET Sipariş Var mı Kontrolü

https://eticaretapi.takipsa.com/Eticaret/SiparisVarMi?marketplace=Trendyol&siparisNo=TY-10001

Belirtilen pazaryeri sipariş numarası daha önce aktarılmış mı kontrol eder.

ApiKey Gerekli: Evet

Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Parametreler

Parametre	Tip	Zorunlu	Açıklama
marketplace	string	Evet	Pazaryeri adı. Örnek: Trendyol, Hepsiburada, Shopify, WooCommerce
siparisNo	string	Evet	Pazaryeri sipariş numarası.

Response JSON

{
  "success": true,
  "exists": false
}

POST Sipariş Aktar

https://eticaretapi.takipsa.com/Eticaret/SiparisAktar

Pazaryerinden gelen siparişi Cari, ORDERS, ORDERS_DETAIL tablolarına aktarır ve stok miktarını düşer.

ApiKey Gerekli: Evet

Header

Content-Type: application/json
X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Request JSON

{
  "Marketplace": "Trendyol",
  "SiparisNo": "TY-10001",
  "SiparisTarihi": "2026-05-13T14:00:00",
  "ParaBirimi": "TL",
  "OdemeSekli": "Pazaryeri",
  "TeslimatAdresi": "İstanbul Kadıköy teslimat adresi",
  "FaturaAdresi": "İstanbul Kadıköy fatura adresi",
  "Aciklama": "Trendyol siparişi",
  "Customer": {
    "CariUnvan": "Ahmet Yılmaz",
    "VergiNo": "",
    "VergiDairesi": "",
    "TcNo": "11111111111",
    "Telefon": "02120000000",
    "Gsm": "05550000000",
    "EPosta": "ahmet@test.com",
    "Adres": "İstanbul Kadıköy adres",
    "Il": "İstanbul",
    "Ilce": "Kadıköy",
    "Ulke": "Türkiye"
  },
  "Lines": [
    {
      "StokKodu": "STK-001",
      "Barkod": "8690000000001",
      "UrunAdi": "Test Ürün",
      "Miktar": 2,
      "BirimFiyat": 100,
      "Kdv": 20,
      "Iskonto": 0,
      "Birim": "ADET"
    }
  ]
}

Response JSON

{
  "Success": true,
  "Message": "Sipariş başarıyla aktarıldı.",
  "ID": 123
}

POST Siparişten Fatura Oluştur

https://eticaretapi.takipsa.com/Eticaret/FaturaOlustur?orderId=123

Aktarılmış siparişten INVOICE ve INVOICE_DETAIL kayıtlarını oluşturur.

ApiKey Gerekli: Evet

Header

X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Parametreler

Parametre	Tip	Zorunlu	Açıklama
orderId	int	Evet	ORDERS tablosundaki sipariş ID değeri.

Response JSON

{
  "Success": true,
  "Message": "Fatura başarıyla oluşturuldu.",
  "ID": 456
}

POST Sipariş İptal

https://eticaretapi.takipsa.com/Eticaret/SiparisIptal

Pazaryerinden gelen iptal bilgisini muhasebe siparişine işler. İstenirse stok miktarını geri ekler.

ApiKey Gerekli: Evet

Header

Content-Type: application/json
X-Api-Key: hsp_live_xxxxxxxxxxxxxxxxx

Request JSON

{
  "Marketplace": "Trendyol",
  "SiparisNo": "TY-10001",
  "IptalAciklama": "Müşteri siparişi iptal etti.",
  "StokGeriEklensin": true,
  "FaturaliSiparisIptalEdilsin": false
}

Response JSON

{
  "Success": true,
  "Message": "Sipariş başarıyla iptal edildi.",
  "ID": 123
}