{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"a0a159c4-b83b-49b2-b941-8811903bce92","name":"Hugin PC Link","description":"# 📘 Satış Sistemi ile Entegrasyon Dokümanı\n\n## 1\\. Genel Bakış\n\nPCLink 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.\n\n### Kapsam ve Modüller\n\n- **Satış:** Fiş, e-Fatura, e-Arşiv , Avans Tahsilat gibi çeşitli belge türlerinin oluşturulması, güncellenmesi ve yönetimi.\n    \n- **Banka İşlemleri:** İptal ve iade ödemeleri, gün sonu raporları gibi finansal hareketlerin yönetimi.\n    \n- **Raporlar:** X ve Z raporu gibi standard mali raporların tüm içerikleri ile birlikte PC üzerinden alınabilmesi.\n    \n- **Ayarlar:** Cihaz ve uygulama ayarlarının merkezi ve güvenli biçimde yapılandırılması.\n    \n- **Kimlik Doğrulama:** Gerekli senaryolarda refresh token, yazılım kimliği ve cihaz seri numarası ile kısa ömürlü bearer token alınması.\n    \n\nBu bölümler, geliştiricilerin gerçek satış senaryolarını kolayca uyarlayabilmesi için örneklerle ve açıklamalarla desteklenmiştir.\n\n**Hedef Kullanıcılar:**\n\n- Yazılım geliştiriciler\n    \n- Entegratör firmalar\n    \n- POS ve masaüstü yazılım üreticileri\n    \n\nAPI, 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.\n\n## Kimlik Doğrulama Notu\n\nBu koleksiyona eklenen token alma akışı, ihtiyaç duyulan senaryolarda bir `refreshToken`, yazılıma ait kimlik bilgisi (`X-SoftwareId` veya eşdeğer alan) ve cihaza ait seri numarası (`X-SerialNo` 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.\n\nYerel 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 `tsmToken` değişkeni varsa isteklerin `Authorization: Bearer {{tsmToken}}` başlığı ile gönderilmesi desteklenmeye devam eder.\n\n---\n\n## 2\\. Temel Kavramlar\n\n### 2.1 Document (Satış ve Tahsilat Belgeleri)\n\nHem 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ı `document`tir. Mali belgenin temel bilgilerinin yanı sıra, bir veya birden fazla ürün/hizmet kalemi (`items`) ve ödeme bilgilerini (`payments`) içerebilir.\n\n### 2.2 Belge Durumları\n\n| Durum | Açıklama |\n| --- | --- |\n| `OPEN` | Satış başlatıldı, belgede değişiklik yapılabilir veya ödeme gönderilebilir. |\n| `COMPLETED` | Kapanmış (tamamlanmış) |\n| `CANCELLED` | İptal edilmiş |\n\nMevcut koleksiyon açıklamasının geri kalan içeriği korunarak bu kimlik doğrulama bilgisi eklenmiştir.\n\n---","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"36539729","team":8241247,"collectionId":"a0a159c4-b83b-49b2-b941-8811903bce92","publishedId":"2sB34co2wN","public":true,"publicUrl":"https://documenter-api.postman.tech/view/36539729/2sB34co2wN","privateUrl":"https://go.postman.co/documentation/36539729-a0a159c4-b83b-49b2-b941-8811903bce92","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"055BE9"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":"https://content.pstmn.io/a6cef060-458e-461a-9681-a2309553361a/SFVHSU4gT8yIwplTIETCmMKewpguanBn","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"2B74EC"}},{"name":"light","logo":"https://content.pstmn.io/b95d94cd-1e4b-4923-ba38-9c6b7f3ef327/SFVHSU4gT8yIUyBFLmpwZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"055BE9"}}]}},"version":"8.12.12","publishDate":"2026-03-23T20:03:38.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/b95d94cd-1e4b-4923-ba38-9c6b7f3ef327/SFVHSU4gT8yIUyBFLmpwZw==","logoDark":"https://content.pstmn.io/a6cef060-458e-461a-9681-a2309553361a/SFVHSU4gT8yIwplTIETCmMKewpguanBn"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/2b4598965cbe4f43aecafdfc3c8ad36f178ad0e158180e2c27c9f73057d8e009","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB34co2wN"}