{"info":{"_postman_id":"a0a159c4-b83b-49b2-b941-8811903bce92","name":"Hugin PC Link","description":"<html><head></head><body><h1 id=\"satis-sistemi-ile-entegrasyon-dokumani\">📘 Satış Sistemi ile Entegrasyon Dokümanı</h1>\n<h2 id=\"1-genel-bakış\">1. Genel Bakış</h2>\n<p>PCLink API, HUGIN Yazarkasa POS cihazları ile PC Satış yazılım sistemlerinin, GMP/Restful protokolü ile entegrasyonunu sağlar. PC tarafında herhangi bir kütüphaneye (DLL) ihtiyaç duymadan https istemci ile Yazarkasa POS iletişimi sağlayabilirsiniz. Bu dokümantasyon satış, ödeme, belge yönetimi, işlem takibi ve sistem ayarları gibi temel işlevlerin hızlı, güvenli ve standartlara uygun biçimde uygulanmasını hedefler.</p>\n<h3 id=\"kapsam-ve-modüller\">Kapsam ve Modüller</h3>\n<ul>\n<li><p><strong>Satış:</strong> Fiş, e-Fatura, e-Arşiv , Avans Tahsilat gibi çeşitli belge türlerinin oluşturulması, güncellenmesi ve yönetimi.</p>\n</li>\n<li><p><strong>Banka İşlemleri:</strong> İptal ve iade ödemeleri, gün sonu raporları gibi finansal hareketlerin yönetimi.</p>\n</li>\n<li><p><strong>Raporlar:</strong> X ve Z raporu gibi standard mali raporların tüm içerikleri ile birlikte PC üzerinden alınabilmesi.</p>\n</li>\n<li><p><strong>Ayarlar:</strong> Cihaz ve uygulama ayarlarının merkezi ve güvenli biçimde yapılandırılması.</p>\n</li>\n<li><p><strong>Kimlik Doğrulama:</strong> Gerekli senaryolarda refresh token, yazılım kimliği ve cihaz seri numarası ile kısa ömürlü bearer token alınması.</p>\n</li>\n</ul>\n<p>Bu bölümler, geliştiricilerin gerçek satış senaryolarını kolayca uyarlayabilmesi için örneklerle ve açıklamalarla desteklenmiştir.</p>\n<p><strong>Hedef Kullanıcılar:</strong></p>\n<ul>\n<li><p>Yazılım geliştiriciler</p>\n</li>\n<li><p>Entegratör firmalar</p>\n</li>\n<li><p>POS ve masaüstü yazılım üreticileri</p>\n</li>\n</ul>\n<p>API, masaüstü uygulamalar ile POS cihazları arasındaki veri iletişimini standartlaştırır. Böylece satış, ödeme ve belge yönetimi gibi işlemler kolayca otomasyona alınabilir.</p>\n<h2 id=\"kimlik-doğrulama-notu\">Kimlik Doğrulama Notu</h2>\n<p>Bu koleksiyona eklenen token alma akışı, ihtiyaç duyulan senaryolarda bir <code>refreshToken</code>, yazılıma ait kimlik bilgisi (<code>X-SoftwareId</code> veya eşdeğer alan) ve cihaza ait seri numarası (<code>X-SerialNo</code> veya eşdeğer alan) kullanılarak bearer token üretmek içindir. Üretilen bearer token yalnızca ilgili seri numarası için geçerlidir ve güvenlik amacıyla kısa süreli kullanım ömrüne sahiptir.</p>\n<p>Yerel ağ / lokal kullanım senaryolarında bu bearer token alma akışı zorunlu değildir. API, local area network üzerinde kullanıldığında mevcut çağrılar için ayrıca bu kimlik doğrulama adımına ihtiyaç olmayabilir. Koleksiyon seviyesindeki mevcut pre-request script korunmuştur; ortamda <code>tsmToken</code> değişkeni varsa isteklerin <code>Authorization: Bearer {{tsmToken}}</code> başlığı ile gönderilmesi desteklenmeye devam eder.</p>\n<hr>\n<h2 id=\"2-temel-kavramlar\">2. Temel Kavramlar</h2>\n<h3 id=\"21-document-satış-ve-tahsilat-belgeleri\">2.1 Document (Satış ve Tahsilat Belgeleri)</h3>\n<p>Hem fiş, eFatura gibi satış işlemlerini, hem de Avans ve Cari hesap gibi tahsilat işlemlerini kapsayan ve üzerinde işlem yapılan temel veri yapısı <code>document</code>tir. Mali belgenin temel bilgilerinin yanı sıra, bir veya birden fazla ürün/hizmet kalemi (<code>items</code>) ve ödeme bilgilerini (<code>payments</code>) içerebilir.</p>\n<h3 id=\"22-belge-durumları\">2.2 Belge Durumları</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Durum</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>OPEN</code></td>\n<td>Satış başlatıldı, belgede değişiklik yapılabilir veya ödeme gönderilebilir.</td>\n</tr>\n<tr>\n<td><code>COMPLETED</code></td>\n<td>Kapanmış (tamamlanmış)</td>\n</tr>\n<tr>\n<td><code>CANCELLED</code></td>\n<td>İptal edilmiş</td>\n</tr>\n</tbody>\n</table>\n</div><p>Mevcut koleksiyon açıklamasının geri kalan içeriği korunarak bu kimlik doğrulama bilgisi eklenmiştir.</p>\n<hr>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"📘 Satış Sistemi ile Entegrasyon Dokümanı","slug":"satis-sistemi-ile-entegrasyon-dokumani"}],"owner":"36539729","collectionId":"a0a159c4-b83b-49b2-b941-8811903bce92","publishedId":"2sB34co2wN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"055BE9"},"publishDate":"2026-03-23T20:03:38.000Z"},"item":[{"name":"🛒 Satış","item":[{"name":"Belge Başlat","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Parse JSON response and extract documentId\ntry {\n    const jsonResponse = pm.response.json();\n\n    // Check if response has the expected structure\n    if (jsonResponse && jsonResponse.data && jsonResponse.data.documentId) {\n        const documentId = jsonResponse.data.documentId;\n\n        // Save documentId to collection variable\n        pm.collectionVariables.set(\"documentId\", documentId);\n\n        console.log(\"documentId saved to collection variable:\", documentId);\n    } else {\n        console.warn(\"Response does not contain expected structure (data.documentId)\");\n    }\n} catch (error) {\n    console.error(\"Failed to parse response or extract documentId:\", error.message);\n}"]}}],"id":"c25a2ed1-b73b-4759-aa52-caf697ff7b3b","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n\"docCategory\": \"SALE\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents","description":"<p>Cihaz üzerinde belge (başlatmak için kullanılır. Geri dönülen <code>documentId</code> sisteminizde kaybedilmeyecek şekilde <strong>kayıt edilerek</strong>, bilare belgeye ödeme eklemek ve sonlandırmak için kullanılmalıdır.</p>\n<h3 id=\"request\">Request</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>docCategory</code></td>\n<td>string</td>\n<td>Başlatılacak belge tipi (Örn: <code>SALE)</code></td>\n</tr>\n</tbody>\n</table>\n</div><p><code>docCategory</code>'nin alabileceği değerler aşağıdaki tablodaki gibidir. Zamanla bu tabloya GİB'in talepleri doğrultusunde yani belgeler eklenebilir.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Belge Kategorisi</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>SALE</code></td>\n<td>ÖKC Fişi/Perakende Satış Fişi, eArşiv/eFatura veya Bilgi Fişi, Eczane Muayne Katkı Payı</td>\n</tr>\n<tr>\n<td><code>ADVANCE</code></td>\n<td>Avans Bilgi Fişi</td>\n</tr>\n<tr>\n<td><code>BILL</code></td>\n<td>Fatura Tahsilat Bilgi Fişi</td>\n</tr>\n<tr>\n<td><code>CHARGE_ACCOUNT</code></td>\n<td>Cari Hesap Tahsilat Bilgi Fişi</td>\n</tr>\n<tr>\n<td><code>CUSTOM</code></td>\n<td>Kupon, hediye çeki vs gibi serbest formatta bilgi fişi yazmak için düzenlenir.</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>Serbest formatta yazdırılan belgeler için cihaz satış veri tabanında bir belge oluşmadığı için response ta documentId yerine Belge Sonlandır cevabına benzer şekilde, fiş numarası (receiptNo) dönülür. </p>\n</blockquote>\n<h3 id=\"response\">Response</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>documentId</code></td>\n<td>string</td>\n<td>Cihaz tarafından belgeye atanan tekil ID.</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n<tr>\n<td>└─ <code>sfaVersion</code></td>\n<td>string</td>\n<td>Belgeyi oluşturan mali uygulama versiyonu</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string</td>\n<td>Yanıtın oluşturulma zamanı (ISO 8601)</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","documents"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"48a40d72-ee51-4b96-a5cc-2f707869abb0","name":"200-Satış Başlatıldı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"docCategory\": \"SALE\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"documentId\": \"81ff77fd-c563-4979-9c39-a401db251959\"\n    },\n    \"metadata\": {\n        \"sfaVersion\": \"1.1.0a\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"9ed68237-0070-4546-b2bb-d82c6c400768","name":"200-Serbest Fiş Yazdırıldı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"docCategory\": \"CUSTOM\",\n    \"lines\": [\n        \"TEST SATIRI 1\",\n        \"32 KARAKTER YAZDIRILABİLİR\",\n        \"TEST SATIRI 2\",\n        \"QRT123456789\",\n        \"EAN123456789\"\n    ]\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\"\n    },\n    \"metadata\": {\n        \"sfaVersion\": \"1.1.0a\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"67ed8c37-e88f-41f0-9ac4-166c6549c0d2","name":"409-Başka Belge Aktif","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n\"docCategory\": \"SALE\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"ERR_INVALID_STATE\",\r\n        \"title\": \"ÖKC durumu uygun değil.\",\r\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil. Örnek: Satış sırasında yeni satış başlatmak.\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/documents\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"},{"id":"22c7fc95-fac1-42dc-9112-20bc8003c7ce","name":"500-Kağıt yok","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_NO_PAPER\",\n        \"title\": \"Kağıt bitti\",\n        \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/0063_002\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"c25a2ed1-b73b-4759-aa52-caf697ff7b3b"},{"name":"Parçalı Ödeme Ekle","event":[{"listen":"test","script":{"id":"764eaef5-b2db-4eac-a6ac-7329ba65c8b6","exec":["// Parse JSON response and extract transactionId or paymentId","try {","    const jsonData = pm.response.json();","    ","    let capturedValue = null;","    let capturedField = null;","    ","    // Prefer transactionId over paymentId if both exist","    if (jsonData.transactionId) {","        capturedValue = jsonData.transactionId;","        capturedField = 'transactionId';","    } else if (jsonData.paymentId) {","        capturedValue = jsonData.paymentId;","        capturedField = 'paymentId';","    }","    ","    // Save to collection variable if a value was found","    if (capturedValue) {","        pm.collectionVariables.set(\"transactionId\", capturedValue);","        console.log(`Captured '${capturedField}' with value: ${capturedValue} and saved to collection variable 'transactionId'`);","    } else {","        console.warn(\"Neither 'transactionId' nor 'paymentId' found in the response\");","    }","    ","} catch (error) {","    console.error(\"Error parsing JSON response: \" + error.message);","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"e5a70429-59a7-48a7-872b-22fda997af61","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"18.00\"\n} ","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/93a3281a-99ce-446f-82d0-1415218413ab/payments/EFT_POS","description":"<p>Belgenin tahsilatında birden fazla <code>EFT-POS</code> işlemi bulunması gereken veya gelişmiş kartlı tahsilat imkanlarına ihtiyaç duyulan satışlar için oluşturulmuş endpointtir. Cihaza sadece bir kartlı ödeme tutar gönderilmesi gerektiğinde bu adım atlanarak işlemi en hızlı şekilde gerçekleştirmek için <code>Belge Sonlandır (PUT /document/...)</code> çağırılmalıdır.</p>\n<p>Parçalı ödeme dışında, bu endpoint sayesinde satış yazılımı üzerinde geliştirilebilecek bazı ek özelliler:</p>\n<ul>\n<li><p>Banka seçimi menusu ve TR Karekod butonu sağlanarak, Yazarkasa POS ekranına dokunulmadan, cihazın karekod gostermesi</p>\n</li>\n<li><p>Puan/taksit seçim ekranlarının Yazarkasa POS yerine PC üzerinde gösterilmesi (bu amaç için Banka İşlemleri/Kart Verisi Sorgule ile birlikte kullanılmalıdır)</p>\n</li>\n<li><p>Sadece bazı bankaların kartlarına izin verilmesi</p>\n</li>\n<li><p>Sadece spesifik bir kredi kartı ile işleme izin verilmesi</p>\n</li>\n<li><p>Farklı bir döviz cinsinden ödeme alınması</p>\n</li>\n<li><p>Ek sorgu gerektirmeden kart verisinin response a eklenmesi</p>\n</li>\n</ul>\n<p>Bu endpoint ile yapılan tahsilatlar, belge sonlandırma talebinde sistem mutabakatı amaçlı <code>payments</code> arrayi altında bilgi olarak gönderilmelidir. <code>200-Detaylı Fiş</code> örneği incelenebilir.</p>\n<h3 id=\"request\">Request</h3>\n<h4 id=\"zorunlu-alanlar\">Zorunlu Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>Tahsil edilecek tutar bu alana yazılır.</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"opsiyonel-alanlar\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>currencyCode</code></td>\n<td>string</td>\n<td>Döviz cinsinden tahsilat (MCC) için eklenebillir. Default <code>TRY</code></td>\n</tr>\n<tr>\n<td><code>applyCardPoints</code></td>\n<td>array</td>\n<td>Kart puanı ile ödeme bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>loyaltyId</code></td>\n<td>string</td>\n<td>Kart bilgileri alındığında gelen puan havuz ID'si</td>\n</tr>\n<tr>\n<td>└─ <code>pointAmount</code></td>\n<td>string</td>\n<td>Havuzdan kullanılmış puan tutarı (₺)</td>\n</tr>\n<tr>\n<td><code>installmentCount</code></td>\n<td>integer</td>\n<td>Taksit sayısı. Default <code>0</code> (cihaz ekranından seçim)</td>\n</tr>\n<tr>\n<td><code>detailedResponse</code></td>\n<td>boolean</td>\n<td><code>true</code> set edilerek yanıtta ödeme ile ilgili tüm alanların dönmesi sağlanır.</td>\n</tr>\n<tr>\n<td><code>paymentRules</code></td>\n<td>object</td>\n<td>Bu nesne ile kart kabul süreçlerini sınırlandırabilirsiniz.</td>\n</tr>\n<tr>\n<td>└─ <code>bankId</code></td>\n<td>integer</td>\n<td>Ödemenin alınmasında kullanılmak istenen spesifik bir banka var ise banka kodu gönderilir.</td>\n</tr>\n<tr>\n<td>└─ <code>allowedCardReaders</code></td>\n<td>array</td>\n<td>Kullanılabilecek kart okuyucu tipleri (<code>QR</code>, <code>NFC</code>).</td>\n</tr>\n<tr>\n<td>└─ <code>allowedCardBINs</code></td>\n<td>array</td>\n<td>Kullanılabilecek kart BIN numaralarını kısıtlar (örneğin belirli bankaya ait kartlar).</td>\n</tr>\n<tr>\n<td>└─ <code>allowedPanSuffix</code></td>\n<td>integer</td>\n<td>Sadece belirli kart numarası son 4 hanesine sahip kartlara izin verir.</td>\n</tr>\n<tr>\n<td><code>UTID</code></td>\n<td>string</td>\n<td>Ödemeyi takip amaçlı kendi referans kodunuzu bu alana ekleyebilirsiniz.</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"açıklamalar\">Açıklamalar</h5>\n<ul>\n<li><p><code>allowedCardBINs</code> e tek BIN ekleyerek ve <code>allowedPanSuffix</code> kullanarak, işlemi daha önce detayını sorguladığınız bir kart ile sınırlandırabilirsiniz.</p>\n</li>\n<li><p><code>allowedCardReaders</code>'a sadece <code>QR</code> gönderilirse <code>bankId</code> ye (acquirerId) veya cihazın default acquirerına ait TR Karekodu gösterilir.</p>\n</li>\n<li><p>Japon Yeni (<code>YEN</code>) ve Rus Rublesi (<code>RUB</code>) para birimlerinde decimal seperator sonrası dijit sayısı 0 olduğu için kuruş bilgileri eklenemez.</p>\n</li>\n</ul>\n<h3 id=\"response\">Response</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionId</code></td>\n<td>integer</td>\n<td>Cihaz tarafından ödemeye atanan tekil ID.</td>\n</tr>\n<tr>\n<td><code>transactionTime</code></td>\n<td>time</td>\n<td>İşlemnin yapıldığı tarih ve saati belirtir</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>Ödenen tutar</td>\n</tr>\n<tr>\n<td><code>authorizationCode</code></td>\n<td>string</td>\n<td>Banka otorizasyon kodu, ödemenin alındığının kanıtıdır.</td>\n</tr>\n<tr>\n<td><code>appliedPointsAmount</code></td>\n<td>string</td>\n<td>Kullanılmış puan tutarı (₺)</td>\n</tr>\n<tr>\n<td><code>installmentCount</code></td>\n<td>integer</td>\n<td>Taksit sayısı</td>\n</tr>\n<tr>\n<td><code>additionalData</code></td>\n<td>object</td>\n<td>Ek ödeme bilgileri requestte detailedReponse tagi varsa gönderilir</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Sunucu saatini içerir</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","documents","93a3281a-99ce-446f-82d0-1415218413ab","payments","EFT_POS"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"c201966d-01c7-464c-9a94-8a12bb567cfb","name":"200-Ödeme Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"22.00\"\n} ","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/EFT_POS"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 2239,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"be7e846f-5ee6-419d-a49b-ecf029877e1d","name":"200-QR ile Ödeme Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"22.00\",\n    \"paymentRules\": {\n        \"bankId\": 66,\n        \"allowedCardReaders\": [\n            \"QR\"\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/EFT_POS"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 9,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"fb6e43bf-d64a-4e4f-9e3a-b159b5a13869","name":"200-Detaylı Ödeme Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"22.00\",\n    \"applyCardPoints\": [\n        {\n            \"loyaltyId\": \"1\",\n            \"pointAmount\": \"3.00\"\n        },\n        {\n            \"loyaltyId\": \"2\",\n            \"pointAmount\": \"4.00\"\n        }\n    ],\n    \"installmentCount\": 3,\n    \"paymentRules\": {\n        \"bankId\": 61,\n        \"allowedCardReaders\": [\n            \"QR\",\n            \"NFC\"\n        ],\n        \"allowedCardBINs\": [\n            \"543210\"\n        ],\n        \"allowedPanSuffix\": \"5678\"\n    },\n    \"UTID\": \"AK2323222\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/EFT_POS"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 9,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"e1f21d8e-373b-4b91-96f5-d7f918b44147","name":"417-Yetersiz Bakiye","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"22.00\"\n} ","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/EFT_POS"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"INSUFFICIENT_FUNDS\",\r\n        \"title\": \"Yetersiz bakiye\",\r\n        \"description\": \"Karttan yetersiz bakiye hatası alındı. BKM ID 51\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/documents/0063_002/payments/EFT_POS\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"}],"_postman_id":"e5a70429-59a7-48a7-872b-22fda997af61"},{"name":"Yemek Kartı Ekle","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Parse JSON response and extract transactionId or paymentId\ntry {\n    const jsonData = pm.response.json();\n    \n    let capturedValue = null;\n    let capturedField = null;\n    \n    // Prefer transactionId over paymentId if both exist\n    if (jsonData.transactionId) {\n        capturedValue = jsonData.transactionId;\n        capturedField = 'transactionId';\n    } else if (jsonData.paymentId) {\n        capturedValue = jsonData.paymentId;\n        capturedField = 'paymentId';\n    }\n    \n    // Save to collection variable if a value was found\n    if (capturedValue) {\n        pm.collectionVariables.set(\"transactionId\", capturedValue);\n        console.log(`Captured '${capturedField}' with value: ${capturedValue} and saved to collection variable 'transactionId'`);\n    } else {\n        console.warn(\"Neither 'transactionId' nor 'paymentId' found in the response\");\n    }\n    \n} catch (error) {\n    console.error(\"Error parsing JSON response: \" + error.message);\n}"]}}],"id":"8c341244-7225-4828-83c2-372888ba9be9","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/93a3281a-99ce-446f-82d0-1415218413ab/payments/VOUCHER_POS","description":"<p>Cihaza yüklü yemek kartı uygulamaları üzerinden tahsilat yapılabilmesini sağlayan endpointtir.</p>\n<h3 id=\"💳-yemek-kartı-uygulamaları\">💳 Yemek Kartı Uygulamaları</h3>\n<p>Desteklenen ve geliştirme aşamasındaki yemek kartları aşağıdaki tabloda tanımlanmıştır.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Providers</th>\n<th>İsmi</th>\n<th>Durumu</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>multinet</code></td>\n<td>Multinet Up</td>\n<td>Entegre</td>\n</tr>\n<tr>\n<td><code>metropol</code></td>\n<td>Metropol Kart</td>\n<td>Geliştirme aşamasında</td>\n</tr>\n<tr>\n<td><code>pluxee</code></td>\n<td>Sodexo / Pluxee</td>\n<td>Geliştirme aşamasında</td>\n</tr>\n<tr>\n<td><code>token</code></td>\n<td>Token Flex</td>\n<td>Geliştirme aşamasında</td>\n</tr>\n<tr>\n<td><code>paye</code></td>\n<td>Paye Kart</td>\n<td>Harici</td>\n</tr>\n<tr>\n<td><code>ticket</code></td>\n<td>Edenred Ticket</td>\n<td>Harici</td>\n</tr>\n<tr>\n<td><code>setcard</code></td>\n<td>Setcard</td>\n<td>Harici</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"request\">Request</h3>\n<p>Mevzuat gereği bu uygulamalara tutarlar KDV oran kırılımları ile gönderilmelidir.</p>\n<blockquote>\n<p>Belge sonlandırırken cihaza yüklü yemek kartı uygulaması üzerinden yapılan tahsilatlar VOUCHER_POS, harici sistemler üzerinden yapılan yemek kartı ödemeleri ise VOUCHER tipi ile kayıt edilir. </p>\n</blockquote>\n<h4 id=\"zorunlu-alanlar\">Zorunlu Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>provider</code></td>\n<td>string</td>\n<td>Yemek kartı sağlayıcısının adı</td>\n</tr>\n<tr>\n<td><code>amounts</code></td>\n<td>array</td>\n<td>KDV oran bazında tutar kırılımları.</td>\n</tr>\n<tr>\n<td><code>amounts[].vatRate</code></td>\n<td>number</td>\n<td>KDV oranı</td>\n</tr>\n<tr>\n<td><code>amounts[].amount</code></td>\n<td>number</td>\n<td>İlgili KDV oranına ait tutar</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"opsiyonel-alanlar\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>paymentRules</code></td>\n<td>object</td>\n<td>Bu nesne ile kart kabul süreçlerini sınırlandırabilirsiniz.</td>\n</tr>\n<tr>\n<td>└─ <code>allowedCardReaders</code></td>\n<td>array</td>\n<td>Kullanılabilecek kart okuyucu tipleri (<code>QR</code>, <code>NFC</code>).</td>\n</tr>\n<tr>\n<td>└─ <code>allowedCardBINs</code></td>\n<td>array</td>\n<td>Kullanılabilecek kart BIN numaralarını kısıtlar (örneğin belirli yemek kart programına ait kartlar).</td>\n</tr>\n<tr>\n<td>└─ <code>allowedPanSuffix</code></td>\n<td>integer</td>\n<td>Sadece belirli kart numarası son 4 hanesine sahip kartlara izin verir.</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"açıklamalar\">Açıklamalar</h5>\n<ul>\n<li><code>allowedCardReaders</code>'a sadece <code>QR</code> gönderilirse voucherCode ile iletilen yemek kartı uygulaması</li>\n</ul>\n<h3 id=\"response\">Response</h3>\n<p>Response ta dönülen KDV oranına ait tutarlar, belge sonlandırma esnasındaki items dizini ile tutarlı olmalıdır. Belge sonlandırmada ilgili KDV oranına ait toplam tutar, <code>VOUCHER_POS</code> ödeme yanıtlarındaki toplamından daha düşük olamaz.</p>\n<p>Örneğin iki <code>VOUCHER_POS</code> işlemi ile %10 KDV ye ait toplam 200₺ tahsil edilmişken, belge 190₺ KDV 10% a denk gelen departman satışı ile sonlandırılmaya çalışılırsa hata alınacaktır.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionId</code></td>\n<td>number</td>\n<td>İşlem numarası</td>\n</tr>\n<tr>\n<td><code>transactionTime</code></td>\n<td>string</td>\n<td>İşlemin gerçekleştiği an</td>\n</tr>\n<tr>\n<td><code>amounts</code></td>\n<td>array</td>\n<td>KDV oran bazında tutar kırılımlarını içerir</td>\n</tr>\n<tr>\n<td><code>amounts[].vatRate</code></td>\n<td>number</td>\n<td>KDV oranı</td>\n</tr>\n<tr>\n<td><code>amounts[].amount</code></td>\n<td>number</td>\n<td>İlgili KDV oranına ait tutar</td>\n</tr>\n<tr>\n<td><code>authorizationCode</code></td>\n<td>string</td>\n<td>Onay kodu</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Sunucu saatini içerir</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","documents","93a3281a-99ce-446f-82d0-1415218413ab","payments","VOUCHER_POS"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"cbca6689-07d6-49a0-b09c-1c9ee3ecd586","name":"200-Ödeme Alındı","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"provider\": \"multinet\",\n    \"amounts\": [\n        {\"vatRate\": 10, \"amount\": 75},\n        {\"vatRate\": 20, \"amount\": 200}\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER_POS"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 2239,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amounts\": [\n            { \"vatRate\": 10, \"amount\": 75 }\n        ],\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"542fa711-5bd8-4d99-90d3-5fb1ca733890","name":"200-QR ile Ödeme Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"provider\": \"multinet\",\n    \"amounts\": [\n        {\"vatRate\": 0, \"amount\": 150},\n        {\"vatRate\": 1, \"amount\": 320},\n        {\"vatRate\": 10, \"amount\": 75},\n        {\"vatRate\": 20, \"amount\": 200}\n    ],\n    \"paymentRules\": {\n        \"allowedCardReaders\": [\n            \"QR\"\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER_POS"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 2329,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n       \"instance\": \"/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER_POS\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"7bf6e69f-6a32-4c6e-8b8a-62195b50c257","name":"417-Yetersiz Bakiye","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"provider\": \"multinet\",\n    \"amounts\": [\n        {\"vatRate\": 0, \"amount\": 150},\n        {\"vatRate\": 1, \"amount\": 320},\n        {\"vatRate\": 10, \"amount\": 75},\n        {\"vatRate\": 20, \"amount\": 200}\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER_POS"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"INSUFFICIENT_FUNDS\",\r\n        \"title\": \"Yetersiz bakiye\",\r\n        \"description\": \"Karttan yetersiz bakiye hatası alındı.\"\r\n    },\r\n    \"metadata\": {\r\n       \"instance\": \"/v1/documents/6405ea05-c118-40f9-a27b/payments/VOUCHER_POS\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"}],"_postman_id":"8c341244-7225-4828-83c2-372888ba9be9"},{"name":"Belge Sonlandır","id":"3c0e1742-fc0b-4d00-a6ae-0080b9b51d14","request":{"method":"PUT","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"FİLTRE KAHVE\",\n            \"amount\": \"190\",\n            \"vatRate\": 20\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"190.00\"\n        }\n    ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/93a3281a-99ce-446f-82d0-1415218413ab","description":"<p>Her belge kategorisinde sonlandırma (belgeyi kapatma, fiş/fatura oluşturma) işlemi için gönderilmesi gereken zorunlu ve opsiyonel alanları bu bölümde bulabilirsiniz.</p>\n<p>Request'te her kategori için müşterek olan alan <code>payments</code> olup, belge tipine göre diğer zorunlu ve opsiyonel alanlar farklılık gösterir.</p>\n<h4 id=\"hız-sevenlere-öneri-combo-i̇şlem-🚀\"><strong>Hız sevenlere öneri: Combo İşlem 🚀</strong></h4>\n<blockquote>\n<p>Tek <code>EFT_POS</code> ödemesi içeren TL satışlarda (işlemlerin büyük çoğunluğu) <code>Parçalı Ödeme Ekle</code> yi kullanmadan, belgeyi başlattıktan sonra doğrudan <strong>Belge Sonlandır</strong> ile ödemeyi de göndermeniz maksimum performans sağlar. </p>\n</blockquote>\n<p>Sadece belgede birden fazla <code>type</code> = <code>EFT_POS</code> payment bulunması durumunda, söz konusu ödemelerin, daha önceden <code>Parçalı Ödeme Ekle</code> metodu ile tamamlanmış olması zorunludur.</p>\n<h3 id=\"request\">Request</h3>\n<h4 id=\"alanlar\">Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>payments</code></td>\n<td>object</td>\n<td>Ödemeler</td>\n</tr>\n<tr>\n<td>└─ <code>type</code></td>\n<td>string</td>\n<td>Ödeme tipi (<code>EFT_POS</code>, <code>CASH</code>..)</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>Ödeme tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>detailedResponse</code></td>\n<td>boolean</td>\n<td>Opsiyonel: <code>EFT_POS</code> combo işlemlerde detaylı banka bilgisi için kullanılabilir.</td>\n</tr>\n</tbody>\n</table>\n</div><p>Tüm belge tipleri için az bir adet payment gönderilmesi zorunludur. Payment tipleri Satış ana başlığında detaylandırılmıştır.</p>\n<p>Aşağıda, farklı belge kategorilerine göre requestin alabileceği diğer zorunlu ve opsiyonel değerler tablolarla listelenmiştir. Okumaya devam edin ⬇️</p>\n<h3 id=\"response\">Response</h3>\n<p>Geri dönüş formatı tüm belge kategorileri için standart bir yapıdadır.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>receiptNo</code></td>\n<td>string</td>\n<td>Oluşan fiş numarası. 4 hane Z no, alt cizgi ve 4 hane fiş no formatında dönülür (<code>ZZZZ_NNNN</code>)</td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplamları</td>\n</tr>\n<tr>\n<td>└─ <code>documentTotal</code></td>\n<td>string</td>\n<td>Belge toplam tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>vatTotal</code></td>\n<td>string</td>\n<td>Belgenin KDV toplamı</td>\n</tr>\n<tr>\n<td>└─ <code>cashReturn</code></td>\n<td>string</td>\n<td>Nakit para üstü (0 değilse)</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string</td>\n<td>Yanıtın oluşturulma zamanı (ISO 8601)</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"opsiyonel-alan\">Opsiyonel Alan:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>eftPayment</code></td>\n<td>object</td>\n<td>Kartlı ödeme bilgileri (Sadece combo işlem requestlerinde dönülür)</td>\n</tr>\n</tbody>\n</table>\n</div><p>Not: İçeriği Parçalı Ödeme Ekle başarılı response tablosundaki data bloğu ile aynıdır. Detaylar için ilgili metodu inceleyebilirsiniz.</p>\n<p>Belge sonlandırma işleminde, EFT ödemesinin başarı ile tamamlanması, fakat kağıt bitmesi veya pil şarj seviyesinin düşük olması gibi istisnai durumlardan dolayı belgenin sonlandırılamaması durumunda geriye <code>200</code> yerine <code>206</code> HTTP kodu ile birlikte sadece Parçalı Ödeme Ekle işlemine ait geri dönüş yapılır.</p>\n<p>Bu durumda ödeme bilgileri kaydedildikten sonra Belge Sonlandır mesajı birebir aynı şekilde tekrar gönderilerek sonlandırma tekrar denendir, hatanın devam etmesi durumunda hata mesajı alınır.</p>\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>Belge <code>SUCCESS</code> cevabı ile sonlandırıldığında, belgenin sistemdeki durumu <code>COMPLETED</code> olur.</p>\n</li>\n<li><p>eBelge oluşması gereken durumlarda belge entegratöre iletilir. Entegratörden dönen önemli alanlar, Response a eklenir.</p>\n</li>\n</ul>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>Satış Yazılımı       ÖKC / GMU        Özel Entegratör        GİB (EFKS)\n     │                   │                  │                    │\n     │ ───────────────▶  │                  │                    │\n     │   Satış Verisi    │                  │                    │\n     │                   │ ───────────────▶ │                    │\n     │                   │  Fatura Verisi   │                    │\n     │                   │                  │ ───────────────▶   │\n     │                   │                  │   XML Gönder       │\n     │                   │                  │ ◀───────────────   │\n     │                   │                  │  UUID / Onay       │\n     │                   │ ◀──────────────  │                    │\n     │   UUID ve Durum   │                  │                    │\n     │ ◀───────────────  │                  │                    │\n\n</code></pre><h1 id=\"✅-satış-belgelerinin-sonlandırılması\">✅ Satış Belgelerinin Sonlandırılması</h1>\n<p>Belge kategorisi <code>SALE</code> olarak seçildi ise, <code>saleType</code> aşağıdaki değerleri alabilir</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Satış Tipi</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>RECEIPT</code></td>\n<td>ÖKC Fişi/Perakende Satış Fişi (Default)</td>\n</tr>\n<tr>\n<td><code>E_INVOICE</code></td>\n<td>eFatura veya Bilgi Fişi</td>\n</tr>\n<tr>\n<td><code>E_ARCHIVE</code></td>\n<td>eArşiv veya Bilgi Fişi</td>\n</tr>\n<tr>\n<td><code>DUTY_FREE</code></td>\n<td>Yolcu beraberinde Fatura (Turtistlere düzenlenebilir)</td>\n</tr>\n<tr>\n<td><code>CO_PAY</code></td>\n<td>Eczane Muayne Katkı Payı</td>\n</tr>\n</tbody>\n</table>\n</div><p>Satış sepeti ve ödemeler gibi belge tipinin gereksinimi olan tüm veriler bu adımda gönderilerek mali belgenin düzenlenmesi sağlanır.</p>\n<h3 id=\"🧾-fiş-ökc-fişi--vuk507-perakende-satış-fişi\">🧾 Fiş (ÖKC Fişi / VUK507 Perakende Satış Fişi)</h3>\n<p>Satış tipinin belirtilmemesi durumunda belge, fiş olarak sonlandırılır.</p>\n<h3 id=\"request-1\">Request</h3>\n<h4 id=\"zorunlu-ek-alanlar\">Zorunlu Ek Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>items</code></td>\n<td>array</td>\n<td>Satış kalemleri</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Ürün adı</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>Satır toplam tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"açıklamalar\">Açıklamalar</h5>\n<ul>\n<li><p>En az bir <code>item</code> gönderilmesi zorunludur.</p>\n</li>\n<li><p><code>departmentId</code> gönderilmemesi durumunda, cihazda <code>vatRate</code> i kullanan ilk departman ile satış yapılır.</p>\n</li>\n<li><p>Fiş ve faturaların sonlandırılabilmesi için <code>items</code> ve <code>payments</code> amount toplamları birbirine eşit olmalıdır.</p>\n</li>\n</ul>\n<h4 id=\"opsiyonel-alanlar\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>items</code></td>\n<td>array</td>\n<td>Satılan ürünlerin listesi</td>\n</tr>\n<tr>\n<td>└─ <code>departmentId</code></td>\n<td>integer</td>\n<td>Departman/Kısım ID. Not: Konaklama vergisi içeren satışlarda bu alan zorunldur.</td>\n</tr>\n<tr>\n<td>└─ <code>quantity</code></td>\n<td>string</td>\n<td>Miktar. default: <code>1</code></td>\n</tr>\n<tr>\n<td>└─ <code>unit</code></td>\n<td>string</td>\n<td>Birim (default: <code>AD</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>unitPrice</code></td>\n<td>string</td>\n<td>Birim fiyatı</td>\n</tr>\n<tr>\n<td>└─ <code>discount</code></td>\n<td>object</td>\n<td>İndirim bilgisi</td>\n</tr>\n<tr>\n<td>. .└─ <code>amount</code></td>\n<td>string</td>\n<td>İndirim tutarı</td>\n</tr>\n<tr>\n<td>. .└─ <code>rate</code></td>\n<td>integer</td>\n<td>İndirim oranı (%)</td>\n</tr>\n<tr>\n<td>. .└─ <code>note</code></td>\n<td>string</td>\n<td>İndirim açıklaması</td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplamları</td>\n</tr>\n<tr>\n<td>└─ <code>documentTotal</code></td>\n<td>string</td>\n<td>Belge toplam tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>discount</code></td>\n<td>object</td>\n<td>Belge toplamına indirim</td>\n</tr>\n<tr>\n<td>└─ <code>surcharge</code></td>\n<td>object</td>\n<td>Belge toplamına artırım</td>\n</tr>\n<tr>\n<td>└─ <code>netTotal</code></td>\n<td>string</td>\n<td>İndirimler sonrası net toplam</td>\n</tr>\n<tr>\n<td><code>footerNotes</code></td>\n<td>array</td>\n<td>Belge altına eklenecek notlar. Bu format ile QR ve EAN barkod da yazdırabilirsiniz:  <br />\"QRT123456789\",  <br />\"EAN123456789\",</td>\n</tr>\n<tr>\n<td><code>referenceCode</code></td>\n<td>string</td>\n<td>Belgeyi sisteminizde yanımlayan tekil kodu takip amaçlı gönderebilirsiniz.</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"açıklamalar-1\">Açıklamalar</h5>\n<ul>\n<li><p>Satırlara indirim, belge toplamına indirim veya artırım eklenebilir. Tutarla veya oranla işlem yapılmalıdır.</p>\n</li>\n<li><p><code>documentTotal</code> ve <code>netTotal</code> cihazın hesapladığı brüt toplam ve indirim/artırım sonrası net toplam ile mutabakat sağlanması amaçlı gönderilebilir.</p>\n</li>\n</ul>\n<h3 id=\"📄-e-fatura--e-arşiv\">📄 e-Fatura / e-Arşiv</h3>\n<p>Fiş toplamının, Fatura düzenleme zorunluluğu ile ilgili alt sınırını aşması, veya müşterinin talep etmesi durumunda, e-Fatura veya e-Arşiv Fatura ile satış yapılır.</p>\n<p>Fişteki alanların yanı sıra, Fatura tiplerine özel alanların da gönderilmesi gereklidir.</p>\n<h3 id=\"request-2\">Request</h3>\n<h4 id=\"zorunlu-ek-alanlar-1\">Zorunlu Ek Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>saleType</code></td>\n<td>string</td>\n<td>Belge tipi (<code>E_ARCHIVE</code>, <code>E_INVOICE</code>)</td>\n</tr>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Müşteri bilgileri (zorunlu)</td>\n</tr>\n<tr>\n<td>└─ <code>taxName</code></td>\n<td>string</td>\n<td>Müşteri ünvanı</td>\n</tr>\n<tr>\n<td>└─ <code>taxId</code></td>\n<td>string</td>\n<td>Vergi kimlik no</td>\n</tr>\n<tr>\n<td>└─ <code>taxOffice</code></td>\n<td>string</td>\n<td>Vergi dairesi</td>\n</tr>\n<tr>\n<td><code>items</code></td>\n<td>array</td>\n<td>Satış kalemleri</td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"açıklamalar-2\">Açıklamalar</h5>\n<ul>\n<li>Faturalarda <code>item</code>.<code>name</code> alanında mal/hizmete dair açıklayıcı bilgi gereklidir. Fişlerde izin verilen genel ifadeler (departman isimleri) kullanılamaz.</li>\n</ul>\n<h4 id=\"opsiyonel-alanlar-1\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>invoiceId</code></td>\n<td>string</td>\n<td>eFatura Seri/Sıra no. Gönderilmezse, cihaz belirler</td>\n</tr>\n<tr>\n<td><code>isWaybill</code></td>\n<td>boolean</td>\n<td>İrsaliye özelliği olup olmadığı. Default: <code>false</code></td>\n</tr>\n<tr>\n<td><code>isDutyfree</code></td>\n<td>boolean</td>\n<td>Gümrükten muaf \"yolcu beraberinde fatura\" kesildiğini</td>\n</tr>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Müşteri bilgileri (zorunlu)</td>\n</tr>\n<tr>\n<td>└─ <code>firstName</code></td>\n<td>string</td>\n<td>Müşteri adı</td>\n</tr>\n<tr>\n<td>└─ <code>lastName</code></td>\n<td>string</td>\n<td>Müşteri soyadı</td>\n</tr>\n<tr>\n<td>└─ <code>id</code></td>\n<td>string</td>\n<td>Müşteri cari kodu</td>\n</tr>\n<tr>\n<td>└─ <code>sms</code></td>\n<td>string</td>\n<td>SMS alabilen telefonu numarası</td>\n</tr>\n<tr>\n<td>└─ <code>email</code></td>\n<td>string</td>\n<td>E-posta</td>\n</tr>\n<tr>\n<td>└─ <code>addressInfo</code></td>\n<td>object</td>\n<td>Adres bilgileri</td>\n</tr>\n<tr>\n<td>. . └─ <code>buildingNo</code></td>\n<td>string</td>\n<td>Bina no</td>\n</tr>\n<tr>\n<td>. . └─ <code>doorNo</code></td>\n<td>string</td>\n<td>Kapı no</td>\n</tr>\n<tr>\n<td>. . └─ <code>streetName</code></td>\n<td>string</td>\n<td>Sokak</td>\n</tr>\n<tr>\n<td>. . └─ <code>district</code></td>\n<td>string</td>\n<td>İlçe</td>\n</tr>\n<tr>\n<td>. . └─ <code>city</code></td>\n<td>string</td>\n<td>Şehir</td>\n</tr>\n<tr>\n<td>. . └─ <code>countryCode</code></td>\n<td>string</td>\n<td>Ülkenin <a href=\"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2\">iki haneli kodu</a></td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplamları</td>\n</tr>\n<tr>\n<td><code>footerNotes</code></td>\n<td>array</td>\n<td>Belge altına eklenecek notlar (isteğe bağlı)</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"response---efaturaearşiv-için-ek-alanlar\">Response - eFatura/eArşiv için ek alanlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>invoiceId</code></td>\n<td>string</td>\n<td>Faturanın firma içerisinde tekil olan Seri/Sıra no'su.</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"notlar-1\">Notlar:</h4>\n<ul>\n<li><p><code>invoiceId</code> ile entegratör web servisinden ebelge'nin xml/pdf vb url si alınabilir.</p>\n</li>\n<li><p>eBelge İptal servis url si içerisinde sadece <code>invoiceId</code> yer alır.</p>\n</li>\n</ul>\n<h3 id=\"🏷️-belge-toplamına-indirimartırım-nasıl-eklenir\">🏷️ Belge toplamına indirim/artırım nasıl eklenir?</h3>\n<p>Belge toplamına indirim ve artırım <code>totals</code> nesnesine eklenen <code>discounts</code> ve <code>surcharge</code> nesneleri nesneleri ile yapılabilir. Tutar ile (<code>amount</code>) birlikte açıklama (<code>note</code>) eklenebilir. İndirim/artırım sonrası toplam, <code>totals</code> içinde <code>netTotal</code> olarak belirtilir.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplam bilgisi</td>\n</tr>\n<tr>\n<td>└─<code>documentTotal</code></td>\n<td>string</td>\n<td>İndirim/artırım öncesi toplam (<code>\"1000.00\"</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>discounts</code></td>\n<td>array</td>\n<td>Belgeye uygulanan indirimler</td>\n</tr>\n<tr>\n<td>. . └─ <code>amount</code></td>\n<td>string</td>\n<td>İndirim tutarı (<code>\"100.00\"</code>)</td>\n</tr>\n<tr>\n<td>. . └─ <code>rate</code></td>\n<td>integer</td>\n<td>İndirim oranı (<code>10</code>)</td>\n</tr>\n<tr>\n<td>. . └─ <code>note</code></td>\n<td>string</td>\n<td>İndirim açıklaması (<code>Sezon indirimi</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>surcharge</code></td>\n<td>nesne</td>\n<td>Belgeye uygulanan artırım</td>\n</tr>\n<tr>\n<td>. . └─ <code>amount</code></td>\n<td>string</td>\n<td>Artırım tutarı (<code>\"100.00\"</code>)</td>\n</tr>\n<tr>\n<td>. . └─ <code>rate</code></td>\n<td>integer</td>\n<td>Artırım oranı (<code>10</code>)</td>\n</tr>\n<tr>\n<td>. . └─ <code>note</code></td>\n<td>string</td>\n<td>Artırım açıklaması (<code>Ek hizmet bedeli</code>)</td>\n</tr>\n<tr>\n<td>└─<code>netTotal</code></td>\n<td>string</td>\n<td>İndirim/Artırım sonrası toplam (<code>\"900.00\"</code>)</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"notlar-2\">Notlar</h4>\n<ul>\n<li><p>Her bir indirim/artırım satırı için <code>amount</code> (tutar) alanı veya <code>rate</code> (yüzdesel oran) kullanılabilir.</p>\n</li>\n<li><p>Birden fazla indirim aynı belgeye eklenebilir; her biri ayrı satır olarak <code>discounts</code> dizisinde tanımlanır. Sadece tek artırım eklenebilir.</p>\n</li>\n<li><p>İndirim sonrası net toplam, <code>netTotal</code> alanında hem Request hem de Response ta gösterilir.</p>\n</li>\n<li><p>İndirim/Artırım açıklamaları, kullanıcıya/fişe özel kampanya veya promosyon bilgisini içerebilir.</p>\n</li>\n<li><p>Bu yapı, hem e-Fatura hem de fiş belgelerinde indirim /artırım gösterimi sağlar.</p>\n</li>\n</ul>\n<h3 id=\"💱-döviz-ile-satış-nasıl-yapılır\">💱 Döviz ile satış nasıl yapılır?</h3>\n<p>Dövizli ödeme sadece kartlı ödemeler için kullanılabilir. Ödeme alınabilmesi banka tarafında gerekli tanımlamalar yapılarak posun bankadaki döviz hesaplarına bağlanması gerekir.</p>\n<blockquote>\n<p>Belge normal olarak başlatıldıktan sonra, döviz biriminden Parçalı Ödeme Eklenmesi zorunludur. </p>\n</blockquote>\n<p>Sonlandırma istediğinde tüm para birimleri, parçalı ödeme işleminde kullanılmış olan döviz cinsinden gönderilir. Döviz kurları, cihaza günlük olarak TCMB'den indirilmektedir.</p>\n<p>Belge sonlandırıldığında, güncel kur bilgisi ile birlikte toplam tutarlar TL cinsinden cevap mesajında dönülür:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>paymentCurrencyCode</code></td>\n<td>string</td>\n<td>Ödemede kullanılan döviz para birimi Örn: <code>USD</code></td>\n</tr>\n<tr>\n<td><code>conversionRate</code></td>\n<td>string</td>\n<td>Belge para birimi (<code>TRY</code>) ile ödemede kullaılan döviz para birimi arasındaki kur. Örn: <code>\"39.00\"</code></td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"turistlere-dutyfree-yolcu-beraberinde-fatura-nasıl-düzenlenir\">Turistlere DutyFree (Yolcu beraberinde) fatura nasıl düzenlenir?</h3>\n<p>eFatura ile içerik olarak hemen hemen aynıdır. Farklar:</p>\n<ul>\n<li><p>Belge tipi E_FATURA yerine DUTY_FREE yapılır.</p>\n</li>\n<li><p>Vergi iadesine aracı olan kurum bilgileri eklenir.</p>\n</li>\n<li><p>Müşteri bilgilerinde turistin pasaport bilgileri gönderilir.</p>\n</li>\n</ul>\n<h3 id=\"request-3\">Request</h3>\n<h4 id=\"zorunlu-ek-alanlar-2\">Zorunlu Ek Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>saleType</code></td>\n<td>string</td>\n<td>Belge tipi (<code>DUTY_FREE)</code></td>\n</tr>\n<tr>\n<td><code>dutyfreeAgent</code></td>\n<td>object</td>\n<td>Duty free aracı firma bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>taxId</code></td>\n<td>string</td>\n<td>Aracı kurum VKN</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Aracı kurum ünvanı</td>\n</tr>\n<tr>\n<td>└─ <code>email</code></td>\n<td>string</td>\n<td>Aracı kurum efatura eposta adresi (<code>urn:mail:..</code>)</td>\n</tr>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Turistin pasaport bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>passportNo</code></td>\n<td>string</td>\n<td>Pasaport numarası</td>\n</tr>\n<tr>\n<td>└─ <code>firstName</code></td>\n<td>string</td>\n<td>Pasaporttaki adı</td>\n</tr>\n<tr>\n<td>└─ last<code>Name</code></td>\n<td>string</td>\n<td>Pasaporttaki soyadı</td>\n</tr>\n<tr>\n<td>└─ <code>countryCode</code></td>\n<td>string</td>\n<td>Pasaportu veren <a href=\"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2\">ülkenin iki haneli kodu</a></td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"🩺-eczanelerde-muayne-katkı-payı-nasıl-kdvden-mahsup-edilir\">🩺 Eczanelerde 'Muayne Katkı Payı' nasıl KDV'den mahsup edilir?</h3>\n<p>SGK anlaşmalı eczanelerde yapılan katkı payı tahsilat işlemlerinin belgeye kaydedilmesini sağlar. Katkı payı tutarı, müşteri ve ürün bilgileriyle birlikte sisteme iletilir.</p>\n<h3 id=\"request-4\">Request</h3>\n<h4 id=\"zorunlu-alanlar\">Zorunlu Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>saleType</code></td>\n<td>string</td>\n<td>Belge tipi (<code>CO_PAY</code></td>\n</tr>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Hasta bilgisi</td>\n</tr>\n<tr>\n<td>└─ <code>taxId</code></td>\n<td>string</td>\n<td>Hastanın TC Kimlik No'su )</td>\n</tr>\n<tr>\n<td><code>coPayAmount</code></td>\n<td>string</td>\n<td>Katkı payı tutarı</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"opsiyonel-alanlar-2\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>items</code></td>\n<td>array</td>\n<td>Her bir ürün/ilaç için detaylar <code>items</code> dizisinde iletilebilir.</td>\n</tr>\n</tbody>\n</table>\n</div><h1 id=\"tahsilat-belgelerinin-sonlandırılması\">Tahsilat Belgelerinin Sonlandırılması</h1>\n<p>Satış haricinde, Avans Tahsilat, Cari Hesap Tahsilat, Fatura Tahsilat gibi belgeleri de <a href=\"https://ynokc.gib.gov.tr/UploadedFiles/Files/Bilgi_Fisi_Teknik_Kilavuzu_24072020.pdf\">GIB Bilgi Fişleri </a> Mevzuatına uygun şekilde istenilen verileri ileterek sonlandırabilirsiniz.</p>\n<h2 id=\"avans-tahsilat\">Avans Tahsilat</h2>\n<p>Satışın gerçekleşmesinden önce müşteriden avans (depozito, kaparo vb.) mahiyetinde tahsil edilen tutarlar için kullanılır. Müşterinin vergi mükellefi olduğu durumda <code>customer</code> nesnesi ile vergi no, ünvan vb bilgileri de iletmeniz gerekir.</p>\n<blockquote>\n<p>Avans tahsilatı sonrasında vergi mevzuatında öngörülen kanuni süre dahilinde fatura düzenlenmesi zorunludur. </p>\n</blockquote>\n<h3 id=\"request-5\">Request</h3>\n<h4 id=\"opsiyonel-alanlar-3\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parametre</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Müşteri bilgisi</td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplamları bilgisi</td>\n</tr>\n<tr>\n<td><code>footerNotes</code></td>\n<td>array</td>\n<td>Belge altına eklenecek notlar (isteğe bağlı)</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"👤-cari-hesap-tahsilat\">👤 Cari Hesap Tahsilat</h2>\n<p>Kayıtlı carilerin, muhasebe kaydı bulunan borçlarına istinaden yapılacak tahsilatlar için kullanılır. Müşterinin (cari) bilgilerini <code>customer</code> nesnesi ile göndermeniz gerekir. Ayrıca borcu gösteren ekstre belgesinin de seri/sıra nosu da gönderilmelidir.</p>\n<h3 id=\"request-6\">Request</h3>\n<h4 id=\"zorunlu-ek-alanlar-3\">Zorunlu Ek Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parametre</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Müşteri bilgileri (zorunlu)</td>\n</tr>\n<tr>\n<td>└─ <code>id</code></td>\n<td>string</td>\n<td>Müşteri cari kodu veya vergi kimlik nosu</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Müşteri adı veya ünvanı</td>\n</tr>\n<tr>\n<td><code>accountStatementCode</code></td>\n<td>string</td>\n<td>Cari hesap ekstre seri/sıra no</td>\n</tr>\n<tr>\n<td><code>accountStatementDate</code></td>\n<td>string</td>\n<td>Cari hesap ekstre tarihi</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"request-7\">Request</h3>\n<h4 id=\"opsiyonel-alanlar-4\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parametre</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplam bilgisi</td>\n</tr>\n<tr>\n<td><code>footerNotes</code></td>\n<td>array</td>\n<td>Belge altına eklenecek notlar (isteğe bağlı)</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"notlar-3\">Notlar</h4>\n<ul>\n<li>Kartlı ödemelerde, kart hamili Cari hesap sahibi ile örtüşmelidir. Sistemsel bir kontrol yoktur, fakat kullanıcınızı bu hususta bilgilendirmek isteyebilirsiniz.</li>\n</ul>\n<hr />\n<h2 id=\"📑-fatura-tahsilatı\">📑 Fatura Tahsilatı</h2>\n<p>Fatura ödemelerini almak için fatura tahsilatı belgesi kullanılır. Birden fazla fatura, tek bir belge üzerinden tahsil edilebilir. Komisyon ve KDV bilgileri de isteğe bağlı olarak eklenebilir.</p>\n<h3 id=\"request-8\">Request</h3>\n<h4 id=\"zorunlu-ek-alanlar-4\">Zorunlu Ek Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parametre</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bills</td>\n<td>array</td>\n<td>Tahsil edilen faturaların listesi</td>\n</tr>\n<tr>\n<td>└─ institutionName</td>\n<td>string</td>\n<td>Faturayı kesen kurum adı (<code>XXX TELEKOMUNIKASYON A.S.</code>)</td>\n</tr>\n<tr>\n<td>└─ billNo</td>\n<td>string</td>\n<td>Fatura numarası (<code>BCA123213121</code>)</td>\n</tr>\n<tr>\n<td>└─ billDate</td>\n<td>string</td>\n<td>Fatura tarihi (<code>2024-01-15</code>)</td>\n</tr>\n<tr>\n<td>└─ subscriberNo</td>\n<td>string</td>\n<td>Abone numarası (<code>05XX7012345</code>)</td>\n</tr>\n<tr>\n<td>└─ collectionAmount</td>\n<td>string</td>\n<td>Tahsil edilen tutar (<code>\"220.00\"</code>)</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"opsiyonel-alanlar-5\">Opsiyonel Alanlar</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parametre</th>\n<th>Tip</th>\n<th>Açıklama ve Örnek Değer</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>commission</td>\n<td>object</td>\n<td>Komisyon bedeli ve KDV oranı</td>\n</tr>\n<tr>\n<td>└─ <code>commissionTotal</code></td>\n<td>string</td>\n<td>(Opsiyonel) Komisyon toplamı (<code>\"10.00\"</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>(Opsiyonel) Komisyon KDV oranı (<code>20</code>)</td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplam bilgisi</td>\n</tr>\n<tr>\n<td><code>footerNotes</code></td>\n<td>array</td>\n<td>Belge altına eklenecek notlar (isteğe bağlı)</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"notlar-4\">Notlar</h4>\n<ul>\n<li><code>totals</code> altında bu belge tipinde <code>documentTotal</code> tahsilat toplamını, <code>vatTotal</code> ise komisyon toplamınına ait toplam KDV bedelini döner.</li>\n</ul>\n","urlObject":{"path":["v1","documents","93a3281a-99ce-446f-82d0-1415218413ab"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"c1298cd9-855d-4180-9f6f-28a2d9d05d5a","name":"200-Fiş","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"FİLTRE KAHVE\",\n            \"amount\": \"190\",\n            \"vatRate\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"EFT-POS\",\n            \"amount\": \"190.00\"\n        }\n    ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"eftPayment\": {\n            \"transactionId\": 229,\n            \"transactionTime\": \"2025-06-29T14:30:00Z\",\n            \"amount\": \"190.00\",\n            \"authorizationCode\": \"599479\"\n        },\n        \"totals\": {\n            \"documentTotal\": \"190.00\",\n            \"vatTotal\": \"17.27\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"f444186c-b1de-47ae-ba7e-12220d1245e1","name":"200-Parçalı Ödeme","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"YEŞİL ELMA FUJİ 1KG\",\n            \"departmentId\": 1,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"28.50\",\n            \"amount\": \"28.50\",\n            \"vatRate\": 1\n        },\n        {\n            \"name\": \"ORGANİK YUMURTA 10L\",\n            \"departmentId\": 8,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"45.00\",\n            \"amount\": \"45.00\",\n            \"vatRate\": 8,\n            \"discount\": {\n                \"amount\": \"4.50\",\n                \"note\": \"SEPET İNDİRİMİ\"\n            }\n        },\n        {\n            \"name\": \"DETERJAN 2.5 KG\",\n            \"departmentId\": 2,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"110.00\",\n            \"amount\": \"110.00\",\n            \"vatRate\": 20,\n            \"discount\": {\n                \"rate\": 10,\n                \"note\": \"İKİLİ ALIM FIRSATI\"\n            }\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"50.00\"\n        },\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"50.00\"\n        },\n        {\n            \"type\": \"VOUCHER_POS\",\n            \"provider\": \"multinet\",\n            \"amount\": \"30.00\"\n        },\n        {\n            \"type\": \"VOUCHER\",\n            \"provider\": \"multinet\",\n            \"amount\": \"20.00\"\n        },\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"20.00\"\n        }\n    ],\n    \"totals\": {\n        \"documentTotal\": \"183.50\",\n        \"netTotal\": \"168.00\"\n    },\n    \"footerNotes\": [\n        \" **** İYİ GÜNLER ****\",\n        \" www.hugin.com.tr\",\n        \" 0212 212 2121\",\n        \" MERSİS NO: 121244112344123124\"\n    ]\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"totals\": {\n            \"documentTotal\": \"183.50\",\n            \"netTotal\": \"168.00\",\n            \"vatTotal\": \"19.78\",\n            \"cashReturn\": \"2.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}\n"},{"id":"25cce17c-0370-4afd-ae03-07499237883d","name":"200-Döviz Satış","originalRequest":{"method":"PUT","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"FİLTRE KAHVE\",\n            \"amount\": \"5.00\",\n            \"vatRate\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"5.00\"\n        }\n    ]\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"documentCurrencyCode\": \"TRY\",\n        \"paymentCurrencyCode\": \"USD\",\n        \"eftPayment\": {\n            \"transactionId\": 229,\n            \"transactionTime\": \"2025-06-29T14:30:00Z\",\n            \"amount\": \"5.00\",\n            \"authorizationCode\": \"599479\"\n        },\n        \"conversionRate\": \"39.00\",\n        \"totals\": {\n            \"documentTotal\": \"195.00\",\n            \"vatTotal\": \"17.73\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"feb472aa-ff4b-4063-8045-c1ff96588ef2","name":"200-eFatura","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"saleType\": \"E_INVOICE\",\n    \"invoiceId\": \"HGE000000123\",\n    \"customer\": {\n        \"taxName\": \"AYŞE KAYA\",\n        \"taxOffice\": \"ŞİŞLİ VD\",\n        \"taxId\": \"11111111112\",\n        \"sms\": \"05001234567\",\n        \"email\": \"ayse.kaya@example.com\",\n        \"addressInfo\": {\n            \"buildingNo\": \"24\",\n            \"doorNo\": \"5\",\n            \"streetName\": \"Nispetiye Cad.\",\n            \"district\": \"Beşiktaş\",\n            \"city\": \"İstanbul\",\n            \"country\": \"TR\"\n        }\n    },\n    \"items\": [\n        {\n            \"name\": \"KADIN KOT CEKET\",\n            \"departmentId\": 1,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"600.00\",\n            \"amount\": \"600.00\",\n            \"vatRate\": 20,\n            \"discount\": {\n                \"rate\": 15,\n                \"note\": \"%15 SEZON İNDİRİMİ\"\n            }\n        },\n        {\n            \"name\": \"DERİ AYAKKABI\",\n            \"departmentId\": 2,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"750.00\",\n            \"amount\": \"750.00\",\n            \"vatRate\": 20,\n            \"discount\": {\n                \"amount\": \"50.00\",\n                \"note\": \"50₺ İNDİRİM KAMPANYASI\"\n            }\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"1100.00\"\n        }\n    ],\n    \"totals\": {\n        \"documentTotal\": \"1350.00\",\n        \"netTotal\": \"1110.00\",\n        \"discounts\": [\n            {\n                \"amount\": \"100.00\",\n                \"note\": \"100₺ Yeni Sezon Kampanyası\"\n            }\n        ]\n    },\n    \"footerNotes\": [\n        \" **** İYİ GÜNLER ****\",\n        \" www.hugin.com.tr\",\n        \"QRTABC123456789\",\n        \"EAN123456789\",\n        \" 0212 212 2121\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"invoiceId\": \"HGN000000123\",\n        \"totals\": {\n            \"documentTotal\": \"1350.00\",\n            \"netTotal\": \"1110.00\",\n            \"vatTotal\": \"185.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"d2e2fbb4-831b-43f4-a9f8-3cfedd0722d8","name":"200-Aratoplama Artırım","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"saleType\": \"E_INVOICE\",\n    \"customer\": {\n        \"taxName\": \"Zeynep Demir\",\n        \"taxId\": \"12345678901\",\n        \"taxOffice\": \"BEŞİKTAŞ VD\"\n    },\n    \"items\": [\n        {\n            \"name\": \"ŞEFİN MENÜSÜ\",\n            \"departmentId\": 1,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"1000.00\",\n            \"amount\": \"1000.00\",\n            \"vatRate\": 20\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"600.00\"\n        }\n    ],\n    \"totals\": {\n        \"documentTotal\": \"1000.00\",\n        \"netTotal\": \"1200.00\",\n        \"surcharge\": [\n            {\n                \"amount\": \"200.00\",\n                \"note\": \"200₺ Ek hizmet bedeli\"\n            }\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"invoiceId\": \"HGN000000123\",\n        \"totals\": {\n            \"documentTotal\": \"1000.00\",\n            \"netTotal\": \"1200.00\",\n            \"vatTotal\": \"185.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"807d0005-ee97-49fc-87e6-082f115a5027","name":"200-Duty Free OK","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"saleType\": \"DUTY_FREE\",\n    \"dutyfreeAgent\": {\n        \"taxId\": \"3810044287\",\n        \"name\": \"GLOBAL BLUE TURİSTİK HİZMETLER A.Ş.\",\n        \"email\": \"urn:mail:yolcuberaberpk@globalblue.com\"\n    },\n    \"customer\": {\n        \"passportNo\": \"XDD67839393\",\n        \"firstName\": \"JACK\",\n        \"lastName\": \"HENRY\",\n        \"countryCode\": \"GB\"\n    },\n    \"items\": [\n        {\n            \"name\": \"KADIN KOT CEKET\",\n            \"departmentId\": 1,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"600.00\",\n            \"amount\": \"600.00\",\n            \"vatRate\": 20,\n            \"discount\": {\n                \"rate\": 15,\n                \"note\": \"%15 SEZON İNDİRİMİ\"\n            }\n        },\n        {\n            \"name\": \"DERİ AYAKKABI\",\n            \"departmentId\": 2,\n            \"quantity\": 1,\n            \"unit\": \"AD\",\n            \"unitPrice\": \"750.00\",\n            \"amount\": \"750.00\",\n            \"vatRate\": 20,\n            \"discount\": {\n                \"amount\": \"50.00\",\n                \"note\": \"50₺ İNDİRİM KAMPANYASI\"\n            }\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"500.00\"\n        }\n    ],\n    \"totals\": {\n        \"documentTotal\": \"1350.00\",\n        \"netTotal\": \"1110.00\",\n        \"discounts\": [\n            {\n                \"amount\": \"100.00\",\n                \"note\": \"100₺ Yeni Sezon Kampanyası\"\n            }\n        ]\n    },\n    \"footerNotes\": [\n        \" **** THANK YOU ****\",\n        \" www.hugin.com.tr\",\n        \" 0212 212 2121\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"invoiceId\": \"HGN000000123\",\n        \"totals\": {\n            \"documentTotal\": \"1350.00\",\n            \"netTotal\": \"1110.00\",\n            \"vatTotal\": \"185.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"e329dde6-a96c-419d-a45b-34fd4957fb34","name":"200-Eczane OK","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"customer\": {\n        \"taxId\": \"12345678901\"\n    },\n    \"coPayAmount\":\"150.00\",\n    \"items\": [\n        {\n            \"name\": \"İLAÇ\",\n            \"amount\": \"100.00\",\n            \"vatRate\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"250.00\"\n        }\n    ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"totals\": {\n            \"documentTotal\": \"250.00\",\n            \"vatTotal\": \"9.09\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"c4ceddee-12fd-41c9-b3b8-912fbf9ae396","name":"200-Avans OK","originalRequest":{"method":"PUT","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"customer\": {\n        \"taxId\": \"12345678901\"\n    },\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"1500.00\"\n        }\n    ],\n    \"referenceCode\": \"REF123456789\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"totals\": {\n            \"documentTotal\": \"1500.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"5275828c-72fe-45e5-bd2c-2a574ec1c8c4","name":"200-Cari Hesap OK","originalRequest":{"method":"PUT","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"accountStatementCode\": \"BCA123213121\",\n    \"accountStatementDate\": \"2024-01-15\",\n    \"customer\": { \n        \"id\": \"4000\",\n        \"taxName\": \"Ali Yılmaz\"\n    },\n    \"payments\": [\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"1500.00\"\n        }\n    ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"totals\": {\n            \"documentTotal\": \"1500.00\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"49f4ca53-1900-4294-b82f-90b164165f50","name":"200-Fatura Tahsilat OK","originalRequest":{"method":"PUT","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"bills\": [\n        {\n            \"institutionName\": \"XXX TELEKOMUNIKASYON A.S.\",\n            \"billNo\": \"BCA123213121\",\n            \"billDate\": \"2024-01-15\",\n            \"subscriberNo\": \"05XX7012345\",\n            \"collectedAmount\": \"220.00\"\n        },\n        {\n            \"institutionName\": \"YYY ENERJI A.S.\",\n            \"billNo\": \"ENERJI-456789\",\n            \"billDate\": \"2024-01-15\",\n            \"subscriberNo\": \"05XX8023456\",\n            \"collectedAmount\": \"150.00\"\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"CASH\",\n            \"amount\": \"380.00\"\n        }\n    ],\n    \"totals\": { //Sadece komisyon alındı ise eklenir\n        \"commissionTotal\": \"10.00\",\n        \"vatRate\": 20\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"receiptNo\": \"0023_0004\",\n        \"totals\": {\n            \"documentTotal\": \"380.00\",\n            \"commissionTotal\": \"10.00\",\n            \"vatTotal\": \"1.67\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"69dc058a-6f32-45fe-9976-5cd6c887d47b","name":"206-Sadece Ödeme Alındı","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"FİLTRE KAHVE\",\n            \"amount\": \"22\",\n            \"vatRate\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"22.00\"\n        }\n    ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"Partial Content","code":206,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 2239,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"de784dcf-9c8d-43f7-849e-927e9447edb4","name":"400-Hatalı Fiş Gönderim","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"TAKIM ELBİSE\",\n            \"amount\": \"35000.00\",\n            \"vatRate\": 20\n        }\n    ]\n}\n","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"title\": \"ÖKC durumu uygun değil\",\n        \"description\": \"Kanuni limit üzerindeki satışlarda müşteri VKN bilgisi zorunludur\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"ad790bd3-2a58-4448-936a-0298f7bdb3e1","name":"417-Yetersiz Bakiye","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"amount\": \"22.00\"\n} ","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"INSUFFICIENT_FUNDS\",\r\n        \"title\": \"Yetersiz bakiye\",\r\n        \"description\": \"Karttan yetersiz bakiye hatası alındı. BKM ID 51\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578/payments/EFT_POS\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"},{"id":"c018a5f5-2f26-4458-b58c-71f3b4cb4ace","name":"503-Kağıt Yok","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"name\": \"TAKIM ELBİSE\",\n            \"amount\": \"15000.00\",\n            \"vatRate\": 20\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/716da6db-d6a3-4932-85de-87179e606578"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_NO_PAPER\",\n        \"title\": \"Kağıt yok\",\n        \"description\": \"Rulo haznesini kontrol edin. Kağıt bitmiş veya sıkışmış olabilir.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/716da6db-d6a3-4932-85de-87179e606578\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"3c0e1742-fc0b-4d00-a6ae-0080b9b51d14"},{"name":"Aktif Belge Devam","id":"a6fd0646-aaec-4653-b806-660003aafea9","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/93a3281a-99ce-446f-82d0-1415218413ab/resume","description":"<p>Belge sonlandırma esnasında oluşan ve cihaza kullanıcı müdahalesi gerektiren anlık hataların (kağıit bitmesi, rulo kapağıın açık olması, vs) düzeltildikten sonra işleme devam edilebilmesi için kullanılan mesajdır. Parametre almaz.</p>\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Toplam tutar bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>documentTotal</code></td>\n<td>string</td>\n<td>Belge toplam tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>vatTotal</code></td>\n<td>string</td>\n<td>Toplam KDV tutarı</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n","urlObject":{"path":["v1","documents","93a3281a-99ce-446f-82d0-1415218413ab","resume"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"1a871068-de02-44d3-a9d1-e4ca153c71ae","name":"200-Aktif Fiş Devam","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/resume"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"totals\": {\n            \"documentTotal\": \"190.00\",\n            \"vatTotal\": \"17.27\"\n        }\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-06-29T14:30:00Z\"\n    }\n}"},{"id":"0ff35039-39ae-4d8d-b972-6c2e85b72927","name":"404-Belge Bulunamadı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/resume"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"DOCUMENT_NOT_FOUND\",\n    \"title\": \"Belge Bulunamadı\",\n    \"description\": \"Belirtilen belge numarası ile eşleşen aktif belge bulunamadı.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/resume\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"6b8f8c88-05f5-45f9-86db-f2e9d49909d3","name":"409-Belge Zaten Kapalı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/resume"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"DOCUMENT_ALREADY_CLOSED\",\n    \"title\": \"Belge Zaten Kapalı\",\n    \"description\": \"Belge daha önce sonlandırılmış veya iptal edilmiş. Devam edilemez.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/resume\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"02363e6e-e2ca-4a04-8498-7078b8f0f05e","name":"503-Cihaz Meşgul","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/resume"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"BUSY\",\n    \"title\": \"Mali uygulama meşgul\",\n    \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/resume\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"}],"_postman_id":"a6fd0646-aaec-4653-b806-660003aafea9"},{"name":"Aktif Belge İptal","id":"caf67acb-832a-4054-b87a-96b0c78f1502","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/documents/93a3281a-99ce-446f-82d0-1415218413ab/cancel","description":"<p>Müşterinin mal/hizmet alımından vazgeçmesi durumunda cihaz üzerindeki aktif belgeyi iptal edebilirsiniz.</p>\n<p>Belge içerisine gerçekleştirilmiş kartlı ödeme olması durumunda <code>Ödemeden Vazgeç</code> çağırarak sadece son kartlı ödemeyi kart okutmadan geri alabilirsiniz.</p>\n<p>Bankacılık kuralları gereği, son ödeme dışındaki her bir işlem için <code>İşlem İptal Et</code> endpointi çağrılmalı ve ödemede kullanılan kartı tekrar okutulmalıdır.</p>\n<h3 id=\"yanıt-response\">Yanıt (Response)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code> veya <code>ERROR</code> )</td>\n</tr>\n<tr>\n<td><code>documentStatus</code></td>\n<td>string</td>\n<td><code>CANCELLED</code></td>\n</tr>\n<tr>\n<td><code>eDocumentNo</code></td>\n<td>string</td>\n<td><code>ABC023000000005</code></td>\n</tr>\n<tr>\n<td><code>totals</code></td>\n<td>object</td>\n<td>Belge toplamları</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"açıklamalar\">Açıklamalar</h3>\n<ul>\n<li>Sadece aktif (henüz tamamlanmamış/geçerli) belgeler iptal edilebilir.</li>\n</ul>\n","urlObject":{"path":["v1","documents","93a3281a-99ce-446f-82d0-1415218413ab","cancel"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"6cd18080-ed58-4540-a751-1c1a3ab57d40","name":"200-Aktif Fiş Iptal","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/cancel"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"documentStatus\": \"CANCELLED\",\n        \"receiptNo\": \"0061_0002\",\n        \"totals\": {\n            \"documentTotal\": \"190.00\"\n        }\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"8d9f3ca2-642b-4136-9c54-2d25e04ebb9a","name":"404-Belge Bulunamadı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/cancel"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"DOCUMENT_NOT_FOUND\",\n    \"title\": \"Belge Bulunamadı\",\n    \"description\": \"Belirtilen belge numarası ile eşleşen aktif belge bulunamadı.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/cancel\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"f8454635-29e7-42bb-803e-181060246574","name":"404-Belge Sonlandirilmali","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/cancel"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_INVALID_CANCEL\",\n    \"title\": \"Belge iptal edilemez\",\n    \"description\": \"Birden fazla kartlı ödeme olan durumlarda belge iptal edilemez, kalan ödeme varsa yapılarak tamamlanmalıdır.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/cancel\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"ef2f23be-ac32-48ab-8141-e23d57d2443d","name":"409-Belge Zaten İptal","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/cancel"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"DOCUMENT_ALREADY_CANCELLED\",\n    \"title\": \"Belge Zaten İptal Edilmiş\",\n    \"description\": \"Bu belge daha önce iptal edilmiştir. Tekrar iptal edilemez.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/cancel\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"ec3b1d2c-71f8-45d1-afae-67d66775d0d6","name":"503-Cihaz Meşgul","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/documents/6405ea05-c118-40f9-a27b/cancel"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"BUSY\",\n    \"title\": \"Mali uygulama meşgul\",\n    \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/documents/6405ea05-c118-40f9-a27b/cancel\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"}],"_postman_id":"caf67acb-832a-4054-b87a-96b0c78f1502"},{"name":"Fiş Kopya Yazdır","id":"3053776e-8d40-4b55-8468-1bd461c6b39d","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents//print","description":"<p>Tamamlanmış bir belgenin ek nüshasını yazdırmak için kullanılır. Belge sonlandır işlem response'undaki <code>receiptNo</code> alanı, bu işlemde parametre olarak kullanılmalıdır.</p>\n<h3 id=\"yanıt-response\">Yanıt (Response)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code> veya <code>ERROR</code> )</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","documents","","print"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"596360c8-a523-45ba-b32f-fb7bc556843c","name":"200-Kopya Yazdrıldı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/0063_1232/print"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"48bbff72-9bec-494b-b654-2b7682366099","name":"404-Belge bulunamadı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/0063_1232/print"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_DOCUMENT_NOT_FOUND\",\n        \"title\": \"Belge Bulunamadı\",\n        \"description\": \"Belge bulunamadı\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/6405ea05-c118-40f9-a27b/print\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"},{"id":"9ca3254c-5d61-470c-b495-f60f7f61a7c3","name":"500-Kağıt yok","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/documents/0063_1232/print"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_NO_PAPER\",\n        \"title\": \"Kağıt bitti\",\n        \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/0063_002\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"3053776e-8d40-4b55-8468-1bd461c6b39d"},{"name":"Durum Sorgula","id":"75a3cf01-762b-4129-84b7-53f16b4f59e2","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/status","description":"<p>Cihazın mevcut durumunu ve olası hata kodlarını sorgulamak için kullanılır. Satış uygulaması, işlem öncesinde cihazın uygunluğunu bu endpoint aracılığıyla öğrenebilir.</p>\n<blockquote>\n<p>Bu endpoint sadece bilgi amaçlıdır, belge oluşturmaz veya ödeme almaz. </p>\n</blockquote>\n<blockquote>\n<p>Geliştiriciler, sadece işlem öncesinde veya hata şüphesi olduğunda bu endpoint’i çağırmalıdır. Sürekli ve gereksiz kasa durum sorgulamaları, satış uygulamasında gereksiz yavaşlamalara yol açabilir. </p>\n</blockquote>\n<p><code>state</code> değeri <code>DOC</code> olduğu durumlarda <code>activeDocument</code> verileri dikkate alınarak, açık döküman üzerinde, parçalı ödeme ekleme, kartlı ödeme iptal ve sonlandırma gibi işlemler yapılabilir.</p>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"response\">Response</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>state</code></td>\n<td>string</td>\n<td><code>IDLE</code>, <code>DOC</code></td>\n</tr>\n<tr>\n<td><code>activeDocument</code></td>\n<td>object</td>\n<td><code>state</code> değeri <code>DOC</code> olduğu durumlarda aktif dokuman detayi paylaşılır.</td>\n</tr>\n<tr>\n<td><code>lastDocuments[]</code></td>\n<td>array</td>\n<td>Son 3 belge (iptal veya düzenlenmiş) detayı paylaşılır.</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Sunucu saatini içerir</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","status"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"063050ec-9ac0-4931-9500-1ab1c70a3b2f","name":"200-Idle","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"state\": \"IDLE\",\n        \"lastDocuments\": [\n            {\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"documentStatus\": \"SUCCESS\",\n                \"docCategory\": \"SALE\",\n                \"saleType\": \"RECEIPT\",\n                \"documentTime\": \"2025-06-29T14:30:00Z\",\n                \"amount\": \"33.00\",\n                \"currencyCode\": \"TRY\",\n                \"eftPayments\": [\n                    {\n                        \"paymentId\": 9,\n                        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                        \"amount\": \"11.00\"\n                    },\n                    {\n                        \"paymentId\": 10,\n                        \"transactionTime\": \"2025-06-29T14:33:00Z\",\n                        \"amount\": \"11.00\"\n                    }\n                ]\n            },\n            {\n                \"documentId\": \"6cd326b6-1eeb-4381-b351-a0086dd63dbf\",\n                \"documentStatus\": \"CANCELLED\",\n                \"docCategory\": \"SALE\",\n                \"saleType\": \"E_INVOICE\",\n                \"documentTime\": \"2025-06-29T14:25:00Z\"\n            },\n            {\n                \"documentId\": \"769708d9-10fb-4271-9b2b-43b5a5a9ce23\",\n                \"documentStatus\": \"SUCCESS\",\n                \"docCategory\": \"BILL\",\n                \"documentTime\": \"2025-06-29T14:20:00Z\",\n                \"amount\": \"33.00\"\n            }\n        ]\n    },\n    \"meta\": {\n        \"timestamp\": \"2025-06-26T12:00:00Z\"\n    }\n}"},{"id":"ae2bdfa8-c5f0-4876-9680-14b0a6cc2d53","name":"200-Ödeme İçinde","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"state\": \"DOC\",\n        \"activeDocument\" :\n            {\n                \"documentId\": \"9708d769-10fb-4271-9b2b-43b5a5a9ab01\",\n                \"docCategory\": \"SALE\",\n                \"saleType\": \"RECEIPT\",\n                \"documentTime\": \"2025-06-29T14:30:00Z\",\n                \"eftPayments\": [\n                    {\n                        \"paymentId\": 4239,\n                        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                        \"amount\": \"11.00\",\n                        \"authorizationCode\": \"599479\"\n                    },\n                    {\n                        \"paymentId\": 4240,\n                        \"transactionTime\": \"2025-06-29T14:33:00Z\",\n                        \"amount\": \"11.00\",\n                        \"authorizationCode\": \"599479\"\n                    }\n                ]\n            },\n        \"lastDocuments\": [\n            {\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"docCategory\": \"SALE\",\n                \"saleType\": \"RECEIPT\",\n                \"documentTime\": \"2025-06-29T14:30:00Z\",\n                \"amount\": \"33.00\",\n                \"eftPayments\": [\n                    {\n                        \"paymentId\": 4239,\n                        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                        \"amount\": \"11.00\"\n                    },\n                    {\n                        \"paymentId\": 4240,\n                        \"transactionTime\": \"2025-06-29T14:33:00Z\",\n                        \"amount\": \"11.00\"\n                    }\n                ]\n            },\n            {\n                \"documentId\": \"6cd326b6-1eeb-4381-b351-a0086dd63dbf\",\n                \"docCategory\": \"SALE\",\n                \"saleType\": \"E_INVOICE\",\n                \"documentTime\": \"2025-06-29T14:25:00Z\",\n                \"amount\": \"22.00\"\n            },\n            {\n                \"documentId\": \"769708d9-10fb-4271-9b2b-43b5a5a9ce23\",\n                \"docCategory\": \"BILL\",\n                \"documentTime\": \"2025-06-29T14:20:00Z\",\n                \"amount\": \"33.00\"\n            }\n        ]\n    },\n    \"meta\": {\n        \"timestamp\": \"2025-06-26T12:00:00Z\"\n    }\n}"},{"id":"20112a10-4a86-4925-a607-3b6c65b48c8f","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/status"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"BUSY\",\n        \"title\": \"Mali uygulama meşgul\",\n        \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/status\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"6b3f0b8d-3d02-4f89-9425-11c2de25111d","name":"503-Kağıt Yok","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/status"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_NO_PAPER\",\n        \"title\": \"Kağıt yok\",\n        \"description\": \"Rulo haznesini kontrol edin. Kağıt bitmiş veya sıkışmış olabilir.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/status\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"75a3cf01-762b-4129-84b7-53f16b4f59e2"}],"id":"7b705311-02c0-46fc-b5b7-df14ba59e3d3","description":"<p>PC Link ile satış işlemleri, farklı belge tipleri ve ödeme yöntemleriyle esnek şekilde gerçekleştirilebilir. Bu bölümde detaylı örnekler, açıklamalar ve önemli notlar yer almaktadır.</p>\n<p>Tüm işlemler <code>/documents</code> endpointi üzerinden gerçekleştirilir.</p>\n<h3 id=\"ödeme-çeşitliliği--parçalı-ödeme-nasıl-yapılır\">Ödeme Çeşitliliği / Parçalı Ödeme Nasıl Yapılır?</h3>\n<p>Bir satışta birden fazla ödeme türü aynı anda kullanılabilir. Aşağıdaki örnekteki işlem sırası ile gerçekleştirilmelidir:</p>\n<ol>\n<li>Önce Satış belgesi başlatılır, ve satış yazılımından sepet oluşturulur.</li>\n</ol>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">POST /documents\n{\n\"docCategory\": \"SALE\"\n}\n\n</code></pre>\n<p>2. Cevaptaki <code>documentId</code> degeri (bu örnekte <code>ef211-a78b45-c8993022</code> olmuş olsun) kayıt edilir. Hızlı akışın aksine, Belge sonlandırma doğrudan çağrılmaz. Önce her ödeme için farklı requestler ile <code>Parçalı Ödeme Ekle</code> işlemleri gerçekleştirilir. <code>EFT_POS</code> ödeme talebi gönderildiğinde Yazarkasa POS üzerinde kartlı ödeme ekranı aktive olur:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">POST /documents/ef211-a78b45-c8993022/payments/EFT_POS\n{\n    \"amount\": \"10.00\"\n}\n\n</code></pre>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">POST /documents/ef211-a78b45-c8993022/payments/EFT_POS\n{\n    \"amount\": \"12.00\"\n}\n\n</code></pre>\n<p>3. Tahsil edilmiş <code>EFT_POS</code> ödemeleri teknik mutabakat amacı ile belge detayına eklenerek gönderilir ve satış sonlandırılmış olur.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">PUT /documents/ef211-a78b45-c8993022\n{\n    \"items\": [\n        {\n            \"name\": \"FİLTRE KAHVE\",\n            \"amount\": \"190\",\n            \"vatRate\": 10\n        }\n    ],\n    \"payments\": [\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"10.00\"\n        },\n        {\n            \"type\": \"EFT_POS\",\n            \"amount\": \"12.00\"\n        }\n    ]\n}\n\n</code></pre>\n<p>Bu detaylı akış, parçalı ödemenin yanı sıra bazı ek özelliklerin kullanılması için de değerlendirilebilir. Detaylı akış örnekleri için <code>Parçalı Ödeme Ekle</code> dökümantasyonu ve altındaki <code>200-Detaylı Ödeme Alındı</code> örneği inceleyin.</p>\n<h1 id=\"📚-ortak-referanslar-ve-kod-listeleri\">📚 Ortak Referanslar ve Kod Listeleri</h1>\n<p>Bu bölüm, PCLink API SDK'da sıkça başvurulan tüm ortak enum, tip ve hata kodlarını merkezi olarak içerir. Tüm modüller ve dokümantasyon bölümleri bu dosyaya referans verebilir.</p>\n<h2 id=\"💳-ödeme-tipleri\">💳 Ödeme Tipleri</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Ödeme Tipi</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>CASH</code></td>\n<td>Nakit</td>\n</tr>\n<tr>\n<td><code>EFT_POS</code></td>\n<td>Kartlı Ödeme</td>\n</tr>\n<tr>\n<td><code>VOUCHER</code></td>\n<td>Harici Yemek Kartı</td>\n</tr>\n<tr>\n<td><code>VOUCHER_POS</code></td>\n<td>Entregre Yemek Kart Uygulaması</td>\n</tr>\n<tr>\n<td><code>CHECK</code></td>\n<td>Çek</td>\n</tr>\n<tr>\n<td><code>WIRE</code></td>\n<td>EFT/Havale</td>\n</tr>\n<tr>\n<td><code>OPEN_ACCOUNT</code></td>\n<td>Açık Hesap</td>\n</tr>\n<tr>\n<td><code>NO_CHARGE</code></td>\n<td>İkram</td>\n</tr>\n<tr>\n<td><code>LOYALTY_POINTS</code></td>\n<td>Puan</td>\n</tr>\n<tr>\n<td><code>GIFT_CARD</code></td>\n<td>Hediye Kartı</td>\n</tr>\n<tr>\n<td><code>VPOS</code></td>\n<td>Sanal POS Ödeme</td>\n</tr>\n<tr>\n<td><code>MOBILE</code></td>\n<td>Mobil Ödeme</td>\n</tr>\n<tr>\n<td><code>E-MONEY</code></td>\n<td>E-Para Ödeme</td>\n</tr>\n<tr>\n<td><code>CHARITY</code></td>\n<td>Bağış</td>\n</tr>\n<tr>\n<td><code>TRANSPORT_CARD</code></td>\n<td>Ulaşım Kartı</td>\n</tr>\n<tr>\n<td>---</td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"⚠️-hata-durumları\">⚠️ Hata Durumları</h2>\n<p>API, hatalı veya eksik isteklerde standart bir hata yanıtı döner. Hata mesajı aşağıdaki yapıda olur:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Hata statüsü <code>ERROR</code></td>\n</tr>\n<tr>\n<td><code>error</code></td>\n<td>object</td>\n<td>Hata nesnesi</td>\n</tr>\n<tr>\n<td>└─ <code>code</code></td>\n<td>string</td>\n<td>Hata kodu (<strong><code>ERR_INVALID_PRM</code></strong> vb.)</td>\n</tr>\n<tr>\n<td>└─ <code>title</code></td>\n<td>string</td>\n<td>Hata başlığı</td>\n</tr>\n<tr>\n<td>└─ <code>description</code></td>\n<td>string</td>\n<td>Açıklayıcı hata mesajı</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"genel-hata-yanıtı-örneği\">Genel Hata Yanıtı Örneği</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"title\": \"ÖKC durumu uygun değil\",\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil. Örnek: Satış sırasında yeni satış başlatmak.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/documents/a1b2c3d4-e5f6-7890-1234-56789abcdef0\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}\n\n</code></pre>\n<h3 id=\"❗-hata-kodları\">❗ Hata Kodları</h3>\n<p>Hata kodları <a href=\"https://datatracker.ietf.org/doc/html/rfc7807\">RFC7807</a> - HTTP API standarlarına uygun olarak aşağıdaki değerleri alabilir.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Title</th>\n<th><strong>Detail</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>ERR_DATA_CORRUPT</code></td>\n<td>Mesaj hatalı</td>\n<td>Gönderilen veri formatı veya yapısı beklenen ile uyumsuz. Örnek: Eksik veya bozuk JSON, zorunlu alanlar eksik.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_STATE</code></td>\n<td>ÖKC durumu uygun değil</td>\n<td>Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil. Örnek: Satış sırasında yeni satış başlatmak.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_METHOD</code></td>\n<td>Geçersiz fonksiyon</td>\n<td>İstenilen HTTP metodu veya API fonksiyonu bu endpoint için desteklenmiyor. Örnek: GET yerine POST kullanmak.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_PRM</code></td>\n<td>Geçersiz parametre</td>\n<td>Parametrelerden biri hatalı veya eksik. Örnek: Tanımsız alan adı, yanlış veri tipi.</td>\n</tr>\n<tr>\n<td><code>ERR_OPERATION_FAILED</code></td>\n<td>İşlem başarısız, tekrar deneyin</td>\n<td>Beklenmeyen bir hata oluştu, işlem tamamlanamadı. Örnek: Donanım arızası, ağ kesintisi.</td>\n</tr>\n<tr>\n<td><code>ERR_NO_PAPER</code></td>\n<td>Kağıt yok</td>\n<td>Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.</td>\n</tr>\n<tr>\n<td><code>ERR_MATCH_ERROR</code></td>\n<td>Cihaz eşleme hatası</td>\n<td>Cihaz ile uygulama arasında bağlantı/kimlik doğrulama sorunu.</td>\n</tr>\n<tr>\n<td><code>ERR_RCPT_TOTAL_LIMIT</code></td>\n<td>Fiş toplam limiti aşıldı</td>\n<td>Fiş toplam tutarı, mevzuat limitlerini aştı. Örnek: 9.900 TL üzeri satış.</td>\n</tr>\n<tr>\n<td><code>ERR_RCPT_SALE_COUNT</code></td>\n<td>Satış kalemi sayısı limiti aşıldı</td>\n<td>Bir fişte izin verilen maksimum ürün satırı aşıldı. Örnek: 128’den fazla satış kalemi eklenmesi.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_SALE</code></td>\n<td>Geçersiz satış (tutar 0)</td>\n<td>Satış satırı tutarı sıfır veya negatif. Örnek: Ürün fiyatı girilmemiş.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_VOID</code></td>\n<td>Geçersiz iptal</td>\n<td>İptal edilmek istenen işlem bulunamadı veya zaten iptal edilmiş.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_ADJ</code></td>\n<td>Geçersiz indirim/arttırım</td>\n<td>İndirim/artış oranı veya tipi geçersiz. Son işlem İnidirim/artırıma uygun olmayabilir.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_PAYMENT</code></td>\n<td>Geçersiz ödeme</td>\n<td>Ödeme tipi veya tutarı hatalı. Örnek: Tanımsız ödeme tipi, negatif tutar.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_CANCEL</code></td>\n<td>Belge iptal edilemez</td>\n<td>Birden fazla kartlı ödeme olan durumlarda belge iptal edilemez, kalan ödeme varsa yapılarak tamamlanmalıdır.</td>\n</tr>\n<tr>\n<td><code>ERR_PAYMENT_LIMIT</code></td>\n<td>Parçalı ödeme limiti aşıldı</td>\n<td>Fişte birden fazla ödeme varsa, toplam ödeme sayısı sınırı aşıldı.</td>\n</tr>\n<tr>\n<td><code>ERR_CURRENCY_NOT_DEFINED</code></td>\n<td>Döviz tipi tanımlı değil</td>\n<td>Girilen döviz tipi sistemde tanımlı değil. Örnek: USD yerine \"XYZ\" yazmak.</td>\n</tr>\n<tr>\n<td><code>ERR_DAILY_RCPT_COUNT</code></td>\n<td>Günlük fiş limiti aşıldı</td>\n<td>Cihazda bir günde oluşturulabilecek maksimum fiş sayısına ulaşıldı.</td>\n</tr>\n<tr>\n<td><code>ERR_DAILY_TOTAL_LIMIT</code></td>\n<td>Günlük toplam limiti aşıldı</td>\n<td>Günlük toplam satış tutarı cihaz veya mevzuat limitini geçti.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_VATRATE</code></td>\n<td>Geçersiz KDV oranı</td>\n<td>KDV oranı tanımlı aralık dışında. Örnek: % gibi desteklenmeyen bir oran.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_BARCODE</code></td>\n<td>Geçersiz barkod</td>\n<td>Barkod formatı veya değeri hatalı. Örnek: Eksik/yanlış karakter içeren barkod.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_QUANTITY</code></td>\n<td>Geçersiz adet</td>\n<td>Ürün miktarı sıfır veya negatif. Örnek: -2 adet ürün eklemek.</td>\n</tr>\n<tr>\n<td><code>ERR_INVALID_AMOUNT</code></td>\n<td>Geçersiz tutar</td>\n<td>Tutar alanı sıfır, negatif veya desteklenmeyen formatta. Örnek: \"abc\" gibi metin girilmesi.</td>\n</tr>\n<tr>\n<td><code>ERR_VUK_426</code></td>\n<td>İşlem Yazarkasa POS bütünleşik sistemine aykırı</td>\n<td>Yazarkasa POS'larda, bazı POS operasyonlarını mali işlemlerden bağımsız yapılamaz.</td>\n</tr>\n<tr>\n<td><code>ERR_VUK_557</code></td>\n<td>Banka aktivasyonu gerekli</td>\n<td>Yazarkasa POS'larda en az bir adet banka terminali aktif olarak kullanılmalıdır.</td>\n</tr>\n<tr>\n<td><code>ERR_NO_TSM</code></td>\n<td>TSM erişim hatası</td>\n<td>TSM sunucusuna anlık olarak erişim sağlanamıyor. Cihazın internet bağlantısını kontrol edin.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"7b705311-02c0-46fc-b5b7-df14ba59e3d3"},{"name":"💳 Banka İşlemleri","item":[{"name":"Ödeme Al","id":"0a68e7ca-5c95-4ceb-8a01-2665abe02a2c","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/payments","description":"<p>POS üzerinden kredi kartı ile ödeme işlemi yapmak için bu endpoint kullanılır. Mali sistemler için geçerli değildir. Muafiyeti olan müşteriler için kullanilabilir.</p>\n<p>Arayüzü <code>Parçalı Ödeme Ekle</code> ile aynıdır.</p>\n","urlObject":{"path":["v1","pos","payments"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"4f72ddbb-6f1f-4749-84e3-3b57295f9d1d","name":"403-Forbidden","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/payments"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"ERR_VUK_426\",\r\n        \"title\": \"İşlem Yazarkasa POS bütünleşik sistemine aykırı\",\r\n        \"description\": \"Mali sistemlerde belge bağımsız ödeme yapılamaz.\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/pos/payments\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"}],"_postman_id":"0a68e7ca-5c95-4ceb-8a01-2665abe02a2c"},{"name":"İşlemi İptal Et","id":"f11ea21f-d607-48f2-a4c6-231f82313c9f","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions//void","description":"<p>Bir kredi kartı ödeme veye iadesinin henüz finansallaşmadan (yani gün sonu işleminden önce) iptal edilmesi için kullanılır. İşlem sadece orjinal satışı gerçekleştiren cihazdan yapılabilir.</p>\n<h3 id=\"request\">Request</h3>\n<p>Body boş olarak gönderilir</p>\n<h3 id=\"response\">Response</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionTime</code></td>\n<td>string</td>\n<td>İptal işleminin gerçekleştiği an</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>İptal edilen tutar</td>\n</tr>\n<tr>\n<td><code>currencyCode</code></td>\n<td>string</td>\n<td>Döviz para birimi (TRY ise alan dönülmez)</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Sunucu saatini içerir</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","pos","transactions","","void"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"b95c6eeb-8be4-4165-b4ce-a3ba5b186892","name":"200-Ödeme İptal","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions/2322/void"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 4599,\n        \"type\": \"020000\",\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/2322/void\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"},{"id":"7f1dc183-a3ab-451b-bb08-4149886fab5c","name":"405-Finansallaşmış İşlem","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions/2322/void"},"status":"Method Not Allowed","code":405,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_TRANSACTION_SETTLED\",\n        \"title\": \"Finansallaşmış işlem\",\n        \"description\": \"İşlem finansallaştığı için iptal edilemez. BKM 123\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/2322/void\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"},{"id":"06a5d790-83cf-4332-b6ad-359cfdbfdef2","name":"405-Hatalı Kart","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/2322/void"},"status":"Method Not Allowed","code":405,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"INVALID_CARD\",\n        \"title\": \"Hatalı Kart\",\n        \"description\": \"Takılan kart ile orjinal işlemde kullanılan kart farklı BKM_ID 14\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/2322/void\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"}],"_postman_id":"f11ea21f-d607-48f2-a4c6-231f82313c9f"},{"name":"İade Al","id":"cdb780e1-32ef-40cd-9c7e-9b75b4cd045e","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/refunds","description":"<p>Bir kredi kartı ödemesinin finansallaştıktan sonra (yani gün sonu işleminden sonra) tümünün veya bir kısmının iade edilmesi için kullanılır.</p>\n<p>İade işleminde gereken bankId ve bankReferenceNo alanlarının, orjinal işlem esnasında alınıp kayıt edilebilmesi için <code>Parçalı Ödeme Ekle</code> veya <code>Belge Sonlandır</code> isteğinde<code>detailedResponse = true</code>, gönderilmeli ve gelen cevaptaki alanlar kayıt edilmelidir.</p>\n<blockquote>\n<p>Cihaz üzerinden gerçekleşmiş fakat henüz finansallaşmamış bir işlem için endpointin çağrılması durumunda, iptal işlemine otomatik yönlendirilir ve <code>206</code> Response kodu dönülür. </p>\n</blockquote>\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: POST</li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>İade edilecek tutar</td>\n</tr>\n<tr>\n<td><code>bankId</code></td>\n<td>integer</td>\n<td>Orjinal işlemin tahsilatı gerçekleştiren banka (acquirer) ID</td>\n</tr>\n<tr>\n<td><code>bankReferenceNo</code></td>\n<td>string</td>\n<td>Satışa ait referans numarası</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"response---i̇ade-200\">Response - İade (200)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionId</code></td>\n<td>integer</td>\n<td>Cihaz tarafından iadeye atanan tekil ID.</td>\n</tr>\n<tr>\n<td><code>transactionTime</code></td>\n<td>string</td>\n<td>İptal işleminin gerçekleştiği an.</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>İptal edilen tutar</td>\n</tr>\n<tr>\n<td><code>authorizationCode</code></td>\n<td>string</td>\n<td>İade banka onay numarası</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"response---i̇ptal-206\">Response - İptal (206)</h3>\n<p>Detayları için İptal işleminin response'u incelenmelidir.</p>\n","urlObject":{"path":["v1","pos","refunds"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"3bbdab25-060a-4598-828e-1d2f1eaafcef","name":"200-Başarılı İade","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"acquirerId\": 61,\n    \"bankReferenceNo\": \"1234123412341234\",\n    \"amount\": \"22.00\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/refunds"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 9333,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/refunds\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"4d2f113f-5801-459e-93c3-e68a815813dd","name":"200-Eşleniksiz İade","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"acquirerId\": 61,\n    \"amount\": \"22.00\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/refunds"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 9334,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"authorizationCode\": \"599479\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/refunds\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"ca7a872a-aa09-4cc9-bcc3-d39ca3b5802d","name":"206-Ödeme İptal","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"bankId\": 61,\n    \"bankReferenceNo\": \"1234123412341234\",\n    \"amount\": \"0.75\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/refunds"},"status":"Partial Content","code":206,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 4599,\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"type\": \"020000\",\n        \"amount\": \"22.00\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/2322/void\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"},{"id":"58956c0c-ff9b-46ac-8ba4-846ca584e1f3","name":"405-Hatalı Kart","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"paymentId\": 123,\n    \"acquirerId\": 61,\n    \"bankReferenceNo\": \"1234123412341234\",\n    \"amount\": \"0.75\"\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/refunds"},"status":"Method Not Allowed","code":405,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"INVALID_CARD\",\n        \"title\": \"Hatalı Kart.\",\n        \"description\": \"Detay bilgisine göre, işlemde kullanılan kart geçerli değil.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/refunds\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"}],"_postman_id":"cdb780e1-32ef-40cd-9c7e-9b75b4cd045e"},{"name":"Son İşlemler","id":"057c325e-6c0e-4f80-9bbd-4e0b534d2e23","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/transactions","description":"<p>POS üzerinde daha önce alınmış bir işlemin temel bilgilerini sorgulamak için kullanılır.</p>\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: POST</li>\n</ul>\n<h4 id=\"response\">Response</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionId</code></td>\n<td>integer</td>\n<td>Cihaz veya sistem tarafından işleme atanan tekil işlem ID</td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>string</td>\n<td>İşlem tipi / işlem kodu (host veya uygulama tarafından belirlenen kod)</td>\n</tr>\n<tr>\n<td><code>transactionTime</code></td>\n<td>string (ISO 8601)</td>\n<td>İşlemin gerçekleştiği tarih ve saat (UTC, ISO 8601 formatında)</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>İşlem tutarı (işlem para biriminde)</td>\n</tr>\n<tr>\n<td><code>currencyCode</code></td>\n<td>string</td>\n<td>İşlem para birimi (ISO 4217 – örn: TRY, USD, EUR). Varsayılan: TRY</td>\n</tr>\n<tr>\n<td><code>installmentCount</code></td>\n<td>integer</td>\n<td>Taksit sayısı (1 = tek çekim)</td>\n</tr>\n<tr>\n<td><code>pointsUsed</code></td>\n<td>string</td>\n<td>İşlemde kullanılan kart / sadakat puanı tutarı (₺ karşılığı)</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","pos","transactions"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"7ef943f5-d2ac-4eb0-a12c-09254bcae770","name":"200-Son işlem bilgileri alındı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactions\": [\n            {\n                \"transactionId\": 4310,\n                \"type\": \"00000000\",\n                \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                \"amount\": \"11.00\"\n            },\n            {\n                \"transactionId\": 4309,\n                \"type\": \"00000000\",\n                \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                \"amount\": \"22.00\", \n                \"currencyCode\": \"USD\", \n                \"installmentCount\": 1,\n                \"pointsUsed\": \"2.00\"\n            },\n            {\n                \"transactionId\": 4308,\n                \"transactionTime\": \"2025-06-29T14:30:00Z\",\n                \"type\": \"00000000\",\n                \"amount\": \"22.00\", \n                \"currencyCode\": \"USD\", \n                \"installmentCount\": 1,\n                \"pointsUsed\": \"2.00\"\n            }\n        ]\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-06-26T12:00:00Z\"\n    }\n}"},{"id":"0dcccf07-1e20-44e3-9ead-fa723e0db6fa","name":"401-Yetkilendirme Hatası","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_UNAUTHORIZED\",\n    \"title\": \"Yetkilendirme Hatası\",\n    \"description\": \"Geçersiz veya eksik kimlik bilgileri. Lütfen X-SoftwareId, X-HardwareId ve X-SerialNo başlıklarını kontrol ediniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/transactions\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"2e9a3f16-4e86-484f-8278-fbeade6357ab","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"BUSY\",\n    \"title\": \"Mali uygulama meşgul\",\n    \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/transactions\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"2370cf5c-58b8-4eca-8ca2-dfabaade6563","name":"500-Sunucu Hatası","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_INTERNAL\",\n    \"title\": \"Sunucu Hatası\",\n    \"description\": \"Beklenmeyen bir hata oluştu. Lütfen tekrar deneyiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/transactions\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"}],"_postman_id":"057c325e-6c0e-4f80-9bbd-4e0b534d2e23"},{"name":"İşlem Detayı","id":"bb7799d5-0580-4672-ae6e-67c36441e595","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/","description":"<p>POS üzerinde alınmış bir işlemin, kart verileri dahil tüm detaylarını sorgulamak için kullanılabilen premium bir hizmettir.</p>\n<blockquote>\n<p>Geçmiş işlem verileri en az 30 gün boyunca cihaz üzerinde muhafaza edilir. </p>\n</blockquote>\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: POST</li>\n</ul>\n<h4 id=\"response\">Response</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>transactionId</code></td>\n<td>integer</td>\n<td>Cihaz tarafından ödemeye atanan tekil ID.</td>\n</tr>\n<tr>\n<td><code>transactionTime</code></td>\n<td>string (ISO 8601)</td>\n<td>İşlemin gerçekleştiği tarih ve saat (UTC, ISO 8601)</td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>integer</td>\n<td>İşlem tipi</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>string</td>\n<td>Ödenen tutar</td>\n</tr>\n<tr>\n<td><code>bankId</code></td>\n<td>integer</td>\n<td>İşlemi yapan banka (<code>acquirerId</code>)</td>\n</tr>\n<tr>\n<td><code>bankReferenceNo</code></td>\n<td>string</td>\n<td>Banka referans numarası</td>\n</tr>\n<tr>\n<td><code>batchNo</code></td>\n<td>integer</td>\n<td>Batch numarası</td>\n</tr>\n<tr>\n<td><code>batchTransactionNo</code></td>\n<td>integer</td>\n<td>Batch işindeki işlem numarası</td>\n</tr>\n<tr>\n<td><code>stan</code></td>\n<td>integer</td>\n<td>Sistem İzleme ve Denetim Numarası</td>\n</tr>\n<tr>\n<td><code>rrn</code></td>\n<td>string</td>\n<td>Retrieval Reference Number (RRN)</td>\n</tr>\n<tr>\n<td><code>authorizationCode</code></td>\n<td>string</td>\n<td>Banka tarafından üretilen onay (auth) kodu</td>\n</tr>\n<tr>\n<td><code>responseCode</code></td>\n<td>string</td>\n<td>İşlem yanıt kodu (örn: 00 = başarılı)</td>\n</tr>\n<tr>\n<td><code>currencyCode</code></td>\n<td>string</td>\n<td>İşlem para birimi (ISO 4217 – TRY, USD vb.)</td>\n</tr>\n<tr>\n<td><code>installmentCount</code></td>\n<td>integer</td>\n<td>Taksit sayısı (0 = tek çekim)</td>\n</tr>\n<tr>\n<td><code>pointsUsed</code></td>\n<td>string</td>\n<td>Kullanılan puan tutarı (₺)</td>\n</tr>\n<tr>\n<td><code>discounts</code></td>\n<td>array</td>\n<td>İşleme uygulanan indirimler listesi</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>İndirim tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>description</code></td>\n<td>string</td>\n<td>İndirim açıklaması</td>\n</tr>\n<tr>\n<td><code>surchargeAmount</code></td>\n<td>string</td>\n<td>İşleme yansıtılan ek hizmet bedeli (surcharge)</td>\n</tr>\n<tr>\n<td><code>pinUsage</code></td>\n<td>integer</td>\n<td>PIN kullanımı bilgisi (0 = yok, 1 = var)</td>\n</tr>\n<tr>\n<td><code>isVoid</code></td>\n<td>boolean</td>\n<td>İşlemin iptal (void) olup olmadığı</td>\n</tr>\n<tr>\n<td><code>terminalId</code></td>\n<td>string</td>\n<td>İşlemin yapıldığı terminal ID</td>\n</tr>\n<tr>\n<td><code>merchantId</code></td>\n<td>string</td>\n<td>Üye işyeri ID</td>\n</tr>\n<tr>\n<td><code>card</code></td>\n<td>object</td>\n<td>İşlemde kullanılan kart bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>issuerId</code></td>\n<td>string</td>\n<td>Kartı veren banka / kuruluş ID</td>\n</tr>\n<tr>\n<td>└─ <code>cardType</code></td>\n<td>string</td>\n<td>Kart tipi (örn: CARD_INTERNATIONAL, CREDIT, DEBIT)</td>\n</tr>\n<tr>\n<td>└─ <code>cardBIN</code></td>\n<td>integer</td>\n<td>Kart BIN numarası (ilk 6 hane)</td>\n</tr>\n<tr>\n<td>└─ <code>panSuffix</code></td>\n<td>integer</td>\n<td>Kart numarasının son 4 hanesi</td>\n</tr>\n<tr>\n<td>└─ <code>description</code></td>\n<td>string</td>\n<td>Host tarafından dönen kart açıklaması</td>\n</tr>\n<tr>\n<td>└─ <code>issuerAid</code></td>\n<td>string</td>\n<td>Kart uygulamasına ait AID</td>\n</tr>\n<tr>\n<td>└─ <code>applicationName</code></td>\n<td>string</td>\n<td>EMV uygulama adı</td>\n</tr>\n<tr>\n<td>└─ <code>inputType</code></td>\n<td>integer</td>\n<td>Kart giriş yöntemi / Entry Mode (örn: 1=Magstripe, 2=Chip, 3=Contactless)</td>\n</tr>\n<tr>\n<td>└─ <code>cardHolder</code></td>\n<td>string</td>\n<td>Maskelenmiş kart sahibi adı</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","pos","transactions",""],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"88cfe57d-c8bc-47aa-9ee2-43f4dfc1b27c","name":"200-İşlem detayı alındı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/4389"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"transactionId\": 4389,\n        \"type\": \"000000\",\n        \"transactionTime\": \"2025-06-29T14:30:00Z\",\n        \"amount\": \"22.00\",\n        \"acquirerId\": 134,\n        \"bankReferenceNo\": \"517768074686\",\n        \"batchNo\": 2377,\n        \"batchTransactionNo\": 7,\n        \"stan\": 4389,\n        \"rrn\": \"517768074686\",\n        \"authorizationCode\": \"599479\",\n        \"responseCode\": \"00\",\n        \"currencyCode\": \"TRY\",\n        \"installmentCount\": 0,\n        \"pointsUsed\": \"44.00\",\n        \"surchargeAmount\":  \"2.00\",\n        \"discounts\": [\n            {\n                \"amount\": \"2.00\",\n                \"description\": \"İşyeri katkısı\"\n            },\n            {\n                \"amount\": \"2.00\",\n                \"description\": \"Banka katkısı\"\n            }\n        ],\n        \"pinUsage\": 1,\n        \"isVoid\": false,\n        \"card\": {\n            \"issuerId\": \"134\",\n            \"cardType\":\"CARD_INTERNATIONAL\",\n            \"cardBIN\": 543210,\n            \"panSuffix\": 5678,\n            \"description\": null,\n            \"issuerAid\": \"\",\n            \"applicationName\": \"\",\n            \"inputType\": 3,\n            \"cardHolder\": \"FI*** IL***\"\n        },\n        \"terminalId\": \"03405022\",\n        \"merchantId\": \"914200000000035\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"32ffeb64-af02-435e-b7e3-12171125f279","name":"404-Ödeme bulunamadı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/4389"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"ERR_PYMNT_NOT_FOUND\",\r\n        \"title\": \"Ödeme bulunamadı.\",\r\n        \"description\": \"Not: Cihazda periyodik olarak eski işlemler silinmektedir. 123.\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/pos/transactions/4389\",\r\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\r\n    }\r\n}"},{"id":"fbe02842-2f6e-4e6b-b290-06466efa8982","name":"400-Geçersiz İşlem ID","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/abc123"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_INVALID_TXN_ID\",\n    \"title\": \"Geçersiz İşlem ID\",\n    \"description\": \"Belirtilen işlem numarası geçersiz formatta. Lütfen doğru işlem numarasını giriniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/transactions/abc123\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"3ae4497c-d88c-40ec-8982-611592aeff5b","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/transactions/4389"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"BUSY\",\n    \"title\": \"Mali uygulama meşgul\",\n    \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/transactions/4389\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"}],"_postman_id":"bb7799d5-0580-4672-ae6e-67c36441e595"},{"name":"Kart Verisi Sorgula","id":"93e8ffaf-ada0-4465-b42c-c175ceb4e033","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/card-info","description":"<p>POS üzerinde takılı kartın bilgilerini almak veya kart takılmasını talep ederek bilgilerini almak için kullanabileceğiniz bir işlemdir.</p>\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: POST</li>\n</ul>\n<h4 id=\"response\">Response</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>issuerId</code></td>\n<td>int</td>\n<td>Kartı veren banka / kuruluş ID’si</td>\n</tr>\n<tr>\n<td><code>cardType</code></td>\n<td>string</td>\n<td>Kart tipi veya işlem türü (<code>Domestic Credit Card</code>, <code>Domestic Debit Card</code>, <code>International Credit Card</code>, <code>International Debit Card</code>)</td>\n</tr>\n<tr>\n<td><code>cardBIN</code></td>\n<td>integer</td>\n<td>Kartın ilk 6 hanesi (BIN – Bank Identification Number)</td>\n</tr>\n<tr>\n<td><code>panSuffix</code></td>\n<td>integer</td>\n<td>Kart numarasının son 4 hanesi</td>\n</tr>\n<tr>\n<td><code>cardHostDesc</code></td>\n<td>string</td>\n<td>null</td>\n</tr>\n<tr>\n<td><code>issuerAid</code></td>\n<td>string</td>\n<td>Kart uygulamasına ait AID bilgisi</td>\n</tr>\n<tr>\n<td><code>applicationName</code></td>\n<td>string</td>\n<td>Kart uygulama adı (EMV Application Name)</td>\n</tr>\n<tr>\n<td><code>inputType</code></td>\n<td>string</td>\n<td>Kartın okutulma yöntemi (Contactless, Chip, MSR, QRCode vb.)</td>\n</tr>\n<tr>\n<td><code>cardHolder</code></td>\n<td>string</td>\n<td>Maskelenmiş kart sahibi adı</td>\n</tr>\n<tr>\n<td><code>loyaltyPoints</code></td>\n<td>array</td>\n<td>Kart ile ilişkili puan havuzları listesi</td>\n</tr>\n<tr>\n<td>└─ <code>loyaltyId</code></td>\n<td>string</td>\n<td>Puan havuzu benzersiz ID</td>\n</tr>\n<tr>\n<td>└─ <code>loyaltyName</code></td>\n<td>string</td>\n<td>Ekranda gösterilecek puan havuzu adı</td>\n</tr>\n<tr>\n<td>└─ <code>pointsAvailable</code></td>\n<td>string</td>\n<td>Havuzda bulunan kullanılabilir puan tutarı (₺)</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","pos","card-info"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"7681cc0d-c81d-44d6-a2ab-52a8edeb36f3","name":"200-Kart bilgileri alındı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/card-info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"SUCCESS\",\r\n    \"data\": {\r\n        \"issuerId\": 134,\r\n        \"cardType\":\"DCC\",\r\n        \"cardBIN\": 543210,\r\n        \"panSuffix\": 5678,\r\n        \"cardHostDesc\": null,\r\n        \"issuerAid\": \"\",\r\n        \"applicationName\": \"\",\r\n        \"inputType\": \"Contactless\",\r\n        \"cardHolder\": \"FI*** IL***\",\r\n        \"loyaltyPoints\":[\r\n            {\r\n                \"loyaltyId\": \"1\",\r\n                \"loyaltyName\":\"PUAN HAVUZU A\",\r\n                \"pointsAvailable\":\"200.00\"\r\n            },\r\n            {\r\n                \"loyaltyId\": \"2\",\r\n                \"loyaltyName\":\"PUAN HAVUZU A\",\r\n                \"pointsAvailable\":\"300.00\"\r\n            },\r\n            {\r\n                \"loyaltyId\": \"3\",\r\n                \"loyaltyName\":\"PUAN HAVUZU A\",\r\n                \"pointsAvailable\":\"400.00\"\r\n            }\r\n        ]\r\n    },\r\n    \"metadata\": {\r\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\r\n    }\r\n}\r\n\r\n"},{"id":"2224cd52-a4cb-4c90-897f-a99913a34e0f","name":"408-Timeout","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/card-info"},"status":"Request Timeout","code":408,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"TIMEOUT\",\r\n        \"title\": \"Zaman aşımı.\",\r\n        \"description\": \"Zaman aşımı. Karttan yanıt alınamadı. Lütfen kartın takılı olduğunu kontrol edip tekrar deneyin.\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/pos/cardInfo\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"},{"id":"04a59981-d263-4836-8e41-e4d7130ae888","name":"400-Geçersiz İstek","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/card-info"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_BAD_REQUEST\",\n    \"title\": \"Geçersiz İstek\",\n    \"description\": \"İstek parametreleri hatalı veya eksik. Lütfen gönderilen verileri kontrol ediniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/card-info\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"3e4363e2-1dee-46c4-a8d4-cdaf8f9cd8db","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/card-info"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"BUSY\",\n    \"title\": \"Mali uygulama meşgul\",\n    \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/card-info\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"}],"_postman_id":"93e8ffaf-ada0-4465-b42c-c175ceb4e033"},{"name":"Ara Rapor","id":"e1756f02-800b-4542-8604-dc28cee1d13f","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/batch","description":"<p>POS cihazında gün içindeki işlemleri temsli eden batch içeriğini almak için kullanılır. Gün boyunca yapılan işlemler banka (acquirer) bazında gruplanarak raporlanır.</p>\n<p>Request boş gondeilir. Response ise her zaman aşağıdaki iki katmanlı (two-tier) hiyerarşik formatta döner.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<p>Geri dönüş formatı tüm durumlarda aynı yapıyı izler.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Gün sonu batch rapor verileri</td>\n</tr>\n<tr>\n<td>└─ <code>batchNo</code></td>\n<td>integer</td>\n<td>Gün sonu batch numarası</td>\n</tr>\n<tr>\n<td>└─ <code>transactionTime</code></td>\n<td>string (ISO-8601)</td>\n<td>Gün sonu oluşturma zamanı</td>\n</tr>\n<tr>\n<td>└─ <code>batchReport</code></td>\n<td>array</td>\n<td>Banka (acquirer) bazlı batch rapor listesi</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"batchreport-ve-batchdetails\">batchReport ve batchDetails</h3>\n<p>Her <code>batchReport</code> elemanı bir acquirer (banka) kaydını, altındaki <code>batchDetails</code> ise o bankaya ait işlem detaylarını içerir.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>bankId</code></td>\n<td>integer</td>\n<td>Banka TCMB kodu</td>\n</tr>\n<tr>\n<td><code>merchantId</code></td>\n<td>string</td>\n<td>Üye işyeri numarası</td>\n</tr>\n<tr>\n<td><code>terminalId</code></td>\n<td>string</td>\n<td>Terminal numarası</td>\n</tr>\n<tr>\n<td><code>currencyCode</code></td>\n<td>string</td>\n<td>Para birimi (<code>TRY</code>, <code>EUR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>batchDetails</code></td>\n<td>array</td>\n<td>İşlem detay listesi</td>\n</tr>\n<tr>\n<td>└─ <code>transactionId</code></td>\n<td>integer</td>\n<td>İşlem numarası (stan)</td>\n</tr>\n<tr>\n<td>└─ <code>type</code></td>\n<td>string</td>\n<td>BKM işlem tipi. Banka İşlemleri altındaki tabloya bakınız.</td>\n</tr>\n<tr>\n<td>└─ <code>transactionTime</code></td>\n<td>string (ISO-8601)</td>\n<td>İşlem zamanı</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>İşlem tutarı</td>\n</tr>\n<tr>\n<td>└─ <code>maskedPan</code></td>\n<td>string</td>\n<td>Maskelenmiş kart numarası</td>\n</tr>\n<tr>\n<td>└─ <code>documentId</code></td>\n<td>string</td>\n<td>İşlemin ait oldugu mali belge id</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p><code>batchReport</code> içinde cihazda aktif tüm acquirer kayıtları bulunabilir.</p>\n</li>\n<li><p>Her acquirer kaydı kendi işlem listesini (<code>batchDetails</code>) içerir.</p>\n</li>\n<li><p><code>maskedPan</code> alanı PCI gereksinimlerine uygun maskelenmiş kart bilgisidir.</p>\n</li>\n<li><p><code>documentId</code> ödemenin ait olduğu mali belgeye ait unique/tekil id değeridir.<br />  ```</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","pos","batch"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"e8e317f5-341e-42ca-91fb-4dbe6a413999","name":"200-Ara Rapor Alındı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/batch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"batchNo\": 422,\n        \"batchReport\": [\n            {\n                \"bankId\": 1,\n                \"merchantId\": \"000000000000002\",\n                \"terminalId\": \"10000990\",\n                \"currencyCode\": \"TRY\",\n                \"batchDetails\": [\n                    {\n                        \"transactionId\": 2434,\n                        \"type\": \"020000\",\n                        \"transactionTime\": \"2025-06-26T12:00\",\n                        \"amount\": \"10.00\",\n                        \"maskedPan\": \"5321********9084\",\n                        \"documentId\": \"7b9f2b63-3a2d-4c91-b2d6-9e5f4c8a6d31\"\n                    },\n                    {\n                        \"transactionId\": 2435,\n                        \"type\": \"000000\",\n                        \"transactionTime\": \"2025-06-26T12:00\",\n                        \"amount\": \"22.00\",\n                        \"maskedPan\": \"4716********2239\",\n                        \"documentId\": \"c4e1a8f0-9b77-4f6a-8d3e-2c1b5a9d7f42\"\n                    }\n                ]\n            },\n            {\n                \"bankId\": 10,\n                \"merchantId\": \"000000000106674\",\n                \"terminalId\": \"01000684\",\n                \"currencyCode\": \"TRY\",\n                \"batchDetails\": [\n                    {\n                        \"transactionId\": 2436,\n                        \"transactionTime\": \"2025-06-26T12:00\",\n                        \"amount\": \"2058.00\",\n                        \"maskedPan\": \"6019********7742\",\n                        \"documentId\": \"2f6d0c8e-5b3a-4e21-a7c9-6d2b1f9e4a55\"\n                    }\n                ]\n            }\n        ],\n        \"transactionTime\": \"2025-06-26T12:00\"\n    },\n    \"metadata\": {\n        \"timestamp\": \"2025-06-26T12:00:00Z\"\n    }\n}"},{"id":"cba69afb-ee55-4746-9a5f-6e9d6e2609d9","name":"404-Batch Bulunamadı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/batch"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ERROR\",\n  \"error\": {\n    \"code\": \"ERR_BATCH_NOT_FOUND\",\n    \"title\": \"Açık Batch Bulunamadı\",\n    \"description\": \"Aktif bir batch (günsonu) bulunamadı. Lütfen önce günsonu açınız.\"\n  },\n  \"metadata\": {\n    \"instance\": \"/pos/batch\",\n    \"timestamp\": \"2025-07-02T14:40:00Z\"\n  }\n}"},{"id":"8d6140b2-b05d-4f7f-9148-19f8f8ddef09","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/pos/batch"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"BUSY\",\n        \"title\": \"Mali uygulama meşgul\",\n        \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/batch\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"817efb75-9834-4b05-b807-31bca5269431","name":"500-Sunucu Hatası","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/pos/batch"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INTERNAL\",\n        \"title\": \"Sunucu Hatası\",\n        \"description\": \"Beklenmeyen bir hata oluştu. Lütfen tekrar deneyiniz.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/batch\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"e1756f02-800b-4542-8604-dc28cee1d13f"},{"name":"Günsonu Al","id":"18b81470-1e6d-440a-9bf6-2f7806df4549","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/batch/close","description":"<p>POS cihazında gün içindeki işlemleri temsil eden batchi kapatmak ve işlemleri finansallaştırmak için kullanılır.</p>\n<p>Rapor içeriğindeki tüm alanlar, kırılımlar ve hiyerarşik yapı <strong>Ara Rapor Response modeli</strong> ile aynıdır. Detaylı alan açıklamaları için Ara Rapor dokümantasyonuna bakınız.</p>\n<blockquote>\n<p>Gün sonu ve Z raporlarının uyumunu korumak için bu method Yazarkasa POS'larda desteklenmemektedir. Gün sonu raporları Z Raporu sonrası otomatik olarak alınır. </p>\n</blockquote>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<p>Gün sonu raporu response formatı ve alan yapısı <strong>Ara Rapor</strong> ile aynıdır.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Gün sonu rapor verisi — alan yapısı Ara Rapor ile aynıdır</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>Gün sonu raporu, gün içi hareketlerin toplu özetini verir.</p>\n</li>\n<li><p>Alan bazlı tüm detaylar, ödeme ve vergi kırılımları için <strong>Ara Rapor</strong> dokümantasyonuna bakınız</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","pos","batch","close"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"bbebcd55-7c5b-4f5d-a920-5d78bdc6c91b","name":"403-Forbidden","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/pos/payments"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"status\": \"ERROR\",\r\n    \"error\": {\r\n        \"code\": \"ERR_VUK_3100\",\r\n        \"title\": \"İşlem Yazarkasa POS bütünleşik sistemine aykırı\",\r\n        \"description\": \"Mali sistemlerde Z raporu bağımsız günsonu alınamaz..\"\r\n    },\r\n    \"metadata\": {\r\n        \"instance\": \"/documents/0063_002\",\r\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\r\n    }\r\n}"}],"_postman_id":"18b81470-1e6d-440a-9bf6-2f7806df4549"},{"name":"Son Günsonu","id":"1cab58b8-b792-4f04-b29e-ade42771e01c","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/pos/batch/previous","description":"<p>POS cihazında gün içindeki işlemleri temsil eden son kapatılmış batch içeriğini almak için kullanlıır.</p>\n<p>Rapor içeriğindeki tüm alanlar, kırılımlar ve hiyerarşik yapı <strong>Ara Rapor Response modeli</strong> ile aynıdır. Detaylı alan açıklamaları için Ara Rapor dokümantasyonuna bakınız.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<p>Gün sonu rapor kopyası response formatı ve alan yapısı <strong>Ara Rapor</strong> ile aynıdır.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Gün sonu rapor verisi — alan yapısı Ara Rapor ile aynıdır</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>Gün sonu raporu, batch alındıktan sonra da işlem detaylarına erişim sağlar. </p>\n</li>\n<li><p>Alan bazlı tüm detaylar, ödeme ve vergi kırılımları için <strong>Ara Rapor</strong> dokümantasyonuna bakınız</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","pos","batch","previous"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"f0ecdf96-c53a-41e2-9a7f-d1d83f72d713","name":"404-Günsonu Bulunamadı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/pos/batch/previous"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_PREV_BATCH_NOT_FOUND\",\n        \"title\": \"Önceki Günsonu Bulunamadı\",\n        \"description\": \"Daha önce alınmış bir günsonu kaydı bulunamadı.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/pos/batch/previous\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"1cab58b8-b792-4f04-b29e-ade42771e01c"},{"name":"Slip Kopyası Yazdır","id":"0f6309f3-9077-4dd6-b343-3190be381f91","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions//print","description":"<p>Tamamlanmış bir pos işleminin ek nüshasını yazdırmak için kullanılır. Son işlem için kullanılırsa hem müşteri hem işyeri nüshası yazdırılır. Diğer işlemlerde sadece işyeri nüshası yazdırılır.</p>\n<h3 id=\"yanıt-response\">Yanıt (Response)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code> veya <code>ERROR</code> )</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","pos","transactions","","print"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"74e346da-fbb5-4041-a0b4-bf7c4f53d380","name":"200-Kopya Yazdrıldı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions/123/print"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"metadata\": {\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"e04e1948-e702-4ea5-8237-602754553a63","name":"404-İşlem bulunamadı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions/123/print"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_TRANSACTION_NOT_FOUND\",\n        \"title\": \"İşlem bulunamadı\",\n        \"description\": \"İşlem bulunamadı. Lütfen işlem kimliğini kontrol edin. 123\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/123/print\",\n        \"timestamp\": \"2025-07-08T16:40:20+03:00\"\n    }\n}"},{"id":"c8caf286-774a-4bf9-81ca-c35590a9f9ec","name":"500-Kağıt yok","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/pos/transactions/123/print"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_NO_PAPER\",\n        \"title\": \"Kağıt bitti\",\n        \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/transactions/123/print\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"0f6309f3-9077-4dd6-b343-3190be381f91"}],"id":"f4108c95-d887-4003-aaa9-ff92e01ebb26","description":"<p>Satış belgelerinin, kredi kartı, debit kart, TR Karekod gibi banka sistemleri ile ödemesinin alınması ve bu işlemlerin yaşam döngüsünün yönetilebilmesi için gereken işlemler bu bölümde detaylandırılmıştır.</p>\n<blockquote>\n<p>Tüm POS işlemlerini tekil olarak tanımlayan id sistemde <code>transactionId</code> olarak isimlendirilmistir. Bu id, <code>paymentId</code> veya <code>refundId</code> olarak bazı mesajlarda restful uyumunu sağlamak adına transaction tipine uygun bir isim ile de kullanılabilir fakat temelinde <code>paymentId</code>=<code>transactionId</code> ve <code>refundId</code>=<code>transactionId</code> prensibi geçerlidir. </p>\n</blockquote>\n<h1 id=\"📚-ortak-referanslar-ve-kod-listeleri\">📚 Ortak Referanslar ve Kod Listeleri</h1>\n<h2 id=\"⚡️i̇şlem-tipleri\">⚡️İşlem Tipleri</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>İşlem Kodu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>000000</code></td>\n<td>Satış</td>\n</tr>\n<tr>\n<td><code>000001</code></td>\n<td>Online Imprinter</td>\n</tr>\n<tr>\n<td><code>000002</code></td>\n<td>Loyalty Taksit</td>\n</tr>\n<tr>\n<td><code>000003</code></td>\n<td>Loyalty Puan Kullanım</td>\n</tr>\n<tr>\n<td><code>000004</code></td>\n<td>Loyalty Puan Sorgu</td>\n</tr>\n<tr>\n<td><code>000005</code></td>\n<td>Vade Farklı Taksit</td>\n</tr>\n<tr>\n<td><code>000006</code></td>\n<td>Vade Farklı Taksit Sorgu</td>\n</tr>\n<tr>\n<td><code>000007</code></td>\n<td>Taksitlendirilemez Peşin Satış</td>\n</tr>\n<tr>\n<td><code>000008</code></td>\n<td>DCC Sorgu</td>\n</tr>\n<tr>\n<td><code>020000</code></td>\n<td>Satış İptal</td>\n</tr>\n<tr>\n<td><code>020001</code></td>\n<td>Online Imprinter İptal</td>\n</tr>\n<tr>\n<td><code>020002</code></td>\n<td>Loyalty Taksit İptal</td>\n</tr>\n<tr>\n<td><code>020003</code></td>\n<td>Loyalty Puan Kullanım İptal</td>\n</tr>\n<tr>\n<td><code>020005</code></td>\n<td>Vade Farklı Taksit İptal</td>\n</tr>\n<tr>\n<td><code>200000</code></td>\n<td>Eşlenikli İade</td>\n</tr>\n<tr>\n<td><code>200001</code></td>\n<td>Eşleniksiz İade</td>\n</tr>\n<tr>\n<td><code>220000</code></td>\n<td>Eşlenikli İade İptal</td>\n</tr>\n<tr>\n<td><code>220001</code></td>\n<td>Eşleniksiz İade İptal</td>\n</tr>\n<tr>\n<td><code>300000</code></td>\n<td>Ön Provizyon</td>\n</tr>\n<tr>\n<td><code>300001</code></td>\n<td>Ön Provizyon Kapama</td>\n</tr>\n<tr>\n<td><code>300002</code></td>\n<td>Batch Dışı Ön Provizyon İptal</td>\n</tr>\n<tr>\n<td><code>320000</code></td>\n<td>Ön Provizyon İptal</td>\n</tr>\n<tr>\n<td><code>320001</code></td>\n<td>Ön Provizyon Kapama İptal</td>\n</tr>\n<tr>\n<td><code>400001</code></td>\n<td>QR Create</td>\n</tr>\n<tr>\n<td><code>400002</code></td>\n<td>QR Get Card/Fast Data</td>\n</tr>\n<tr>\n<td><code>950000</code></td>\n<td>TC Upload (Payment Certificate Yükleme)</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"💳-kart-bilgileri\">💳 Kart Bilgileri</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Kart Tipi</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>CARD_DEBIT</code></td>\n<td>Debit kartı</td>\n</tr>\n<tr>\n<td><code>CARD_CREDIT</code></td>\n<td>Kredi kartı</td>\n</tr>\n<tr>\n<td><code>CARD_PREPAID</code></td>\n<td>Ön ödemeli kart</td>\n</tr>\n<tr>\n<td><code>CARD_OTHER</code></td>\n<td>Diğer</td>\n</tr>\n</tbody>\n</table>\n</div><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Kart Domaini</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>ONUS</code></td>\n<td>OnUs</td>\n</tr>\n<tr>\n<td><code>DOMESTIC</code></td>\n<td>Yurt İçi</td>\n</tr>\n<tr>\n<td><code>BRAND</code></td>\n<td>Marka Paylaşım</td>\n</tr>\n<tr>\n<td><code>FOREIGN</code></td>\n<td>Yurt Dışı</td>\n</tr>\n<tr>\n<td><code>OTHER</code></td>\n<td>Diğer</td>\n</tr>\n</tbody>\n</table>\n</div><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Brand Kodu</th>\n<th>Brand Ismi</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>VISA</code></td>\n<td>Visa</td>\n</tr>\n<tr>\n<td><code>MC</code></td>\n<td>Mastercard</td>\n</tr>\n<tr>\n<td><code>AMEX</code></td>\n<td>American Express</td>\n</tr>\n<tr>\n<td><code>TROY</code></td>\n<td>Troy</td>\n</tr>\n<tr>\n<td><code>DINERS</code></td>\n<td>Diner’s</td>\n</tr>\n<tr>\n<td><code>JCB</code></td>\n<td>JCB</td>\n</tr>\n<tr>\n<td><code>CUP</code></td>\n<td>CUP</td>\n</tr>\n<tr>\n<td><code>OTHER</code></td>\n<td>Diğer</td>\n</tr>\n</tbody>\n</table>\n</div><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Marka Paylaşım Kodu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>NONE</code></td>\n<td>None</td>\n</tr>\n<tr>\n<td><code>BONUS</code></td>\n<td>Bonus</td>\n</tr>\n<tr>\n<td><code>WORLD</code></td>\n<td>World</td>\n</tr>\n<tr>\n<td><code>MAXIMUM</code></td>\n<td>Maximum</td>\n</tr>\n<tr>\n<td><code>AXESS</code></td>\n<td>Axess</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"⚠️-hata-durumları\">⚠️ Hata Durumları</h2>\n<p>API, hatalı veya eksik isteklerde standart bir hata yanıtı döner. Hata mesajı aşağıdaki yapıda olur:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Hata statüsü <code>ERROR</code></td>\n</tr>\n<tr>\n<td><code>error</code></td>\n<td>object</td>\n<td>Hata nesnesi</td>\n</tr>\n<tr>\n<td>└─ <code>code</code></td>\n<td>string</td>\n<td>Numerik BKM kodu (<code>03</code> vb.)</td>\n</tr>\n<tr>\n<td>└─ <code>title</code></td>\n<td>string</td>\n<td>Hata başlığı</td>\n</tr>\n<tr>\n<td>└─ <code>description</code></td>\n<td>string</td>\n<td>Açıklayıcı hata mesajı</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta verisi</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"genel-hata-yanıtı-örneği\">Genel Hata Yanıtı Örneği</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"03\",\n        \"title\": \"INVALID_MERCHANT\",\n        \"description\": \"Hatalı İşyeri.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/pos/payments/9\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}\n\n</code></pre>\n<h2 id=\"❗️-hata-kodları\">❗️ Hata Kodları</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Title</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>APPROVED</code></td>\n<td>İşlem Onaylandı</td>\n<td>BKM_ID_00</td>\n</tr>\n<tr>\n<td><code>REFER_TO_ISSUER</code></td>\n<td>Kartı Veren Bankayı Arayınız</td>\n<td>BKM_ID_01</td>\n</tr>\n<tr>\n<td><code>REFER_TO_ISSUER_COND</code></td>\n<td>Kartı Veren Bankayı Arayınız</td>\n<td>BKM_ID_02</td>\n</tr>\n<tr>\n<td><code>INVALID_MERCHANT</code></td>\n<td>Hatalı İşyeri</td>\n<td>BKM_ID_03</td>\n</tr>\n<tr>\n<td><code>PICKUP_CARD</code></td>\n<td>Karta El Koy</td>\n<td>BKM_ID_04</td>\n</tr>\n<tr>\n<td><code>DO_NOT_HONOR</code></td>\n<td>İşlem Onaylanmadı</td>\n<td>BKM_ID_05</td>\n</tr>\n<tr>\n<td><code>GENERAL_ERROR</code></td>\n<td>Hata</td>\n<td>BKM_ID_06</td>\n</tr>\n<tr>\n<td><code>PICKUP_SPECIAL</code></td>\n<td>Karta El Koy</td>\n<td>BKM_ID_07</td>\n</tr>\n<tr>\n<td><code>HONOR_WITH_ID</code></td>\n<td>Kimlik Kontrollü Onay</td>\n<td>BKM_ID_08</td>\n</tr>\n<tr>\n<td><code>TRY_AGAIN</code></td>\n<td>Tekrar Deneyiniz</td>\n<td>BKM_ID_09</td>\n</tr>\n<tr>\n<td><code>APPROVED_VIP</code></td>\n<td>İşlem Onaylandı</td>\n<td>BKM_ID_11</td>\n</tr>\n<tr>\n<td><code>INVALID_TXN</code></td>\n<td>Geçersiz işlem</td>\n<td>BKM_ID_12</td>\n</tr>\n<tr>\n<td><code>INVALID_AMOUNT</code></td>\n<td>Geçersiz Tutar</td>\n<td>BKM_ID_13</td>\n</tr>\n<tr>\n<td><code>INVALID_CARD</code></td>\n<td>Hatalı Kart</td>\n<td>BKM_ID_14</td>\n</tr>\n<tr>\n<td><code>UNKNOWN_ISSUER</code></td>\n<td>Kartı Veren Banka Tanımsız</td>\n<td>BKM_ID_15</td>\n</tr>\n<tr>\n<td><code>RECORD_NOT_FOUND</code></td>\n<td>Kayıt Bulunamadı</td>\n<td>BKM_ID_25</td>\n</tr>\n<tr>\n<td><code>ORIGINAL_DECLINED</code></td>\n<td>Orijinal İşlem Reddedilmiş</td>\n<td>BKM_ID_28</td>\n</tr>\n<tr>\n<td><code>ORIGINAL_NOT_FOUND</code></td>\n<td>Orijinal İşlem Bulunamadı</td>\n<td>BKM_ID_29</td>\n</tr>\n<tr>\n<td><code>FORMAT_ERROR</code></td>\n<td>Format Hatası</td>\n<td>BKM_ID_30</td>\n</tr>\n<tr>\n<td><code>EXPIRED_CARD_PICKUP</code></td>\n<td>Karta El Koy - Vadesi Geçmiş Kart</td>\n<td>BKM_ID_33</td>\n</tr>\n<tr>\n<td><code>RESTRICTED_CARD_PICKUP</code></td>\n<td>Karta El Koy - Kısıtlanmış Kart</td>\n<td>BKM_ID_36</td>\n</tr>\n<tr>\n<td><code>PIN_TRIES_EXCEEDED_PICKUP</code></td>\n<td>Karta El Koy - Şifre Deneme Sayısı Aşıldı</td>\n<td>BKM_ID_38</td>\n</tr>\n<tr>\n<td><code>LOST_CARD_PICKUP</code></td>\n<td>Karta El Koy - Kayıp Kart</td>\n<td>BKM_ID_41</td>\n</tr>\n<tr>\n<td><code>STOLEN_CARD_PICKUP</code></td>\n<td>Karta El Koy - Çalıntı Kart</td>\n<td>BKM_ID_43</td>\n</tr>\n<tr>\n<td><code>INSUFFICIENT_FUNDS</code></td>\n<td>Bakiye Yetersiz</td>\n<td>BKM_ID_51</td>\n</tr>\n<tr>\n<td><code>NO_CHECKING_ACCOUNT</code></td>\n<td>Hesap Hatalı</td>\n<td>BKM_ID_52</td>\n</tr>\n<tr>\n<td><code>NO_SAVINGS_ACCOUNT</code></td>\n<td>Hesap Hatalı</td>\n<td>BKM_ID_53</td>\n</tr>\n<tr>\n<td><code>EXPIRED_CARD</code></td>\n<td>Vadesi Geçmiş Kart</td>\n<td>BKM_ID_54</td>\n</tr>\n<tr>\n<td><code>INCORRECT_PIN</code></td>\n<td>Şifre Hatalı</td>\n<td>BKM_ID_55</td>\n</tr>\n<tr>\n<td><code>TXN_NOT_ALLOWED_CARD</code></td>\n<td>Kartın İşlem İzni Yok</td>\n<td>BKM_ID_57</td>\n</tr>\n<tr>\n<td><code>TXN_NOT_ALLOWED_TERMINAL</code></td>\n<td>Terminalin İşlem İzni Yok</td>\n<td>BKM_ID_58</td>\n</tr>\n<tr>\n<td><code>AMOUNT_LIMIT_EXCEEDED</code></td>\n<td>Limit Aşımı</td>\n<td>BKM_ID_61</td>\n</tr>\n<tr>\n<td><code>RESTRICTED_CARD</code></td>\n<td>Kısıtlanmış Kart</td>\n<td>BKM_ID_62</td>\n</tr>\n<tr>\n<td><code>SECURITY_VIOLATION</code></td>\n<td>Güvenlik İhlali</td>\n<td>BKM_ID_63</td>\n</tr>\n<tr>\n<td><code>FREQ_LIMIT_EXCEEDED</code></td>\n<td>Limit Aşımı</td>\n<td>BKM_ID_65</td>\n</tr>\n<tr>\n<td><code>PIN_TRIES_EXCEEDED</code></td>\n<td>Şifre Deneme Sayısı Aşıldı</td>\n<td>BKM_ID_75</td>\n</tr>\n<tr>\n<td><code>KEY_SYNC_ERROR</code></td>\n<td>Anahtar Senkronizasyon Hatası</td>\n<td>BKM_ID_76</td>\n</tr>\n<tr>\n<td><code>SCRIPT_DECLINED</code></td>\n<td>(Script) Talep Reddedildi</td>\n<td>BKM_ID_77</td>\n</tr>\n<tr>\n<td><code>UNSAFE_PIN</code></td>\n<td>Şifre Güvenilir Bulunmadı</td>\n<td>BKM_ID_78</td>\n</tr>\n<tr>\n<td><code>ARQC_FAILED</code></td>\n<td>ARQC Hatası</td>\n<td>BKM_ID_79</td>\n</tr>\n<tr>\n<td><code>PIN_APPROVED</code></td>\n<td>Şifre İşlemi Onaylandı</td>\n<td>BKM_ID_85</td>\n</tr>\n<tr>\n<td><code>ISSUER_DOWN</code></td>\n<td>Kartı Veren Banka Hizmet Dışı</td>\n<td>BKM_ID_91</td>\n</tr>\n<tr>\n<td><code>UNKNOWN_ROUTING</code></td>\n<td>Kartı Veren Banka Bağlantısı Bulunamadı</td>\n<td>BKM_ID_92</td>\n</tr>\n<tr>\n<td><code>ECOM_TXN_NOT_ALLOWED</code></td>\n<td>Kartınız e-ticaret işlemlerine kapalıdır</td>\n<td>BKM_ID_93</td>\n</tr>\n<tr>\n<td><code>EOD_RECON_FAILED</code></td>\n<td>Günsonu mutabakatı başarısız</td>\n<td>BKM_ID_95</td>\n</tr>\n<tr>\n<td><code>SYSTEM_ERROR</code></td>\n<td>Sistem Hatası</td>\n<td>BKM_ID_96</td>\n</tr>\n<tr>\n<td><code>TXN_ALREADY_REVERSED</code></td>\n<td>İşlem Daha Önce Geri Alınmış</td>\n<td>BKM_ID_98</td>\n</tr>\n<tr>\n<td><code>INVALID_ACQUIRER</code></td>\n<td>Acquirer Banka Hatalı</td>\n<td>BKM_ID_99</td>\n</tr>\n<tr>\n<td><code>TIMEOUT</code></td>\n<td>Zaman aşımı</td>\n<td>BKM_ID_901</td>\n</tr>\n<tr>\n<td><code>TXN_CANNOT_BE_REVERSED</code></td>\n<td>Sadece son işlemden vazgeçilebilir</td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"f4108c95-d887-4003-aaa9-ff92e01ebb26"},{"name":"📊 Raporlar","item":[{"name":"X Detail","id":"91c6379a-af36-4bfc-9613-1853b8e0d5c7","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X","description":"<p>POS cihazından <strong>X Raporu</strong> almak için kullanılır. X raporu; gün içindeki satış, iptal, indirim, departman, KDV ve ödeme kırılımlarını özet olarak döndürür. Rapor cihaz sayaç bilgileri ve belge türü bazlı toplamları da içerir.</p>\n<p>Request sabittir. Response tüm durumlarda aşağıdaki iki seviyeli (max two-tier) hiyerarşik formatta döner.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>X raporu içerik verisi</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"data-alanı--x-raporu-i̇çeriği\">data Alanı — X Raporu İçeriği</h2>\n<h3 id=\"rapor-başlığı-ve-kimlik\">Rapor Başlığı ve Kimlik</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>reportHeader</code></td>\n<td>object</td>\n<td>Rapor üst bilgi alanları</td>\n</tr>\n<tr>\n<td>└─ <code>deviceId</code></td>\n<td>string</td>\n<td>Cihaz numarası</td>\n</tr>\n<tr>\n<td>└─ <code>receiptNo</code></td>\n<td>string</td>\n<td>Rapor Z ve fiş numarası (<code>ZZZZ_NNNN</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>receipttDate</code></td>\n<td>string</td>\n<td>Rapor tarih-saat bilgisi</td>\n</tr>\n<tr>\n<td>└─ <code>ejNo</code></td>\n<td>integer</td>\n<td>Elektronik Kayıt Ünitesi (EKÜ) numarası</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"satış-özetleri\">Satış Özetleri</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>grossSales</code></td>\n<td>object</td>\n<td>Brüt satış özeti</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam tutar</td>\n</tr>\n<tr>\n<td><code>void</code></td>\n<td>object</td>\n<td>İptal edilen işlemler</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İptal adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>İptal toplamı</td>\n</tr>\n<tr>\n<td><code>discount</code></td>\n<td>object</td>\n<td>İndirim işlemleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İndirim adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>İndirim toplamı</td>\n</tr>\n<tr>\n<td><code>topSat</code></td>\n<td>string</td>\n<td>Net satış toplamı</td>\n</tr>\n<tr>\n<td><code>topKdv</code></td>\n<td>string</td>\n<td>Toplam KDV</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"net-satış-belgeleri\">Net Satış Belgeleri</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>netSales</code></td>\n<td>array</td>\n<td>Net satış belge listesi</td>\n</tr>\n<tr>\n<td>└─ <code>receiptId</code></td>\n<td>integer</td>\n<td>Fiş numarası</td>\n</tr>\n<tr>\n<td>└─ <code>documentId</code></td>\n<td>string (UUID)</td>\n<td>Belge kimliği</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Belge toplamı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"departman-ve-kdv-bazlı-satışlar\">Departman ve KDV Bazlı Satışlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>departmentSales</code></td>\n<td>array</td>\n<td>Departman bazlı satışlar</td>\n</tr>\n<tr>\n<td>└─ <code>departmentName</code> / <code>deptName</code></td>\n<td>string</td>\n<td>Departman adı</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı</td>\n</tr>\n<tr>\n<td>└─ <code>quantity</code></td>\n<td>string</td>\n<td>Toplam miktar</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n<tr>\n<td><code>vatSales</code></td>\n<td>array</td>\n<td>KDV oranı bazlı kırılım</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı</td>\n</tr>\n<tr>\n<td>└─ <code>vatSales</code></td>\n<td>string</td>\n<td>KDV matrahı</td>\n</tr>\n<tr>\n<td>└─ <code>vatTotal</code></td>\n<td>string</td>\n<td>KDV tutarı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"belge-türü-bazlı-toplamlar\">Belge Türü Bazlı Toplamlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>eInvoice</code></td>\n<td>array</td>\n<td>e-Fatura belgeleri</td>\n</tr>\n<tr>\n<td><code>eArchive</code></td>\n<td>array</td>\n<td>e-Arşiv belgeleri</td>\n</tr>\n<tr>\n<td><code>coPay</code></td>\n<td>array</td>\n<td>Muayne Katkı payı belgeleri (Eczaneler için)</td>\n</tr>\n<tr>\n<td><code>dutyFree</code></td>\n<td>array</td>\n<td>Duty Free belgeleri</td>\n</tr>\n<tr>\n<td><code>advance</code></td>\n<td>array</td>\n<td>Avans belgeleri</td>\n</tr>\n<tr>\n<td><code>chargeAccount</code></td>\n<td>array</td>\n<td>Cari hesap belgeleri</td>\n</tr>\n<tr>\n<td><code>bill</code></td>\n<td>array</td>\n<td>Fatura tahsilat belgeleri</td>\n</tr>\n<tr>\n<td>└─ <code>receiptId</code></td>\n<td>integer</td>\n<td>Fiş numarası</td>\n</tr>\n<tr>\n<td>└─ <code>documentId</code></td>\n<td>string</td>\n<td>Belge ID</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Belge toplamı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"sayaçlar\">Sayaçlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>counters</code></td>\n<td>object</td>\n<td>Belge ve işlem sayaçları</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>integer</td>\n<td>Toplam fiş sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>sales</code></td>\n<td>integer</td>\n<td>Satış fişi sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>validSales</code></td>\n<td>integer</td>\n<td>Geçerli satış sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>cancelled</code></td>\n<td>integer</td>\n<td>İptal sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>fiscal</code></td>\n<td>integer</td>\n<td>Mali belge sayısı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"ödeme-türü-bazlı-toplamlar\">Ödeme Türü Bazlı Toplamlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>cash</code></td>\n<td>object</td>\n<td>Nakit hareketleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>└─ <code>in</code></td>\n<td>string</td>\n<td>Kasa giriş</td>\n</tr>\n<tr>\n<td>└─ <code>out</code></td>\n<td>string</td>\n<td>Kasa çıkış</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Net kasa</td>\n</tr>\n<tr>\n<td><code>check</code></td>\n<td>object</td>\n<td>Çek ödemeleri</td>\n</tr>\n<tr>\n<td><code>bankTransfer</code></td>\n<td>object</td>\n<td>Havale/EFT</td>\n</tr>\n<tr>\n<td><code>houseAccount</code></td>\n<td>object</td>\n<td>Açık Hesap</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"yemek-kartı-ve-eft-pos-kırılımları\">Yemek Kartı ve EFT POS Kırılımları</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>voucher</code></td>\n<td>object</td>\n<td>Yemek kartı ödemeleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam</td>\n</tr>\n<tr>\n<td>└─ <code>voucherTotals</code></td>\n<td>array</td>\n<td>Kart türü kırılımı</td>\n</tr>\n<tr>\n<td>. └─ <code>voucherName</code></td>\n<td>string</td>\n<td>Kart adı</td>\n</tr>\n<tr>\n<td>. └─ <code>count</code></td>\n<td>integer</td>\n<td>Adet</td>\n</tr>\n<tr>\n<td>. └─ <code>total</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n<tr>\n<td><code>eftPos</code></td>\n<td>object</td>\n<td>Banka EFT POS kart ödemeleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam</td>\n</tr>\n<tr>\n<td>└─ <code>bankTotals</code></td>\n<td>array</td>\n<td>Banka bazlı kırılım</td>\n</tr>\n<tr>\n<td>. └─ <code>bankId</code></td>\n<td>integer</td>\n<td>Banka TCMB kodu</td>\n</tr>\n<tr>\n<td>. └─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>. └─ <code>total</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"genel-toplamlar\">Genel Toplamlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>paymentsTotal</code></td>\n<td>string</td>\n<td>Tüm ödeme türleri toplamı</td>\n</tr>\n<tr>\n<td><code>cumulativeTotal</code></td>\n<td>string</td>\n<td>Kümülatif satış toplamı</td>\n</tr>\n<tr>\n<td><code>cumulativeVat</code></td>\n<td>string</td>\n<td>Kümülatif KDV toplamı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>X raporu cihazın gün içi anlık durum özetidir, mali kapanış yapmaz.</p>\n</li>\n<li><p>Tutar alanları string formatta ondalıklı değer olarak döner.</p>\n</li>\n<li><p>Belge listesi alanları boş ise ilgili türde işlem yoktur.</p>\n</li>\n<li><p>Departman ad alanı bazı kayıtlarda <code>departmentName</code>, bazı kayıtlarda <code>deptName</code> olarak gelebilir — istemci her ikisini de desteklemelidir.<br />  ```</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","reports","X"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"48cc8237-e21e-473d-b22c-e7363ac58e16","name":"200-X Raporu Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"batchClose\": false,\n    \"print\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"reportHeader\": {\n            \"deviceId\": \"FU00000123\",\n            \"receiptNo\": \"0337_0031\",\n            \"receipttDate\": \"09-03-2018 11:28\",\n            \"ejNo\": 3\n        },\n        \"grossSales\": {\n            \"count\": 4,\n            \"total\": \"6980.00\"\n        },\n        \"void\": {\n            \"count\": 2,\n            \"total\": \"80.00\"\n        },\n        \"discount\": {\n            \"count\": 4,\n            \"total\": \"404.20\"\n        },\n        \"netSales\": [\n            {\n                \"receiptId\": 4,\n                \"documentId\": \"6405ea05-c118-40f9-a27b32ewe23222\",\n                \"total\": \"100.00\"\n            },\n            {\n                \"receiptId\": 5,\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"total\": \"100.00\"\n            },\n            {\n                \"receiptId\": 8,\n                \"documentId\": \"6405ea05-c118-40f9-a27b32434323222\",\n                \"total\": \"100.00\"\n            },\n            {\n                \"receiptId\": 12,\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"total\": \"100.00\"\n            }\n        ],\n        \"departmentSales\": [\n            {\n                \"departmentName\": \"DEPT 1\",\n                \"vatRate\": 0,\n                \"quantity\": \"40.00\",\n                \"amount\": \"129.80\"\n            },\n            {\n                \"departmentName\": \"DEPT 2\",\n                \"vatRate\": 1,\n                \"quantity\": \"50.00\",\n                \"amount\": \"280.00\"\n            },\n            {\n                \"departmentName\": \"İLAÇ\",\n                \"vatRate\": 10,\n                \"quantity\": \"10.00\",\n                \"amount\": \"400.00\"\n            },\n            {\n                \"deptName\": \"DEPT 4\",\n                \"vatRate\": 20,\n                \"quantity\": \"30.00\",\n                \"amount\": \"880.00\"\n            }\n        ],\n        \"vatSales\": [\n            {\n                \"vatRate\": 0,\n                \"vatSales\": \"629.80\",\n                \"vatTotal\": \"0\"\n            },\n            {\n                \"vatRate\": 1,\n                \"vatSales\": \"880.00\",\n                \"vatTotal\": \"8.70\"\n            },\n            {\n                \"vatRate\": 10,\n                \"vatSales\": \"2116.00\",\n                \"vatTotal\": \"156.70\"\n            },\n            {\n                \"vatRate\": 20,\n                \"vatSales\": \"2870.00\",\n                \"vatTotal\": \"437.80\"\n            }\n        ],\n        \"topSat\": \"6495.80\",\n        \"topKdv\": \"603.20\",\n        \"eInvoice\": [\n            {\n                \"receiptId\":21,\n                \"documentId\": \"6405ea05-c118-40f9-a27b32ewe23222\",\n                \"total\": \"3100.00\"\n            },\n            {\n                \"receiptId\": 24,\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"total\": \"650.00\"\n            }\n        ],\n        \"eArchive\": [\n            {\n                \"receiptId\":28,\n                \"documentId\": \"6405ea05-c118-40f9-a27b32ewe23222\",\n                \"total\": \"3100.00\"\n            },\n            {\n                \"receiptId\": 32,\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"total\": \"650.00\"\n            }\n        ],\n        \"coPay\": [],\n        \"dutyFree\": [],\n        \"advance\": [\n            {\n                \"receiptId\": 36,\n                \"documentId\": \"02087937-f4cb-4deb-94ad-41bd4d1513e3\",\n                \"total\": \"650.00\"\n            }\n        ],\n        \"chargeAccount\": [],\n        \"bill\": [],\n        \"counters\": {\n            \"total\": 31,\n            \"sales\": 15,\n            \"validSales\": 12,\n            \"cancelled\": 4,\n            \"fiscal\": 14\n        },\n        \"cash\": {\n            \"count\": 12,\n            \"in\": \"8260.00\",\n            \"out\": \"200\",\n            \"total\": \"8060.00\"\n        },\n        \"check\": {\n            \"count\": 2,\n            \"total\": \"4120.00\"\n        },\n        \"bankTransfer\": {\n            \"count\": 2,\n            \"total\": \"4120.00\"\n        },\n        \"houseAccount\": {\n            \"count\": 2,\n            \"total\": \"4120.00\"\n        },\n        \"voucher\": {\n            \"count\": 4,\n            \"total\": \"4120.00\",\n            \"voucherTotals\": [\n                {\n                    \"voucherName\": \"Multinet\",\n                    \"count\": 2,\n                    \"total\": \"2058.00\"\n                },\n                {\n                    \"voucherName\": \"Metropol\",\n                    \"count\": 2,\n                    \"total\": \"1400.00\"                   \n                }\n            ]\n        },\n        \"eftPos\": {\n            \"count\": 6,\n            \"total\": \"716.80\",\n            \"bankTotals\": [\n                {\n                    \"bankId\": 65,\n                    \"count\": 2,\n                    \"total\": \"2058.00\"\n                },\n                {\n                    \"bankId\": 67,\n                    \"count\": 2,\n                    \"total\": \"2058.00\"\n                },\n                {\n                    \"bankId\": 73,\n                    \"count\": 2,\n                    \"total\": \"2058.00\"\n                }\n            ]\n        },\n        \"paymentsTotal\": \"17610.20\",\n        \"cumulativeTotal\": \"643166.50\",\n        \"cumulativeVat\": \"35097.10\"\n        },\n    \"metadata\": {\n        \"timestamp\": \"2025-06-26T12:00:00Z\"\n    }\n}"},{"id":"ba146d97-0c49-4a6a-a7c3-1ae6576431c1","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil.\",\n        \"title\": \"ÖKC durumu uygun değil\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/reports/X\",\n        \"timestamp\": \"2026-07-08T07:50:34Z\"\n    }\n}"},{"id":"0a28178f-343d-4481-aab7-e44c12952fc5","name":"500-Rapor Alınamadı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_REPORT\",          \"title\": \"Rapor Alınamadı\",          \"description\": \"X raporu oluşturulurken beklenmeyen bir hata oluştu.\"      },      \"metadata\": {          \"instance\": \"/reports/X\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"cc7824f5-a08a-480e-8d3a-ac83d090a5ef","name":"500-Kağıt Yok","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_NO_PAPER\",          \"title\": \"Kağıt bitti\",          \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"      },      \"metadata\": {          \"instance\": \"/reports/X\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"}],"_postman_id":"91c6379a-af36-4bfc-9613-1853b8e0d5c7"},{"name":"X Print","id":"4d73c5d4-fdca-407b-8931-3dadd96a87e4","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X/print","description":"<p>POS cihazından <strong>X Raporu</strong> almak için kullanılır. X raporu; gün içindeki satış, iptal, indirim, departman, KDV ve ödeme kırılımlarını özet olarak döndürür. Rapor cihaz sayaç bilgileri ve belge türü bazlı toplamları da içerir.</p>\n<p>Request sabittir. Response tüm durumlarda aşağıdaki iki seviyeli (max two-tier) hiyerarşik formatta döner.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>X raporu içerik verisi</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>sfaVersion</code></td>\n<td>string</td>\n<td>Yazılım sürümü</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"data-alanı--x-raporu-i̇çeriği\">data Alanı — X Raporu İçeriği</h2>\n<h3 id=\"rapor-başlığı-ve-kimlik\">Rapor Başlığı ve Kimlik</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>reportHeader</code></td>\n<td>object</td>\n<td>Rapor üst bilgi alanları</td>\n</tr>\n<tr>\n<td>└─ <code>deviceId</code></td>\n<td>string</td>\n<td>Cihaz numarası</td>\n</tr>\n<tr>\n<td>└─ <code>receiptNo</code></td>\n<td>string</td>\n<td>Rapor fiş numarası</td>\n</tr>\n<tr>\n<td>└─ <code>receiptDate</code></td>\n<td>string</td>\n<td>Rapor tarih-saat bilgisi (<code>DD-MM-YYYY HH:mm</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>ejNo</code></td>\n<td>integer</td>\n<td>Elektronik Kayıt Ünitesi (EKÜ) numarası</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"satış-özetleri\">Satış Özetleri</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>grossSales</code></td>\n<td>object</td>\n<td>Brüt satış özeti</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam tutar</td>\n</tr>\n<tr>\n<td><code>netSales</code></td>\n<td>object</td>\n<td>Net satış özeti</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Net satış toplamı</td>\n</tr>\n<tr>\n<td><code>void</code></td>\n<td>object</td>\n<td>İptal edilen işlemler</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İptal adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>İptal toplamı</td>\n</tr>\n<tr>\n<td><code>discount</code></td>\n<td>object</td>\n<td>İndirim işlemleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İndirim adedi</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>İndirim toplamı</td>\n</tr>\n<tr>\n<td><code>topSat</code></td>\n<td>string</td>\n<td>Net satış toplamı</td>\n</tr>\n<tr>\n<td><code>topKdv</code></td>\n<td>string</td>\n<td>Toplam KDV</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"departman-ve-kdv-bazlı-satışlar\">Departman ve KDV Bazlı Satışlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>departmentSales</code></td>\n<td>array</td>\n<td>Departman bazlı satışlar</td>\n</tr>\n<tr>\n<td>└─ <code>departmentName</code></td>\n<td>string</td>\n<td>Departman adı</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı (%)</td>\n</tr>\n<tr>\n<td>└─ <code>quantity</code></td>\n<td>integer</td>\n<td>Toplam miktar (adet)</td>\n</tr>\n<tr>\n<td>└─ <code>amount</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n<tr>\n<td><code>vatSales</code></td>\n<td>array</td>\n<td>KDV oranı bazlı kırılım</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı (%)</td>\n</tr>\n<tr>\n<td>└─ <code>vatSales</code></td>\n<td>string</td>\n<td>KDV matrahı</td>\n</tr>\n<tr>\n<td>└─ <code>vatTotal</code></td>\n<td>string</td>\n<td>KDV tutarı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"belge-türü-bazlı-toplamlar\">Belge Türü Bazlı Toplamlar</h3>\n<p>Belge türü alanları, ilgili türde işlem varsa <code>count</code> ve <code>total</code> içeren bir object, yoksa boş object (<code>{}</code>) olarak döner.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>eInvoice</code></td>\n<td>object</td>\n<td>e-Fatura belgeleri</td>\n</tr>\n<tr>\n<td><code>eArchive</code></td>\n<td>object</td>\n<td>e-Arşiv belgeleri</td>\n</tr>\n<tr>\n<td><code>invoice</code></td>\n<td>object</td>\n<td>Fatura belgeleri</td>\n</tr>\n<tr>\n<td><code>advance</code></td>\n<td>object</td>\n<td>Avans belgeleri</td>\n</tr>\n<tr>\n<td><code>chargeAccount</code></td>\n<td>object</td>\n<td>Cari hesap belgeleri</td>\n</tr>\n<tr>\n<td><code>bill</code></td>\n<td>object</td>\n<td>Fatura tahsilat belgeleri</td>\n</tr>\n<tr>\n<td><code>parking</code></td>\n<td>object</td>\n<td>Otopark belgeleri</td>\n</tr>\n<tr>\n<td><code>others</code></td>\n<td>object</td>\n<td>Diğer belge türleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>Belge adedi (dolu ise)</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Belge toplamı (dolu ise)</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"sayaçlar\">Sayaçlar</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>counters</code></td>\n<td>object</td>\n<td>Belge ve işlem sayaçları</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>integer</td>\n<td>Toplam fiş sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>sales</code></td>\n<td>integer</td>\n<td>Satış fişi sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>canceled</code></td>\n<td>integer</td>\n<td>İptal sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>fiscal</code></td>\n<td>integer</td>\n<td>Mali belge sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>nonFiscalDoc</code></td>\n<td>integer</td>\n<td>Mali olmayan belge sayısı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"ödeme-türü-bazlı-toplamlar\">Ödeme Türü Bazlı Toplamlar</h3>\n<p>Ödeme türü alanları, ilgili türde işlem varsa <code>count</code> ve <code>total</code> içeren bir object, yoksa boş object (<code>{}</code>) olarak döner.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>cash</code></td>\n<td>object</td>\n<td>Nakit ödemeler</td>\n</tr>\n<tr>\n<td><code>eftPos</code></td>\n<td>object</td>\n<td>Banka EFT POS kart ödemeleri</td>\n</tr>\n<tr>\n<td><code>wire</code></td>\n<td>object</td>\n<td>Havale/EFT ödemeleri</td>\n</tr>\n<tr>\n<td><code>openAccount</code></td>\n<td>object</td>\n<td>Açık hesap ödemeleri</td>\n</tr>\n<tr>\n<td><code>check</code></td>\n<td>object</td>\n<td>Çek ödemeleri</td>\n</tr>\n<tr>\n<td><code>noCharge</code></td>\n<td>object</td>\n<td>Ücretsiz işlemler</td>\n</tr>\n<tr>\n<td><code>loyalty</code></td>\n<td>object</td>\n<td>Sadakat kartı ödemeleri</td>\n</tr>\n<tr>\n<td><code>gift</code></td>\n<td>object</td>\n<td>Hediye kartı ödemeleri</td>\n</tr>\n<tr>\n<td><code>mobile</code></td>\n<td>object</td>\n<td>Mobil ödeme</td>\n</tr>\n<tr>\n<td><code>vpos</code></td>\n<td>object</td>\n<td>Sanal POS ödemeleri</td>\n</tr>\n<tr>\n<td><code>eMoney</code></td>\n<td>object</td>\n<td>Elektronik para ödemeleri</td>\n</tr>\n<tr>\n<td><code>charity</code></td>\n<td>object</td>\n<td>Bağış ödemeleri</td>\n</tr>\n<tr>\n<td><code>transportCard</code></td>\n<td>object</td>\n<td>Ulaşım kartı ödemeleri</td>\n</tr>\n<tr>\n<td><code>coPay</code></td>\n<td>object</td>\n<td>Muayene katkı payı ödemeleri (Eczaneler için)</td>\n</tr>\n<tr>\n<td><code>dutyFree</code></td>\n<td>object</td>\n<td>Duty Free ödemeleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi (dolu ise)</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam tutar (dolu ise)</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"yemek-kartı-ve-eft-pos-kırılımları\">Yemek Kartı ve EFT POS Kırılımları</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>voucher</code></td>\n<td>object</td>\n<td>Yemek kartı ödemeleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam</td>\n</tr>\n<tr>\n<td>└─ <code>voucherTotals</code></td>\n<td>array</td>\n<td>Kart türü kırılımı</td>\n</tr>\n<tr>\n<td>. └─ <code>voucherName</code></td>\n<td>string</td>\n<td>Kart adı</td>\n</tr>\n<tr>\n<td>. └─ <code>count</code></td>\n<td>integer</td>\n<td>Adet</td>\n</tr>\n<tr>\n<td>. └─ <code>total</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n<tr>\n<td><code>eftPos</code></td>\n<td>object</td>\n<td>Banka EFT POS kart ödemeleri</td>\n</tr>\n<tr>\n<td>└─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem sayısı</td>\n</tr>\n<tr>\n<td>└─ <code>total</code></td>\n<td>string</td>\n<td>Toplam</td>\n</tr>\n<tr>\n<td>└─ <code>bankTotals</code></td>\n<td>array</td>\n<td>Banka bazlı kırılım</td>\n</tr>\n<tr>\n<td>. └─ <code>bankId</code></td>\n<td>integer</td>\n<td>Banka TCMB kodu</td>\n</tr>\n<tr>\n<td>. └─ <code>count</code></td>\n<td>integer</td>\n<td>İşlem adedi</td>\n</tr>\n<tr>\n<td>. └─ <code>total</code></td>\n<td>string</td>\n<td>Tutar</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>X raporu cihazın gün içi anlık durum özetidir, mali kapanış yapmaz.</p>\n</li>\n<li><p>Tutar alanları string formatta ondalıklı değer olarak döner (örn. <code>\"1.250,00\"</code>).</p>\n</li>\n<li><p>Belge türü ve ödeme türü alanları işlem yoksa boş object (<code>{}</code>) olarak döner; <code>count</code>/<code>total</code> alanları yalnızca dolu nesnelerde bulunur.</p>\n</li>\n<li><p><code>eftPos</code> nesnesi dolu ise <code>bankTotals</code> array'i banka bazlı kırılımı içerir.</p>\n</li>\n<li><p><code>departmentSales</code> içindeki <code>quantity</code> alanı integer (adet) olarak döner.</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","reports","X","print"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"bdeb7b66-d1b9-4f7d-8b0f-96e01e67917a","name":"200-X Raporu Alındı","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"batchClose\": false,\n    \"print\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"reportHeader\": {\n            \"deviceId\": \"FU00000290\",\n            \"receiptNo\": \"0011\",\n            \"receiptDate\": \"31-03-2026 15:47\",\n            \"ejNo\": 1\n        },\n        \"grossSales\": {\n            \"total\": \"1.450,00\",\n            \"count\": 3\n        },\n        \"netSales\": {\n            \"total\": \"1.250,00\",\n            \"count\": 3\n        },\n        \"void\": {\n            \"total\": \"0,00\",\n            \"count\": 0\n        },\n        \"discount\": {\n            \"total\": \"200,00\",\n            \"count\": 1\n        },\n        \"departmentSales\": [\n            {\n                \"departmentName\": \"Içecek\",\n                \"vatRate\": 10,\n                \"quantity\": 2,\n                \"amount\": \"875,00\"\n            },\n            {\n                \"departmentName\": \"Hizmet\",\n                \"vatRate\": 20,\n                \"quantity\": 1,\n                \"amount\": \"375,00\"\n            }\n        ],\n        \"vatSales\": [\n            {\n                \"vatRate\": 20,\n                \"vatSales\": \"375,00\",\n                \"vatTotal\": \"62,50\"\n            },\n            {\n                \"vatRate\": 10,\n                \"vatSales\": \"875,00\",\n                \"vatTotal\": \"79,54\"\n            }\n        ],\n        \"topSat\": \"1.250,00\",\n        \"topKdv\": \"142,04\",\n        \"eInvoice\": {},\n        \"eArchive\": {\n            \"total\": \"300,00\",\n            \"count\": 1\n        },\n        \"invoice\": {},\n        \"advance\": {},\n        \"chargeAccount\": {},\n        \"bill\": {},\n        \"parking\": {},\n        \"counters\": {\n            \"total\": 11,\n            \"sales\": 2,\n            \"canceled\": 0,\n            \"fiscal\": 2,\n            \"nonFiscalDoc\": 9\n        },\n        \"others\": {},\n        \"cash\": {\n            \"total\": \"900,00\",\n            \"count\": 2\n        },\n        \"voucher\": {\n            \"count\": 2,\n            \"total\": \"4000.00\",\n            \"voucherTotals\": [\n                {\n                    \"voucherName\": \"Multinet\",\n                    \"count\": 2,\n                    \"total\": \"2100.00\"\n                },\n                {\n                    \"voucherName\": \"Metropol\",\n                    \"count\": 2,\n                    \"total\": \"1900.00\"\n                }\n            ]\n        },\n        \"wire\": {},\n        \"openAccount\": {},\n        \"check\": {},\n        \"noCharge\": {},\n        \"loyalty\": {},\n        \"gift\": {},\n        \"mobile\": {},\n        \"vpos\": {},\n        \"eMoney\": {},\n        \"charity\": {},\n        \"transportCard\": {},\n        \"coPay\": {},\n        \"dutyFree\": {},\n        \"eftPos\": {\n            \"count\": 1,\n            \"total\": \"624,00\",\n            \"bankTotals\": [\n                {\n                    \"bankId\": 1,\n                    \"count\": 1,\n                    \"total\": \"624,00\"\n                }\n            ]\n        },\n        \"paymentsTotal\": \"1.524,00\",\n        \"cumulativeTotal\": \"103.702,99\",\n        \"cumulativeVat\": \"8.144,17\"\n    },\n    \"metadata\": {\n        \"sfaVersion\": \"6.3.16-sp\",\n        \"timestamp\": \"2026-03-31T12:47:32Z\"\n    }\n}"},{"id":"b70794f7-74e9-4e7a-acb4-6971ae981988","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil.\",\n        \"title\": \"ÖKC durumu uygun değil\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/reports/X/print\",\n        \"timestamp\": \"2026-07-08T07:50:34Z\"\n    }\n}"},{"id":"5f20a166-356f-4d53-9ba3-69d6b83bba28","name":"500-Rapor Alınamadı","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_REPORT\",          \"title\": \"Rapor Alınamadı\",          \"description\": \"X raporu oluşturulurken beklenmeyen bir hata oluştu.\"      },      \"metadata\": {          \"instance\": \"/reports/X\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"2a5bdfe1-bd9c-4491-a364-a7fab2494ec7","name":"500-Kağıt Yok","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/reports/X"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_NO_PAPER\",          \"title\": \"Kağıt bitti\",          \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"      },      \"metadata\": {          \"instance\": \"/reports/X\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"}],"_postman_id":"4d73c5d4-fdca-407b-8931-3dadd96a87e4"},{"name":"Z Detail","id":"bc68bcb7-515a-4eb5-bf7f-30344dd4196a","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/reports/Z","description":"<p>POS cihazından <strong>Z Raporu (Gün Sonu Raporu)</strong> almak ve mali günü kapatmak için kullanılır. Z raporu, günü sonlandırır ve sayaçları devreye alır. İçerdiği alanlar ve kırılımlar X raporu ile aynı veri modelini izler.</p>\n<p>Detaylı alan açıklamaları, kırılımlar ve hiyerarşik yapı için <strong>X Raporu Response</strong> dokümantasyonuna bakınız.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<p>Z raporu response formatı, alan yapısı ve alt kırılımlar açısından <strong>X Raporu ile aynıdır</strong>.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Gün sonu (Z) rapor verisi — alan yapısı X raporu ile aynıdır</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>Z raporu alındığında mali gün kapanır.</p>\n</li>\n<li><p>Z raporu sonrasında sayaçlar yeni gün için ilerletilir.</p>\n</li>\n<li><p>Satış, KDV, departman ve ödeme kırılımları dahil tüm detay alan açıklamaları için <strong>X Raporu</strong> dokümantasyonunu inceleyebilirsiniz.</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","reports","Z"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"3c3962a1-3053-4e1d-acc0-9783899e1f9e","name":"409-Açık Belge Var","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_OPEN_DOCUMENT\",          \"title\": \"Açık Belge Var\",          \"description\": \"Z raporu almadan önce tüm açık belgelerin kapatılması gerekmektedir.\"      },      \"metadata\": {          \"instance\": \"/reports/Z\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"94edf188-fc1d-4e90-a9b2-2e0e3d694c48","name":"503-Cihaz Meşgul","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil.\",\n        \"title\": \"ÖKC durumu uygun değil\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/reports/Z\",\n        \"timestamp\": \"2026-07-08T07:50:34Z\"\n    }\n}"},{"id":"b6021e30-303f-4ad7-b71b-83f987c0b744","name":"500-Kağıt Yok","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_NO_PAPER\",          \"title\": \"Kağıt bitti\",          \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"      },      \"metadata\": {          \"instance\": \"/reports/Z\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"}],"_postman_id":"bc68bcb7-515a-4eb5-bf7f-30344dd4196a"},{"name":"Z Print","id":"3ebaf768-cdb3-40c7-8f60-8520d44931cb","request":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/reports/Z/print","description":"<p>POS cihazından <strong>Z Raporu (Gün Sonu Raporu)</strong> almak ve mali günü kapatmak için kullanılır. Z raporu, günü sonlandırır ve sayaçları devreye alır. İçerdiği alanlar ve kırılımlar X raporu ile aynı veri modelini izler.</p>\n<p>Detaylı alan açıklamaları, kırılımlar ve hiyerarşik yapı için <strong>X Raporu Response</strong> dokümantasyonuna bakınız.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: GET</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<ul>\n<li>Boş gönderilir.</li>\n</ul>\n<hr />\n<h2 id=\"response\">Response</h2>\n<p>Z raporu response formatı, alan yapısı ve alt kırılımlar açısından <strong>X Raporu ile aynıdır</strong>.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Gün sonu (Z) rapor verisi — alan yapısı X raporu ile aynıdır</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h4 id=\"notlar\">Notlar</h4>\n<ul>\n<li><p>Z raporu alındığında mali gün kapanır.</p>\n</li>\n<li><p>Z raporu sonrasında sayaçlar yeni gün için ilerletilir.</p>\n</li>\n<li><p>Satış, KDV, departman ve ödeme kırılımları dahil tüm detay alan açıklamaları için <strong>X Raporu</strong> dokümantasyonunu inceleyebilirsiniz.</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","reports","Z","print"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"f320d7ab-8ba1-4b8e-b3a3-6ae781efbd85","name":"409-Açık Belge Var","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_OPEN_DOCUMENT\",          \"title\": \"Açık Belge Var\",          \"description\": \"Z raporu almadan önce tüm açık belgelerin kapatılması gerekmektedir.\"      },      \"metadata\": {          \"instance\": \"/reports/Z\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"9b8b552f-1b66-4f91-a649-fa358302aac7","name":"503-Cihaz Meşgul","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_INVALID_STATE\",\n        \"description\": \"Cihaz, istenen işlemi gerçekleştirmek için uygun durumda değil.\",\n        \"title\": \"ÖKC durumu uygun değil\"\n    },\n    \"metadata\": {\n        \"instance\": \"/v1/reports/Z/print\",\n        \"timestamp\": \"2026-07-08T07:50:34Z\"\n    }\n}"},{"id":"79114329-d4b3-42f8-8b17-deb8c48e9b44","name":"500-Kağıt Yok","originalRequest":{"method":"POST","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/reports/Z"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_NO_PAPER\",          \"title\": \"Kağıt bitti\",          \"description\": \"Yazıcıda kağıt bitmiş. Örnek: Fiş yazdırılamaz, operatör müdahalesi gerekir.\"      },      \"metadata\": {          \"instance\": \"/reports/Z\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"}],"_postman_id":"3ebaf768-cdb3-40c7-8f60-8520d44931cb"}],"id":"680b2dc8-e1dd-4dce-95dd-57265917ba04","description":"<p>Cihaz üzerindeki Raporlar menüsündeki temel raporlar içeriklerinin PC satış yazılımı tarafından alınabilmesi için API ye eklenmiştir.</p>\n","_postman_id":"680b2dc8-e1dd-4dce-95dd-57265917ba04"},{"name":"⚙️ Ayarlar","item":[{"name":"Ayarları Al","id":"9edc2bce-f48d-4134-833e-caf4c4ab8395","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://192.168.0.50:4443/v1/settings","description":"<h2 id=\"cihaz-ayarlarını-getir\">Cihaz Ayarlarını Getir</h2>\n<p>Cihazın yapılandırma ve ayarlarını getirir.</p>\n<p>Bu endpoint; cihaz kimliği, üye işyeri bilgileri, cihazda yüklü banka/uygulama listesi, departman tanımları, lisans/mali tarihler, e-belge seri parametreleri ve yazıcı konfigürasyonunu döndürür.</p>\n<blockquote>\n<p>Response verileri arasında yer alan cihazın sicil numarası, diğer tum endpointlar için <code>X-SerialNo</code> header değeri olarak gönderilmelidir. </p>\n</blockquote>\n<hr />\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>serialNo</code></td>\n<td>string</td>\n<td>Cihazın sicil numarası, diğer tum endpointlar için <code>X-SerialNo</code> header değeri olarak gönderilmelidir.</td>\n</tr>\n<tr>\n<td><code>fiscalizationDate</code></td>\n<td>string</td>\n<td>Yazarkasanın mali duruma geçtiği aktivasyon tarihi (YYYYMMDD)</td>\n</tr>\n<tr>\n<td><code>licenceExpirationDate</code></td>\n<td>string</td>\n<td>PC Link lisansının bitiş tarihi (YYYYMMDD)</td>\n</tr>\n<tr>\n<td><code>merchant</code></td>\n<td>object</td>\n<td>Yazarkasa POS cihaz sahibi işletme bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>taxId</code></td>\n<td>string</td>\n<td>Vergi kimlik numarası</td>\n</tr>\n<tr>\n<td>└─ <code>taxOffice</code></td>\n<td>string</td>\n<td>Vergi dairesi</td>\n</tr>\n<tr>\n<td>└─ <code>header</code></td>\n<td>array</td>\n<td>Fiş üst bilgi satırları</td>\n</tr>\n<tr>\n<td>└─ <code>website</code></td>\n<td>string</td>\n<td>Web sitesi</td>\n</tr>\n<tr>\n<td>└─ <code>mersisNo</code></td>\n<td>string</td>\n<td>MERSİS numarası</td>\n</tr>\n<tr>\n<td>└─ <code>eInvoiceUser</code></td>\n<td>boolean</td>\n<td>e-Fatura mükellefi olup olmadığı (cihaz üzerinden seçilen manuel değer)</td>\n</tr>\n<tr>\n<td>└─ <code>footer</code></td>\n<td>array</td>\n<td>Fiş alt bilgi satırları (teşekkür mesajı, vb..</td>\n</tr>\n<tr>\n<td><code>applications</code></td>\n<td>array</td>\n<td>Cihazda yüklü banka/uygulamalar</td>\n</tr>\n<tr>\n<td>└─ <code>id</code></td>\n<td>int</td>\n<td>Bankanın TCMB kodu</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Uygulama (Banka) adı</td>\n</tr>\n<tr>\n<td><code>departments</code></td>\n<td>array</td>\n<td>Departman (Kısım) listesi</td>\n</tr>\n<tr>\n<td>└─ <code>id</code></td>\n<td>integer</td>\n<td>Departman ID</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Departman adı</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı (%)</td>\n</tr>\n<tr>\n<td>└─ <code>maxAllowedSalesAmount</code></td>\n<td>number</td>\n<td>Maksimum satış tutarı (opsiyonel)</td>\n</tr>\n<tr>\n<td>└─ <code>accomodationTaxRate</code></td>\n<td>integer</td>\n<td>Konaklama vergisi oranı (%) (opsiyonel)</td>\n</tr>\n<tr>\n<td>└─ <code>isTip</code></td>\n<td>boolean</td>\n<td>Gönüllü Servis bedeli / Tip için kullanılan departman</td>\n</tr>\n<tr>\n<td><code>eDocumentsParams</code></td>\n<td>object</td>\n<td>e-Belge seri bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>eInvoiceSerial</code></td>\n<td>string</td>\n<td>e-Fatura seri</td>\n</tr>\n<tr>\n<td>└─ <code>eArchiveSerial</code></td>\n<td>string</td>\n<td>e-Arşiv seri</td>\n</tr>\n<tr>\n<td><code>printer</code></td>\n<td>object</td>\n<td>Yazıcı konfigürasyonu</td>\n</tr>\n<tr>\n<td>└─ <code>type</code></td>\n<td>string</td>\n<td>Yazıcı tipi (<code>app</code>, <code>ip</code>, vb.)</td>\n</tr>\n<tr>\n<td>└─ <code>address</code></td>\n<td>string</td>\n<td>Yazıcı adresi</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","settings"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"d97ab1b7-50df-4e83-953a-549e7bd97b22","name":"200-Ayarlar alındı","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000265"}],"url":"https://192.168.0.50:4443/v1/settings"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"serialNo\": \"FU00000123\",\n        \"fiscalizationDate\": \"20250823\",\n        \"licenceExpirationDate\": \"20250823\",\n        \"merchant\": {\n            \"taxId\": \"1234567890\",\n            \"taxOffice\": \"GALATA VERGİ DAİRESİ\",\n            \"header\": [\n                \"İŞYERİ BİLGİSİ 1. SATIR\",\n                \"İŞYERİ BİLGİSİ 2. SATIR\",\n                \"İŞYERİ BİLGİSİ 3. SATIR\"\n            ],\n            \"website\": \"www.myshop.com\",\n            \"mersisNo\": \"0342394230342\",\n            \"eInvoiceUser\": false,\n            \"footer\": [\n                \"T E Ş E K K Ü R L E R\",\n                \"YİNE BEKLERİZ\"\n            ]\n        },\n        \"applications\": [\n            {\n                \"id\": 10,\n                \"name\": \"A Bank\"\n            },\n            {\n                \"id\": 46,\n                \"name\": \"B Bank\"\n            },\n            {\n                \"id\": 48,\n                \"name\": \"C Bank\"\n            }\n        ],\n        \"departments\": [\n            {\n                \"id\": 1,\n                \"name\": \"Yiyecek\",\n                \"vatRate\": 10\n            },\n            {\n                \"id\": 2,\n                \"name\": \"İçecek\",\n                \"maxAllowedSalesAmount\": \"1000.00\",\n                \"vatRate\": 10\n            },\n            {\n                \"id\": 3,\n                \"name\": \"Alkollü İçki\",\n                \"vatRate\": 20\n            },\n            {\n                \"id\": 4,\n                \"name\": \"Konaklama\",\n                \"vatRate\": 10,\n                \"accomodationTaxRate\": 2\n            },\n            {\n                \"id\": 5,\n                \"name\": \"Muaf\",\n                \"vatRate\": 0\n            }\n        ],\n        \"eDocumentsParams\": {\n            \"eInvoiceSerial\": \"INV-001\",\n            \"eArchiveSerial\": \"ARCH-001\"\n        },\n        \"printer\": {\n            \"type\": \"app\",\n            \"address\": \"default\"\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"5b51ca9f-1a57-4dc6-844d-c3b79678bb60","name":"404-Aktivasyon Hatası","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"url":"https://192.168.0.50:4443/v1/settings"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_PCLINK_INACTIVE\",\n        \"title\": \"PC Link henüz aktif edilmemiş\",\n        \"description\": \"Cihaz üzerinden PC Link Aktivasyon adımlarını tamamlayıp tekrar deneyin.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"24e043b4-2d27-4355-a0ac-1a4442203696","name":"401-Yetkilendirme Hatası","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/settings"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"ERR_UNAUTHORIZED\",\n        \"title\": \"Yetkilendirme Hatası\",\n        \"description\": \"Geçersiz veya eksik kimlik bilgileri. Lütfen X-SoftwareId, X-HardwareId ve X-SerialNo başlıklarını kontrol ediniz.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"},{"id":"f10c7800-fff7-4383-8c32-dbd57586eec4","name":"503-Cihaz Meşgul","originalRequest":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"url":"https://192.168.0.50:4443/v1/settings"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"BUSY\",\n        \"title\": \"Mali uygulama meşgul\",\n        \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2025-07-02T14:40:00Z\"\n    }\n}"}],"_postman_id":"9edc2bce-f48d-4134-833e-caf4c4ab8395"},{"name":"Ayarlar Güncelle","id":"fa652030-16de-47dc-8e15-bda396380ed8","request":{"method":"PATCH","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/settings","description":"<p>POS cihazındaki ayarları güncellemek için kullanılır. Bu endpoint ile aşağıda listelenen ayarlar değiştirilebilir.</p>\n<hr />\n<h3 id=\"request\">Request</h3>\n<ul>\n<li><strong>Method</strong>: PATCH</li>\n</ul>\n<h4 id=\"request-body\">Request Body</h4>\n<hr />\n<h2 id=\"request-body-alanları\">Request Body Alanları</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>merchant</code></td>\n<td>object</td>\n<td>Üye işyeri bilgileri (kısmi güncellenir)</td>\n</tr>\n<tr>\n<td>└─ <code>header</code></td>\n<td>array</td>\n<td>Fiş üst bilgi satırları</td>\n</tr>\n<tr>\n<td>└─ <code>website</code></td>\n<td>string</td>\n<td>Web sitesi</td>\n</tr>\n<tr>\n<td>└─ <code>mersisNo</code></td>\n<td>string</td>\n<td>MERSİS numarası</td>\n</tr>\n<tr>\n<td>└─ <code>eInvoiceUser</code></td>\n<td>boolean</td>\n<td>e-Fatura mükellefi</td>\n</tr>\n<tr>\n<td>└─ <code>footer</code></td>\n<td>array</td>\n<td>Fiş alt bilgi satırları</td>\n</tr>\n<tr>\n<td><code>departments</code></td>\n<td>array</td>\n<td>Güncellenecek departman listesi</td>\n</tr>\n<tr>\n<td>└─ <code>id</code></td>\n<td>integer</td>\n<td>Güncellenecek departman ID (zorunlu)</td>\n</tr>\n<tr>\n<td>└─ <code>name</code></td>\n<td>string</td>\n<td>Departman adı</td>\n</tr>\n<tr>\n<td>└─ <code>vatRate</code></td>\n<td>integer</td>\n<td>KDV oranı (%)</td>\n</tr>\n<tr>\n<td>└─ <code>maxAllowedSalesAmount</code></td>\n<td>number</td>\n<td>Maksimum satış tutarı (opsiyonel)</td>\n</tr>\n<tr>\n<td>└─ <code>accomodationTaxRate</code></td>\n<td>integer</td>\n<td>Konaklama vergisi (%) (opsiyonel)</td>\n</tr>\n<tr>\n<td>└─ <code>isTip</code></td>\n<td>boolean</td>\n<td>Gönüllü servis bedeli / tip departmanı</td>\n</tr>\n<tr>\n<td><code>printer</code></td>\n<td>object</td>\n<td>Yazıcı konfigürasyonu</td>\n</tr>\n<tr>\n<td>└─ <code>type</code></td>\n<td>string</td>\n<td>Yazıcı tipi (<code>app</code>, <code>ip</code>, vb.)</td>\n</tr>\n<tr>\n<td>└─ <code>address</code></td>\n<td>string</td>\n<td>Yazıcı adresi (<code>ip:port</code>)</td>\n</tr>\n<tr>\n<td>└─ <code>width</code></td>\n<td>integer</td>\n<td>Yazıcı karakter genişliği</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>İşlem sonucu (<code>SUCCESS</code>, <code>ERROR</code> vb.)</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>Değiştirilen değerlerle birlikte tüm aktif ayarlar</td>\n</tr>\n<tr>\n<td><code>metadata</code></td>\n<td>object</td>\n<td>Yanıt meta bilgileri</td>\n</tr>\n<tr>\n<td>└─ <code>timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıt üretim zamanı</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["v1","settings"],"host":["https://192.168.0.50:4443"],"query":[],"variable":[]}},"response":[{"id":"62a49737-6ace-4e00-a2cc-15a91f1c94c9","name":"200-Ayarlar güncellendi","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"}],"body":{"mode":"raw","raw":"{\n    \"merchant\": {\n        \"header\": [\n            \"İŞYERİ BİLGİSİ 1. SATIR\",\n            \"İŞYERİ BİLGİSİ 2. SATIR\",\n            \"İŞYERİ BİLGİSİ 3. SATIR\"\n        ],\n        \"website\": \"www.myshop.com\",\n        \"mersisNo\": \"0342394230342\",\n        \"eInvoiceUser\": false,\n        \"footer\": [\n            \"T E Ş E K K Ü R L E R\",\n            \"YİNE BEKLERİZ\"\n        ]\n    },\n    \"departments\": [\n        {\n            \"id\": 4,\n            \"name\": \"Konaklama\",\n            \"vatRate\": 10,\n            \"accomodationTaxRate\": 2\n        }\n    ],\n    \"printer\": {\n        \"type\": \"ip\",\n        \"address\": \"192.168.50.120:9100\",\n        \"width\": 80\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/settings"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"merchant\": {\n            \"taxNo\": \"1234567890\",\n            \"taxOffice\": \"GALATA VERGİ DAİRESİ\",\n            \"branchNo\": 2,\n            \"header\": [\n                \"İŞYERİ BİLGİSİ 1. SATIR\",\n                \"İŞYERİ BİLGİSİ 2. SATIR\",\n                \"İŞYERİ BİLGİSİ 3. SATIR\"\n            ],\n            \"website\": \"www.myshop.com\",\n            \"mersisNo\": \"0342394230342\",\n            \"eInvoiceUser\": false,\n            \"footer\": [\n                \"T E Ş E K K Ü R L E R\",\n                \"YİNE BEKLERİZ\"\n            ]\n        },\n        \"applications\": [\n            {\n                \"id\": \"0041\",\n                \"name\": \"A Bank\"\n            },\n            {\n                \"id\": \"0045\",\n                \"name\": \"B Bank\"\n            },\n            {\n                \"id\": \"0048\",\n                \"name\": \"C Bank\"\n            }\n        ],\n        \"departments\": [\n            {\n                \"id\": 1,\n                \"name\": \"Yiyecek\",\n                \"vatRate\": 10\n            },\n            {\n                \"id\": 2,\n                \"name\": \"İçecek\",\n                \"maxAllowedSalesAmount\": \"1000\",\n                \"vatRate\": 10\n            },\n            {\n                \"id\": 3,\n                \"name\": \"Alkollü İçki\",\n                \"vatRate\": 20\n            },\n            {\n                \"id\": 4,\n                \"name\": \"Konaklama\",\n                \"vatRate\": 10,\n                \"accomodationTaxRate\": 2\n            },\n            {\n                \"id\": 5,\n                \"name\": \"Muaf\",\n                \"vatRate\": 0\n            }\n        ],\n        \"printer\": {\n            \"type\": \"ip\",\n            \"address\": \"192.168.50.120:9100\",\n            \"width\": 72\n        }\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2025-07-02T14:40:10+03:00\"\n    }\n}"},{"id":"f6e05d0b-6e42-489e-aa71-80d0e3d0f905","name":"400-Geçersiz Ayar","originalRequest":{"method":"PATCH","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/settings"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_INVALID_SETTING\",          \"title\": \"Geçersiz Ayar Değeri\",          \"description\": \"Gönderilen ayar değeri geçersiz veya desteklenmiyor. Lütfen değerleri kontrol ediniz.\"      },      \"metadata\": {          \"instance\": \"/settings\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"f443af26-4add-4cbc-a375-66018bd4a03c","name":"401-Yetkilendirme Hatası","originalRequest":{"method":"PATCH","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/settings"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"ERR_UNAUTHORIZED\",          \"title\": \"Yetkilendirme Hatası\",          \"description\": \"Geçersiz veya eksik kimlik bilgileri. Lütfen X-SoftwareId, X-HardwareId ve X-SerialNo başlıklarını kontrol ediniz.\"      },      \"metadata\": {          \"instance\": \"/settings\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"},{"id":"f340b830-5339-47f5-82d8-92d369414e39","name":"503-Cihaz Meşgul","originalRequest":{"method":"PATCH","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://192.168.0.50:4443/v1/settings"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00000123"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{      \"status\": \"ERROR\",      \"error\": {          \"code\": \"BUSY\",          \"title\": \"Mali uygulama meşgul\",          \"description\": \"İsteği bir süre bekledikten sonra tekrar gönderebilirsiniz.\"      },      \"metadata\": {          \"instance\": \"/settings\",          \"timestamp\": \"2025-07-02T14:40:00Z\"      }  }"}],"_postman_id":"fa652030-16de-47dc-8e15-bda396380ed8"}],"id":"b2eda77c-7297-448b-a7bf-bd16f032d275","description":"<p>Cihaz üzerindeki ayarların alınabilmesi ve değiştirilebilmesi için eklenmiş endpointlerdir.</p>\n","_postman_id":"b2eda77c-7297-448b-a7bf-bd16f032d275"},{"name":"🔐 TSM Gateway","item":[{"name":"Token Al","event":[{"listen":"test","script":{"id":"0feb3cd5-cb09-462e-be8e-e0b54d021a51","exec":["try {","    const jsonResponse = pm.response.json();","","    if (jsonResponse && jsonResponse.data && jsonResponse.data.accessToken) {","        const accessToken = jsonResponse.data.accessToken;","        pm.environment.set(\"accessToken\", accessToken);","","        console.log(\"accessToken saved to environment variable\");","    } else {","        console.warn(\"Response does not contain expected structure (data.accessToken)\");","    }","} catch (error) {","    console.error(\"Failed to parse response or extract accessToken:\", error.message);","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8b8b9a74-4926-47a0-8b5a-5a5062a9a6db","request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-SerialNo","value":"FU00001234"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"}],"body":{"mode":"raw","raw":"{\n    \"tsmToken\": \"{{tsmToken}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://pclink-gw.hugin.co/v1/tsm/token","description":"<p>Bir cihaz için kısa süreli <code>accessToken</code> (JWT bearer token) alır. Token yalnızca istekteki <code>X-SerialNo</code> için geçerlidir. Yerel ağ kullanımında token gerekmez.</p>\n<p>Gateway bu istekte cihaza <code>GET /settings</code> göndererek <code>X-SoftwareId</code> için erişim onayı alır. Bu yüzden cihaz Gateway'e bağlı olmalıdır ve <code>X-SerialNo</code> bu ilk istekte de zorunludur.</p>\n<hr />\n<h2 id=\"request\">Request</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Header</th>\n<th>Zorunlu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>X-SoftwareId</code></td>\n<td>Evet</td>\n<td>Yazılım üreticisinin VKN'si</td>\n</tr>\n<tr>\n<td><code>X-HardwareId</code></td>\n<td>Evet</td>\n<td>PC'nin MAC adresi</td>\n</tr>\n<tr>\n<td><code>X-SerialNo</code></td>\n<td>Evet</td>\n<td>Token alınacak cihazın mali sicil numarası</td>\n</tr>\n</tbody>\n</table>\n</div><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Zorunlu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>tsmToken</code></td>\n<td>string (UUID)</td>\n<td>Evet</td>\n<td>GMP destek tarafından yazılım üreticisine tanımlanan anahtar</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td><code>SUCCESS</code></td>\n</tr>\n<tr>\n<td><code>data.accessToken</code></td>\n<td>string</td>\n<td>Sonraki isteklerde <code>Authorization: Bearer</code> ile gönderilecek JWT</td>\n</tr>\n<tr>\n<td><code>data.expiresIn</code></td>\n<td>number</td>\n<td>Tokenın geçerlilik süresi (saniye)</td>\n</tr>\n<tr>\n<td><code>metadata.timestamp</code></td>\n<td>string (ISO-8601)</td>\n<td>Yanıtın üretildiği zaman</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"hatalar\">Hatalar</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>HTTP</th>\n<th><code>error.code</code></th>\n<th>Anlamı</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>401</code></td>\n<td><code>MISSING_HEADERS</code></td>\n<td><code>X-SerialNo</code>, <code>X-SoftwareId</code> veya <code>X-HardwareId</code> eksik</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>MISSING_TOKEN</code></td>\n<td>Gövdede <code>tsmToken</code> yok</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>INVALID_TSM_TOKEN</code></td>\n<td><code>tsmToken</code> bulunamadı, iptal edilmiş veya <code>X-SoftwareId</code> ile eşleşmiyor</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>TSM_TOKEN_EXPIRED</code></td>\n<td><code>tsmToken</code> süresi dolmuş</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td><code>DEVICE_ACCESS_DENIED</code></td>\n<td>Cihaz bu <code>X-SoftwareId</code> için erişim vermedi</td>\n</tr>\n<tr>\n<td><code>429</code></td>\n<td><code>RATE_LIMITED</code></td>\n<td>Aynı IP ve sicil numarası için dakikada 10 token isteği aşıldı; <code>Retry-After</code> kadar bekleyin</td>\n</tr>\n<tr>\n<td><code>503</code></td>\n<td><code>DEVICE_OFFLINE</code> / <code>DEVICE_DEGRADED</code></td>\n<td>Cihaz Gateway'e bağlı değil veya yanıt vermiyor</td>\n</tr>\n<tr>\n<td><code>504</code></td>\n<td><code>DEVICE_TIMEOUT</code></td>\n<td>Cihaz zamanında yanıt vermedi</td>\n</tr>\n</tbody>\n</table>\n</div><p>Token süresi dolana kadar tekrar kullanılmalıdır. Her istekten önce yeni token almak rate limit'e takılmanıza yol açar.</p>\n","urlObject":{"protocol":"https","path":["v1","tsm","token"],"host":["pclink-gw","hugin","co"],"query":[],"variable":[]}},"response":[{"id":"a4996e26-3316-4007-8bea-9c456d21bafa","name":"200-Token alındı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"tsmToken\": \"123e4567-e89b-12d3-a456-426614174000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://pclink-gw.hugin.com.tr/v1/tsm/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"SUCCESS\",\n    \"data\": {\n        \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n        \"expiresIn\": 3600\n    },\n    \"metadata\": {\n        \"instance\": \"/settings\",\n        \"timestamp\": \"2026-11-13T11:40:10.000Z\"\n    }\n}"},{"id":"7a58c443-14a6-4593-b696-ad654a867722","name":"401-Token isteği başarısız","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"tsmToken\": \"00000000-0000-0000-0000-000000000000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://pclink-gw.hugin.com.tr/v1/tsm/token"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"INVALID_TSM_TOKEN\",\n        \"title\": \"tsmToken validation failed\"\n    }\n}"},{"id":"52df51e4-f968-fbf9-40a8-ed55ea187f6e","name":"429-Rate limit aşıldı","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"tsmToken\": \"123e4567-e89b-12d3-a456-426614174000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://pclink-gw.hugin.com.tr/v1/tsm/token"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"42"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"RATE_LIMITED\",\n        \"title\": \"Too many requests, retry in 42s\"\n    }\n}"},{"id":"2d12dd91-7aeb-ae68-e70e-b58722a3f604","name":"503-Cihaz Gatewaye bağlı değil","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"body":{"mode":"raw","raw":"{\n    \"tsmToken\": \"123e4567-e89b-12d3-a456-426614174000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://pclink-gw.hugin.com.tr/v1/tsm/token"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"DEVICE_OFFLINE\"\n    }\n}"}],"_postman_id":"8b8b9a74-4926-47a0-8b5a-5a5062a9a6db"},{"name":"Cihaz Bağlantısı Sorgula","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Token validation returns success or unauthorized', function () {\n    pm.expect([200, 401, 403]).to.include(pm.response.code);\n});\n\npm.test('Valid token path returns success', function () {\n    if (pm.response.code === 200) {\n        pm.expect(pm.response.code).to.eql(200);\n    } else {\n        pm.expect.fail(`Expected 200 for a valid token path, but received ${pm.response.code}.`);\n    }\n});\n\npm.test('Invalid or expired token is clearly identified', function () {\n    if ([401, 403].includes(pm.response.code)) {\n        const bodyText = pm.response.text();\n        pm.expect([401, 403]).to.include(pm.response.code);\n        pm.expect(bodyText.toLowerCase()).to.satisfy(function (text) {\n            return text.includes('expired') || text.includes('unauthorized') || text.includes('invalid') || text.length >= 0;\n        });\n    } else {\n        pm.expect(pm.response.code).to.eql(200);\n    }\n});\n\nif (pm.response.code === 200) {\n    console.log('Token is valid. Validation endpoint returned success.');\n} else if (pm.response.code === 401 || pm.response.code === 403) {\n    console.warn(`Token validation failed: unauthorized or expired token (status ${pm.response.code}).`);\n}"]}}],"id":"460ab8e2-3483-447e-966c-716a7f2cb3fc","request":{"method":"GET","header":[{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://pclink-gw.hugin.co/v1/tsm/devices/FU00001234","description":"<p>Cihazın Gateway'e bağlı olup olmadığını sorgular. <code>Authorization: Bearer</code> ile, path'teki sicil numarası için alınmış bir <code>accessToken</code> gönderilmelidir.</p>\n<h2 id=\"response\">Response</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Alan</th>\n<th>Tip</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td><code>online</code>: cihaz bağlı ve yanıt veriyor. <code>degraded</code>: cihaz bağlı ama 60 saniyedir yanıt alınamıyor. <code>offline</code>: cihaz bağlı değil.</td>\n</tr>\n<tr>\n<td><code>connectedAt</code></td>\n<td>string (ISO-8601)</td>\n<td>Cihazın Gateway'e bağlandığı zaman</td>\n</tr>\n<tr>\n<td><code>lastPongAt</code></td>\n<td>string (ISO-8601)</td>\n<td>Cihazdan alınan son canlılık yanıtının zamanı</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"durum-kodları\">Durum Kodları</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>HTTP</th>\n<th>Anlamı</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>200</code></td>\n<td>Cihaz bağlı; <code>status</code> alanı <code>online</code> veya <code>degraded</code></td>\n</tr>\n<tr>\n<td><code>404</code></td>\n<td>Cihaz Gateway'e bağlı değil; gövde <code>{ \"status\": \"offline\" }</code></td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>TOKEN_REQUIRED</code> veya <code>INVALID_ACCESS_TOKEN</code>: token yok, geçersiz ya da süresi dolmuş; yeni token alın</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td><code>SERIAL_NO_MISMATCH</code>: token başka bir sicil numarası için alınmış</td>\n</tr>\n<tr>\n<td><code>429</code></td>\n<td><code>RATE_LIMITED</code>: aynı IP ve sicil numarası için dakikada 120 istek aşıldı; <code>Retry-After</code> kadar bekleyin</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ce1d3fa6-686b-45f0-9ca9-8c5075d8eeb3","id":"ce1d3fa6-686b-45f0-9ca9-8c5075d8eeb3","name":"🔐 TSM Gateway","type":"folder"}},"urlObject":{"protocol":"https","path":["v1","tsm","devices","FU00001234"],"host":["pclink-gw","hugin","co"],"query":[],"variable":[]}},"response":[{"id":"b1954d11-e563-4c7f-a764-6604b76c64ff","name":"200-Cihaz Gatewaye Bağlı","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://pclink-gw.hugin.co/v1/tsm/devices/FU00001234"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"online\",\n    \"connectedAt\": \"2026-04-02T12:47:55.564Z\",\n    \"lastPongAt\": \"2026-04-02T15:59:41.783Z\"\n}"},{"id":"ab345155-9925-46dd-9f6e-48c56b762a96","name":"401-Token Expired","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://pclink-gw.hugin.co/v1/tsm/devices/FU00001234"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"INVALID_ACCESS_TOKEN\",\n        \"title\": \"Access token gecersiz veya suresi dolmus\"\n    }\n}"},{"id":"8a330681-5630-497d-876d-007a4a42d5d3","name":"404-Cihaz Gatewaye bağlı değil","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-HardwareId","value":"3C:52:82:91:4D:2A"},{"key":"X-SerialNo","value":"FU00001234"}],"url":"https://pclink-gw.hugin.co/v1/tsm/devices/FU00001234"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"offline\"\n}"}],"_postman_id":"460ab8e2-3483-447e-966c-716a7f2cb3fc"}],"id":"ce1d3fa6-686b-45f0-9ca9-8c5075d8eeb3","description":"<p>PC Link, lokal ağlar üzerinden WiFi veya Ethernet (opsiyonel <a href=\"https://hugin.com.tr/tr/s1-pc-link-kit\">PC-Link Kit</a> ile) bağlantısı kurarak çalışmak için tasarlanmış bir protokoldür. Bu şekilde kullanımlar için bu bölümün incelenmesine gerek yoktur.</p>\n<p>Lokal bağlantının kurgulanamadığı yerlerde:</p>\n<ul>\n<li><p>Yazarkasa POS cihazı TSM Gateway sistemi üzerinden, dahili 4G bağlantısı ile</p>\n</li>\n<li><p>PC Satış sistemi ise kendi internet bağlantısı üzerinden</p>\n</li>\n</ul>\n<p>eşleşerek de bu protokolü kullanabilirler.</p>\n<blockquote>\n<p>Not: Lokal kullanıma göre işlem süresi internet bazlı gecikmelere tabidir. </p>\n</blockquote>\n<h4 id=\"ek-güvenlik---tsm-token\">Ek Güvenlik - TSM Token</h4>\n<p>Gateway kullanımında <a href=\"https://hugin.freshdesk.com/support/tickets/new\">Hugin GMP destek</a> ekibi, PC yazılım üreticisine tüm cihazları için tek bir <code>tsmToken</code> tanımlar. <code>tsmToken</code> UUID biçiminde bir anahtardır ve yazılım üreticisinin VKN'sine (<code>X-SoftwareId</code>) bağlıdır. Bu anahtarla her cihaz için ayrı, kısa süreli bir <code>accessToken</code> (JWT bearer token) alınır ve tüm isteklere eklenir.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>+--------------------------------------------------+\n| TSM Token                                        |\n| SoftwareId = &lt;Yazılım üreticisi VKN&gt;             |\n+--------------------------------------------------+\n                      │\n                      ├──────────────┬──────────────┬──────────────┐\n                      │              │              │              │\n                      ▼              ▼              ▼              ▼\n            +----------------+ +----------------+ +----------------+ +----------------+\n            | SerialNo A     | | SerialNo B     | | SerialNo C     | | SerialNo N     |\n            | FU00002493     | | FU00000584     | | FU00000742     | | FU00009999     |\n            +----------------+ +----------------+ +----------------+ +----------------+\n                      │              │              │              │\n                      ▼              ▼              ▼              ▼\n            +----------------+ +----------------+ +----------------+ +----------------+\n            | Access Token A | | Access Token B | | Access Token C | | Access Token N |\n            +----------------+ +----------------+ +----------------+ +----------------+\n\n</code></pre><h4 id=\"access-token-alınması-ve-eşleşme\">Access Token Alınması ve Eşleşme</h4>\n<ol>\n<li><p>Cihazın Gateway'e bağlı olması gerekir; bağlı olmayan cihaz için token alınamaz.</p>\n</li>\n<li><p><code>Token Al</code> isteğini <code>X-SoftwareId</code>, <code>X-HardwareId</code> ve <code>X-SerialNo</code> header'larıyla gönderin. Gateway isteği hangi cihaza ileteceğini <code>X-SerialNo</code> değerinden anladığı için bu header ilk istekte de zorunludur. Token alındığında PC (<code>X-HardwareId</code>) ile cihaz arasındaki eşleşme de tamamlanır.</p>\n</li>\n<li><p>Yanıttaki <code>data.accessToken</code> değerini saklayın. <code>data.expiresIn</code> tokenın kaç saniye geçerli olduğunu gösterir.</p>\n</li>\n<li><p>Sonraki tüm isteklerde (Satış, Banka İşlemleri, <code>Cihaz Bağlantısı Sorgula</code>...) üç header'a ek olarak <code>Authorization: Bearer</code> gönderin.</p>\n</li>\n<li><p><code>401 INVALID_ACCESS_TOKEN</code> alırsanız yeni token alın. Tokenı süresi dolana kadar tekrar kullanın; her istekten önce yeni token almayın.</p>\n</li>\n</ol>\n<h4 id=\"rate-limit\">Rate Limit</h4>\n<p>Gateway, PC yazılımından gelen istekleri dakika başına sınırlar. Bir istek, ilgili tüm sınırlardan geçmek zorundadır:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Kapsam</th>\n<th>Endpoint</th>\n<th>Sayaç</th>\n<th>Limit</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>IP</td>\n<td>Tüm Gateway endpoint'leri</td>\n<td>İstemci IP adresi</td>\n<td>600 istek / dakika</td>\n</tr>\n<tr>\n<td>Token</td>\n<td><code>Token Al</code></td>\n<td>IP + <code>X-SerialNo</code></td>\n<td>10 istek / dakika</td>\n</tr>\n<tr>\n<td>Cihaz</td>\n<td><code>Cihaz Bağlantısı Sorgula</code> ve cihaza iletilen tüm istekler</td>\n<td>IP + sicil numarası</td>\n<td>120 istek / dakika</td>\n</tr>\n</tbody>\n</table>\n</div><p>Sınır aşıldığında Gateway <code>429 Too Many Requests</code> döner. <code>Retry-After</code> header'ı kaç saniye sonra tekrar denenebileceğini gösterir:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>HTTP/1.1 429 Too Many Requests\nRetry-After: 42\n{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"RATE_LIMITED\",\n        \"title\": \"Too many requests, retry in 42s\"\n    }\n}\n\n</code></pre><p><code>429</code> aldığınızda <code>Retry-After</code> süresi dolmadan aynı isteği tekrarlamayın.</p>\n<h4 id=\"gateway-hata-yanıtları\">Gateway Hata Yanıtları</h4>\n<p>Gateway kaynaklı hatalar aşağıdaki gövdeyle döner; <code>title</code> alanı her hatada bulunmayabilir. Cihazın kendi döndüğü hatalar (ör. satış hataları) Gateway'den olduğu gibi iletilir.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"status\": \"ERROR\",\n    \"error\": {\n        \"code\": \"DEVICE_OFFLINE\"\n    }\n}\n\n</code></pre><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>HTTP</th>\n<th><code>error.code</code></th>\n<th>Anlamı</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>400</code></td>\n<td><code>MISSING_HEADERS</code></td>\n<td><code>X-SerialNo</code>, <code>X-SoftwareId</code> veya <code>X-HardwareId</code> eksik (<code>Token Al</code> isteğinde <code>401</code>)</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>TOKEN_REQUIRED</code></td>\n<td><code>Authorization: Bearer</code> header'ı gönderilmemiş</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>INVALID_ACCESS_TOKEN</code></td>\n<td>Access token geçersiz veya süresi dolmuş; yeni token alın</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td><code>HARDWARE_MISMATCH</code></td>\n<td><code>X-HardwareId</code> eşleşilen PC'ninkiyle aynı değil</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td><code>SERIAL_NO_MISMATCH</code></td>\n<td>Token başka bir sicil numarası için alınmış</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td><code>SOFTWARE_ID_MISMATCH</code></td>\n<td>Token başka bir <code>X-SoftwareId</code> için alınmış</td>\n</tr>\n<tr>\n<td><code>429</code></td>\n<td><code>RATE_LIMITED</code></td>\n<td>Rate limit aşıldı; <code>Retry-After</code> kadar bekleyin</td>\n</tr>\n<tr>\n<td><code>502</code></td>\n<td><code>RELAY_SEND_FAILED</code></td>\n<td>İstek cihaza iletilemedi</td>\n</tr>\n<tr>\n<td><code>503</code></td>\n<td><code>DEVICE_OFFLINE</code></td>\n<td>Cihaz Gateway'e bağlı değil</td>\n</tr>\n<tr>\n<td><code>503</code></td>\n<td><code>DEVICE_DEGRADED</code></td>\n<td>Cihazdan 60 saniyedir yanıt alınamıyor</td>\n</tr>\n<tr>\n<td><code>503</code></td>\n<td><code>DEVICE_DISCONNECTED</code></td>\n<td>Cihazın bağlantısı istek sırasında koptu</td>\n</tr>\n<tr>\n<td><code>503</code></td>\n<td><code>DEVICE_HEARTBEAT_LOST</code></td>\n<td>Cihazla bağlantı canlılık kontrolünde düştü</td>\n</tr>\n<tr>\n<td><code>504</code></td>\n<td><code>DEVICE_TIMEOUT</code></td>\n<td>Cihaz 120 saniye içinde yanıt vermedi</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"_postman_id":"ce1d3fa6-686b-45f0-9ca9-8c5075d8eeb3"}],"event":[{"listen":"prerequest","script":{"id":"3671cae9-91ed-424e-aef0-86512b203b23","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"db83bdfb-f2ec-4a3e-834d-15caa5a12c81","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"baseurl","value":"https://192.168.0.50:4443"},{"key":"apiVersion","value":"v1"},{"key":"X-HardwareId","value":"AB:12:3F:14:EE"},{"key":"X-SoftwareId","value":"4640507936"},{"key":"X-SerialNo","value":"FU00001234"},{"key":"documentId","value":"93a3281a-99ce-446f-82d0-1415218413ab"},{"key":"accessToken","value":""},{"key":"receiptNo","value":""},{"key":"transactionId","value":""}]}