Sipariş Kontrol V2

Bu metod ile mağazanızdaki belirtilen tarih aralığındaki sipariş bilgilerini almanıza olanak tanır. (Siparişte birden fazla ürün varsa ürün kırılımı ile bilgilerin alınmasına olanak tanır.)

Endpoint Bilgileri

  • URL: `https://integration-api.pttavm.com/api/v1/shipping/cargo-profiles
  • HTTP Metodu: GET
  • header : Api-Key zorunlu
  • header : access-token zorunlu
  • header : Content-Type: application/json

Dikkat Edilmesi Gereken Kurallar

  • Başlangıç ve bitiş tarihleri arasındaki süre en fazla 40 gün olabilir.
  • Bitiş tarihi başlangıç tarihinden önce olamaz; aksi takdirde hata dönecektir.
  • ‘AktifSiparisler’=1 olarak gönderilirse, ‘kargo_yapilmasi_bekleniyor’ durumuna sahip siparişler gösterilir, yani ödeme yapılmıştır ancak sipariş tedarikçi tarafından hazırlanmamıştır. Tüm siparişleri almak için 'AktifSiparisler'=0 olarak gönderilmesi gerekmektedir.
Parametre Tür Açıklama
startDate string / date-time Sipariş bilgisini almak istediğiniz başlangıç tarihi ** zorunlu**
endDate DateTime / date-time Sipariş bilgisini almak istediğiniz bitiş tarihi **zorunlu**
isActiveOrders boolean False olarak gönderilmesi gerekmektedir. ** zorunlu**

Örnek Servis İsteği


curl 'http://integrator-core-api-test.rancher.pttavm.com/api/v1/orders/search?startDate=&endDate=&isActiveOrders=' \
  --header 'Api-Key: ' \
  --header 'Access-Token: '

Örnek Servis Cevabı


[
  {
    "vergiDaire": null,
    "vergiNo": null,
    "kargoTutari": 1,
    "musteriId": null,
    "eposta": null,
    "tckn": null,
    "islemTarihi": "2026-01-23T10:40:02.399Z",
    "siparisNo": null,
    "musteriAdi": null,
    "musteriSoyadi": null,
    "siparisAdresi": null,
    "telefonNo": null,
    "ilKod": null,
    "ilceKod": null,
    "siparisIli": null,
    "siparisIlce": null,
    "tedarikciFirmaAdi": null,
    "firmaUnvani": null,
    "urunAdi": null,
    "urunKodu": null,
    "siparisUrunler": [
      {
        "urunId": 1,
        "garantiVerenFirma": null,
        "komisyon": 1,
        "siparisDurumu": null,
        "urunBarkod": null,
        "siparisNotu": null,
        "kdvOrani": 1,
        "kdvHaricTutar": 1,
        "kdvHaricToplamTutar": 1,
        "kdvDahilToplamTutar": 1,
        "toplamIslemAdedi": 1,
        "variantBarkod": null,
        "kargoKimden": null,
        "indirimToplam": 1,
        "indirimPttavm": 1,
        "indirimTedarikci": 1,
        "couponAmount": 1,
        "lineItemId": 1,
        "isInvoice": true,
        "urun": null
      }
    ],
    "faturaMusteriAdi": null,
    "faturaMusteriSoyadi": null,
    "faturaAdresi": null,
    "faturaIli": null,
    "faturaIlce": null,
    "farkliAdres": null,
    "faturaTip": null,
    "seriBarkod": true,
    "kargoBarkod": null,
    "barcodes": [
      {
        "barcode": null,
        "type": null
      }
    ]
  }
]
Parametre Tür Açıklama
VergiDaire string Vergi dairesi bilgisi
VergiNo string Vergi numarası bilgisi
KargoTutari double Kargo bedeli bilgisi
MusteriId string Müşteri kimlik bilgisi
Eposta string Müşteri mail adresi
TCKN string TC Kimlik bilgisi
IslemTarihi DateTime İşlem tarihi alanıdır. (Örnek Tarih Formatı: 2024-01-01T14:57:12)
SiparisNo string Sipariş numarası bilgisi
MusteriAdi string Müşteri isim bilgisi
MusteriSoyadi string Müşteri soyadı bilgisi
SiparisAdresi string Sipariş teslimat adres bilgisi
TelefonNo string Müşteri telefon numarası bilgisi ( Telefon numarası maskelenmiş olarak görünecektir
IlKod string İl kod bilgisi
IlceKod string İlçe kod bilgisi
SiparisIli string Sipariş il bilgisi
SiparisIlce string Sipariş ilçe bilgisi
TedarikciFirmaAdi string Mağaza adı bilgisi
TedarikciFirmaAdi string Mağaza adı bilgisi
FirmaUnvani string Şirket adı
UrunAdi string Ürün adı
UrunKodu string Ürün stok kod bilgisi
UrunId int Ürün id bilgisi
GarantiVerenFirma string Garantiyi veren firma bilgisi
Komisyon double Komisyon bilgisi
SiparisDurumu string Siparişin durum bilgisini içerir. Olası dönüş değerleri
kargo_yapilmasi_bekleniyor, havale_onayi_bekleniyor, iptal, gondericisine_teslim_edildi, iade, gonderilmiş, odeme_gecersiz, onay_surecinde, tamamlandi, null [string]
UrunBarkod string Ürün barkod bilgisi
siparisNotu string Sipariş ile ilgili genel bilgiler
KdvOrani double KDV oranı bilgisi Formül: VAT (Value Added Tax - KDV)
KdvHaricTutar double Ürünün KDV hariç tutar bilgisi Formül: VAT (Value Added Tax - KDV)
KdvHaricToplamTutar string Kdv hariç toplam tutar bilgisi Formül: ToplamIslemAdedi X KdvHaricTutar
KdvDahilToplamTutar double Kdv dahil toplam tutar bilgisi. Formül: ToplamIslemAdedi X KdvDahilTutar
ToplamIslemAdedi int Satılan ürünün adet bilgisi
VariantBarkod string Satılan ürünün varyantları varsa, varyant kimliği kombinasyonları virgülle ayrılarak döndürülür. (Örnek: 2737667, 2737668, 2737669)
KargoKimden string Gönderiyi kimin gönderdiği bilgisi
IndirimToplam double Uygulanan toplam indirim tutarı bilgisi
IndirimPttavm double Pttavm indirim bilgisi
IndirimTedarikci double Tedarikçi(mağaza) indirim bilgisi
LineItemId int Siparişteki ürün id bilgisi
Urun string Ürün bilgisi
FaturaMusteriAdi string Faturada yer alan müşteri adı bilgisi
FaturaMusteriSoyadi string Faturada yer alan müşteri soyadı bilgisi
FaturaAdresi string Fatura adresi
FaturaIli string Fatura adresindeki il bilgisi
FaturaIlce string Fatura adresindeki ilçe bilgisi
FarkliAdres string Sipariş içerisinde farklı bir adres bilgisi varsa bu alan 1 olarak, aksi halde 0 olarak dönecektir. 1 dönmesi durumunda 2,5 ₺ (Türk Lirası) ek fatura ücreti alınacaktır.
faturaTip string Fatura tipi
SeriBarkod boolean Belirtilen durumlar dışında bir sipariş durumu döndürülürse, bu alan true olacaktır; aksi takdirde, false olacaktır.
KargoBarkod string Kargo barkod bilgisi
Barcodes string Sipariş barkod bilgisi