Ana içeriğe geç

Adisyon Gönderim - Send Check (XML)

POST https://webservis.ekupbilisim.com/api/outsource/check/send
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için /api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.

Adisyon gönderim işlemleri için gerekli olan API uç noktası. Bu uç nokta, XML(UBL) formatında adisyon verilerini alır, sisteme kaydeder ve GİB'e gönderir.

Üst Bilgi (Header) Parametreleri​

Authorization string required
Bearer token ile kimlik doğrulama yapılmalıdır.

JSON Parametreleri​

xml string required
Base64 formatında XML(UBL) adisyon verisi. Oluşturduğunuz UBL'i string olarak bu alanda göndermelisiniz.
receiver_alias string
Özel bir etikete gönderilmek isteniyorsa kullanılır. Sistem otomatik ilk sıradakine gönderir

Cevaplar ( Responses )​

200
OK
{
        "error": 0,
        "message": "İşlem başarıyla tamamlandı",
        "extra": {
          "id": "01k1x8rykgcnjv07zgf8h07sey",
          "signedXml": [
            "base64"
          ]
        }
      }
422
İş Kuralı Hatası — Etiket
{
"error": 1,
"message": "Bu vergi numarasına ait adisyon gönderici etiketi bulunamadı."
}
422
İş Kuralı Hatası — Yapı Bozuk
{
"error": 1,
"message": "XML yapısı bozuk veya geçerli değildir. Hata: :error"
}
422
İş Kuralı Hatası — Şematron
{
"error": 1,
"message": "E-Adisyon Özel Şematron Kontrolü Hatalıdır."
}
422
İş Kuralı Hatası — XML İçerik
{
"error": 1,
"message": "XML içeriği boş olmamalıdır."
}
422
İş Kuralı Hatası — Base64 Format
{
"error": 1,
"message": "XML içeriği geçerli bir Base64 formatında değildir."
}
422
İş Kuralı Hatası — İmza Doğrulama
{
"error": 1,
"message": "Belge imzalandı ancak doğrulama başarısız."
}
401
Unauthorized
{
  "error": 1,
  "message": "e-Posta veya şifre hatalı."
}
404
Not Found
{
  "error": 1,
  "message": "The route api/outsource/auth/login1 could not be found."
}
500
Server Error
{
  "error": 1,
  "message": "Sunucu Hatası"
}

Örnek İstek ( Curl )​


curl -X POST --location 'https://webservis.ekupbilisim.com/api/outsource-test/check/send' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
"xml": "BASE64 XML"
}'