Serbest Meslek Makbuzu Gönderim - Send Receipt (XML)
POST https://webservis.ekupbilisim.com/api/outsource/receipt/send
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için
/api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.Serbest Meslek Makbuzu gönderim işlemleri için gerekli olan API uç noktası. Bu uç nokta, XML(UBL) formatında serbest meslek makbuzu 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) Serbest Meslek Makbuzu 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",
"signedXml": [
"base64"
]
}
}422
İş Kuralı Hatası — Gönderici Etiketi
{
"error": 1,
"message": "Gönderici etiketi bulunamadı."
}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ı — İçerik
{
"error": 1,
"message": "XML içerisinde ReceiptAdvice bulunamadı."
}422
İş Kuralı Hatası — İmza Doğrulama
{
"error": 1,
"message": "Belge 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/receipt/send' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
"xml": "BASE64 XML"
}'