> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Fatura taslağından muhasebe aktarımına

> Bağlantıyı hazırlayın, gerçek taslak oluşturun, gönderin ve muhasebe aktarımını ayrı adımlar olarak izleyin.

Fatura oluşturma, sağlayıcıya gönderme ve Muhasip muhasebe kayıtlarına aktarma ayrı işlemlerdir. Bu rehberdeki ortak işlem ucu yalnız `invoiceInfo`, `view`, `invoiceapproval` ve `invoicecancel` türlerini kabul eder.

<Steps>
  <Step title="Bağlantıyı ve belge seçeneklerini hazırlayın">
    [Bağlantı durumunu](/api-reference/fatura/finance-get-invoice-info), [krediyi](/api-reference/fatura/finance-get-invoice-credit) ve [ayarları](/api-reference/fatura/finance-get-invoice-settings) okuyun. Bağlı hesap bulunmuyorsa yetkili bilgilerle [bağlantı kurun](/api-reference/fatura/finance-connect-invoice).

    [Fatura işlem ucunda](/api-reference/fatura/finance-invoice-action) `type=invoiceInfo` kullanarak mükellef/seri/şablon seçeneklerini alın. Bu varyant okuma izni ister. Gerçek alıcı posta kutusunu, seriyi ve şablonu bu seçeneklerden seçin.
  </Step>

  <Step title="Belge verisini hazırlayın ve taslak oluşturun">
    Alıcı, satır, vergi ve toplamları [veri kuralları](/rehberler/veri-kurallari) ile doğrulayın. İş referansınız için kalıcı bir `Idempotency-Key` saklayın; `type=view` ile taslak oluşturun.

    **view yalnız önizleme değildir; sağlayıcıda gerçek taslak oluşturur.** Dönen belge ve işlem kimliklerini kaydedin. Rastgele UUID üretip sağlayıcı kimliği kabul etmeyin.
  </Step>

  <Step title="Mevcut taslağı gönderin">
    Aynı işlem ucunda `type=invoiceapproval`, uygun `moduleType=eInvoice|eArchive` ve 1–100 benzersiz belge UUID’sini kullanın. Örnek gövdeler işlem sayfasında ayrı sekmelerdedir.

    Gönderim kabulü doğrulanmadan belgenin aktarılmış olduğunu varsaymayın. Kısmi veya belirsiz sonucu bütün hedefler için başarı saymayın; makbuzları ayrı izleyin.
  </Step>

  <Step title="Muhasebe aktarımını doğrulayın">
    [Belge aktarımı](/api-reference/fatura/finance-import-invoice) veya [eşitleme](/api-reference/fatura/finance-sync-invoices) ilgili mali kayıtları oluşturabilir. Eşitlemede `Idempotency-Key` zorunludur; alt belge işlemlerini de takip edin.

    Aynı firmada devam eden başka bir mali işlemle çakışma varsa `409` alınabilir. Mevcut işlemin durumunu kontrol edin; yeni anahtarla tekrar başlatmayın.
  </Step>
</Steps>

## Silme, iptal ve bağlantıyı kaldırma

| İşlem | Etki ve sınır |
| - | - |
| `type=invoicecancel` | Mevcut taslağı silme varyantıdır; gönderilmiş faturanın mali iptaliyle aynı değildir. |
| [Fatura iptali](/api-reference/fatura/finance-cancel-invoice) | Belgeyi ve bağlı muhasebe, ödeme ve stok kayıtlarını etkiler; desteklenmeyen ödeme ilişkileri `409` döndürür. |
| [Bağlantıyı kaldırma](/api-reference/fatura/finance-disconnect-invoice) | Entegrasyon bağlantısına yöneliktir; belgelerin mali olarak iptal edildiği anlamına gelmez. |

Banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme içeren iptal `409 INVOICE_COMPLEX_PAYMENT_CANCEL_UNSUPPORTED` ile reddedilir. Desteklenmeyen kaynaktan oluşturulmuş faturada `409 INVOICE_EXCLUDED_SOURCE_CANCEL_UNSUPPORTED` döner. Bu hatalarda belge iptali başlatılmaz.

## Belirsiz cevapta

`502`, bağlantı kopması veya `review_required` sonucunda yeniden taslak/gönderim başlatmayın. [İşlem durumunu okuyun](/api-reference/islem-takibi/muhasip-get-apps-operations-operationid) ve sağlayıcıdaki belgeyle mutabakat yapın. Tamamlanmış tekrar cevabı ilk HTML/PDF veya mali gövdeyi birebir tekrarlamaz.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.