Bu entegrasyon için sisteminizin, siparişlerinizi belirli bir adreste (URL) JSON formatında yayınlaması gerekir. Bunun için teknik ekibinize veya yazılımcınıza aşağıdaki dokümanı iletmeniz yeterlidir:

**Teknik (geliştirici) dokümanı:** <https://dev.faturaentegrator.com/feed-entegrasyonu>

Yazılımcınızdan şu bilgileri isteyin:

* **Sipariş Feed Adresi (URL)** — zorunlu

* **Yetkilendirme bilgileri** — feed adresiniz korumalıysa (token, kullanıcı adı/şifre veya özel header)

* **Bildirim Adresi (URL)** — isteğe bağlı; fatura kesildiğinde sisteminize haber vermemizi istiyorsanız

## Kanalı Ekleyin

Fatura Entegratör paneline giriş yapıp **Ayarlar > Entegrasyonlar > Satış Kanalları** yolunu izliyoruz.

**Kanal Ekle** butonuna tıklayıp listeden **JSON Feed (Özel Entegrasyon)** kanalını seçiyoruz.

## Bilgileri Doldurun

Açılan ekranda aşağıdaki alanları dolduruyoruz:

**Sipariş Feed Adresi (URL)** Siparişlerinizin yayınlandığı adres.

**Yetkilendirme Türü** Feed adresiniz herkese açıksa **Yok** seçeneğini işaretleyin. Adresiniz korumalıysa sisteminize uygun olan seçeneği belirleyin:

* **Bearer Token** — token bilgisi istenir

* **Basic Auth** — kullanıcı adı ve şifre istenir

* **Özel Header** — header adı ve değeri istenir

Seçiminize göre ilgili alanlar ekranda otomatik olarak belirir.

**Bildirim Adresi (URL)** İsteğe bağlıdır. Doldurduğunuzda, faturanız oluşturulduğunda veya silindiğinde sipariş numarası ve fatura bilgileriyle (PDF bağlantısı dahil) bu adrese bildirim gönderilir.

## Bağlantıyı Test Edin ve Kaydedin

**Bağlantıyı Test Et** butonuna tıklıyoruz. "Bağlantı başarılı" mesajını gördüğümüzde **Kanal Bilgilerini Kaydet** butonu ile kurulumu tamamlıyoruz.

⚠️ **Bağlantı testi başarısız olursa:** Feed adresinizin internetten erişilebilir olduğundan, yetkilendirme bilgilerini doğru girdiğinizden ve adresin teknik dokümandaki JSON formatında yanıt verdiğinden emin olun.

## Siparişlerinizi ve Faturalarınızı Takip Edin

* Siparişleriniz **saatte bir** otomatik olarak alınır ve **Siparişler** sayfasında listelenir.

* Siparişlerinizden dilediğiniz an tek tıkla fatura oluşturabilir veya otomatik faturalandırmayı kullanabilirsiniz.

* Bildirim Adresi tanımladıysanız, faturanız resmileştiğinde PDF bağlantısıyla birlikte sisteminize otomatik bildirim gönderilir.

## Denemek İster Misiniz?

* [`https://feed-example.faturaentegrator.com/`](https://feed-example.faturaentegrator.com/) adresinden tüm tip ve webhook için deneme endpointleri mevcut

Kendi feed'inizi hazırlamadan önce entegrasyonun nasıl çalıştığını görmek isterseniz örnek feed adresimizi kullanabilirsiniz:

* **Feed Adresi:** [`https://feed-example.faturaentegrator.com/orders`](https://feed-example.faturaentegrator.com/orders)

* **Yetkilendirme Türü:** Yok

Bu adres, örnek siparişler içeren bir deneme feed'idir. Kanalı bu adresle ekleyip akışı uçtan uca test edebilirsiniz.

## Sık Sorulan Sorular

### Siparişlerim gelmiyor, ne yapmalıyım?

Kanal düzenleme sayfasındaki **Bağlantıyı Test Et** butonu ile adresinizi doğrulayın. Sorun devam ederse feed'inizin teknik dokümandaki formata uygun olduğunu yazılımcınızla birlikte kontrol edin.

### Feed'imde vergi numarası olmayan siparişler var, fatura kesilebilir mi?

Evet. Vergi/TC kimlik numarası boş gelen siparişler, mevzuata uygun şekilde `11111111111` (nihai tüketici) olarak faturalandırılır.

### Hangi para birimleri destekleniyor?

Feed'inizde ISO kodu ile gönderilen tüm para birimleri (TRY, USD, EUR vb.) desteklenir.