# siparis.app API

> Sipariş, müşteri, ürün, stok, kargo, iade ve fatura için Türkçe REST API. Temel adres https://api.siparis.app/v1; Bearer anahtarı; JSON. Uçlar kaynağa göre gruplanmıştır, her uç kendi Markdown sayfasındadır.

Anahtarı sunucunun SIPARIS_API_KEY ortam değişkeninden `Authorization: Bearer` başlığına koyun; belgeye veya AI sohbetine yazmayın. Her yazma isteği `Idempotency-Key` ister. MCP sunucusu: https://api.siparis.app/mcp — OAuth ve kullanıcı onaylı yazma araçları ([bağlantı rehberi](https://developer.siparis.app/mcp.md)).

## Başlangıç

- [Genel bakış](https://developer.siparis.app/index.md)
- [Başlarken](https://developer.siparis.app/baslarken.md)
- [Deneme ortamı](https://developer.siparis.app/deneme-ortami.md)

## Siparişler

Sipariş açın, listeleyin, onaylayın, teslim edin, düzeltin ve iptal edin.

- [Sipariş oluştur](https://developer.siparis.app/uc/siparis-olustur.md): `POST /v1/orders` — Kendi sitenizden, ERP’nizden veya başka bir yazılımdan yeni satış açın; stok ve tahsilat paneldeki elle siparişle aynı kuralla işlenir.
- [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele.md): `GET /v1/orders` — Yetkili markaların siparişlerini zaman, durum, marka ve görünen numarayla süzerek alın; ERP sipariş aktarımında kullanın.
- [Siparişi getir](https://developer.siparis.app/uc/siparisi-getir.md): `GET /v1/orders/{id}` — Siparişin güncel durumunu ve tutarlarını okuyun; olay geldikten sonra ERP kaydını güncellemek için kullanın.
- [Siparişi onayla](https://developer.siparis.app/uc/siparisi-onayla.md): `POST /v1/orders/{id}/confirm` — Yeni (bekleyen) siparişi onaylandı durumuna geçirin.
- [Siparişi hazırlamaya başla](https://developer.siparis.app/uc/siparisi-hazirlamaya-basla.md): `POST /v1/orders/{id}/processing` — Onaylı siparişi hazırlanıyor durumuna geçirin.
- [Teslim almaya hazır işaretle](https://developer.siparis.app/uc/teslim-almaya-hazir-isaretle.md): `POST /v1/orders/{id}/ready` — Markadan teslim alınacak sipariş hazır olduğunda ve müşteriye haber verdiğinizde kullanın.
- [Siparişi teslim et](https://developer.siparis.app/uc/siparisi-teslim-et.md): `POST /v1/orders/{id}/deliver` — Elden, markadan veya kargoyla teslim edilen siparişi teslim edildi durumuna geçirin.
- [Alınan ödemeyi kaydet](https://developer.siparis.app/uc/alinan-odemeyi-kaydet.md): `POST /v1/orders/{id}/payment-received` — Müşteriden gerçekten aldığınız nakit, POS veya havale ödemesini siparişe yazın.
- [Siparişi iptal et](https://developer.siparis.app/uc/siparisi-iptal-et.md): `POST /v1/orders/{id}/cancel` — Siparişi iptal edin; stok geri gelir, ödeme ve iade paneldeki iptal kuralıyla işlenir.
- [Siparişi düzelt](https://developer.siparis.app/uc/siparisi-duzelt.md): `PATCH /v1/orders/{id}` — Siparişin adresini, notlarını, teslim gününü veya kalemlerini değiştirin.
- [Sipariş durumunu düzelt](https://developer.siparis.app/uc/siparis-durumunu-duzelt.md): `POST /v1/orders/{id}/correct-status` — Yanlışlıkla seçilmiş sipariş durumunu gerekçe yazarak düzeltin.
- [Sipariş satırlarını listele](https://developer.siparis.app/uc/siparis-satirlarini-listele.md): `GET /v1/orders/{id}/lines` — Sipariş anındaki ürün, seçenek, miktar ve fiyatları alın; ERP sipariş kalemlerini oluştururken kullanın.
- [Ödemeleri ve para özetini getir](https://developer.siparis.app/uc/odemeleri-ve-para-ozetini-getir.md): `GET /v1/orders/{id}/payments` — Siparişin tahsilat ve geri ödemelerini ve bütün siparişin para özetini okuyun; mutabakatta kullanın.
- [Sipariş geçmişini getir](https://developer.siparis.app/uc/siparis-gecmisini-getir.md): `GET /v1/orders/{id}/history` — Siparişin durum geçişlerini sırasıyla okuyun; işlem sırasını açıklamak için kullanın.

## Müşteriler

Müşteri kartını bulun, ekleyin, güncelleyin, arşivleyin veya KVKK için anonimleştirin.

- [Müşteri oluştur](https://developer.siparis.app/uc/musteri-olustur.md): `POST /v1/customers` — Yeni müşteri kartı açın; sipariş açmadan önce müşteriyi kaydetmek için kullanın.
- [Müşterileri listele](https://developer.siparis.app/uc/musterileri-listele.md): `GET /v1/customers` — Müşteri kartlarını listeleyin veya e-posta/telefonla doğru kartı bulun.
- [Müşteriyi getir](https://developer.siparis.app/uc/musteriyi-getir.md): `GET /v1/customers/{id}` — Bir müşteri kartını okuyun; siparişteki customer kimliğini kendi kaydınızla eşleştirirken kullanın.
- [Müşteriyi güncelle](https://developer.siparis.app/uc/musteriyi-guncelle.md): `PATCH /v1/customers/{id}` — Müşteri kartının adını, iletişim bilgilerini veya notunu değiştirin.
- [Müşteriyi arşivle](https://developer.siparis.app/uc/musteriyi-arsivle.md): `POST /v1/customers/{id}/archive` — Müşteri kartını etkin listeden kaldırın; kart ve siparişleri silinmez.
- [Müşteriyi geri getir](https://developer.siparis.app/uc/musteriyi-geri-getir.md): `POST /v1/customers/{id}/restore` — Arşivdeki müşteri kartını etkin listeye geri getirin.
- [Müşteriyi anonimleştir (KVKK)](https://developer.siparis.app/uc/musteriyi-anonimlestir-kvkk.md): `POST /v1/customers/{id}/anonymize` — Müşterinin KVKK silme isteğini yerine getirin: kişisel bilgiler temizlenir, sipariş ve muhasebe kayıtları kalır.

## Ürünler

Ürün, seçenek, kategori, ürün markası ve markaya özel fiyat.

- [Ürün oluştur](https://developer.siparis.app/uc/urun-olustur.md): `POST /v1/products` — Ürünü seçenekleri, kategorileri ve ürün markasıyla birlikte tek istekte açın.
- [Ürünleri listele](https://developer.siparis.app/uc/urunleri-listele.md): `GET /v1/products` — Görünür ürünleri ve istenirse seçeneklerini, kategorilerini ve marka fiyatlarını alın; katalog aktarımı ve ürün kimliği eşleştirmesi için kullanın.
- [Ürünü getir](https://developer.siparis.app/uc/urunu-getir.md): `GET /v1/products/{id}` — Bir ürünün güncel bilgilerini okuyun; ürün olayından sonra kendi kataloğunuzu güncellerken kullanın.
- [Ürünü güncelle](https://developer.siparis.app/uc/urunu-guncelle.md): `PATCH /v1/products/{id}` — Ürünün adını, fiyatını, açıklamasını, kategorilerini veya satış durumunu değiştirin.
- [Ürünü arşivle](https://developer.siparis.app/uc/urunu-arsivle.md): `POST /v1/products/{id}/archive` — Ürünü listeden ve vitrinden kaldırın; kayıtları silinmez.
- [Ürünü geri getir](https://developer.siparis.app/uc/urunu-geri-getir.md): `POST /v1/products/{id}/restore` — Arşivdeki ürünü ve arşivlenen seçeneklerini geri getirin.
- [Ürüne seçenek ekle](https://developer.siparis.app/uc/urune-secenek-ekle.md): `POST /v1/products/{id}/variants` — Var olan ürüne renk, beden gibi yeni bir seçenek ekleyin.
- [Seçenekleri listele](https://developer.siparis.app/uc/secenekleri-listele.md): `GET /v1/variants` — Ürün seçeneklerini stok kodu (SKU) veya barkodla bulun; ERP stok kartını var_ kimliğiyle eşleştirin.
- [Seçeneği getir](https://developer.siparis.app/uc/secenegi-getir.md): `GET /v1/variants/{id}` — Bir seçeneğin güncel fiyatını ve stok türünü okuyun.
- [Seçeneği güncelle](https://developer.siparis.app/uc/secenegi-guncelle.md): `PATCH /v1/variants/{id}` — Seçeneğin stok kodunu, barkodunu, fiyatını, maliyetini, ağırlığını veya görsellerini değiştirin.
- [Seçeneği arşivle](https://developer.siparis.app/uc/secenegi-arsivle.md): `POST /v1/variants/{id}/archive` — Satılmayan bir seçeneği üründen kaldırın; kaydı silinmez.
- [Marka fiyatını yaz](https://developer.siparis.app/uc/marka-fiyatini-yaz.md): `PUT /v1/store-prices/{store}/{product}` — Ürünün veya seçeneğin bir markadaki satış fiyatını ayarlayın ya da kaldırın.
- [Marka fiyatlarını listele](https://developer.siparis.app/uc/marka-fiyatlarini-listele.md): `GET /v1/store-prices` — Markaya özel kaydedilmiş ürün ve seçenek fiyatlarını alın.
- [Marka fiyatını getir](https://developer.siparis.app/uc/marka-fiyatini-getir.md): `GET /v1/store-prices/{store}/{product}` — Belirli marka ve ürünün kaydedilmiş fiyatını okuyun.
- [Kategori oluştur](https://developer.siparis.app/uc/kategori-olustur.md): `POST /v1/categories` — İşletmenin bütün markalarında kullanılan yeni bir kategori açın.
- [Kategorileri listele](https://developer.siparis.app/uc/kategorileri-listele.md): `GET /v1/categories` — Görünür ürünlerin kategorilerini alın; kendi kategori ağacınızı kurarken kullanın.
- [Kategoriyi getir](https://developer.siparis.app/uc/kategoriyi-getir.md): `GET /v1/categories/{id}` — Bir kategorinin adını, açıklamasını ve görünür üst kategorisini okuyun.
- [Kategoriyi güncelle](https://developer.siparis.app/uc/kategoriyi-guncelle.md): `PATCH /v1/categories/{id}` — Kategorinin adını, açıklamasını veya üst kategorisini değiştirin.
- [Kategoriyi arşivle](https://developer.siparis.app/uc/kategoriyi-arsivle.md): `POST /v1/categories/{id}/archive` — Kategoriyi vitrinden kaldırın; ürün bağları silinmez.
- [Kategoriyi geri getir](https://developer.siparis.app/uc/kategoriyi-geri-getir.md): `POST /v1/categories/{id}/restore` — Arşivdeki kategoriyi geri getirin.
- [Ürün markası oluştur](https://developer.siparis.app/uc/urun-markasi-olustur.md): `POST /v1/brands` — Ürünlerin üretici veya ticari markasını (ör. bir giyim markası) ekleyin.
- [Ürün markalarını listele](https://developer.siparis.app/uc/urun-markalarini-listele.md): `GET /v1/brands` — Ürünlerin üretici veya ticari markalarını alın.
- [Ürün markasını getir](https://developer.siparis.app/uc/urun-markasini-getir.md): `GET /v1/brands/{id}` — Bir ürün markasının adını ve logosunu okuyun; ürünün brand alanını ayrıntılandırırken kullanın.
- [Ürün markasını güncelle](https://developer.siparis.app/uc/urun-markasini-guncelle.md): `PATCH /v1/brands/{id}` — Ürün markasının adını veya logosunu değiştirin.
- [Ürün markasını arşivle](https://developer.siparis.app/uc/urun-markasini-arsivle.md): `POST /v1/brands/{id}/archive` — Ürün markasını vitrinden kaldırın; ürün bağları silinmez.
- [Ürün markasını geri getir](https://developer.siparis.app/uc/urun-markasini-geri-getir.md): `POST /v1/brands/{id}/restore` — Arşivdeki ürün markasını geri getirin.

## Stok

Depodaki miktarlar, stok girişi, sayım, fire, depolar arası taşıma ve stok geçmişi.

- [Stok miktarlarını listele](https://developer.siparis.app/uc/stok-miktarlarini-listele.md): `GET /v1/inventory/levels` — Seçenek ve depo bazında eldeki fiziksel miktarı alın; ERP stok görünümünü güncellerken kullanın.
- [Stok girişi yap](https://developer.siparis.app/uc/stok-girisi-yap.md): `POST /v1/inventory/receipts` — Depoya gelen malı stoğa ekleyin.
- [Stok sayımı yap](https://developer.siparis.app/uc/stok-sayimi-yap.md): `POST /v1/inventory/counts` — Depoda saydığınız miktarı stoğa yazın.
- [Fire ve kayıp yaz](https://developer.siparis.app/uc/fire-ve-kayip-yaz.md): `POST /v1/inventory/write_offs` — Kırılan, kaybolan veya kullanılamayan ürünü stoktan düşün.
- [Depolar arası taşı](https://developer.siparis.app/uc/depolar-arasi-tasi.md): `POST /v1/inventory/transfers` — Bir depodaki malı başka bir depoya taşıyın.
- [Stok hareketlerini listele](https://developer.siparis.app/uc/stok-hareketlerini-listele.md): `GET /v1/inventory/movements` — Stok değişimlerinin değişmez geçmişini alın; mutabakat yaparken kullanın.
- [Stok belgesini getir](https://developer.siparis.app/uc/stok-belgesini-getir.md): `GET /v1/inventory/documents/{id}` — Bir stok girişi, sayım, fire veya taşıma belgesini hareketleriyle okuyun.
- [Stok belgesini geri al](https://developer.siparis.app/uc/stok-belgesini-geri-al.md): `POST /v1/inventory/documents/{id}/reverse` — Yanlış girilmiş mal girişini veya fireyi ters kayıtla düzeltin.
- [Depoları listele](https://developer.siparis.app/uc/depolari-listele.md): `GET /v1/locations` — Anahtarın görebildiği depoları alın; stok miktarlarındaki location kimliğini kendi depo adınızla eşleştirin.

## Kargo

Kargo fiyatı sorun, BasitKargo gönderisi açın, etiket indirin ve iptal edin.

- [Kargo fiyatı sor](https://developer.siparis.app/uc/kargo-fiyati-sor.md): `POST /v1/orders/{id}/shipments/quote` — Gönderi açmadan önce açık kargo firmalarının fiyatını ve gönderim engellerini görün.
- [Gönderi oluştur](https://developer.siparis.app/uc/gonderi-olustur.md): `POST /v1/orders/{id}/shipments` — Siparişi kargoya verin: seçtiğiniz firmayla BasitKargo gönderisi açılır, ücret bakiyenizden düşer.
- [Gönderiyi getir](https://developer.siparis.app/uc/gonderiyi-getir.md): `GET /v1/shipments/{id}` — Gönderinin durumunu, takip kodunu ve kapıda ödeme bilgisini okuyun.
- [Kargo etiketini indir](https://developer.siparis.app/uc/kargo-etiketini-indir.md): `GET /v1/shipments/{id}/label` — Koliye yapıştırılacak kargo etiketini SVG olarak indirin.
- [Gönderiyi iptal et](https://developer.siparis.app/uc/gonderiyi-iptal-et.md): `POST /v1/shipments/{id}/cancel` — Kurye almadan önce gönderiyi iptal edin; ücret paneldeki kuralla bakiyenize döner.
- [Siparişin gönderilerini listele](https://developer.siparis.app/uc/siparisin-gonderilerini-listele.md): `GET /v1/orders/{id}/shipments` — Bir siparişin gönderilerini ve kapıda ödeme bilgilerini alın.

## İade

İade talebini karara bağlayın, ürünü geri alın ve parayı iade edin.

- [İadeyi önizle](https://developer.siparis.app/uc/iadeyi-onizle.md): `POST /v1/orders/{id}/refunds/preview` — İade yapmadan önce iade edilecek tutarı, stok etkisini ve uyarıları görün.
- [İade başlat](https://developer.siparis.app/uc/iade-baslat.md): `POST /v1/orders/{id}/refunds` — Ürünü geri alın ve parayı müşteriye iade edin.
- [Para iadesini getir](https://developer.siparis.app/uc/para-iadesini-getir.md): `GET /v1/refunds/{id}` — Para iadesinin müşteriye ulaşıp ulaşmadığını izleyin.
- [Elle verilen iadeyi kaydet](https://developer.siparis.app/uc/elle-verilen-iadeyi-kaydet.md): `POST /v1/refunds/{id}/money-returned` — Parayı nakit, POS veya havaleyle kendiniz geri verdikten sonra kaydedin.
- [Siparişin iadelerini listele](https://developer.siparis.app/uc/siparisin-iadelerini-listele.md): `GET /v1/orders/{id}/returns` — Siparişe bağlı iade ve değişim kayıtlarını alın; ERP iade durumlarını izlerken kullanın.
- [İade talebini getir](https://developer.siparis.app/uc/iade-talebini-getir.md): `GET /v1/returns/{id}` — Müşterinin iade talebinin kalemlerini ve kararını okuyun.
- [İade talebini onayla](https://developer.siparis.app/uc/iade-talebini-onayla.md): `POST /v1/returns/{id}/approve` — Müşterinin iade veya değişim talebini kabul edin; para iadesi ayrı adımdır.
- [İade talebini reddet](https://developer.siparis.app/uc/iade-talebini-reddet.md): `POST /v1/returns/{id}/reject` — Müşterinin iade talebini gerekçesiyle reddedin.

## Fatura

Fatura kesin, belgesini indirin ve iptal edin.

- [Faturayı önizle](https://developer.siparis.app/uc/faturayi-onizle.md): `POST /v1/orders/{id}/invoices/preview` — Fatura kesmeden önce alıcıyı, kalemleri, tutarı ve fatura türünü görün.
- [Fatura kes](https://developer.siparis.app/uc/fatura-kes.md): `POST /v1/orders/{id}/invoices` — Bağlı fatura sağlayıcınızla siparişin e-Arşiv veya e-Fatura belgesini kesin.
- [Faturayı getir](https://developer.siparis.app/uc/faturayi-getir.md): `GET /v1/invoices/{id}` — Faturanın kesilip kesilmediğini ve iptal durumunu okuyun.
- [Fatura belgesini indir](https://developer.siparis.app/uc/fatura-belgesini-indir.md): `GET /v1/invoices/{id}/document` — Faturanın yazdırılabilir HTML görünümünü indirin.
- [Fatura iptalini önizle](https://developer.siparis.app/uc/fatura-iptalini-onizle.md): `POST /v1/invoices/{id}/cancel/preview` — Faturanın API ile mi, sağlayıcı portalından mı iptal edileceğini öğrenin.
- [Faturayı iptal et](https://developer.siparis.app/uc/faturayi-iptal-et.md): `POST /v1/invoices/{id}/cancel` — Kesilmiş faturayı iptal edin.
- [Siparişin faturalarını listele](https://developer.siparis.app/uc/siparisin-faturalarini-listele.md): `GET /v1/orders/{id}/invoices` — Bir siparişin fatura kayıtlarını ve durumlarını alın; ERP fatura mutabakatında kullanın.

## Başka kanaldaki satış

Ödemesi başka kanalda alınmış satışı stoğa ve sipariş listesine işleyin.

- [Başka kanaldaki satışı bildir](https://developer.siparis.app/uc/baska-kanaldaki-satisi-bildir.md): `POST /v1/external_orders` — Ödemesi başka bir kanalda (ör. Etsy, fuar, kendi kasanız) alınmış kesinleşmiş satışı stoktan düşmek ve listede görmek için kaydedin.

## Toplu işler

Binlerce satırlık fiyat ve stok güncellemesini tek işte yapın.

- [Toplu fiyat güncelle](https://developer.siparis.app/uc/toplu-fiyat-guncelle.md): `POST /v1/bulk/prices` — Binlerce ürün ve seçeneğin fiyatını tek istekte güncelleyin.
- [Toplu stok say](https://developer.siparis.app/uc/toplu-stok-say.md): `POST /v1/bulk/inventory` — Bir depodaki binlerce seçeneğin sayım sonucunu tek istekte yazın.
- [Toplu işin durumunu getir](https://developer.siparis.app/uc/toplu-isin-durumunu-getir.md): `GET /v1/jobs/{id}` — Toplu fiyat veya stok işinin ilerlemesini ve sonucunu izleyin.
- [Toplu işin hatalarını listele](https://developer.siparis.app/uc/toplu-isin-hatalarini-listele.md): `GET /v1/jobs/{id}/errors` — Toplu işte işlenemeyen satırları ve nedenlerini alın.

## Kuponlar

İndirim kuponlarını ekleyin, güncelleyin ve arşivleyin.

- [Kupon oluştur](https://developer.siparis.app/uc/kupon-olustur.md): `POST /v1/coupons` — Markada kullanılacak yeni bir indirim kuponu açın.
- [Kuponları listele](https://developer.siparis.app/uc/kuponlari-listele.md): `GET /v1/coupons` — Markanın veya işletmenin kuponlarını ve kullanım sayılarını alın.
- [Kuponu getir](https://developer.siparis.app/uc/kuponu-getir.md): `GET /v1/coupons/{id}` — Bir kuponun kurallarını ve kullanım sayısını okuyun.
- [Kuponu güncelle](https://developer.siparis.app/uc/kuponu-guncelle.md): `PATCH /v1/coupons/{id}` — Kuponun indirimini, tarihlerini veya kurallarını değiştirin.
- [Kuponu arşivle](https://developer.siparis.app/uc/kuponu-arsivle.md): `POST /v1/coupons/{id}/archive` — Kuponu kullanımdan kaldırın; geçmişi silinmez.
- [Kuponu geri getir](https://developer.siparis.app/uc/kuponu-geri-getir.md): `POST /v1/coupons/{id}/restore` — Arşivdeki kuponu yeniden kullanıma açın.

## Olaylar ve Webhook

Değişiklikleri olay akışından okuyun ya da adresinize imzalı bildirim alın.

- [Olayları listele](https://developer.siparis.app/uc/olaylari-listele.md): `GET /v1/events` — Sipariş, stok, ürün ve müşterideki kalıcı değişiklikleri yayın sırasıyla okuyun; webhook yerine düzenli sorgulamak için kullanın.
- [Olayı getir](https://developer.siparis.app/uc/olayi-getir.md): `GET /v1/events/{id}` — Tek bir olayın değişiklik özetini okuyun; tekil teslimi incelemek için kullanın.
- [Webhook adresi oluştur](https://developer.siparis.app/uc/webhook-adresi-olustur.md): `POST /v1/webhook_endpoints` — Değişikliklerin sizin HTTPS adresinize imzalı olarak gönderilmesi için adres ekleyin.
- [Webhook adreslerini listele](https://developer.siparis.app/uc/webhook-adreslerini-listele.md): `GET /v1/webhook_endpoints` — Bu bağlantının webhook adreslerini ve sağlık durumlarını alın.
- [Webhook adresini getir](https://developer.siparis.app/uc/webhook-adresini-getir.md): `GET /v1/webhook_endpoints/{id}` — Bir webhook adresinin durumunu ve son teslim sonucunu okuyun; teslim sorunlarını teşhis ederken kullanın.
- [Webhook adresini güncelle](https://developer.siparis.app/uc/webhook-adresini-guncelle.md): `PATCH /v1/webhook_endpoints/{id}` — Webhook adresini, olay türlerini veya markasını değiştirin.
- [Webhook denemesi gönder](https://developer.siparis.app/uc/webhook-denemesi-gonder.md): `POST /v1/webhook_endpoints/{id}/test` — Kurulumda veya adresi yeniden açarken adresinize imzalı bir deneme bildirimi gönderin.
- [Webhook sırrını yenile](https://developer.siparis.app/uc/webhook-sirrini-yenile.md): `POST /v1/webhook_endpoints/{id}/rotate_secret` — İmza sırrını değiştirin; eski sır bir süre daha geçerli kalır.
- [Olayı yeniden gönder](https://developer.siparis.app/uc/olayi-yeniden-gonder.md): `POST /v1/webhook_endpoints/{id}/resend` — Alıcınızdaki sorun düzeldikten sonra kaçırılan bir olayı yeniden gönderin.
- [Webhook teslimlerini listele](https://developer.siparis.app/uc/webhook-teslimlerini-listele.md): `GET /v1/webhook_endpoints/{id}/deliveries` — Bir adrese yapılan teslimlerin başarısını, hatasını ve sonraki deneme zamanını izleyin.
- [Teslim denemelerini listele](https://developer.siparis.app/uc/teslim-denemelerini-listele.md): `GET /v1/webhook_endpoints/{id}/deliveries/{delivery}/attempts` — Bir teslimin her denemesindeki HTTP durumunu ve süreyi görün.
- [Webhook adresini kapat](https://developer.siparis.app/uc/webhook-adresini-kapat.md): `POST /v1/webhook_endpoints/{id}/close` — Entegrasyonu durdururken adresi kapatın; teslim geçmişi kalır.

## Dışa aktarma

İlk eşitleme için tutarlı JSONL/CSV dosyası hazırlayın ve indirin.

- [Dışa aktarma başlat](https://developer.siparis.app/uc/disa-aktarma-baslat.md): `POST /v1/exports` — İlk eşitleme için siparişlerin, müşterilerin, ürünlerin veya stoğun tek andaki tutarlı dosyasını hazırlatın.
- [Dışa aktarmanın durumunu getir](https://developer.siparis.app/uc/disa-aktarmanin-durumunu-getir.md): `GET /v1/exports/{id}` — Dosyanın hazırlanmasını izleyin; hazır olunca dosya ve devam imleci gelir.
- [Dışa aktarma dosyasını indir](https://developer.siparis.app/uc/disa-aktarma-dosyasini-indir.md): `GET /v1/files/{id}` — Hazırlanan JSONL/CSV dosyasını indirin.

## Uygulamalar (OAuth) ve MCP

Başka satıcılar için uygulama yapmak (OAuth: /oauth/authorize, /oauth/token) ve AI asistanını /mcp adresine bağlamak. Uygulamalar ve MCP aynı REST uçlarını ve kapsamları kullanır.

- [Başka satıcılar için uygulama yapmak](https://developer.siparis.app/uygulama-yapmak.md)
- [Uygulama sözleşmesi ve KVKK taahhüdü](https://developer.siparis.app/uygulama-sozlesmesi.md)
- [AI asistanınızı bağlamak (MCP)](https://developer.siparis.app/mcp.md)

## Hesap

Bağlantıyı doğrulayın; işletmeyi ve markaları okuyun.

- [Bağlantıyı doğrula](https://developer.siparis.app/uc/baglantiyi-dogrula.md): `GET /v1/me` — Anahtarın çalıştığını, kapsamlarını, erişebildiği markaları ve bu ortamın API adresini görün; ilk istekte ve yetki sorunlarını çözerken kullanın.
- [İşletmeyi getir](https://developer.siparis.app/uc/isletmeyi-getir.md): `GET /v1/business` — Anahtarın bağlı olduğu işletmenin adını, türünü ve vergi durumunu okuyun; ERP şirket kaydını eşleştirirken kullanın.
- [Markaları listele](https://developer.siparis.app/uc/markalari-listele.md): `GET /v1/stores` — Anahtarın erişebildiği satış markalarını alın; çok markalı işletmede store kimliğini seçerken kullanın.

## Rehberler

- [Neler yapabilirim](https://developer.siparis.app/neler-yapabilirim.md)
- [Siparişleri listelemek](https://developer.siparis.app/siparisleri-listelemek.md)
- [Müşterileri bulmak](https://developer.siparis.app/musterileri-bulmak.md)
- [Sipariş eklemek ve ilerletmek](https://developer.siparis.app/siparis-eklemek.md)
- [Başka kanaldaki satışı bildirmek](https://developer.siparis.app/dis-satis-bildirmek.md)
- [Müşteri eklemek ve güncellemek](https://developer.siparis.app/musteri-eklemek.md)
- [Siparişleri ERP’ye almak](https://developer.siparis.app/siparisleri-erpye-almak.md)
- [Stoku eşitlemek](https://developer.siparis.app/stoku-esitlemek.md)
- [Toplu fiyat ve stok güncellemek](https://developer.siparis.app/toplu-guncelleme.md)
- [Stok girmek, saymak ve taşımak](https://developer.siparis.app/stok-yazmak.md)
- [Ürün eklemek ve güncellemek](https://developer.siparis.app/urun-yazmak.md)
- [Kategori, ürün markası ve kupon yazmak](https://developer.siparis.app/kupon-ve-kategori.md)
- [Kargoya vermek](https://developer.siparis.app/kargo-gondermek.md)
- [İade almak ve para iadesi](https://developer.siparis.app/iade-yapmak.md)
- [Fatura kesmek ve iptal etmek](https://developer.siparis.app/fatura-kesmek.md)
- [İlk eşitleme](https://developer.siparis.app/ilk-esitleme.md)
- [Webhook kurmak ve doğrulamak](https://developer.siparis.app/webhook.md)
- [TypeScript ve Python SDK](https://developer.siparis.app/sdk.md)

## Referans

- [Kodlar ve durumlar](https://developer.siparis.app/referans.md)
- [Hata kodları](https://developer.siparis.app/hatalar.md)
- [Kapsamlar ve kişisel veri](https://developer.siparis.app/kapsamlar.md)
- [Olay akışı ve türleri](https://developer.siparis.app/olaylar.md)
- [İmleçle listeleme](https://developer.siparis.app/listeleme.md)
- [Hız sınırı ve tekrar kuralları](https://developer.siparis.app/hiz-siniri.md)
- [Kavramlar ve kimlik önekleri](https://developer.siparis.app/sozluk.md)
- [Bütün uçlar](https://developer.siparis.app/uc-basvurusu.md)
- [Veri modelleri](https://developer.siparis.app/modeller.md)
- [Değişiklik günlüğü](https://developer.siparis.app/degisiklikler.md)
- [OpenAPI sözleşmesini indir](https://developer.siparis.app/uc/openapi-sozlesmesini-indir.md): `GET /v1/openapi.json` — Bütün uçları, alanları ve örnekleri içeren OpenAPI 3.1 belgesini indirin; istemci üretimi, alan doğrulama ve AI entegrasyonu için kullanın.

## Makine için dosyalar

- [OpenAPI 3.1](https://developer.siparis.app/openapi.json): Alanlar, uçlar, örnekler ve kod tabloları.
- [Postman koleksiyonu](https://developer.siparis.app/postman.json): Anahtarsız; {{baseUrl}} ve {{apiKey}} değişkenleriyle.
- [Tam belge](https://developer.siparis.app/llms-full.txt): Bütün rehberler ve uç sayfaları tek Markdown metninde.