forumKonu aç

API entegrasyonu yapacağız dediler — ne demek, teklifte ayrı kalem olmalı mı?

MMeltemYeni üye
Görev
Kitapçı
Yapı
kooperatif
Katılım
Eyl 2024
Mesaj
32
#1

Mobilya üretimi ve perakende satışı yapan bi şirketimiz var. Mevcut durumda içeride bi muhasebe ve ERP yazılımı kullanıyoruz stok ve faturalar oradan dönüyor. Şimdi yeni bi e-ticaret sitesi ve kurumsal web sitesi yaptırmak için bi dijital ajansla görüşüyoruz.

Ajansın sunduğu 180.000 TL tutarındaki geliştirme teklifinde 'Mevcut sistemlerinizle API entegrasyonu' şeklinde tek satırlık bir madde var ve karşısında hiçbir kapsam detayı yok. Toplantıda sorduğumuzda sitenizin ERP sistemiyle konuşacağını ve her şeyin otomatik çalışacağını söylediler ama teknik ayrıntıya girmediler.

Tam olarak API entegrasyonu nedir ve bu iş teklifte neden bu kadar yuvarlak bırakılır? Bu işlem siteden bağımsız ayrı bir iş kalemi olarak mı fiyatlandırılmalı yoksa web geliştirme paketinin doğal bir parçası mıdır? Sözleşme aşamasında sonradan mağdur olmamak için hangi sınırları çizmeliyiz?

GGökhan C***Katılımcı
Görev
Satın alma sorumlusu
Sektör
Matbaa
Yapı
orta ölçekli işletme
Katılım
Haz 2022
Mesaj
181
En çok yardımcı olan#2

Kısa cevap: API entegrasyonu, e-ticaret siteniz ile muhasebe veya depo programınız gibi iki ayrı yazılımın insan müdahalesine gerek kalmadan anlık veri alışverişi yapmasını sağlayan teknik bağlantı köprüsüdür. Bu işlem kesinlikle teklifte tek satır olarak bırakılmamalı, aktarılacak verilerin yönü ve sıklığı ayrı bir teknik şartname kalemi olarak tanımlanmalıdır.

Ajansların bu maddeyi yuvarlak bırakmasının sebebi, işin içine girdiklerinde karşılaşacakları teknik engelleri baştan öngörememeleridir. Entegrasyon tek taraflı bir iş değildir; sitenin hazır olması yetmez, ERP yazılımınızın da dış dünyaya veri açacak API desteğine ve lisansına sahip olması gerekir. Birçok ticari yazılım bu modül için ayrıca lisans ücreti talep eder.

Sözleşmeye netleştirmeniz gereken üç temel konu vardır: 1) Veri akışının yönü: Muhasebedeki stok ve fiyatlar mı siteye akacak, sitedeki sipariş ve cari kartlar mı muhasebeye yazılacak? 2) Tetiklenme sıklığı: Veri anlık mı yoksa günde iki kez mi güncellenecek? 3) İstisna yönetimi: İnternet kesildiğinde veya ERP sunucusu yanıt vermediğinde bekleyen siparişlerin log kaydı nasıl tutulacak?

Tavsiyem, teklifi onaylamadan önce ERP yazılımınızı aldığınız firmadan API dokümantasyonunu temin edip ajansa iletmenizdir. Ajans bu dokümanı inceledikten sonra entegrasyonu ayrı bir teslim kalemi, test senaryoları ve garanti şartlarıyla teklife eklemelidir.

VVildan Ş***Katılımcı
Görev
Kalite kontrol elemanı
Sektör
Tekstil
Yapı
orta ölçekli işletme
Katılım
Ağu 2024
Mesaj
162
#3

API iki yazılımın birbirine soru sorup standart formatta yanıt aldığı kapıdır. Ancak ERP tarafında bu kapı kapalıysa ajans site üzerinden hiçbir şey yapamaz. ERP sağlayıcınızın REST mimarisinde hazır servisleri var mı, yoksa araya özel bir köprü servis mi yazılacak? Bunu netleştirmeden atılan her imza ek maliyet doğurur.

PPerihan S***KatılımcıTopluluk üyesi
Katılım
Tem 2023
Mesaj
352
#4

Biz benzer bir projede aynı hatayı yaptık. Ajans tek satırla entegrasyon yazdı, site bittiğinde muhasebe firmamız 'bizim API lisansımız 50.000 TL ve bağlantıyı siz yapacaksınız' dedi. Ajans 'biz muhasebeye karışmayız' deyip kenara çekildi. Proje tam altı ay boyunca iki firmanın birbirini suçlamasıyla kilitlendi.

KKemal Ç***Katılımcı
Görev
Saha satış temsilcisi
Sektör
Plastik
Yapı
120 kişilik şirket
Katılım
Eki 2022
Mesaj
140

Doki · Arayüz tasarımı · 2023

#5

Teklifteki o tek satırlık maddeyi derhal revize ettirin. Sözleşmeye aktarılacak veri tablolarını tek tek yazdırın: Ürün kartları fiyat listeleri, stok adetleri ve sipariş detayları. Ayrıca veri uyuşmazlığı olduğunda hataların nereye loglanacağını sözleşme şartı haline getirin.

LLeyla Ç***Uzman
Görev
Ön muhasebe
Sektör
Güvenlik hizmetleri
Yapı
orta ölçekli işletme
Katılım
Oca 2026
Mesaj
1
#6

