forumKonu aç

"API entegrasyonu yapacağız" dediler — süreç nasıl ilerler, bizden ne beklenir?

NNuri N***KatılımcıTopluluk üyesi
Katılım
Kas 2023
Mesaj
4
#1

e-ticaret sitemizde günde ortalama 60-70 sipariş alıyoruz. şimdiye kadar faturaları ve stok hareketlerini muhasebe programımıza her akşam bir personelimiz elle giriyordu. artık siparişlerin müşteri carilerinin ve stokların otomatik senkronize olası icin dışarıdan bir yazılım ekibiyle anlaştık. bize 45.000 TL bütçe ve 3 haftalık bir tamamlanma süresi verdiler.

ilk toplantıda "karşı tarafın API uç noktalarını ve test ortamını hazırlayın gerisini biz hallederiz" dediler. fakat biz teknik bi işletme değiliz. muhasebe programımızın sağlayıcısını aradığımızda ise API lisans yükseltme bedeli olarak 12.000 TL ek ücret istediler ve sadece bi doküman bağlantısı gönderip kenara çekildiler.

bu API entegrasyonu süreci pratikte hangi aşamalardan geçer? sürecin tıkanmaması icin bizim işletme olarak hngi yetkileri, hesapları ve verileri temin etmemiz gerekiyor? açıkçası 3 haftalık süre sizce ne kadar gerçekçi?

RRecep T***Yeni üye
Görev
Saha satış temsilcisi
Sektör
Lojistik
Yapı
holding bünyesinde bir şirket
Katılım
Ağu 2026
Mesaj
39

Doki · Yedekleme kurulumu · 2023

En çok yardımcı olan#2

Kısa cevap: API entegrasyonu, web siteniz ile muhasebe yazılımınızın önceden belirlenmiş kurallar çerçevesinde otomatik olarak veri konuşmasını sağlamaktır. Sürecin ilerlemesi için muhasebe yazılımınızın API lisansını açtırmanız, geliştirici dokümantasyonunu yazılımcıya iletmeniz ve canlı veriye dokunmadan çalışılabilecek bir test ortamı sağlamanız gerekir.

Süreç standart olarak dört aşamada yürür. İlk aşama veri haritalamadır; web sitenizdeki alanlar (müşteri adı, vergi no, ürün kodu, KDV oranı kargo bedeli) ile muhasebe programındaki alanların birebir eşleştirilmesi yapılır. İkinci aşama geliştirme ve test ortamı (sandbox) entegrasyonudur; yazılımcı burada sahte siparişler oluşturarak muhasebe sistemine aktarımı dener.

Üçüncü aşamada hata senaryoları test edilir. Örneğin TC kimlik numarası girilmemiş siparişlerde sistem ne yapacak, indirim kuponları faturaya nasıl yansıyacak, iptal ve iadeler muhasebede nasıl kapanacak gibi uç durumlar denenir. Dördüncü aşamada ise canlı API anahtarları girilerek sistem gerçek siparişlere açılır ve ilk birkaç gün yakından izlenir.

Sizden istenecekler temelde üç şeydir: 1) Muhasebe firmasından alınacak API anahtarları ve geliştirici dokümanı, 2) Test veritabanı erişimi, 3) İş kurallarınızı (fatura kesilme zamanı, stok takip mantığı, iskonto kuralları) anlatan yazılı onayınız. Muhasebe tarafı teknik dokümanı eksiksiz sağlarsa 3 hafta gayet makul bir süredir; ancak muhasebe desteği yavaşsa bu süre 5 haftayı bulabilir.

UUfuk S***Katılımcı
Görev
Ön muhasebe
Sektör
Tarım
Yapı
kooperatif
Katılım
Haz 2022
Mesaj
74

Doki · Olay müdahale desteği · 2025

#3

En kritik hata ürün kodlarının uyuşmamasıdır. E-ticaret sitenizdeki stok kodları ile muhasebedeki stok kodları birebir aynı değilse entegrasyon ilk günden patlar. Yazılımcıya işi teslim etmeden önce bir Excel tablosunda tüm ürün kodlarınızın muhasebe tarafıyla eşleştiğini bizzat kontrol edin.

CCanKatılımcı
Görev
SEO uzmanı
Katılım
Mar 2024
Mesaj
172
#4

Entegrasyonun tek yönlü mü çift yönlü mü olacağını yazılı karara bağlayın. Sadece siteden muhasebeye sipariş mi akacak, yoksa muhasebede değişen depo stoku ve fiyatlar siteye geri yazılacak mı? Çift yönlüde API istek limitleri ve çakışma yönetimi devreye girer, bu da geliştirme süresini doğrudan uzatır.

KKader U***Katılımcı
Görev
Mağaza görevlisi
Sektör
Medya ve yayıncılık
Yapı
aile şirketi
Katılım
Haz 2024
Mesaj
86
#5

Geçen yıl benzer bir entegrasyon yaptırdık. Muhasebe firmasından API lisansı ve test anahtarlarını almamız tam 9 gün sürdü. Yazılımcı ekibin kodlaması 12 günde bitti ama kargo ve iskonto satırlarının muhasebeye ters düşmesi yüzünden testler 8 gün uzadı. Toplamda 29 günde canlıya geçebildik.

OOrhan T***KatılımcıTopluluk üyesi
Katılım
Mar 2024
Mesaj
242
#6

Sizin tarafın hazırlık listesi şunlar olmalı: 1) Muhasebe firmasından test ortamı (sandbox) ve doküman talep edin. 2) İptal, iade ve parçalı teslimat durumlarının nasıl işleneceğini mali müşavirinizle netleştirip yazılı kurallar çıkarın. 3) Canlıya geçmeden önce en az 15 farklı senaryoda test faturası kestirin.

