BARKODOS API'ye ERP, CRM ve muhasebe yazılımlarıyla çalışmak için gereken parçaları ekledik: ürün ana verisini yazma, fatura ve irsaliye referanslı stok hareketi, maliyetli stok değeri, olay kuyruğu ve makinece okunur API tanımı. v1 için yazılmış bağlantılar değişmeden çalışır.
Neler yeni?
- Ürün yazma: ERP ürün açar ve günceller (POST ve PATCH /urunler). Numara iç kod, firma önekinden sıradaki GTIN ya da elinizdeki GTIN olabilir; GS1 kuralları paneldekiyle aynıdır.
- Dış sistem kodları: Her ürüne ERP stok kodu, muhasebe hesap kodu ya da CRM ürün kimliği yazılır; ürünler bu kodla aranır.
- Belge referanslı hareket: Stok hareketine belge türü, belge no ve cari eklenir; aktarım (transfer) da API'den girilir. haricId aynı belgenin iki kez işlenmesini kalıcı olarak engeller.
- Hareket geçmişi: GET /hareketler ile sahadaki tüm hareketler imleçle, eskiden yeniye çekilir.
- Muhasebe: Stok değeri ve maliyetli hareket dökümü; JSON ya da Excel'in açtığı CSV.
- Olaylar: Yeni olaylar hareket.olusturuldu, stok.asgari_alti ve urun.guncellendi. Webhook alamayan sistemler için olay kuyruğu.
- OpenAPI: GET /api/v1/openapi.json; Postman ve istemci üreticileri için.
Neden?
Barkod ve stok bilgisi tek başına durmaz: fatura ERP'de, müşteri CRM'de, maliyet muhasebede. Bu bilgiler elle taşındığında aynı ürün iki sistemde farklı kodla, farklı stokla görünür. API v1.1 ile her sistem kendi işini yapar, aynı ürün kaydına bağlanır.
Güvenlik ve yetki
Her sistem ayrı anahtarla bağlanır ve yalnız gereken kapsamı alır. Maliyet bilgisi yalnız muhasebe kapsamlı anahtarla görünür. Her API yazması denetim izine anahtarın adıyla düşer; anahtar panelden anında iptal edilir.
Bilmeniz gerekenler
Hazır Logo, Mikro, Netsis ya da başka bir ERP, CRM veya muhasebe konnektörü yoktur; bağlantı karşı sistemde bu API ile kurulur. Değerleme ürün kartındaki birim maliyetle yapılır; FIFO ya da ağırlıklı ortalama hesaplanmaz. API gerçek bir ERP ya da muhasebe yazılımıyla birlikte henüz denenmedi; ilk kurulumu deneme ortamında birkaç ürünle doğrulamanızı öneririz.
