Mikro V17 API kapsamı: hangi işlem hangi uçla yazılır
Depologi, Mikro V17 API kipi seçildiğinde Mikro'ya yazdığı her kaydı Mikro Desktop API uçlarıyla, Mikro'nun kendi iş kurallarıyla oluşturur. Bu sayfa Depologi'nin kullandığı 38 ucun tamamını ve bu kipte bilinçli olarak kaydedilmeyen 4 durumu listeler. Okuma (liste, rapor, ekstre) iki kipte de Depologi'nin kendi sorgularıyla yapılır; API yalnız yazma, güncelleme ve silme için kullanılır.
Son güncelleme:
İşlemler ve Mikro API uçları
Liste ürünün koduyla birebir aynıdır: koddaki her uç burada anlatılır, burada yazan her uç kodda kullanılır (otomatik test).
| Alan | İşlem | Mikro API ucu | Not |
|---|---|---|---|
| Stok hareketi | Mal giriş ve çıkış irsaliyeleri, iade irsaliyeleri, hal evrakları, fasona sevk ve fasondan dönüş (carili evrak) | IrsaliyeKaydetV2 IrsaliyeDuzeltV2 IrsaliyeSatirSilV2 |
Seri numaraları irsaliye ucunun seri listesiyle gider. Satır iptali satırı siler; silindiği geri okunarak doğrulanır. |
| Stok hareketi | Depo giriş/çıkış fişleri, sayım fişleri, üretime sevk ve sarf, üretimden giriş, virman, depolar arası sevk ve nakliye (carisiz evrak) | DahiliStokHareketKaydetV2 DahiliStokHareketDuzeltV2 DahiliStokHareketGuidSilV2 |
Satır iptali satırı siler; silindiği geri okunarak doğrulanır. |
| Stok hareketi | Evrak açıklamaları | EvrakAciklamaKaydetV2 EvrakAciklamaDuzeltV2 |
|
| Sipariş | Alınan ve verilen sipariş; sevk ve kabulde teslim/kapanış, iş emrinde planlanan miktar | SiparisKaydetV2 SiparisDuzeltV2 SiparisGuidSilV2 |
|
| Sipariş | Depolar arası sipariş; sevkte teslim, satır iptali | DepolarArasiSiparisKaydetV2 DepolarArasiSiparisDuzeltV2 DepolarArasiSiparisGuidSilV2 |
|
| Sayım | Sayım sonuçları | SayimSonuclariKaydetV2 SayimSonuclariDuzeltV2 |
|
| Kart | Stok kartı (birim, barkod, fiyat satırlarıyla) | StokKaydetV2 |
|
| Kart | Cari kart ve adresleri; müşteri konumu (GPS) | CariKaydetV2 CariGuncelleV2 AdresKaydetV2 AdresDuzeltV2 |
|
| Satış | Verilen teklif | VerilenTeklifKaydetV2 |
|
| Satış | Tahsilat makbuzu (nakit, kredi kartı, çek, senet) | TahsilatTediyeKaydetV2 TahsilatTediyeKaydetV3 |
|
| Satış | Siparişten ve irsaliyeden fatura | FaturaKaydetV2 IrsaliyedenFaturaOlusturmaV2 |
|
| Üretim | Ürün reçetesi | UrunReceteKaydetV2 UrunReceteSilV2 |
Silme Mikro'nun kendi revizyon kaydını yazar. |
| Üretim | Ürün rotası | UrunRotaKaydetV2 UrunRotaSilV2 |
|
| Üretim | İş emri rota planı | UretimRotaPlanKaydetV2 UretimRotaPlanSilV2 |
|
| Üretim | Operasyon tamamlama (çalışan, gecikme ve hata listeleriyle) | OperasyonTamamlamaFisKaydetV2 OperasyonTamamlamaFisSilV2 |
|
| Üretim | Üretim talebi | UretimTalepKaydetV2 UretimTalepGuidSilV2 |
|
| Genel | Kendi ucu olmayan kayıtlar: iş emri, malzeme planı ve iş emri malzeme durumu, parti/lot kartı, barkod ve fiyat satırları, saha ziyaret kaydı, operasyon / iş merkezi / gecikme / hata tanımları, plan ve talep güncellemeleri | KayitKaydetV2 KayitKaydetTopluV2 |
Mikro'nun genel kayıt ucu, tablo numarasıyla; birlikte yazılan kayıtlar tek istekte. |
Bu kipte kaydedilmeyenler
Aşağıdaki durumlar Mikro V17 API kipinde reddedilir ve ekran sebebini söyler; Depologi entegrasyon API'leri kipinde kaydedilir. Yarım ya da eksik kayıt üretilmez.
| Durum | Sebep |
|---|---|
| Parçalı senetli tahsilat | Senet parçaları Mikro tarafında üretilen satır kimliklerine bağlıdır; uç bu kimlikleri yanıtında belgelemiyor. |
| Eksik teslimli nakliye kabulü | Yolda kalan payın satır kopyası API gövdesiyle birebir kurulamıyor; tam miktar teslim alınır ya da doğrudan yazma yolu kullanılır. |
| Carisiz fişte seri numaralı satır | Dahili hareket ucu seri listesi taşımaz; seri kaydı satırın Mikro kimliğine bağlıdır. |
| Saha kesin mutabakat evrakları | Ters fiş ile kesin evrak, kasa fark fişi, dekont ve kör kasa teslimi aynı veritabanı işleminde yazılmalıdır; API uçları birden çok evrakı tek işlemde yazmaz. |
Nasıl çalışır
Kurallar önce Depologi'de
Yetki, kilitli evrak, kapanmış satır, stok ve parti/lot denetimleri API'ye gitmeden sunucuda uygulanır; kurala uymayan istek Mikro'ya hiç gönderilmez.
Çift evrak yok
Her gönderimin anahtarı istekten önce kaydedilir; bağlantı kopup aynı belge yeniden gönderilse de Mikro'da ikinci evrak oluşmaz.
Geri okuyarak doğrulama
Sonucu Mikro'nun kendisinin kurduğu alanlar (siparişe bağ ve teslim miktarı, satır iptali) yazıldıktan sonra Mikro veritabanından geri okunur; tutmazsa üstüne yeni değer yazılmaz ve kullanıcıya söylenir.
Uç gövdeleri Mikro'nun yayımladığı API belgesine göre kurulur ve Mikro API sunucusunun test ikizine karşı sınanır. API kipi her kurulumda müşterinin kendi Mikro API sunucusunda ilk evraklarla doğrulanarak açılır. İki entegrasyon modelinin karşılaştırması: Mikro V17 entegrasyonu.
Mikro API hakkında sorular
Mikro API nedir?
Mikro API, Mikro V17'ye kayıt yazmak için üreticinin sunduğu programlama arayüzüdür (Mikro Desktop API). Depologi bu arayüzü, şirket bazında seçilen Mikro V17 API kipinde evrak yazmak için kullanır; hangi işlemin hangi uçla yazıldığı bu sayfadaki tabloda listelenir.
Depologi Mikro'ya API ile mi doğrudan mı yazar?
İkisi de mümkündür ve şirket bazında seçilir: Depologi evrakı kendi entegrasyon API'leriyle Mikro V17'ye doğrudan ya da Mikro V17 API'leri üzerinden yazar. API kipinde evraklar Mikro'nun iş kurallarıyla oluşturulur. İki modelde de Mikro tablolarına kolon eklenmez.
API kipinde hangi işlemler kaydedilmez?
Dört durum: parçalı senetli tahsilat, eksik teslimli nakliye kabulü, carisiz fişte seri numaralı satır ve saha kesin mutabakat evrakları. Bunlar Mikro V17 API kipinde kaydedilmez ve Depologi'nin doğrudan yazma yolunu gerektirir; diğer işlemler bu kipte de yazılır.
Mikro V17 API kipi nasıl seçilir?
Firma Ayarları ekranındaki Mikro V17 API ayarlarından, şirket bazında. Kurumsal BT politikanız yalnız üreticinin kendi arayüzlerini öngörüyorsa o şirkette API kipini açabilirsiniz; diğer şirketler doğrudan yazma modeliyle çalışmaya devam edebilir. API kipi her kurulumda kendi Mikro API sunucunuzda ilk evraklarla doğrulanarak açılır.
Depologi'yi canlı demoda görün
Canlı demo ortamında depo ve saha el terminali ekranlarını, web ekranlarıyla birlikte gezelim; deponuza ve saha ekibinize uygun paketi ve kurulum planını çıkaralım.