ERP, CRM ve muhasebenizi BARKODOS'a bağlayın
Ürün ana verisi ERP'de, müşteri CRM'de, maliyet muhasebede kalsın; barkod, GS1 numarası ve sahadaki stok BARKODOS'ta. İkisini belgelenmiş bir REST API, imzalı webhook'lar ve olay kuyruğu bağlar.
- ERP'den ürün açma ve güncelleme, dış sistem kodları
- Fatura ve irsaliye referanslı stok hareketi, tekrar koruması
- Muhasebeye maliyetli stok değeri ve hareket dökümü (JSON, CSV)
ERP, CRM ya da muhasebe entegrasyonu nasıl kurulur?
Önce iş bölümü yapılır: hangi verinin ana kaynağı hangi sistemdir? Genellikle ürün ana verisi, cari ve fatura ERP'de; GTIN, etiket, konum bazında stok ve sayım BARKODOS'ta; maliyet ve değerleme muhasebede tutulur. Ürünler iki sistemde dış sistem kodlarıyla eşlenir: BARKODOS ürününe ERP stok kodu, muhasebe hesap kodu ya da CRM ürün kimliği yazılır.
Sonra her sistem için ayrı bir API anahtarı oluşturulur ve yalnız gereken kapsam verilir: ERP'ye ürün yazma ve stok yazma, CRM'e okuma, muhasebeye okuma ve muhasebe. Maliyet bilgisi yalnız muhasebe kapsamlı anahtarla görünür.
Veri iki yolla akar. Karşı sistem BARKODOS'a yazar (ürün, fatura ve irsaliye hareketleri) ya da BARKODOS'tan okur (hareketler imleçle, ürünler değişim zamanıyla). Değişiklikler anında imzalı webhook'la gelir; webhook alamayan, güvenlik duvarı arkasındaki sistemler aynı olayları olay kuyruğundan çeker. Hazır ERP, CRM ya da muhasebe konnektörü yoktur; bağlantı karşı sistemde bu API ile kurulur.
Bir sistemi bağlamanın adımları
7 adımda, baştan sona.
Adım 1: İş bölümünü yazın
Hangi veri hangi sistemde ana kaynak: ürün, stok, maliyet, cari.
Adım 2: Anahtar oluşturun
Kullanım amacını (ERP, CRM, muhasebe) ve en az kapsamı seçin.
Adım 3: Ürünleri eşleyin
Dış sistem kodlarını yazın: erp, muhasebe, crm.
Adım 4: Hareketleri belgeyle yazın
Fatura ve irsaliye no, cari ve tekrar korumalı kimlikle.
Adım 5: Olayları bağlayın
Webhook adresi ya da olay kuyruğu imleci.
Adım 6: Muhasebeye aktarın
Stok değeri ve maliyetli hareket dökümü; JSON ya da CSV.
Adım 7: Deneme ortamında doğrulayın
Birkaç ürünle iki yönlü kontrol, sonra tüm katalog.
Üç sistem, tek barkod kaydı
ERP
Ürün ana verisini BARKODOS'a yazar, fatura ve irsaliyeyle stok hareketi gönderir; sahadaki sayım ve aktarımları geri okur.
- POST ve PATCH /urunler, dış kod: erp
- POST /stok/hareketler + referans
- GET /hareketler?sonra=…
CRM
Teklif ve fırsatta güncel stoğu gösterir; stok asgari seviyenin altına inince satış ekibine görev açar.
- GET /urunler, GET /stok
- stok.asgari_alti olayı
- urun.guncellendi olayı
Muhasebe
Dönem sonunda stok değerini, dönem içinde belge no ve cari bilgili maliyetli hareketleri alır.
- GET /muhasebe/stok-degeri
- GET /muhasebe/hareketler
- CSV: ";" ayraç, ondalık virgül
Yeni uçlar ve yetenekler
| Uç nokta | Kapsam | Ne yapar |
|---|---|---|
| POST /urunler | urun-yazma | Ürün açar: iç kod, firma önekinden sıradaki GTIN ya da mevcut numara; dış kodla tekrar gelirse yeni ürün açmaz |
| PATCH /urunler/{kod} | urun-yazma | Yalnız gönderilen alanları değiştirir; GTIN değişmez |
| GET /urunler?degisim_sonra=… | okuma | Belirli zamandan sonra değişen ürünler (artımlı eşitleme) |
| POST /stok/hareketler | stok-yazma | Giriş, çıkış, sayım ve aktarım; belge türü, belge no, cari; kalıcı tekrar koruması |
| GET /hareketler | okuma | Hareket geçmişi, imleçle eskiden yeniye |
| GET /muhasebe/stok-degeri | muhasebe | Miktar × kart maliyeti; JSON ya da CSV |
| GET /muhasebe/hareketler | muhasebe | Hareket anındaki maliyetle tutar; JSON ya da CSV |
| GET /olaylar | okuma | Webhook alamayan sistemler için olay kuyruğu (son 1000 olay) |
| GET /openapi.json | — | OpenAPI 3.0 tanımı; istemci üretimi için |
Değerleme ürün kartındaki birim maliyetle yapılır; FIFO ya da ağırlıklı ortalama hesaplanmaz. Hazır ERP, CRM ya da muhasebe konnektörü yoktur; API gerçek bir ERP ya da muhasebe yazılımıyla birlikte denenmedi.
Anahtar ve veri güvenliği
| Konu | Nasıl |
|---|---|
| Kimlik | Bearer anahtar; yalnız bir kez gösterilir, sunucuda SHA-256 özeti saklanır, panelden anında iptal edilir |
| En az yetki | Beş kapsam: okuma, stok-yazma, urun-yazma, muhasebe, baski; maliyet yalnız muhasebe kapsamında |
| Webhook | HMAC-SHA256 imza ve zaman damgası; başarısız teslim iki kez yeniden denenir |
| Sınır | Anahtar başına dakikada 120 istek; X-RateLimit başlıkları |
| İz | Her API yazması denetim izine anahtar adıyla düşer |
ERP, CRM ve muhasebe API hakkında sık sorulanlar
Sorunuz burada yoksa demo talep formundan yazın.
Logo, Mikro, Netsis ya da başka bir ERP için hazır bağlantı var mı?
Hayır. Hazır konnektör yoktur; bağlantı ERP tarafında bu API ile kurulur. ERP'niz REST çağrısı yapabiliyor ya da bir entegrasyon aracı (iPaaS) kullanıyorsanız uçlar doğrudan kullanılır.
Maliyet bilgisi CRM'e gider mi?
Hayır. Maliyet yalnız muhasebe kapsamlı anahtarla, yalnız muhasebe uçlarında görünür. CRM'e okuma kapsamlı ayrı bir anahtar verin.
ERP aynı faturayı iki kez gönderirse stok iki kez artar mı?
Hayır. Harekete referans.haricId verin; aynı anahtarla aynı kimlik ikinci kez gelirse yeni hareket açılmaz, ilk hareket döner. Ayrıca 24 saatlik Idempotency-Key başlığı da kullanılabilir.
Stok değeri hangi yöntemle hesaplanıyor?
Ürün kartındaki birim maliyetle (miktar × maliyet). FIFO ya da ağırlıklı ortalama hesaplanmaz; bunları muhasebe yazılımınız yapar. Hareket dökümünde her hareketin o anki kart maliyeti saklanır.
Güvenlik duvarı arkasındaki ERP'miz webhook alamıyor.
Olay kuyruğunu kullanın: GET /olaylar?sonra=… ile aynı olaylar çekilir; imleci kendi tarafınızda saklarsınız. Son 1000 olay tutulur.
BARKODOS'u kendi ürünlerinizle görün.
Ürün sayınızı ve mevcut durumunuzu paylaşın; kurulumu ve başvuru adımlarını birlikte çıkaralım. Hemen bakmak isterseniz demo panele kurgusal veriyle girin.