Çekler ve Adisyonlar: ORIONPOS API Satış Kayıtları

ORIONPOS API’de çek, bir şubede gerçekleşen her türlü mali işlemin kaydıdır. Standart satışlardan kasa harcamalarına, cari tahsilatlara kadar tüm işlemler çek olarak modellenir. Satış verilerini dış sistemlerinizle senkronize etmek için çek yapısını ve alanlarını iyi anlamanız gerekir.

Çek Tipleri

ORIONPOS API üç farklı çek tipi sunar:

Adisyonlar (Satış)

Standart satış çekleridir. Masa, paket servis veya gel-al gibi tüm satış kanallarından oluşan çekleri kapsar.

Satılan ürünlerin (Items) ve varsa ilavelerin (Condiments) detaylı listesini içerir.
Bir çek; nakit, kredi kartı, yemek çeki gibi bir veya birden fazla ödeme tipiyle kapatılabilir.
IsReturn: true olan adisyonlar iade işlemini temsil eder; bu çeklerdeki tüm tutar ve miktar değerleri negatif gelir.

Tahsilatlar

Cari (veresiye) hesaplara ait borç ödeme kayıtlarıdır.

Müşterinin birikmiş borcunu kısmen veya tamamen ödediği işlemleri temsil eder.
Items alanı boş olabilir; asıl bilgi Payments alanında yer alır.

Harcamalar

Kasa üzerinden gerçekleşen para çıkışı kayıtlarıdır.

Örneğin temizlik malzemesi alımı veya kurye ödemesi gibi operasyonel giderleri kapsar.
Kasa bakiyesini etkiler ve muhasebe entegrasyonlarında ayrıştırılması gerekir.

Önemli Çek Alanları

Alan	Tür	Açıklama
`Id`	integer	Şube bazında benzersiz çek kimliği
`CheckNumber`	integer	Gün bazında benzersiz çek numarası
`OfficialReceiptNumber`	string	Resmi adisyon numarası
`BusinessDate`	string	Çalışma günü (`yyyy-MM-dd`). Tarih filtrelemeleri bu alana göre yapılır
`State`	string	Çekin durumu: `"Closed"` veya `"Open"`
`IsReturn`	boolean	`true` ise iade çekidir; tüm tutar ve miktar değerleri negatiftir
`GlobalId`	string	`GetCheckByCode` uç noktasında kullanılan evrensel çek kimliği
`OutletInfo`	object	Gelir merkezi bilgisi (Restoran, Kafe, Bar vb.)
`Info`	string	Cari hesap çeklerinde müşterinin cari hesap adını taşır
`Invoice`	object \| null	Fatura bilgisi; fatura kesilmemişse `null` gelir
`Fiscal`	object \| null	Yazarkasa (EKÜ) bilgisi; bağlı yazarkasa yoksa `null` gelir
`Address`	object \| null	Paket servis veya cari müşteriye ait adres; yoksa `null` gelir
`Items`	array	Satılan ürünlerin listesi. Her ürün kendi `Condiments` dizisini içerir
`Payments`	array	Ödeme yöntemleri ve tutarları

Invoice, Fiscal ve Address alanları koşullara bağlı olarak null döner. Bu alanları işlemeden önce null kontrolü yapın.

İndirim Alanı

Items içindeki indirim (Discount) nesnesinde yer alan Type alanı iki değer alabilir:

"Discount" — Standart indirim
"TaxDiscount" — Vergi bazlı indirim

İndirim tipine göre muhasebe kaydı oluşturuyorsanız bu ayrımı mutlaka dikkate alın.

Çek Sorgulama Uç Noktaları

Satış verilerine erişmek için iki farklı uç nokta kullanabilirsiniz:

GetChecks

Belirli bir tarihe veya tarih aralığına ait tüm çekleri listeler. Toplu veri senkronizasyonu için idealdir. branch, start_date ve end_date parametreleri zorunludur.

GetCheckByCode

GlobalId değeriyle tek bir çekin tüm detaylarını getirir. Belirli bir işlemi doğrulamak veya güncellemek için kullanın.

GetChecks

Belirtilen tarih aralığındaki çekleri sorgular. Tarihler yyyy-MM-dd formatında gönderilmelidir. branch, start_date ve end_date zorunlu; number (çek numarası) ve table_no (masa numarası) opsiyonel parametrelerdir.

curl -X POST "https://api.orionpanel.com/GetChecks" \
  -H "Token: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "branch": "SUBE01",
    "start_date": "2024-01-15",
    "end_date": "2024-01-15",
    "number": null,
    "table_no": null
  }'

GetCheckByCode

Tek bir çekin tam detayını GlobalId ile getirir.

curl -X POST "https://api.orionpanel.com/GetCheckByCode" \
  -H "Token: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "global_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

Başlarken

Temel Kavramlar

Çekler ve Adisyonlar: ORIONPOS API Satış Kayıtları

Çek Tipleri

Önemli Çek Alanları

İndirim Alanı

Çek Sorgulama Uç Noktaları

GetChecks

GetCheckByCode

GetChecks

GetCheckByCode

​Çek Tipleri

​Önemli Çek Alanları

​İndirim Alanı

​Çek Sorgulama Uç Noktaları

GetChecks

GetCheckByCode

​GetChecks

​GetCheckByCode

Çek Tipleri

Önemli Çek Alanları

İndirim Alanı

Çek Sorgulama Uç Noktaları

GetChecks

GetCheckByCode