> ## 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.

# GİB e-Arşiv taslak ve imza akışı

> GİB bağlantısı, kesin ETTN, SMS doğrulama ve imzayı ayrı adımlarla yönetin.

GİB e-Arşiv belgeleri için bağlantı kurma, taslak oluşturma, SMS doğrulama, imzalama ve belge çıktısı alma adımlarını izleyin.

<Steps>
  <Step title="Hesabı bağlayın ve durumu okuyun">
    [GİB bağlantısını](/api-reference/e-arsiv/payments-connect-e-archive) kurun; [güvenli hesap bilgisini](/api-reference/e-arsiv/muhasip-get-apps-earsiv-getuserdata) okuyun. GİB tokenı API cevabında sunulmaz.
  </Step>

  <Step title="Taslağı oluşturun ve kesin ETTN’yi alın">
    [Ortak işlem ucunda](/api-reference/e-arsiv/payments-execute-e-archive-action) `func=send` ile belge alanlarını gönderin. `Idempotency-Key` zorunludur. Bu adım SMS imzasıyla aynı işlem değildir.

    Sağlayıcı kesin ETTN sunmazsa `review_required` oluşabilir. Son listelenen belgeyi veya rastgele UUID’yi bu işlemin sonucu kabul etmeyin; yeni belge gönderimi başlatmayın.
  </Step>

  <Step title="SMS işlemini başlatın">
    `func=verifyPhoneNumber` için ayrı, kalıcı iş anahtarı kullanın. Dönen SMS işlem kimliğini (`oid`) ilgili belge ve iş referansıyla saklayın.
  </Step>

  <Step title="Belgeyi imzalayın">
    `func=sign`, SMS kodu, `oid` ve belgenin kesin `ettn` değerini gerektirir. Başarı yalnız GİB’in kesin kabul koşuluyla belirlenir.

    Aynı ETTN+OID altında farklı SMS kodu kullanımı `409` verebilir. Kesin yanlış kod reddinden sonra yeni SMS challenge/oid alın; mevcut hedefi yeni anahtarla zorlamayın.
  </Step>

  <Step title="Belgeyi sorgulayın ve çıktıyı alın">
    `query` için `type=giden|itiraz` ve sıralı iki ISO gün kullanın. `html` ve `download` için doğru UUID ve açık bir `signed` boolean değeri gönderin. Gelen içeriği işlem sayfasının cevap biçimine göre işleyin.
  </Step>
</Steps>

## İşlem türleri

| `func` | Etki | İzin / anahtar |
| - | - | - |
| `getUserData` | Güvenli hesap bilgisini okur | read |
| `query` | Belge listesini sorgular | read |
| `html`, `download` | İstenen belge çıktısını alır | read; `signed` zorunlu |
| `send` | Belge/taslak oluşturma adımı | write; Idempotency-Key zorunlu |
| `verifyPhoneNumber` | SMS doğrulama adımını başlatır | write; Idempotency-Key zorunlu |
| `sign` | Belgeyi SMS bilgisiyle imzalar | write; hedef işlem koruması |
| `cancel` | Belgeli hedefi iptal eder | write; hedef işlem koruması |
| `logout` | GİB oturumundan çıkış yapar | write |

`cancel` için belge tarihi, kesin ETTN ve gerekçe alanlarını doğru taşıyın. Sağlayıcı iptali kesinleşmeden yerel bağın kalktığını varsaymayın. `logout` veya [bağlantıyı kaldırma](/api-reference/e-arsiv/payments-disconnect-e-archive), belgelerin mali iptali değildir.

[İşlem referansı ve tüm varyant örnekleri](/api-reference/e-arsiv/payments-execute-e-archive-action) · [Belirsiz sonuç yönetimi](/rehberler/hata-yonetimi)


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