Fatura sağlayıcıları listesi

API üzerinden fatura hesabı eklerken seçilebilecek sağlayıcıları (entegratör / portal) listelemek için bu endpoint kullanılır. Yanıttaki id değeri, fatura hesabı oluşturma isteğinde integration_id olarak gönderilir; her sağlayıcının hangi ayar alanlarını beklediği ise sağlayıcı alanları endpoint'inden alınır.

Yalnızca Geliştirici paketlerinde

Sağlayıcı listesi ve alanları ile hesap ekleme/güncelleme/silme uçları yalnızca Geliştirici paketlerinde açıktır. Diğer paketlerde 403 ve şu gövde döner:

{
  "message": "Bu özellik yalnızca Geliştirici paketlerinde kullanılabilir.",
  "errors": { "api_error": ["Bu özellik yalnızca Geliştirici paketlerinde kullanılabilir."] }
}

Hesap listeleme ve detay uçları ise tüm paketlerde açıktır.

İstek

GET /api/integrations/invoice/providers
Accept: application/json
Authorization: Bearer YOUR_API_KEY

Örnek istekler

💻 cURL

curl -X GET "https://app.faturaentegrator.com/api/integrations/invoice/providers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/integrations/invoice/providers');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/integrations/invoice/providers', {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const data = await res.json();

🐍 Python

import requests
r = requests.get(
    'https://app.faturaentegrator.com/api/integrations/invoice/providers',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
data = r.json()

Yanıt

Sağlayıcılar data dizisinde döner. Listede yalnızca etkin sağlayıcılar bulunur.

{
  "data": [
    {
      "id": "mysoft",
      "title": "Mysoft",
      "description": "Mysoft portal girişinde kullandığınız e-posta adresiniz ve parolanız ile bağlantı kurabilirsiniz.",
      "help_link": "https://support.faturaentegrator.com/hc/...",
      "logo": "https://app.faturaentegrator.com/assets/images/integration-logo/mysoft.svg",
      "can_check_connection": true,
      "capabilities": {
        "outgoing_waybill": true,
        "incoming_waybill": true,
        "incoming_invoice": true,
        "incoming_invoice_response": true,
        "return_invoice": true
      }
    }
  ]
}

Alan	Tip	Açıklama
id	string	Sağlayıcı kimliği. Hesap eklerken integration_id olarak gönderilir.
title	string	Görünen ad.
description	string | null	Bağlantı için gereken bilgilerin kısa açıklaması (HTML içerebilir).
help_link	string | null	Kurulum yardım makalesi.
logo	string	Logo adresi.
can_check_connection	boolean	true ise hesap eklerken girilen bilgilerle bağlantı testi yapılır; test başarısızsa hesap kaydedilmez.
capabilities.outgoing_waybill	boolean	Giden irsaliye oluşturabilir.
capabilities.incoming_waybill	boolean	Gelen irsaliyeleri aktarabilir.
capabilities.incoming_invoice	boolean	Gelen faturaları aktarabilir.
capabilities.incoming_invoice_response	boolean	Gelen ticari e-faturalara kabul / red yanıtı verebilir.
capabilities.return_invoice	boolean	İade faturası kesebilir.

Yanıtta ayar alanlarının şeması yer almaz; onun için sağlayıcı alanları endpoint'ini çağırın.