Skip to main content

İrsaliye Yanıtı - Despatch Receipt (JSON)

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

JSON formatında irsaliye yanıtı (ReceiptAdvice) gönderim işlemleri için gerekli olan API uç noktası. XML oluşturmaya gerek kalmadan Kabul, Red veya kısmi kabul 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 irsaliye yanıtı göndermenizi sağlar. Sistem, JSON'u otomatik olarak UBL-TR ReceiptAdvice 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 irsaliyenin UUID bilgisi.

JSON Parametreleri​

ID string
Yanıt belge numarası. Boş bırakılırsa sistem otomatik oluşturur
UUID string
Yanıt UUID bilgisi. Boş bırakılırsa sistem otomatik oluşturur
IssueDate string required
Yanıt düzenleme tarihi. YYYY-MM-DD formatında
DespatchDocumentReference object required
Yanıt verilen irsaliye referans bilgisi
DespatchSupplierParty object required
İrsaliyeyi gönderen taraf bilgileri
DeliveryCustomerParty object required
İrsaliyeyi alan taraf bilgileri
ReceiptLine array required
Yanıt kalem bilgileri. Kabul/Red detaylarını 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/despatch/{UUID}/application-response-json' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
    "IssueDate": "2025-01-15",
    "DespatchDocumentReference": {
        "ID": "IRS2025000000001",
        "IssueDate": "2025-01-14"
    },
    "DespatchSupplierParty": {
        "Party": {
            "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "0987654321"}}],
            "PartyName": {"Name": "Gönderici Firma Ünvanı"}
        }
    },
    "DeliveryCustomerParty": {
        "Party": {
            "PartyIdentification": [{"ID": {"@schemeID": "VKN", "Value": "1234567890"}}],
            "PartyName": {"Name": "Alıcı Firma Ünvanı"}
        }
    },
    "ReceiptLine": [
        {
            "ID": "1",
            "ReceivedQuantity": {"@unitCode": "C62", "Value": "10"},
            "ShortQuantity": {"@unitCode": "C62", "Value": "0"},
            "RejectedQuantity": {"@unitCode": "C62", "Value": "0"},
            "Item": {"Name": "Ürün Adı"}
        }
    ]
}'