Ana Sayfa › Gelen e-Fatura › Gelen e-Fatura Arşive Ekle / Çıkar

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; kimlik doğrulama için Login servisinden alınan Token UID değeri gereklidir.

POSThttps://ws.evobulut.com/api/FaturaUbl/base/

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

İstek Gövdesi (JSON)

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

Kod Örnekleri

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"
}'

const response = await fetch("https://ws.evobulut.com/api/FaturaUbl/base/", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      "cmd": "arsive_ekle_kaldir",
      "UID": "KULLANICI_UID",
      "ids": [
        18245,
        18246
      ],
      "ekle_kaldir": "1"
    })
});

const veri = await response.json();
console.log(veri);

using System.Text;
using System.Text.Json;

using var client = new HttpClient();

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

var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://ws.evobulut.com/api/FaturaUbl/base/", content);
var veri = await response.Content.ReadAsStringAsync();

Console.WriteLine(veri);

import requests

url = "https://ws.evobulut.com/api/FaturaUbl/base/"
payload = {
  "cmd": "arsive_ekle_kaldir",
  "UID": "KULLANICI_UID",
  "ids": [
    18245,
    18246
  ],
  "ekle_kaldir": "1"
}

response = requests.post(url, json=payload)
print(response.json())

<?php
$url = "https://ws.evobulut.com/api/FaturaUbl/base/";
$payload = '{
  "cmd": "arsive_ekle_kaldir",
  "UID": "KULLANICI_UID",
  "ids": [
    18245,
    18246
  ],
  "ekle_kaldir": "1"
}';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();

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

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://ws.evobulut.com/api/FaturaUbl/base/"))
        .header("Content-Type", "application/json")
        .method("POST", HttpRequest.BodyPublishers.ofString(json))
        .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

import 'dart:convert';
import 'package:http/http.dart' as http;

final response = await http.post(
  Uri.parse('https://ws.evobulut.com/api/FaturaUbl/base/'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({
    "cmd": "arsive_ekle_kaldir",
    "UID": "KULLANICI_UID",
    "ids": [
      18245,
      18246
    ],
    "ekle_kaldir": "1"
  }),
);

print(jsonDecode(response.body));

Başarılı Yanıt

200 OK

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

Başarısız Yanıt

200 OK — status: ERR

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

Gelen e-Fatura modülündeki diğer servisler

Gelen e-Fatura modülünün tamamı (7 servis) →