API referansı

Siparişleri listele

GET/api/v1/siparisler

Tüm kanallardaki siparişleri kayıt sırasıyla döndürür. Web sitenizin (ikas) siparişleri de dahildir.

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama
`baslangic`	string	hayır	Bu tarihten (dahil) sonraki siparişler: `YYYY-AA-GG` ya da `YYYY-AA-GG SS:DD`
`kanal`	string	hayır	Yalnız bu kanal (ör. `trendyol`)
`durum`	string	hayır	`bekliyor` · `kargoda` · `teslim` · `iptal_iade` · `diger`
`limit`	integer	hayır	Sayfa boyu, 1–200 (varsayılan 50)
`imlec`	integer	hayır	Önceki yanıttaki `sonraki_imlec`

Örnek istek

curl "https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&durum=bekliyor&limit=50" \
  -H "Authorization: Bearer $BULUTEGRA_ANAHTAR"

import os, requests

r = requests.get(
    "https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&durum=bekliyor&limit=50",
    headers={"Authorization": "Bearer " + os.environ["BULUTEGRA_ANAHTAR"]},
    timeout=30,
)
r.raise_for_status()
print(r.json())

const r = await fetch("https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&durum=bekliyor&limit=50", {
  headers: { Authorization: `Bearer ${process.env.BULUTEGRA_ANAHTAR}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

<?php
$ch = curl_init("https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&durum=bekliyor&limit=50");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("BULUTEGRA_ANAHTAR")],
]);
$veri = json_decode(curl_exec($ch), true);

Yanıt

{
  "siparisler": [
    {
      "kanal": "trendyol",
      "kanal_ad": "Trendyol",
      "siparis_no": "10000000001",
      "belge": "20000000001",
      "tarih": "2026-10-07 10:42:11",
      "durum": "Picking",
      "durum_kategori": "bekliyor",
      "tutar": 849.9,
      "para_birimi": "TRY",
      "adet": 2,
      "kalemler": [
        {
          "sku": "ABC-1001|SIYAH|M|",
          "barkod": "8680000000017",
          "adet": 2,
          "ad": "Örnek Ürün — Pamuklu Tişört, M"
        }
      ],
      "erp": {
        "yonetim": "bulutegra",
        "aktarildi": true,
        "erp_no": "1-S-1-000123"
      },
      "ilk_gorulme": "2026-10-07 10:43:02",
      "son_kontrol": "2026-10-07 11:20:45"
    }
  ],
  "adet": 1,
  "sonraki_imlec": null
}

Alanlar

Alan	Tür	Açıklama
`kanal`	string	Kanal kodu: `trendyol`, `hepsiburada`, `n11`, `amazon`, `ikas` (web siteniz) …
`kanal_ad`	string	Kanalın görünen adı
`siparis_no`	string	Kanaldaki sipariş numarası
`belge`	string	Kanalın paket / belge numarası (bazı kanallarda sipariş numarasından farklıdır)
`tarih`	string	Sipariş tarihi, `YYYY-AA-GG SS:DD:ss`, Türkiye saati
`durum`	string	Kanalın kendi durum metni
`durum_kategori`	string	Ortak durum: `bekliyor`, `kargoda`, `teslim`, `iptal_iade`, `diger`, `bilinmiyor`
`tutar`	number	Sipariş tutarı
`para_birimi`	string	`TRY`, `USD` …
`adet`	integer	Toplam ürün adedi
`kalemler[]`	array	`sku`, `barkod`, `adet`, `ad`
`erp`	object	`yonetim` (`bulutegra` ya da web siteniz için `harici`), `aktarildi` (true/false/null), `erp_no`
`ilk_gorulme`	string	Bulutegra'nın siparişi ilk gördüğü an
`son_kontrol`	string	Kanalda son kontrol edildiği an
`musteri`	string	Müşteri adı — yalnız kişisel veri dahil kapsamlı anahtarla döner

Son güncelleme: 2026-10-07

Siparişleri listele

#Sorgu parametreleri

#Örnek istek

#Yanıt

#Alanlar

Sorgu parametreleri

Örnek istek

Yanıt

Alanlar