Login ve token akışı
İstemci uygulama kullanıcı veya servis hesabı ile oturum açar. JWT token, tenant, rol, lokasyon ve izin kapsamına göre üretilir.
POST /api/v1/auth/login
{ "email": "user@firma.com", "password": "***" }Entegrasyon
RFID API ve ERP entegrasyonu
RfidSpace RFID API katmanı; mobil terminaller, sabit okuyucular, ERP, SAP, WMS, MES, POS ve bordro sistemleri arasında güvenli veri akışı sağlar.
Görsel özet
Kurumsal entegrasyon haritası
RFID olaylarının ERP ve raporlama katmanına aktarımını gösterir.
RfidSpace API katmanı; sahadaki RFID okuma, etiket basımı, sayım, belge hareketi ve kurumsal sistem entegrasyonlarını denetlenebilir servis akışına dönüştürür. Amaç yalnız veri almak değil, her hareketi belge, kullanıcı, cihaz, lokasyon ve zaman bağlamıyla kurumsal kayda çevirmektir.
Master data endpointleri
Ürün, barkod, varyant, lokasyon, personel, cihaz, etiket şablonu ve belge tipi bilgileri mobil terminaller veya ERP/WMS sistemleriyle paylaşılır.
- GET /api/v1/products
- GET /api/v1/locations
- GET /api/v1/devices
Belge oluşturma
ERP veya WMS, mal kabul, transfer, sevkiyat veya sayım belgesini RfidSpace'e gönderir. Belge satırları beklenen ürün, adet ve operasyon tipini taşır.
POST /api/v1/documents
{ "type":"RECEIPT", "externalNo":"ERP-10045" }Operasyon servisleri ve örnek akışlar
EPC sorgulama
Bir EPC'nin ürün, lokasyon, son hareket ve belge geçmişi sorgulanabilir.
GET /api/v1/epc/3034...
{ "status":"InWarehouse", "location":"A-01-03" }Sayım gönderme
El terminali veya sabit okuyucu sayım oturumundaki EPC listesini toplu olarak gönderir. Sistem eksik, fazla ve yanlış lokasyon kayıtlarını üretir.
POST /api/v1/count-sessions/{id}/reads
{ "device":"C72-01", "epcs":["3034..."] }Etiket basım talebi
ERP veya kullanıcı arayüzü ürün, adet, şablon ve EPC kuralıyla baskı kuyruğu oluşturabilir.
POST /api/v1/label-jobs
{ "template":"pallet", "quantity":120 }Hata kodları
| 400 | Eksik veya hatalı alan |
|---|---|
| 401 | Token yok veya geçersiz |
| 403 | Tenant/rol yetkisi yok |
| 409 | Tekrarlı belge, EPC veya idempotency çakışması |
| 422 | İş kuralı doğrulaması başarısız |
Retry ve idempotency
Mobil cihaz veya ERP bağlantısı kesildiğinde aynı hareketin tekrar gönderilmesi stok çift kaydı oluşturmamalıdır. Kritik POST isteklerinde idempotency anahtarı kullanılır.
Idempotency-Key: tenant-01-receipt-ERP-10045Versiyonlama
Endpointler /api/v1 yapısıyla sürümlenir. Geriye dönük kırıcı değişiklikler yeni major sürümde yayınlanır; entegrasyon ekipleri geçiş süresini planlayabilir.
Webhook veya polling
ERP/WMS sistemleri operasyon sonucunu webhook ile alabilir veya belirli aralıklarla belge sonucu sorgulayabilir. Seçim müşteri altyapısına göre yapılır.
SAP, WMS ve ERP entegrasyon şeması
Ana veri ERP/WMS kaynağından gelir, RfidSpace sahada okuma ve doğrulama yapar, onaylanan hareket sonucu tekrar kurumsal sisteme aktarılır. Tüm adımlar API logu, kullanıcı, cihaz ve zaman bilgisiyle saklanır.
1. Ana veri
Ürün, lokasyon, belge, personel ve cihaz kapsamı alınır.
2. Saha hareketi
El terminali, kapı, tünel, yazıcı veya okuyucu olayı üretilir.
3. Doğrulama
Beklenen belge ile okunan EPC karşılaştırılır.
4. Sonuç aktarımı
Onaylanan hareket ERP/WMS sistemine gönderilir.