Mikro bağlama (Run / Jump / Fly)

Mikro bağlantısı, Mikro Yazılım'ın resmî API'si ile kurulur. Kullandığınız ürüne göre iki yol vardır; ikisinde de kimlik bilgileri aynıdır.

Hangi Mikro'yu kullanıyorsunuz?

Mikro Jump veya Fly (bulut): yalnız Alias alanını doldurun. Alias, Mikro'nun bulut hesabınıza verdiği takma addır; bilmiyorsanız Mikro destek ekibinden öğrenebilirsiniz. Sunucu adresi gerekmez.

Mikro Run (v16/v17, masaüstü): programınızın çalıştığı sunucuya, Mikro sürüm güncelleme sayfasından "Server" seçeneğiyle Mikro Desktop API servisini kurun. Servis kurulunca kendiliğinden çalışır (varsayılan port 8094). Bu adresin panelimizden erişilebilir olması gerekir: güvenlik duvarınızda yalnızca 185.149.102.118 (Senkronia sunucusu) adresine izin verin ve bağlama ekranındaki Sunucu adresi alanına http://SABIT_IP:8094 yazın.

Gerekenler

• Kullanıcı kodu ve şifresi — Mikro'da API işlemleri için kullanacağınız kullanıcı (çoğu kurulumda SRV). Şifre panelde şifreli saklanır, loglara yazılmaz.
• Firma kodu — Mikro'ya girişte seçtiğiniz firma.
• Çalışma yılı — Mikro'da açık dönem (ör. 2026). Yeni yıla geçtiğinizde bu alanı da güncelleyin; aksi hâlde faturalar eski yılın dönemine düşer.

Bağlandıktan sonra

Sipariş ekranında Muhasebe kartı çıkar. Aktarımda panel:

1. Müşteriyi Mikro'da vergi numarasıyla arar; bulamazsa kendi verdiği kodla arar, o da yoksa cari kart açar (mükerrer cari açılmaz),
2. Fatura satırlarındaki stok kodlarını denetler; Mikro'da olmayan kart varsa açar,
3. Satış faturası kaydeder (kargo bedeli ve kapıda ödeme komisyonu ayrı satır, sipariş indirimi satırlara dağıtılmış hâlde — panelde gördüğünüz KDV kırılımıyla birebir).

Bilinmesi gerekenler

• Tutarlar KDV hariç + KDV ayrı sütun olarak gönderilir; çevrimi panel yapar.
• Aynı sipariş iki kez aktarılmaz (idempotent).
• Mikro API'sinde anlık bildirim (webhook) yoktur; aktarım siparişten tetiklenir, Mikro'dan okuma (stok kartları) sizin başlattığınız çekimlerle yapılır.
• e-Fatura ve e-Arşiv evrakları AYRI seriden numara alır (GİB iki belge tipinin aynı seriyi kullanmasına izin vermez): e-Fatura mükellefi alıcının faturası varsayılan SNK, bireysel/mükellef olmayan alıcınınki SNA serisiyle aktarılır; ikisini de Yönet ekranındaki ayarlardan değiştirebilirsiniz. Alıcının tipine panel karar verir: sipariş panelden faturalandıysa kesilen belgenin tipi, yoksa alıcının vergi kimliği (bireysel alıcı her zaman e-Arşiv) ve — bağlıysa — e-fatura entegratörünüzün mükellef sorgusu kullanılır.
• Her müşteri kendi Mikro hesabını bağlar; Senkronia ortak bir hesap kullanmaz.