Ana içeriğe geç

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

POST https://webservis.ekupbilisim.com/api/outsource/invoice/{UUID}/application-response-json
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için /api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.

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.

ipucu

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": [

         ]
      }
422
İş Kuralı Hatası — Boş UUID
{
"error": 1,
"message": "UUID değeri boş olmamalıdır."
}
422
İş Kuralı Hatası — Tekrar Eden UUID
{
"error": 1,
"message": "UUID değeri daha önce kullanılmış."
}
422
İş Kuralı Hatası — Süre Aşımı
{
"error": 1,
"message": "8 gün içerisinde uygulama yanıtı gönderimi yapılmalıdır."
}
422
İş Kuralı Hatası — Mükerrer Yanıt
{
"error": 1,
"message": "Referans belgeye ait uygulama yanıtı daha önce gönderilmiştir."
}
422
İş Kuralı Hatası — Referans Belge
{
"error": 1,
"message": "Referans belge bulunamadı veya size ait değildir."
}
422
İş Kuralı Hatası — Temel Fatura
{
"error": 1,
"message": "Temel Fatura için Uygulama Yanıtı gönderimi yapılamaz."
}
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/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"
}
}
}'