{"info":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","description":"<html><head></head><body><p>Qargomate entegrasyon API'sinin <strong>mağaza (Store / Customer)</strong> tarafından kullanılan uçları.</p>\n<p>Bu koleksiyon yalnızca bir mağazanın gönderi oluşturmak, sorgulamak ve düzeltmek için ihtiyaç duyduğu endpoint'leri içerir; yönetim/raporlama (Admin) uçları kapsam dışıdır.</p>\n<h2 id=\"hızlı-başlangıç\">Hızlı başlangıç</h2>\n<ol>\n<li>Koleksiyon değişkenlerinden <code>baseUrl</code>'i ortamınıza göre ayarlayın (varsayılan: <code>https://integration.qargomate.com</code>).</li>\n<li><strong>1. Kimlik Doğrulama → Login</strong> isteğini çalıştırın. Dönen <code>accessToken</code> otomatik olarak <code></code> değişkenine yazılır ve diğer tüm isteklerde Bearer token olarak kullanılır.</li>\n<li><strong>2. Referans → Depo Ekle</strong> ile bir depo (gönderi çıkış adresi) oluşturun; ya da <strong>Depo Listesi</strong> ile mevcut deponuzun <code>WarehouseID</code>'sini alın.</li>\n<li><strong>3. Sipariş → Toplu Oluştur</strong> ile gönderilerinizi oluşturun.</li>\n</ol>\n<h2 id=\"kimlik-doğrulama\">Kimlik doğrulama</h2>\n<p>Tüm istekler (Login hariç) <code>Authorization: Bearer </code> gerektirir. Token süresi dolduğunda Login isteğini tekrar çalıştırın.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"19073555","collectionId":"c25c0b52-4980-47e6-9121-33910a53ff10","publishedId":"2sBY4LQMNz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-09T13:03:23.000Z"},"item":[{"name":"1. Kimlik Doğrulama","item":[{"name":"Login","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Başarılı login sonrası accessToken'ı koleksiyon değişkenine kaydeder.","if (pm.response.code === 200) {","    const body = pm.response.json();","    if (body.accessToken) {","        pm.collectionVariables.set('accessToken', body.accessToken);","        console.log('accessToken kaydedildi.');","    }","    pm.test('accessToken döndü', function () {","        pm.expect(body.accessToken).to.be.a('string').and.not.empty;","    });","} else {","    pm.test('Login başarılı (200)', function () {","        pm.expect(pm.response.code).to.eql(200);","    });","}"],"id":"996a67ed-5f6e-4065-a71c-6d1da2970aa5"}}],"id":"c01f2464-d80e-43d2-b7f5-488789201644","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"userName\": \"magaza_kullanici_adi\",\n  \"password\": \"sifreniz\"\n}"},"url":"https://integration.qargomate.com/api/authentication/login","description":"<p>Mağaza kullanıcı adı + şifre ile oturum açar.</p>\n<p><strong>Body:</strong></p>\n<ul>\n<li><code>userName</code> (string, zorunlu): Mağaza kullanıcı adı.</li>\n<li><code>password</code> (string, zorunlu): Şifre.</li>\n</ul>\n<p><strong>Yanıt (200):</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"accessToken\": \"eyJ...\",\n  \"name\": \"Mağaza Adı\",\n  \"userID\": \"...\",\n  \"accessID\": \"...\",\n  \"rol\": \"Customer\",\n  \"expiresAt\": 1730000000\n}\n</code></pre>\n<p><code>accessToken</code>, test scriptiyle otomatik olarak <code></code> değişkenine yazılır. Geçersiz kimlikte <strong>401 Unauthorized</strong> döner.</p>\n","urlObject":{"path":["api","authentication","login"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c01f2464-d80e-43d2-b7f5-488789201644"}],"id":"8d63fde4-e3d2-40a8-8cda-504b25704b68","description":"<p>Mağaza kullanıcısının oturum açması.</p>\n","_postman_id":"8d63fde4-e3d2-40a8-8cda-504b25704b68","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}}},{"name":"2. Referans","item":[{"name":"Depo Listesi","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// İlk deponun ID'sini kolaylık için warehouseId değişkenine yazar.","if (pm.response.code === 200) {","    const arr = pm.response.json();","    if (Array.isArray(arr) && arr.length > 0 && arr[0].id) {","        pm.collectionVariables.set('warehouseId', arr[0].id);","    }","}"],"id":"99ac5910-6018-4599-974b-25d1bb9d7532"}}],"id":"5916a6c9-37b5-43a0-b99c-34f22944fbe9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://integration.qargomate.com/api/Warehouse","description":"<p>Mağazaya bağlı depoları listeler. Sipariş oluştururken <code>WarehouseID</code> (gönderinin çıkacağı depo) buradan alınır.</p>\n<p>Yanıt bir depo dizisidir; her kaydın <code>id</code> alanı sipariş gövdesindeki <code>WarehouseID</code>'dir.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Warehouse"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5916a6c9-37b5-43a0-b99c-34f22944fbe9"},{"name":"Depo Ekle (Single)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Oluşan deponun ID'sini kolaylık için warehouseId değişkenine yazar.","if (pm.response.code === 201) {","    const body = pm.response.json();","    if (body && body.id) {","        pm.collectionVariables.set('warehouseId', body.id);","    }","}"],"id":"6e9c5300-7e10-47f1-9860-203c67bd80a2"}}],"id":"749aaaec-01d0-4cc5-a9de-468f734e3391","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"Merkez Depo\",\n  \"person\": \"Depo Yetkilisi\",\n  \"phone1\": \"5551234567\",\n  \"email\": \"depo@ornek.com\",\n  \"city\": \"Ankara\",\n  \"county\": \"Türkiye\",\n  \"neighborhood\": \"Kızılay Mah.\",\n  \"district\": \"Çankaya\",\n  \"addressLine1\": \"Atatürk Bulvarı No:1\"\n}"},"url":"https://integration.qargomate.com/api/Warehouse/Single","description":"<p>Mağazaya yeni bir depo (gönderi çıkış adresi) ekler. Depo, giriş yapan kullanıcının mağazasına bağlanır.</p>\n<h3 id=\"alanlar\">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>Zorunlu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>name</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Depo adı.</td>\n</tr>\n<tr>\n<td><code>person</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Depo yetkilisi.</td>\n</tr>\n<tr>\n<td><code>phone1</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Yetkili telefonu.</td>\n</tr>\n<tr>\n<td><code>email</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Depo e-posta.</td>\n</tr>\n<tr>\n<td><code>city</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>İl.</td>\n</tr>\n<tr>\n<td><code>county</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Ülke (genelde <code>Türkiye</code>).</td>\n</tr>\n<tr>\n<td><code>neighborhood</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Mahalle.</td>\n</tr>\n<tr>\n<td><code>district</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>İlçe.</td>\n</tr>\n<tr>\n<td><code>addressLine1</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Açık adres.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Not:</strong> <code>storeId</code> göndermeyin — otomatik olarak oturum açan mağazaya (<code>AccessID</code>) atanır.</p>\n<p><strong>Yanıt (201):</strong> Oluşturulan depo. <code>id</code> değeri, sipariş oluştururken kullanılacak <code>WarehouseID</code>'dir ve otomatik <code></code> değişkenine yazılır.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Warehouse","Single"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"749aaaec-01d0-4cc5-a9de-468f734e3391"},{"name":"Depo Ekle (Bulk)","id":"559c0f06-f672-473f-8734-5b78e7f40785","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n  {\n    \"name\": \"Ankara Depo\",\n    \"person\": \"Yetkili 1\",\n    \"phone1\": \"5551234567\",\n    \"email\": \"ankara@ornek.com\",\n    \"city\": \"Ankara\",\n    \"county\": \"Türkiye\",\n    \"neighborhood\": \"Kızılay Mah.\",\n    \"district\": \"Çankaya\",\n    \"addressLine1\": \"Atatürk Bulvarı No:1\"\n  },\n  {\n    \"name\": \"İstanbul Depo\",\n    \"person\": \"Yetkili 2\",\n    \"phone1\": \"5559876543\",\n    \"email\": \"istanbul@ornek.com\",\n    \"city\": \"İstanbul\",\n    \"county\": \"Türkiye\",\n    \"neighborhood\": \"Caferağa Mah.\",\n    \"district\": \"Kadıköy\",\n    \"addressLine1\": \"Moda Caddesi No:10\"\n  }\n]"},"url":"https://integration.qargomate.com/api/Warehouse/Bulk","description":"<p>Tek istekte birden çok depo ekler. Gövde depo dizisidir; alanlar Depo Ekle (Single) ile aynıdır. <code>storeId</code> gönderilmez — hepsi oturum açan mağazaya atanır.</p>\n<p><strong>Yanıt (201):</strong> Oluşturulan depolar.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Warehouse","Bulk"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"559c0f06-f672-473f-8734-5b78e7f40785"}],"id":"8f00decc-c315-4f57-ab62-e597d2fe00ec","description":"<p>Sipariş oluştururken gereken referans verileri.</p>\n","_postman_id":"8f00decc-c315-4f57-ab62-e597d2fe00ec","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}}},{"name":"3. Sipariş","item":[{"name":"Toplu Oluştur (Bulk)","id":"a8296c2a-19b0-46b1-b5c6-72770dab0438","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n  {\n    \"warehouseID\": \"\",\n    \"autoGenerateCode\": true,\n    \"totalParcels\": 2,\n    \"desi\": 20,\n    \"deliveryType\": 0,\n    \"city\": \"Ankara\",\n    \"county\": \"Türkiye\",\n    \"district\": \"Çankaya\",\n    \"neighborhood\": \"Kızılay Mah.\",\n    \"addressLine1\": \"Atatürk Bulvarı No:1 Daire:5\",\n    \"firstName\": \"Getir Ankara\",\n    \"lastName\": \"Deposu\",\n    \"phone\": \"5551234567\",\n    \"mail\": \"alici@ornek.com\",\n    \"orderNote\": \"Kapıda teslim\",\n    \"items\": [\n      { \"desi\": 10, \"weight\": 5 },\n      { \"desi\": 10, \"weight\": 5 }\n    ]\n  }\n]"},"url":"https://integration.qargomate.com/api/Order/Bulk","description":"<p>Tek istekte bir veya birden çok gönderi oluşturur. Gövde bir <strong>sipariş dizisidir</strong> (tek sipariş için de tek elemanlı dizi gönderilir).</p>\n<h3 id=\"sipariş-alanları\">Sipariş 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>Zorunlu</th>\n<th>Açıklama</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>warehouseID</code></td>\n<td>guid</td>\n<td>Evet</td>\n<td>Gönderinin çıkacağı depo (Depo Listesi'nden).</td>\n</tr>\n<tr>\n<td><code>autoGenerateCode</code></td>\n<td>bool</td>\n<td>—</td>\n<td><code>true</code> ise backend benzersiz <code>QM######</code> kodu üretip hem <code>barcode</code> hem <code>customerOrder</code> alanına yazar. <code>false</code> ise <code>customerOrder</code>/<code>barcode</code> sizden beklenir.</td>\n</tr>\n<tr>\n<td><code>customerOrder</code></td>\n<td>string</td>\n<td>Koşullu</td>\n<td>Kendi sipariş numaranız. <code>autoGenerateCode=false</code> ise verin.</td>\n</tr>\n<tr>\n<td><code>totalParcels</code></td>\n<td>int</td>\n<td>Evet</td>\n<td>Koli (parça) adedi. <code>items</code> bu adette olmalıdır.</td>\n</tr>\n<tr>\n<td><code>desi</code></td>\n<td>decimal</td>\n<td>Evet</td>\n<td>Siparişin toplam desisi (genelde koli başı desi × koli adedi).</td>\n</tr>\n<tr>\n<td><code>deliveryType</code></td>\n<td>int</td>\n<td>Evet</td>\n<td>0=Standart, 1=MarketPlace, 2=İade, 4=FirstMile.</td>\n</tr>\n<tr>\n<td><code>city</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>İl.</td>\n</tr>\n<tr>\n<td><code>county</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Ülke (genelde <code>Türkiye</code>).</td>\n</tr>\n<tr>\n<td><code>district</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>İlçe.</td>\n</tr>\n<tr>\n<td><code>neighborhood</code></td>\n<td>string</td>\n<td>—</td>\n<td>Mahalle.</td>\n</tr>\n<tr>\n<td><code>addressLine1</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Açık adres (kırpılmaz).</td>\n</tr>\n<tr>\n<td><code>firstName</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Alıcı adı (teslim yeri/müşteri).</td>\n</tr>\n<tr>\n<td><code>lastName</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Alıcı soyadı. Tek kelimelik işletme adında <code>-</code> verilebilir.</td>\n</tr>\n<tr>\n<td><code>phone</code></td>\n<td>string</td>\n<td>Evet</td>\n<td>Alıcı telefonu (10 hane, başında 0 olmadan).</td>\n</tr>\n<tr>\n<td><code>mail</code></td>\n<td>string</td>\n<td>—</td>\n<td>Alıcı e-posta.</td>\n</tr>\n<tr>\n<td><code>orderNote</code></td>\n<td>string</td>\n<td>—</td>\n<td>Gönderi notu.</td>\n</tr>\n<tr>\n<td><code>items</code></td>\n<td>dizi</td>\n<td>Evet</td>\n<td>Her koli için bir eleman. Koli başına <code>desi</code> ve <code>weight</code>.</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"item-alanları\">Item alanları</h3>\n<ul>\n<li><code>desi</code> (decimal): Koli başına desi.</li>\n<li><code>weight</code> (decimal): Koli başına ağırlık (kg).</li>\n</ul>\n<p><strong>Yanıt (201):</strong> Oluşturulan siparişlerin listesi. Fiyatlama ve kargo entegrasyonu arka planda (pipeline) işlenir; barkod/etiket kısa süre sonra hazır olur — durum için <strong>Listele</strong> veya <strong>Detay</strong> uçlarını kullanın.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Order","Bulk"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a8296c2a-19b0-46b1-b5c6-72770dab0438"},{"name":"Tekli Oluştur (Single)","id":"7c94d0b0-d9f1-42ac-85b0-9c402b328d80","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"warehouseID\": \"\",\n  \"autoGenerateCode\": true,\n  \"totalParcels\": 1,\n  \"desi\": 8,\n  \"deliveryType\": 0,\n  \"city\": \"İstanbul\",\n  \"county\": \"Türkiye\",\n  \"district\": \"Kadıköy\",\n  \"neighborhood\": \"Caferağa Mah.\",\n  \"addressLine1\": \"Moda Caddesi No:10\",\n  \"firstName\": \"Ahmet\",\n  \"lastName\": \"Yılmaz\",\n  \"phone\": \"5551112233\",\n  \"mail\": \"ahmet@ornek.com\",\n  \"items\": [\n    { \"desi\": 8, \"weight\": 3 }\n  ]\n}"},"url":"https://integration.qargomate.com/api/Order/Single","description":"<p>Tek gönderi oluşturur. Gövde <strong>tek bir sipariş nesnesidir</strong> (dizi değil). Alanlar Toplu Oluştur ile aynıdır.</p>\n<p><strong>Yanıt (201):</strong> Oluşturulan sipariş.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Order","Single"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7c94d0b0-d9f1-42ac-85b0-9c402b328d80"},{"name":"Listele / Sorgula","id":"b74e3403-6363-4f4b-a73a-d8aaff4f1ab7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://integration.qargomate.com/api/Order?PageNumber=1&PageSize=20&CustomerOrder=&Barcode=&Status=&CustomerName=&StartDate=&EndDate=","description":"<p>Mağazanın siparişlerini sayfalı olarak listeler ve filtreler. Kullanmadığınız query parametrelerini boş bırakın veya URL'den kaldırın.</p>\n<p>Sayfalama bilgisi <code>X-Pagination</code> yanıt başlığında döner.</p>\n<h3 id=\"entegrasyon-sonucu-ve-etiket-zpl-nasıl-alınır\">Entegrasyon sonucu ve etiket (ZPL) nasıl alınır</h3>\n<p>Sipariş oluşturma (<code>Bulk</code>/<code>Single</code>) <strong>senkron değildir</strong> — kargo entegrasyonu arka planda (pipeline) işlenir. Bu yüzden oluşturma yanıtında henüz barkod/etiket olmaz; mağaza kısa süre sonra (birkaç saniye) siparişi bu uçtan veya <strong>Detay</strong>'dan tekrar sorgulamalıdır:</p>\n<ul>\n<li>Sipariş (order) seviyesinde <code>integrationSuccess</code> (bool): kargo firmasına gönderim başarılı oldu mu.</li>\n<li>Başarısızsa <code>integrationError</code> (string): hata mesajı.</li>\n<li>Başarılıysa her <code>items[]</code> elemanının <code>zpl</code> alanı dolar — bu, doğrudan termal yazıcıya gönderilebilecek veya Labelary gibi bir servisle PDF'e çevrilebilecek ZPL etiket kodudur (<code>item.barcode</code>/<code>item.externalBarcode</code> ile birlikte).</li>\n<li><code>integrationSuccess=false</code> iken <code>items[].zpl</code> boş kalır; sipariş <strong>Revize Et</strong> ile düzeltilip yeniden denenebilir.</li>\n</ul>\n<p>Özetle: entegrasyon durumu + ZPL bilgisi <strong>oluşturma yanıtında değil</strong>, sonraki bir <strong>Listele/Detay</strong> sorgusunda gelir.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Order"],"host":["https://integration.qargomate.com"],"query":[{"description":{"content":"<p>Sayfa numarası (varsayılan 1).</p>\n","type":"text/plain"},"key":"PageNumber","value":"1"},{"description":{"content":"<p>Sayfa başına kayıt.</p>\n","type":"text/plain"},"key":"PageSize","value":"20"},{"description":{"content":"<p>Sipariş numarasına göre filtre (içerir).</p>\n","type":"text/plain"},"key":"CustomerOrder","value":""},{"description":{"content":"<p>Barkoda göre filtre.</p>\n","type":"text/plain"},"key":"Barcode","value":""},{"description":{"content":"<p>Durum: 0=Bekliyor,1=Kabul Edildi,2=Dağıtımda,3=Teslim Edildi,4=İptal,5=Tekrar Denenecek,6=Teslim Edilemedi.</p>\n","type":"text/plain"},"key":"Status","value":""},{"description":{"content":"<p>Alıcı ad/soyada göre filtre (içerir).</p>\n","type":"text/plain"},"key":"CustomerName","value":""},{"description":{"content":"<p>Başlangıç tarihi (ISO 8601, örn 2026-07-01).</p>\n","type":"text/plain"},"key":"StartDate","value":""},{"description":{"content":"<p>Bitiş tarihi (ISO 8601).</p>\n","type":"text/plain"},"key":"EndDate","value":""}],"variable":[]}},"response":[],"_postman_id":"b74e3403-6363-4f4b-a73a-d8aaff4f1ab7"},{"name":"Detay (Id ile)","id":"c30f9042-cec1-4a48-b28b-f5e7df981e0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://integration.qargomate.com/api/Order/","description":"<p>Tek bir siparişin detayını getirir. Yanıtta önemli alanlar:</p>\n<ul>\n<li><code>integrationSuccess</code> (bool): kargo entegrasyonu başarılı mı.</li>\n<li><code>integrationError</code> (string, varsa): başarısızlık nedeni.</li>\n<li><code>items[].zpl</code> (string): entegrasyon başarılıysa her kolinin ZPL etiket kodu (yazıcıya veya PDF'e çevirmeye hazır).</li>\n<li><code>items[].barcode</code> / <code>items[].externalBarcode</code>: koli barkodları.</li>\n<li><code>items[].price</code>, <code>items[].carrierDesi</code>: fiyat ve kargonun ölçtüğü desi.</li>\n</ul>\n<p>Sipariş yeni oluşturulduysa entegrasyon henüz işlenmemiş olabilir — <code>integrationSuccess=false</code> ve <code>zpl</code> boşsa birkaç saniye sonra bu uç tekrar çağrılmalıdır.</p>\n<p><code></code> = siparişin GUID <code>id</code> değeri (Listele yanıtındaki <code>id</code>).</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Order",""],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c30f9042-cec1-4a48-b28b-f5e7df981e0c"},{"name":"Revize Et","id":"85d70e5f-df37-4cd1-b119-3cf53ac043fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"firstName\": \"Ahmet\",\n  \"lastName\": \"Yılmaz\",\n  \"phone\": \"5551112233\",\n  \"mail\": \"ahmet@ornek.com\",\n  \"city\": \"İstanbul\",\n  \"county\": \"Türkiye\",\n  \"district\": \"Kadıköy\",\n  \"neighborhood\": \"Caferağa Mah.\",\n  \"addressLine1\": \"Moda Caddesi No:12 (düzeltildi)\",\n  \"desi\": 8,\n  \"items\": [\n    { \"weight\": 3, \"desi\": 8 }\n  ]\n}"},"url":"https://integration.qargomate.com/api/Order//Revise","description":"<p><strong>Başarısız</strong> veya <strong>Bekliyor</strong> durumdaki bir siparişi düzeltip yeniden kargo entegrasyonu kuyruğuna alır (iptal edip sıfırdan oluşturmaya gerek kalmadan).</p>\n<p>Entegrasyon (<code>IntegrationName</code>) mağaza üzerinden belirlendiğinden revize gövdesinde gönderilmez; siparişin mevcut entegrasyonu korunur.</p>\n<p><strong>Body:</strong> alıcı/adres bilgileri + <code>desi</code> + <code>items</code> (her koli için <code>weight</code>, <code>desi</code>).</p>\n<p><code></code> = siparişin GUID <code>id</code> değeri.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Order","","Revise"],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"85d70e5f-df37-4cd1-b119-3cf53ac043fe"}],"id":"25b0a9df-7eed-4d73-a03c-0dd93bd5647a","description":"<p>Gönderi oluşturma, sorgulama ve düzeltme.</p>\n","_postman_id":"25b0a9df-7eed-4d73-a03c-0dd93bd5647a","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}}},{"name":"4. Hareket (Takip)","item":[{"name":"Hareket Listesi (Takip)","id":"825ebf39-bca4-4cd0-a5f5-4bb5fd1da317","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://integration.qargomate.com/api/Transaction?PageNumber=1&PageSize=50&Barcode=&SearchTerm=&OrderBy=","description":"<p>Gönderi hareketlerini (kargo takip adımları / transaction'lar) sayfalı listeler. Bir gönderiyi takip etmek için <code>Barcode</code> verin; kabul edildi → dağıtımda → teslim/iade adımları ve tarihleri döner.</p>\n<p>Sayfalama bilgisi <code>X-Pagination</code> yanıt başlığındadır.</p>\n<p><strong>Not:</strong> Genel gönderi durumu (statü) için <strong>3. Sipariş → Listele/Detay</strong> daha pratiktir; bu uç adım adım hareket geçmişi içindir.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Transaction"],"host":["https://integration.qargomate.com"],"query":[{"description":{"content":"<p>Sayfa numarası (varsayılan 1).</p>\n","type":"text/plain"},"key":"PageNumber","value":"1"},{"description":{"content":"<p>Sayfa başına kayıt (maksimum 50).</p>\n","type":"text/plain"},"key":"PageSize","value":"50"},{"description":{"content":"<p>Barkoda göre filtre — bir gönderinin tüm hareketlerini (kargo takip adımları) getirir.</p>\n","type":"text/plain"},"key":"Barcode","value":""},{"description":{"content":"<p>Serbest metin arama.</p>\n","type":"text/plain"},"key":"SearchTerm","value":""},{"description":{"content":"<p>Sıralama alanı.</p>\n","type":"text/plain"},"key":"OrderBy","value":""}],"variable":[]}},"response":[],"_postman_id":"825ebf39-bca4-4cd0-a5f5-4bb5fd1da317"},{"name":"Hareket Detay (Id ile)","id":"fda36bae-fe0d-4eba-8c91-c81ee670d334","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://integration.qargomate.com/api/Transaction/","description":"<p>Tek bir hareket kaydının (transaction) detayını getirir.</p>\n<p><code></code> = hareket kaydının GUID <code>id</code> değeri (Hareket Listesi yanıtından).</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}},"urlObject":{"path":["api","Transaction",""],"host":["https://integration.qargomate.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fda36bae-fe0d-4eba-8c91-c81ee670d334"}],"id":"2a0d917f-b530-4986-9ded-ef8b5c94a6be","description":"<p>Gönderi hareketleri (kargo takip adımları).</p>\n","_postman_id":"2a0d917f-b530-4986-9ded-ef8b5c94a6be","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"c25c0b52-4980-47e6-9121-33910a53ff10","id":"c25c0b52-4980-47e6-9121-33910a53ff10","name":"Qargomate - Store (Mağaza) API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"variable":[{"key":"baseUrl","value":"https://integration.qargomate.com"},{"key":"accessToken","value":""},{"key":"warehouseId","value":""},{"key":"orderId","value":""},{"key":"transactionId","value":""}]}