Ana içeriğe geç

İrsaliye Gönderim - Send Despatch (XML)

POST https://webservis.ekupbilisim.com/api/outsource/despatch/send
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için /api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.

İrsaliye gönderim işlemleri için gerekli olan API uç noktası. Bu uç nokta, XML(UBL) formatında irsaliye verilerini alır, sisteme kaydeder ve GİB'e gönderir.

Üst Bilgi (Header) Parametreleri​

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

JSON Parametreleri​

xml string required
Base64 formatında XML(UBL) irsaliye verisi. Oluşturduğunuz UBL'i string olarak bu alanda göndermelisiniz.
receiver_alias string
Özel bir etikete gönderilmek isteniyorsa kullanılır. Sistem otomatik ilk sıradakine gönderir

Cevaplar ( Responses )​

200
OK
{
        "error": 0,
        "message": "İşlem başarıyla tamamlandı",
        "extra": {
          "id": "01k1x8rykgcnjv07zgf8h07sey",
          "envelopeId": "32a0fa61-1aa9-47ef-123d-30f72e326369",
          "signedXml": [
            "base64"
          ],
          "isEDespatch": true
        }
      }
422
İş Kuralı Hatası — Gönderici Etiketi
{
"error": 1,
"message": "Hesaba ait aktif etiket bulunamadı. Lütfen etiket tanımlarınızı kontrol edin."
}
422
İş Kuralı Hatası — XML İçerik
{
"error": 1,
"message": "XML içeriği boş olmamalıdır."
}
422
İş Kuralı Hatası — Base64 Format
{
"error": 1,
"message": "XML içeriği geçerli bir Base64 formatında değildir."
}
422
İş Kuralı Hatası — XML Formatı
{
"error": 1,
"message": "Geçersiz DespatchAdvice XML formatı."
}
422
İş Kuralı Hatası — İmza Doğrulama
{
"error": 1,
"message": "İrsaliye imzalandı ancak doğrulama başarısız."
}
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/send' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
"xml": "BASE64 XML"
}'