İrsaliye Yanıtı - Despatch Receipt (JSON)
POST https://webservis.ekupbilisim.com/api/outsource/despatch/{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 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.
ipucu
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": [
]
}422
İş Kuralı Hatası — Referans Belge
{
"error": 1,
"message": "Referans belge bulunamadı veya size ait değildir."
}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."
}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/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ı"}
}
]
}'