CoperAPI

OtelFiyatSec

Verilen tarih aralığı ve kriterlere göre otel fiyat sorgusu yapar.

POST /api/Coper/OtelFiyatSec

Yetkilendirme: Authorization: Bearer {{Token}}

Header'lar

Header	Değer
CariSirketNo	`{{CariSirketNo}}`
CoperSirketNo	`{{CoperSirketNo}}`

Örnek İstek Gövdesi

{
    "GirisTarihi":"2023-05-23",
    "CikisTarihi":"2023-05-23",
    "CariKod":"DENEME",
    "OtelKod":null,
    "OperatorKod":null,
    "Pansiyon":null,
    "OdaTip":null,
    "Konum":null,
    "Ulke":"",
    "Sehir":"",
    "Yer":"",
    "SaticiKonumu":"",
    "SiralamaTipi":4,
    "Kategori":"",
    "MaxGunSayisi":7,
    "FiyatKodu":null
}

CoperFaturaInfo

Fatura kayıtlarını tarih, cari, seri no, PNR gibi filtrelerle listeler.

POST /api/Coper/CoperFaturaInfo

Yetkilendirme: Authorization: Bearer {{Token}}

Header'lar

Header	Değer
CariSirketNo	`{{CariSirketNo}}`
CoperSirketNo	`{{CoperSirketNo}}`

Örnek İstek Gövdesi

  
  //FatTip değerleri aşağıdaki gibi      
  //Satis Faturasi = 1  
  //Komisyon Faturasi = 2 
  //Iade Faturası = 3
  //Gelen Fatura = 4 
  //Satis Iade Faturası = 5

  //DisEnt: fatura tablolarindaki logo_ent alanina gore filtreler. null (filtre yok), 'E' (entegre edildi), 'H' (entegre edilmedi / kaldirildi - NULL kayitlari da kapsar)

{
  "FatTip": null, 
  "CariKod": null,
  "MuhEnt": null,
  "DisEnt": null,
  "SeriNo": null,
  "FaturaNo": null,
  "Tarih1": "2025-01-01",
  "Tarih2": "2025-03-20",
  "PNR_No": null,
  "IslemRef": null,
  "SaticiTip": null,
  "SaticiKod": null,
  "GenelFatId": null,
  "NotMuhData": false
}

Notlar

