Fatura hesabı güncelleme

Mevcut bir fatura hesabının adını, varsayılan/test işaretini, gelen belge aktarım ayarlarını veya sağlayıcı ayarlarını değiştirmek için bu endpoint kullanılır. Yalnızca gönderdiğiniz alanlar güncellenir; gönderilmeyenler korunur.

Bu uç yalnızca Geliştirici paketlerinde açıktır (bkz. sağlayıcı listesi sayfasındaki uyarı).

İstek

PUT /api/integrations/invoice/{id}
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

PATCH de kabul edilir. Hesabınıza ait olmayan {id} için 404 döner.

İstek gövdesi

Tüm alanlar isteğe bağlıdır.

Alan	Tip	Açıklama
name	string	Hesabın görünen adı.
is_default	boolean	true gönderilirse bu hesap varsayılan olur, diğer hesapların varsayılan işareti kaldırılır.
is_test	boolean	Test hesabı işareti.
stop_before_formalize	boolean	true ise faturalar taslak olarak aktarılır, resmileştirilmez.
sync_incoming_waybills	boolean	Gelen irsaliye aktarımını açar/kapatır. Sağlayıcının capabilities.incoming_waybill değeri false ise her zaman false kaydedilir.
sync_incoming_invoices	boolean	Gelen fatura aktarımını açar/kapatır. Sağlayıcının capabilities.incoming_invoice değeri false ise her zaman false kaydedilir.
settings	object	Sağlayıcı ayarları; yalnızca verilen anahtarlar güncellenir (kısmi güncelleme). Anahtarlar sağlayıcı alanları şemasındaki key değerleridir.
settings.extra	array	Satış kanalı bazlı ek ayarlar. Her öğe sale_channel_id içermelidir; aynı kanal için kayıt varsa güncellenir, yoksa oluşturulur.

Ayarlar doğrulanmaz, bağlantı test edilmez

Oluşturmadan farklı olarak güncellemede settings alanları şemaya göre doğrulanmaz ve sağlayıcıya bağlantı testi yapılmaz. Yanlış kimlik bilgisi, ilk fatura/irsaliye işleminde hata olarak ortaya çıkar.

Gelen belge aktarımı

sync_incoming_invoices / sync_incoming_waybills açıldığında platform bu hesaptaki yeni gelen faturaları / irsaliyeleri 30 dakikada bir çeker. Aktarılan her belge paketinizden 1 kontör düşer; kontör bittiğinde aktarım durur. Ayrıntı için gelen faturalar ve gelen irsaliyeler sayfalarına bakın.

Örnek istekler

💻 cURL

curl -X PUT "https://app.faturaentegrator.com/api/integrations/invoice/12" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Klinik A - Mysoft (Merkez)",
    "is_default": true,
    "sync_incoming_invoices": true,
    "settings": { "password": "yeni-parola" }
  }'

🐘 PHP

<?php
$body = [
    'name' => 'Klinik A - Mysoft (Merkez)',
    'is_default' => true,
    'sync_incoming_invoices' => true,
    'settings' => ['password' => 'yeni-parola'],
];
$ch = curl_init('https://app.faturaentegrator.com/api/integrations/invoice/12');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_POSTFIELDS => json_encode($body),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    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/12', {
  method: 'PUT',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Klinik A - Mysoft (Merkez)',
    is_default: true,
    sync_incoming_invoices: true,
    settings: { password: 'yeni-parola' },
  }),
});
const data = await res.json();

🐍 Python

import requests
r = requests.put(
    'https://app.faturaentegrator.com/api/integrations/invoice/12',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'name': 'Klinik A - Mysoft (Merkez)',
        'is_default': True,
        'sync_incoming_invoices': True,
        'settings': {'password': 'yeni-parola'},
    },
)
data = r.json()

Yanıt

Güncellenen hesap kaydı, oluşturma yanıtıyla aynı biçimde data altında döner.