Yalnız fatura gönderimiyle sınırlı olmayan bir entegrasyon
Belge oluşturmak işin ilk adımıdır. Bağlı yazılımın gelen belgeleri alması, ticari faturaya yanıt vermesi, PDF/UBL XML içeriğine erişmesi ve gönderim sonucunu izlemesi de gerekir. MultiPortal’ın herkese açık uç listesi bu işlemleri belge gruplarıyla gösterir. 21 Kasım 2026 kontrolünde listede 61 REST uç tanımı vardır; uç sayısı tek başına entegrasyonun işletmeye uygunluğunu göstermez.
- Fatura: e-Fatura/e-Arşiv oluşturma, gönderim, durum, içerik indirme ve uygun e-Arşiv iptal işlemi.
- Gelen belgeler: fatura listeleme ve ticari faturaya kabul/red; gelen irsaliyede kabul, red veya kısmi kabul yanıtı.
- Diğer belge türleri: e-İrsaliye, e-SMM ve e-MM için doğrulama, taslak, gönderim ve içerik erişimi.
- İşletim: hesap/yetki ve kontör sorgusu, olay akışı ve imzalı webhook teslimleri.
Gönderim yanıtı alınması ile belgenin nihai durumu aynı şey değildir. Belge türüne uygun durum takibini ayrı kurun. e-Defter saklama hizmetini, bu API’nin belge oluşturma kapsamına dahilmiş gibi değerlendirmeyin.
Güvenli başlangıç için altı adım
- Kapsamı belirleyin. Hangi yazılımdan, hangi firma ve belge türleriyle bağlanacağınızı netleştirin. API sayfasındaki talep alanından erişim koşullarını görüşün.
- Yetkiyi kontrol edin. İlk sorgunuz
GET /hesapolsun. Anahtar tek firmaya bağlıdır; okuma, taslak ve tam modlarının izinleri farklıdır. Anahtarı istemci koduna, açık depoya veya loglara koymayın. - Alıcı ve tutarı doğrulayın. Mükellef sorgusunu ve ilgili
/dogrulaucunu kullanın. Bu denetim kayıt oluşturmaz. KDV dahil/hariç birim fiyat ayrımını vebeklenen_toplamalanını doğru eşleyin. - Önce taslakla çalışın.
gonder: falseile belgeyi inceleyin. Taslak modundaki anahtar GİB gönderimi yapamaz. Demo ekranı ile API geliştirme yetkisi farklıdır; ayrı bir test alan adı varmış gibi adres üretmeyin. - Mükerrer kaydı önleyin. Kendi sisteminizdeki benzersiz referansı
harici_idolarak taşıyın. Aynı kimlik/aynı gövde tekrarı ile farklı gövde çakışmasını ayırın;409 HARICI_ID_CAKISMASIdurumunda kör yeniden gönderim yapmayın. - Sonucu izleyin. İmzalı webhook veya
GET /olaylarüzerinden değişimleri takip edin. Bağlantı kesilmesini kesin başarısızlık, bilinmeyen durumu başarı saymayın. Gönderim/iptal/yanıt işlemlerini yetkili kullanıcı onayıyla yürütün.
Webhook ve MCP hangi ihtiyacı çözer?
Webhook, belge durumundaki değişikliği bağlı yazılıma bildirmek için kullanılır. Alıcı uygulama imzayı ham gövde ve zaman bilgisiyle doğrulamalı, aynı olay kimliğini tekrar işlerken mükerrer iş oluşturmamalıdır. Bildirim teslim hatasını belgenin başarısızlığıyla karıştırmayın.
MCP, yapay zekâ istemcisinin tanımlı araçları kullanmasına olanak verir. Yapay zekânın belgeyi açıklaması ile mali sonuç doğuran gönderim yapması ayrıdır. Önce hesap, alıcı ve tutar doğrulanmalı; gönderim, iptal ve yanıt gibi işlemler belgeye özel açık onayla yürütülmelidir. Makine okunur kullanım özeti ve OpenAPI 3.1 sözleşmesi teknik ekibin başvuru kaynaklarıdır.
Mevcut entegrasyonu taşırken neyi eşlemelisiniz?
Adres ve anahtarı değiştirmek her zaman yeterli değildir. ETTN ile belge numarasını ayrı tutun; kimlik doğrulamasını, alan adlarını, durum/hata kodlarını, sayfalama ve tekrar kurallarını karşılaştırın. MultiPortal için doğrulanan arayüzler REST ve MCP’dir; başka sağlayıcının SOAP operasyon adlarını veya yanıt alanlarını birebir kullanmayın.
Sık sorulan sorular
e-Fatura API entegrasyonu nedir?
ERP, e-ticaret veya özel yazılımın e-belge işlemlerini portalda yeniden veri girmeden yürütmesini sağlayan bağlantıdır. MultiPortal REST API ve MCP erişimini aynı firma anahtarıyla sunar.
MultiPortal API hangi belgeleri kapsar?
e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-SMM ve e-Müstahsil Makbuzu işlemlerini kapsar. Belge türünün ilgili firma için açık olması gerekir; e-Defter saklama bu API kapsamıyla karıştırılmamalıdır.
API denemesi için gerçek fatura göndermek gerekir mi?
Hayır. dogrula uçları kayıt oluşturmadan denetim yapar. Taslak modundaki anahtar belge oluşturabilir ancak GİB gönderimi yapamaz. Portal demosu ise ekranları tanımak içindir; API anahtarı yerine geçmez.
SOAP kullanan bir yazılım doğrudan bağlanabilir mi?
Bu rehberde doğrulanan MultiPortal arayüzleri JSON REST ve MCP’dir. SOAP sözleşmesinin birebir uyumluluğu varsayılmamalı; mevcut alanlar ve işlem akışı OpenAPI belgesine göre eşlenmelidir.
Kaynaklar ve bir sonraki adım
Bu rehber MultiPortal’ın 21 Kasım 2026 tarihinde erişilen kendi teknik tanımlarına dayanır. Uygulamada güncel sözleşmeyi esas alın.