YYaseminKatılımcı
Görev
KOBİ sahibi
Katılım
Tem 2024
Mesaj
98
#7

Muhasebe programınız bulut tabanlı mı yoksa kendi ofisinizdeki yerel bi sunucuda mı kurulu? Eğer ofisteki bi bilgisayarda çalışıyorsa sabit IP ve sunucuya port açılması gerekir. işte bu da hem güvenlik açığı yaratabilir hem de ofisin interneti kesildiğinde entegrasyonun durmasına yol açar; bunu konuştunuz mu?

TTaner E***Katılımcı
Görev
Satın alma sorumlusu
Sektör
Deri
Yapı
yeni kurulmuş girişim
Katılım
Haz 2023
Mesaj
132
#8

bizim muhasebeci ilk başta tc kimlik numarası olmayan yabancı müşterilerin faturalarında hata verdirmişti.. ama yabancı sipariş alıyorsanız veya kurumsal fatura kesiyorsanız o alanların nsl eşleşeceğini şimdiden konuşun sonra siparişler sistemde aslı kalıyor.

edit: yukarıda yanlış yazmışım, kusura bakmayın.

SSinemUzman
Görev
Proje yöneticisi
Katılım
Eki 2023
Mesaj
176
#9

Yazılım ekibi ile muhasebe programınızın teknik destek birimini ortak bir e-posta grubunda veya iletişim kanalında birleştirin. Siz teknik terimleri anlamak ve aradaki köprü olmak zorunda değilsiniz. Bırakın parametreleri ve uç noktaları doğrudan teknik kişiler kendi aralarında çözsün.

VVahide K***Katılımcı
Görev
Grafik tasarımcı
Sektör
Enerji
Yapı
120 kişilik şirket
Katılım
Kas 2023
Mesaj
411
#10

İlk entegrasyonumuzda test ortamı icin 12.000 TL ödemek istemedik, doğrudan canlı veritabanında test yaptık. Yazılımcı deneme faturası keserken gerçek müşteriye e-arşiv fatura ve SMS bildirimleri gitti. O gün test ortamına verilen paranın aslında en ucuz sigorta olduğunu çok net anladık.

OOnur M***Uzman
Görev
Muhasebe elemanı
Sektör
Plastik
Yapı
orta ölçekli işletme
Katılım
May 2023
Mesaj
7
#11

kaydettim.

HHüseyin S***VeteranTopluluk üyesi
Katılım
Tem 2022
Mesaj
175
#12

Yukarıdaki cevap işin özünü söylemiş. Asıl mesele rakam değil, o rakamın neye göre çıktığı.

Acele karar, altı ay sonra düzeltilen karar oluyor. Başka türlü yapan varsa onu da merak ederim.

İİbrahim Y***KatılımcıTopluluk üyesi
Katılım
Ara 2024
Mesaj
182
#13

Anlamadığım bir yer var. Sözleşmede kod sahipliği yazmıyorsa, ayrılırken pazarlık gücünüz kalmıyor.

Başka türlü yapan varsa onu da merak ederim.

HHilal B***Veteran
Görev
Grafik tasarımcı
Sektör
Elektrik-elektronik
Yapı
bölge bayisi
Katılım
Ara 2023
Mesaj
17
#14

Kendi tecrübemi yazayım. Erişim bilgileri kurum adına açılmalı, kişisel hesaplarla değil.

Not olarak bırakayım, lazım olur.

İİbrahim Y***KatılımcıTopluluk üyesi
Katılım
Şub 2026
Mesaj
3
#15

katiliyorum

EElifKatılımcı
Görev
Kafe zinciri sahibi
Yapı
40 kişilik üretim firması
Katılım
Ağu 2024
Mesaj
63

Doki · Olay müdahale desteği · 2024

#16

bi şeyi atlamayın: En ucuz teklif genelde en az düşünülmüş tekliftir.

ben olsam bu yoldan giderdim.

HHavva K***KatılımcıTopluluk üyesi
Katılım
Tem 2024
Mesaj
111
#17

Ucuz görünen yol genelde sonradan pahalıya patlıyor. Erişim bilgileri kurum adına açılmalı, kişisel hesaplarla değil.

Bizde en çok zaman kaybettiren şey, kimin karar vereceğinin belli olmamasıydı. Sorunuz olursa yazın, elimden geldiğince cevaplarım.

MMehmet A***Uzman
Görev
Yazılım geliştirici
Sektör
Eğitim
Yapı
300 kişilik kurum
Katılım
Tem 2022
Mesaj
2
#18

Bir uyarı bırakayım. Yazılı olmayan her madde, ileride iki tarafın da farklı hatırladığı bir madde.

Ben olsam bu yoldan giderdim.

KKübra G***Uzman
Görev
Bilgi işlem müdürü
Sektör
Spor ve fitness
Yapı
20 kişilik firma
Katılım
Kas 2025
Mesaj
10
#19

Aynısını yaşadım. Haftalık yazılı ilerleme raporu, tarih sormaktan çok daha işe yarıyor.

Küçük bir deneme ile başlayın, tamamını bir anda bağlamayın. Kolay gelsin.

OOsman K***KatılımcıTopluluk üyesi
Katılım
Mar 2024
Mesaj
117
#20

Bunu yazdığınız için teşekkürler, doğrusu bu. Acele karar, altı ay sonra düzeltilen karar oluyor.

Sormaktan çekinmeyin, sormayan hep daha pahalıya ödüyor. Bu kadar, uzattıysam kusura bakmayın.

Yanıt yaz