Skip to main content

Makbuz Gönderim - Send Receipt (JSON)

POST https://webservis.ekupbilisim.com/api/outsource/receipt/send-json

JSON formatında serbest meslek makbuzu gönderim işlemleri için gerekli olan API uç noktası. Bu uç nokta, UBL yapısına uygun JSON verilerini alır, XML'e dönüştürür, sisteme kaydeder ve GİB'e gönderir.

tip

XML oluşturmaya gerek kalmadan doğrudan JSON verileriyle serbest meslek makbuzu gönderebilirsiniz. Sistem, JSON'u otomatik olarak e-Arşiv formatına dönüştürür.

Üst Bilgi (Header) Parametreleri​

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

JSON Parametreleri​

receiver_alias string
Özel bir etikete gönderilmek isteniyorsa kullanılır. Sistem otomatik ilk sıradakine gönderir
ProfileID string required
Belge profili. Örn: EARSIVBELGE
DocumentCurrencyCode string required
Para birimi kodu. Örn: TRY, USD, EUR
IssueDate string required
Makbuz düzenleme tarihi. YYYY-MM-DD formatında
AccountingSupplierParty object required
Hizmet veren taraf bilgileri. UBL-TR AccountingSupplierParty yapısına uygun JSON nesnesi
AccountingCustomerParty object required
Hizmet alan taraf bilgileri. UBL-TR AccountingCustomerParty yapısına uygun JSON nesnesi
info

Yukarıda listelenmemiş tüm UBL-TR alanları opsiyonel olarak gönderilebilir. Detaylı alan listesi için GİB UBL-TR kılavuzlarına bakınız.

Cevaplar ( Responses )​

200
OK
{
        "error": 0,
        "message": "İşlem başarıyla tamamlandı",
        "extra": {
          "id": "01k1x8rykgcnjv07zgf8h07sey",
          "signedXml": [
            "base64"
          ]
        }
      }
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."
}
422
Unprocessable Entity
{
  "error": 1,
  "message": "Form verileri ile ilgili sorun mevcut, lütfen verileri kontrol ediniz",
  "fields": {
    "password": [
      "password zorunludur."
    ]
  }
}
500
Server Error
{
  "error": 1,
  "message": "Sunucu Hatası"
}

Örnek İstek ( Curl )​


curl -X POST --location 'https://webservis.ekupbilisim.com/api/outsource/receipt/send-json' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
    "ProfileID": "EARSIVBELGE",
    "DocumentCurrencyCode": "TRY",
    "IssueDate": "2025-01-15",
    "AccountingSupplierParty": {
        "Party": {
            "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "1234567890"}}],
            "PartyName": {"Name": "Hizmet Veren Firma Ünvanı"},
            "PostalAddress": {
                "CitySubdivisionName": "İlçe",
                "CityName": "İl",
                "Country": {"Name": "Türkiye"}
            }
        }
    },
    "AccountingCustomerParty": {
        "Party": {
            "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "0987654321"}}],
            "PartyName": {"Name": "Hizmet Alan Firma Ünvanı"},
            "PostalAddress": {
                "CitySubdivisionName": "İlçe",
                "CityName": "İl",
                "Country": {"Name": "Türkiye"}
            }
        }
    },
    "InvoiceLine": [
        {
            "ID": "1",
            "InvoicedQuantity": {"@unitCode": "C62", "Value": "1"},
            "LineExtensionAmount": {"@currencyID": "TRY", "Value": "500.00"},
            "Item": {"Name": "Danışmanlık Hizmeti"},
            "Price": {"PriceAmount": {"@currencyID": "TRY", "Value": "500.00"}}
        }
    ]
}'