# Gelen e-Fatura Arşive Ekle / Çıkar

> Gelen e-Fatura Arşive Ekle / Çıkar, Evobulut ön muhasebe / ERP yazılımının Gelen e-Fatura modülüne ait bir REST API servisidir. POST yöntemiyle `https://ws.evobulut.com/api/FaturaUbl/base/` adresine JSON gönderilerek çağrılır.

- **Modül:** Gelen e-Fatura
- **Yöntem:** POST
- **Endpoint:** `https://ws.evobulut.com/api/FaturaUbl/base/`
- **Kimlik doğrulama:** Login servisinden alınan Token UID
- **Son güncelleme:** 2026-09-10
- **Doküman:** https://dev.evobulut.com/servis/gelen-e-fatura/gelen-e-fatura-arsive-ekle-cikar-328

## Açıklama

Gelen e-faturaları **arşive ekler** ya da **arşivden çıkarır**. Toplu çalışır. Arşiv yalnızca bir işaretlemedir; kayıt silinmez, listede `a_arsiv` filtresiyle ayrılır.

| cmd | İlgili komut // arsive_ekle_kaldir |
| --- | --- |
| UID | KULLANICI_UID |
| ids | Kimlik Listesi // Virgülle ayrılmış metin ("18245,18246") ya da JSON dizisi ([18245, 18246]) olarak verilebilir. Tek kayıt için a_id de kullanılabilir. Tek istekte en fazla 500 kayıt. |
| ekle_kaldir | Islem // 1 arşive ekle, 2 arşivden çıkar. Zorunludur. |

**Dönen veri**

| veri.islenen | Gerçekten güncellenen kayıt sayısı. Verilen kimlik veritabanında yoksa bu sayı gönderdiğiniz kimlik sayısından küçük olur. |
| --- | --- |
| veri.a_arsiv | Kayıtların ulaştığı durum: 1 arşivde, 0 arşivde değil. |
| veri.mevcut_durumda | İşlem yapılmadıysa, zaten istenen durumda olduğu için engelleyen kayıtların kimlikleri. |

**Kısıt:** Listedeki kayıtlardan biri bile zaten istenen durumdaysa işlemin **tamamı** yapılmaz; arayüzdeki davranış da böyledir. Hangi kayıtların engellediği veri.mevcut_durumda ile döner, o kimlikleri listeden çıkarıp tekrar çağırabilirsiniz.

**Yetki:** “Gelen e-Faturalar” menü yetkisi gereklidir.

## Header bilgileri

| X-ClientId | Login anında alınan kullanıcı Token UID bilgisi |
| --- | --- |

## İstek gövdesi

```json
{
  "cmd": "arsive_ekle_kaldir",
  "UID": "KULLANICI_UID",
  "ids": [
    18245,
    18246
  ],
  "ekle_kaldir": "1"
}
```

## Örnek istek (cURL)

```bash
curl -X POST "https://ws.evobulut.com/api/FaturaUbl/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "cmd": "arsive_ekle_kaldir",
  "UID": "KULLANICI_UID",
  "ids": [
    18245,
    18246
  ],
  "ekle_kaldir": "1"
}'
```

## Başarılı yanıt

```json
{
  "status": "OK",
  "veri": {
    "islenen": 2,
    "a_arsiv": 1
  }
}
```

## Başarısız yanıt

```json
{
  "status": "ERR",
  "veri": {
    "mesaj": "Yapmak istediğiniz işlem daha önce gerçekleştirilmiş.",
    "mevcut_durumda": [
      "18246"
    ]
  }
}
```