Response içindeki data.SatisFaturalari[].Header.CariInfo (ve aynı şekilde KomisyonFaturalari/IadeFaturalari/GelenFaturalar/SatisIadeFaturalari altındaki Header.CariInfo) nesnesine şu alanlar eklendi: VergiNo, TCKimlikNo, VergiDairesi, Email, Telefon, Faks, Adres, Ilce, Sehir, UlkeKodu, Bireysel (bool).
Aynı alanlar kalem seviyesinde de eklendi: her satırdaki (Lines[]) Satici.CariInfo ve TurOperatoru.CariInfo nesneleri de aynı 11 alanı içerir.
Kalemlere (Lines[]) ayrıca YolcuAdi, GirisTarihi, CikisTarihi, AlisTutar, AlisParaBirimi, AlisKur, KomisyonTutar, KomisyonYuzde, KomisyonParaBirimi, KomisyonKur alanları eklendi. GirisTarihi/CikisTarihi PersonDetails kaydının Donem1/Donem2 alanlarından, AlisTutar/AlisParaBirimi/AlisKur/KomisyonTutar/KomisyonYuzde V_Persondetails view'ının satıcı tipine göre hesaplanan alanlarından, YolcuAdi KisiIsim -> Adresler zincirinden gelir.
KomisyonParaBirimi/KomisyonKur, PersonDetails üzerindeki satıcı (tedarikçi) komisyonuna ait KomParaBirimi/KomKur alanlarından gelir; acente komisyonuna ait ayrı bir doviz/kur alanı (KomisyonDovizCinsi/KomisyonKur, DB'de AcenteKomisyon olarak da anılır) bununla karıştırılmamalıdır, bu response'a dahil edilmedi.
Request'e DisEnt alanı eklendi: fatura tablolarındaki logo_ent kolonuna göre filtreler. Değerler: null (filtre uygulanmaz), 'E' (entegre edildi), 'H' (entegre edilmedi/kaldırıldı — logo_ent NULL olan kayıtlar da 'H' ile eşleşir).
PERFORMANS/DAVRANIŞ NOTU: Kalemlerdeki AlisTutar, AlisParaBirimi, AlisKur, KomisyonTutar, KomisyonYuzde alanları V_Persondetails_Light view'ından geliyor — bu, orijinal V_Persondetails view'ının (13 alt tabloyu tek satırda CASE ile join eden ağır view) hafifletilmiş bir sürümüdür: aynı formülleri satıcı tipine göre ayrı UNION ALL dallarına bölerek her dalın yalnızca kendi tek detay tablosuna join yapmasını sağlar. KomisyonParaBirimi/KomisyonKur artık view'a hiç gitmeden doğrudan PersonDetails tablosundan okunuyor. Bu join (ve dolayısıyla bu 7 alanın hesaplanması) SADECE DisEnt alanı doldurulduğunda (null/boş değilse) yapılıyor; DisEnt boş/null bırakılırsa sorgu daha hafif çalışır ama yukarıdaki alanlar response'ta NULL döner.
Kalemlere (Lines[]) TurKodu ve ReferansKodu eklendi. Bu alanlar PNR (rezervasyon) seviyesindeki Kisi tablosundan (Kisi.TurKodu / Kisi.ReferansKod) gelir; aynı PNR'a bağlı tüm kalemlerde aynı değeri taşır.
Ilce/Sehir alanları CariHesap kaydındaki e-fatura adresinden (efatura_ilce/efatura_il) gelir; genel fatura adresindeki 'ilce_il' tek parça olduğu için ayrı il/ilçe olarak sunulamıyor.
UlkeKodu, veritabanındaki serbest metin 'Ulke' alanının ham halidir; ISO 3166 kodu olduğu garanti edilmez.
Bireysel, TCKimlikNo alanı doluysa true (gerçek kişi), aksi halde false (tüzel kişi) olarak hesaplanır.

RezervasyonKaydet

Otel/tur rezervasyonunu ve kalemlerini sisteme kaydeder.

POST /api/Coper/RezervasyonKaydet

Yetkilendirme: Authorization: Bearer {{Token}}

Header'lar

Header	Değer
CariSirketNo	`{{CariSirketNo}}`
CoperSirketNo	`{{CoperSirketNo}}`

Örnek İstek Gövdesi

{
    "Rezervasyon": {                        //Rezervasyon:required field
        "pNR_No": 0,
        "Status": 0,
        "FaturaBilgileri": [],
        "kayitTarihi": "2025-05-09",        //kayitTarihi:required field
        "cariKod": {
            "kod": "DENEME"
        },
        "rezVeren": "",
        "masrafMerkezi": {
            "kod": ""
        },
        "anaTip": 0,
        "ulke": null,
        "karsiRezKod": "",
        "turKod": "",
        "acenteDepartman": {
            "kod": ""
        },
        "hizmetNo": "",
        "referansKod": "",
        "adresler": [                        //adresler:required field
            {
              
                "kisiTip": 0,
                "kisiSira": 0,
                "yas": 0,
                "profilId": 0,
                "sicilId": 0,
                "tcKimlikNo": "",
                "uyeNo": "",
                "lastName": "Öztürk",            //lastName:required field
                "firstName": "Ahmet04",          //firstName:required field            
                "adSoyad": "Ahmet Öztürk",
                "adres": "",
                "dogumTarihi": null,
                "cinsiyet": "",
                "telefon1": "",
                "gsm": "",
                "eMail": ""
            }
        ],
        "kalemler": [                                //kalemler:required field
            {
                "islemRef": 0,
                "saticiEntegrasyon": null,
                "entTip": null,
                "entId": null,
                "donem1": "2025-05-09",             //donem1:required field
                "donem2": "2025-05-10",             //donem2:required field
                "satis": {                           //satis:required field
                    "KDVOran": 10
                },
                "alis": {                            //alis:required field
                    "KDVOran": 0
                },
                "komisyon": {                        //komisyon:required field
                    "KDVOran": null,
                    "tutar": 0
                },
                "acenteKomisyon": null,
                "iskonto": {                         //iskonto:required field
                    "oran": 0,
                    "tutar": 0,
                    "iskontoSebebi": null
                },
                "odeyenTaraf": 1,
                "aciklama": null,
                "tedarikciAciklama": null,
                "turOperatoru": {
                    "kod": null
                },
                "departman": {
                    "kod": null
                },
              
              
                "entegrasyonKodu": null,
                "maliyetCariKod": {
                     "kod": null
                },
                "saticiTip": 1,                                              //saticiTip:required field
                "kisiSira": [                                                 //kisiSira:required field
                    0
                ],
                "yet_Satis": 100,
                "co1_Satis": 0,
                "co2_Satis": 0,
                "co3_Satis": 0,
                "co4_Satis": 0,
                "ekY_Satis": 0,
                "yet_Alis": 0,
                "co1_Alis": 0,
                "co2_Alis": 0,
                "co3_Alis": 0,
                "co4_Alis": 0,
                "ekY_Alis": 0,
                "yet_KisiSayisi": 1,
                "co1_KisiSayisi": 0,
                "co2_KisiSayisi": 0,
                "co3_KisiSayisi": 0,
                "co4_KisiSayisi": 0,
                "ekY_KisiSayisi": 0,
                "satici": {                                                      //satici:required field
                    "kod": "DENEME"                                               //kod:required field
                },
                "alisPara": {                                                    //alisPara:required field               
                    "paraBirimi": "TL",
                    "kur": 1,
                    "kurTarihi": null
                },
                "satisPara": {                                                   //satisPara:required field
                    "paraBirimi": "TL",
                    "kur": 1,
                    "kurTarihi": null
                },
                "komisyonPara": {                                                //komisyonPara:required field
                    "paraBirimi": "TL",
                    "kur": 1,
                    "kurTarihi": null
                },
                "komisyonYuzdeTip": 1,
                "komisyonYuzde": 0,
                "komisyonTutar": 0,
                "P_RP": "P",
                "KKartNo": null,
                "KKartOdemeTipi": 0,
                "masrafMerkezi": {
                     "kod": ""
                },
                "kalemOtel": {                                           //kalemOtel:required field
                    "odaTipi": {
                        "kod": null
                    },
                    "pansiyon": 0,
                    "girisSaati": "12:00",
                    "konum": null,
                    "RP": "T",
                    "KomKDVHaric": false,
                    "KomKahvaltiHaric": false,
                    "KomOgleYemegiHaric": false,
                    "KomAksamYemegiHaric": false,
                    "KonaklamaVergisiVar": false,
                    "odaSayi": 1,
                    "kontenjan": false,
                    "freeKisi": 0
                  
                },
                "kalemArac": null,
                "kalemRestaurant": null,
                "kalemDiger": null,
                "kalemRentACar": null,
                "kalemVize": null,
                "kalemSigorta": null,
                "kalemGemi": null,
                "kalemRehber": null,
                "kalemAcente": null,
                "kalemCharter": null,
                "kalemFeribot": null,
                "kalemGolf": null,
                "kalemMuze": null
            }
        ],
        "odemeler": [],
      
        "opsiyonluMusteri": false,
        "opsiyonTarihi": null,
        "opsiyonSaati": null,
        "acente": {
            "kod": null
        }
    }
}

CoperFaturaStatusSet

Fatura kayıtlarının muhasebe (Logo) entegrasyon durumunu ("entegre edildi" / "entegre kaldır") günceller.

POST /api/Coper/CoperFaturaStatusSet

Yetkilendirme: Authorization: Bearer {{Token}}

Header'lar

Header	Değer
CariSirketNo	`{{CariSirketNo}}`
CoperSirketNo	`{{CoperSirketNo}}`

Örnek İstek Gövdesi

//FatTip değerleri aşağıdaki gibi      
//Satis Faturasi = 1  
//Komisyon Faturasi = 2 
//Iade Faturası = 3
//Gelen Fatura = 4 
//Satis Iade Faturası = 5

//Status değerleri: 0 İşlem yapma, 1 Entegre edildi yap, 2 Entegre kaldır

//SaticiTip ve SaticiKod opsiyoneldir, yalnızca FatTip = 4 (Gelen Fatura) için dikkate alınır

{
    "FatTip": 4,
    "CariKod": "CARI-TEST",
    "SeriNo": "GIB",
    "FaturaNo": 12,
    "FaturaTarihi": "2026-08-05",
    "Status": 1,
    "SaticiTip": 1,
    "SaticiKod": "HILTON"
}

Notlar

SaticiTip ve SaticiKod alanları opsiyoneldir; yalnızca FatTip = 4 (Gelen Fatura) için etkilidir ve aynı CariKod'un birden fazla satıcı tipiyle/koduyla eşleştiği durumlarda doğru kaydın güncellenmesini sağlar. Her ikisi de verilirse ikisi birden filtre olarak uygulanır.
Response: { Status: bool, data: int (etkilenen satır sayısı), ErrorList: string[] }. Eşleşen kayıt bulunamazsa "Fatura bulunamadı." hatası döner.

← Tüm Endpoint'ler