Sözleşme hukuku ve teknik şartname prensipleri gereğince, kapsamı belirlenmemiş entegrasyon taahhütleri ihtilaf anında iş sahibinin aleyhine yorumlanabilir. Entegrasyon servislerinin kabul kriterleri, hata tolerans süreleri ve üçüncü taraf yazılım lisans maliyetlerinin kime ait olduğu sözleşme ekinde açıkça tanzim edilmelidir.

VVildan D***Katılımcı
Görev
Kalite kontrol elemanı
Sektör
Elektrik-elektronik
Yapı
bölge bayisi
Katılım
Nis 2024
Mesaj
160

Doki · Oltalama farkındalık eğitimi · 2024

#7

180.000 TL toplam bütçeyle hem kurumsal site, hem e-ticaret altyapısı hem de özel ERP entegrasyonu vadetmeleri bana pek gerçekçi gelmedi. Sağlıklı bir çift yönlü entegrasyon tek başına haftalarca test gerektirir... Muhtemelen sadece basit bir sipariş aktarımı yapıp işi bitmiş sayacaklar.

SSena M***KatılımcıTopluluk üyesi
Katılım
Ara 2024
Mesaj
142
#8

bizde de aynısı oldu, snra siteden sipariş geliyor ama kdv oranları veya iskonto erp tarafına yanlış aktarılıyordu.. ve bu arrada manuel düzeltmekten personel perişan oldu. veri eşleştirme tablosu hazırlamadan o maddeyi onaylamayın derim.

JJülide S***UzmanTopluluk üyesi
Katılım
Eyl 2023
Mesaj
184
#9

Kullandığınız ERP yazılımı bulut tabanlı modern bir sistem mi yoksa şirket içindeki yerel bir sunucuda mı çalışıyor? Eğer eski tip masaüstü bir yapıysa dışarıdan erişim için statik IP ve güvenlik duvarı yapılandırması gerekecektir; ajans bu altyapı gereksinimlerini inceledi mi?

GGamze U***Katılımcı
Görev
Teknoloji direktörü
Sektör
Matbaa
Yapı
8 kişilik ekip
Katılım
Şub 2024
Mesaj
270
#10

Bir uyarı bırakayım... Karar verirken en kötü senaryoyu da yazın sadece iyisini dgl.

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

CCansu I***VeteranTopluluk üyesi
Katılım
Tem 2022
Mesaj
377
#11

Bunu biraz açabilir misiniz? yani küçük ölçekte işe yarayan çözüm büyüyünce çöküyor bunu geç öğrendim.

Yanlışım varsa düzeltin.

KKadir G***KatılımcıTopluluk üyesi
Katılım
Eyl 2022
Mesaj
44
#12

Ben bu yoldan geçtim anlatayım. Küçük bir deneme ile başlayın, tmmını bir anda bağlamayın.

İnsanlar süreci dgl, alışkanlığı savunur. bu arada direnç oradan gelir. Tecrübeyle sabit.

HHilal D***KatılımcıTopluluk üyesi
Katılım
Ara 2024
Mesaj
166
#13

Katılıyorum.

YYağmur P***Uzman
Görev
Müşteri ilişkileri müdürü
Sektör
Elektrik-elektronik
Yapı
120 kişilik şirket
Katılım
Haz 2025
Mesaj
405
#14

Buradan gidecekseniz şunu baştan halledin. En ucuz teklif genelde en az düşünülmüş tekliftir.

Sorunuz olursa yazın, elimden geldiğince cevaplarım.

LLale K***KatılımcıTopluluk üyesi
Katılım
Eki 2025
Mesaj
323
#15

bunu yazdığınız için tşk doğrusu bu... insanlar süreci değl, alışkanlığı savunur ve direnç oradan gelir.

bu kadar, uzattıysam kusura bakmayın.

FFerhat A***UzmanTopluluk üyesi
Katılım
Mar 2026
Mesaj
124
#16

Bunu yaparken çok düşülen bi hata var... neyse küçük ölçekte işe yarayan çözüm büyüyünce çöküyor bunu geç öğrendim.

Kendi durumunuz farklıysa tabii değişir.

MMert Ö***Katılımcı
Görev
Akaryakıt bayi
Yapı
yeni kurulmuş girişim
Katılım
Kas 2023
Mesaj
64
#17

Yeni girenler icin kısa özet: İlk kez yapıyorsanız küçük başlayın, ölçek sonra gelir.

Karar verirken en kötü senaryoyu da yazın sadece iyisini dgl.

PPerihan K***Katılımcı
Görev
Ürün yöneticisi
Sektör
Catering
Yapı
20 kişilik firma
Katılım
Şub 2024
Mesaj
220

Doki · Kurumsal web sitesi · 2024

#18

Bir dönem biz de aynı yerde takıldık. Küçük bir deneme ile başlayın, tmmını bir anda bağlamayın.

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

AAslı G***UzmanTopluluk üyesi
Katılım
Oca 2023
Mesaj
1
#19

Sağ olun, aradığım cevap buydu.

FFatma E***KatılımcıTopluluk üyesi
Katılım
Eki 2025
Mesaj
89
#20

cok tesekkurler bugun deneyecegim.. bir de ya sormaktan cekinmeyin, sormayan hep daha paaliya oduyor.

tecrrübeylle sabit

Yanıt yaz