Selamlar,

Pazaryeri siparişlerinden otomatik fatura kesmek için üç entegratörün API'sine bağlandık (EDM, GAİ ve Trendyol e-Faturam). Hangisi "en iyi" demek zor; işinize göre değişiyor. Ama firma seçerken sorulması gereken şeyler belli, çoğunu biz canlıya çıktıktan sonra öğrendik. Sözleşme imzalamadan önce şunları netleştirmenizi öneririm:

1) Fatura numarasını kim veriyor?
GİB'e göre fatura numarası seri içinde boşluksuz ve tekrarsız olmalı. Numarayı kendi tarafınızda üretirseniz aynı anda kesilen iki fatura aynı numarayı alabilir, başarısız gönderimde de numara yanıp boşluk oluşur. API'nin numarayı entegratör tarafında atayıp size geri döndürdüğünden emin olun. Örneğin EDM'de bu ayrı bir parametreyle açılıyor; UBL'deki numara alanı doluysa sizinkini kullanıyor, boş bırakmanız gerekiyor.

2) Mükellef sorgusu API'de var mı?
Alıcıya e-Fatura mı e-Arşiv mi kesileceği, alıcının GİB'de e-Fatura mükellefi olup olmamasına bağlı. Eskiden GİB'in herkese açık mükellef listesi indirilebiliyordu; o adres artık çalışmıyor. Bu sorguyu fiilen entegratörün API'si üzerinden yapmak zorunda kalıyorsunuz. "VKN ile kullanıcı sorgulama" ucu olmayan bir API'de bu kararı tahminle vermek zorunda kalırsınız; mükellef olan alıcıya e-Arşiv kesmek de geçersiz belge demek.

3) Alıcının posta kutusu etiketi
e-Fatura gönderirken alıcının posta kutusu (urn:mail:...) gerekiyor. "Herkesinki defaultpk@VKN gibidir" diye kalıpla üretmeyin, tutmayan firmalar var ve belge olmayan kutuya gidiyor. Sorgu ucu gerçek etiketi döndürmeli.

4) Protokol ve test ortamı

• Bir kısmı hâlâ SOAP (WCF) servis. Hazır SOAP kütüphaneleri her zaman uyumlu çalışmıyor; biz EDM'de zarfı elle kurmak zorunda kaldık. REST/JSON olanlarla entegrasyon belirgin şekilde daha hızlı bitiyor.
• Ücretsiz test hesabı veriyorlar mı, test ortamında gerçekten fatura kesip sorgulayabiliyor musunuz? Bunu ilk görüşmede isteyin.
• Test ve canlı adresleri bazen tamamen farklı alan adlarında oluyor. "test." ön ekini silerek canlı adresi tahmin etmeyin, dokümandan alın.

5) IP kısıtı
Bazı entegratörler API'yi yalnız önceden tanımladığınız IP'lere açıyor (sayı sınırlı, bazıları IPv6 kabul etmiyor). Sunucunuz bulutta ve çıkış IP'si değişebiliyorsa baştan sorun; tanımsız IP'den gelen istek doğrudan 403 alıyor.

6) Gelen fatura, iptal, görüntü
Sadece kesmek yetmiyor. Gelen faturaları listeleme ve yanıtlama (kabul/red), e-Arşiv iptali ve faturanın PDF/HTML görüntüsünü API'den alabiliyor musunuz, kontrol edin. Birden fazla şubeniz varsa birden çok gönderici/posta kutusu desteğini de sorun.

7) Pazaryeri siparişinden kesecekseniz
Trendyol, Hepsiburada ve diğerleri siparişte fatura adresini teslimat adresinden ayrı gönderiyor; bizim ölçtüğümüz bir mağazada her 25-30 siparişten birinde farklıydı. Faturayı teslimat adresine kesmek yaygın bir hata. Entegratörden bağımsız, ama API'ye bağlarken göz önünde bulundurun.

Kısa özet: fiyat tekliflerini karşılaştırmadan önce yukarıdaki maddeleri yazılı sorun. Numara atama, mükellef sorgusu ve test hesabına net "evet" diyen firmayla ilerlemek, sonradan yaşanacak en pahalı sorunları baştan eliyor.

Kolay gelsin.