Skip to main content

Fatura Uygulama Yanıtı - Application Response (JSON)

POST https://webservis.ekupbilisim.com/api/outsource/invoice/{UUID}/application-response-json

JSON formatında fatura uygulama yanıtı gönderim işlemleri için gerekli olan API uç noktası. XML oluşturmaya gerek kalmadan Kabul veya Red yanıtlarınızı JSON olarak bu uç nokta üzerinden gönderebilirsiniz.

tip

Bu endpoint, XML UBL yapısı oluşturmadan doğrudan JSON verileriyle uygulama yanıtı göndermenizi sağlar. Sistem, JSON'u otomatik olarak UBL-TR ApplicationResponse formatına dönüştürür.

Üst Bilgi (Header) Parametreleri​

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

İstek ( Query ) Parametreleri​

uuid guid required
Yanıt gönderilecek faturanın UUID bilgisi.

JSON Parametreleri​

ID string required
Uygulama yanıtının belge numarası
UUID string required
Uygulama yanıtının UUID bilgisi
IssueDate string required
Uygulama yanıtının düzenleme tarihi. YYYY-MM-DD formatında
SenderParty object required
Gönderici taraf bilgileri
ReceiverParty object required
Alıcı taraf bilgileri
DocumentResponse object required
Belge yanıt bilgileri. Kabul (KABUL) veya Red (RED) bilgisini içerir

Cevaplar ( Responses )​

200
OK
{
        "error": 0,
        "message": "İşlem başarıyla tamamlandı",
        "extra": [

         ]
      }
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/invoice/{UUID}/application-response-json' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
    "ID": "APP2025000000001",
    "UUID": "550e8400-e29b-41d4-a716-446655440000",
    "IssueDate": "2025-01-15",
    "SenderParty": {
        "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "1234567890"}}],
        "PartyName": {"Name": "Alıcı Firma Ünvanı"}
    },
    "ReceiverParty": {
        "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "0987654321"}}],
        "PartyName": {"Name": "Satıcı Firma Ünvanı"}
    },
    "DocumentResponse": {
        "Response": {
            "ResponseCode": "KABUL",
            "Description": "Fatura kabul edilmiştir"
        },
        "DocumentReference": {
            "ID": "FTR2025000000001",
            "IssueDate": "2025-01-14"
        }
    }
}'