Fatura Gönderim - Send Invoice (XML)
POST https://webservis.ekupbilisim.com/api/outsource/invoice/send
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için
/api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.Fatura gönderim işlemleri için gerekli olan API uç noktası. Bu uç nokta, XML(UBL) formatında fatura 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) fatura 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"
],
"isEInvoice": true
}
}422
İş Kuralı Hatası — Alıcı Tipi Uyuşmazlığı
{
"error": 1,
"message": "E-Fatura kullanıcısı için E-Arşiv gönderimi yapılamaz."
}422
İş Kuralı Hatası — Alıcı Tipi Uyuşmazlığı (Ters Yön)
{
"error": 1,
"message": "E-Arşiv kullanıcısı için E-Fatura gönderimi yapılamaz."
}422
İş Kuralı Hatası — GIB Öneki
{
"error": 1,
"message": "GIB kuralları gereği; GIB öneki kullanılamaz"
}422
İş Kuralı Hatası — Gönderici Etiketi
{
"error": 1,
"message": "Gönderici etiketi bulunamadı."
}422
İş Kuralı Hatası — NACE/KDV Uyumsuzluğu
{
"error": 1,
"message": "NACE KDV Oran Kontrolü Hatalıdır."
}422
İş Kuralı Hatası — Şema/Şematron
{
"error": 1,
"message": "Şema / Şematron Kontrolü Hatalıdır."
}422
İş Kuralı Hatası — E-Arşiv Şematron
{
"error": 1,
"message": "E-Arşiv Özel Şematron Kontrolü Hatalıdır."
}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ı — Invoice Kök Eleman
{
"error": 1,
"message": "XML içeriğinde UBL-TR Invoice kök elemanı 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/invoice/send' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••' \
--data '{
"xml": "BASE64 XML"
}'