ZincirX ZincirX

Dokümantasyon

Hızlı Başlangıç Kılavuzu

ZincirX'e hoş geldiniz! Bu kılavuz, tedarik zinciri izlenebilirlik platformumuzu kullanmaya başlamanıza yardımcı olacaktır.

Adım 1: Hesabınızı Oluşturun

  1. ZincirX'i ziyaret edin ve "Hesap oluştur" düğmesine tıklayın
  2. Adınızı ve e-posta adresinizi girin
  3. En az sekiz karakterli bir parola belirleyin veya bunun yerine Google ya da Facebook hesabınızla kayıt olun
  4. Hizmet Koşulları'nı, Satış, Teslimat ve İade Politikası'nı ve Veri İşleme Koşulları'nı kabul edin; Gizlilik Politikası'nı okuyun
  5. Yeni oluşturduğunuz hesapla oturum açın

Adım 2: Kurulumu Tamamlayın

  1. Bildirimler için e-posta adresinizi girin
  2. Onay bağlantısı aracılığıyla e-postanızı doğrulayın
  3. İşletme bilgilerinizi ve kategorinizi girin
  4. İşletme profili kurulumunuzu tamamlayın

Adım 3: İlk Şablonunuzu Oluşturun

  1. Şablonlar bölümüne gidin
  2. "Yeni Şablon Oluştur" düğmesine tıklayın
  3. Tedarik zinciri süreç adımlarınızı tanımlayın
  4. Her adım için doğrulama gereksinimlerini belirleyin
  5. Şablonunuzu kaydedin ve etkinleştirin

Adım 4: Partileri Takip Etmeye Başlayın

  1. Partiler bölümüne gidin
  2. Şablonunuzu kullanarak yeni bir parti oluşturun
  3. Ürünler tedarik zincirinizde ilerlerken her adımı yürütün
  4. Destekleyici belgeleri ve medyayı yükleyin
  5. Paydaşlarla doğrulama bağlantılarını paylaşın

Temel Kavramlar

Şablonlar

Şablonlar, tedarik zinciriniz için standart süreci tanımlar. Her adımın doğrulama gereksinimleriyle birlikte ürünlerin geçmesi gereken bir dizi adımı içerir.

  • Yeniden kullanılabilir iş akışı tanımları
  • Özelleştirilebilir adım gereksinimleri
  • Rol tabanlı erişim kontrolleri
  • Doğrulama kuralları ve bağımlılıklar

Partiler

Partiler, bir şablonu takip eden belirli üretim çalışmalarını veya ürün gruplarını temsil eder. Her partinin takip ve doğrulama için benzersiz bir UUID'si vardır.

  • UUID aracılığıyla benzersiz tanımlama
  • Adım adım yürütme; her adımın tarihi ve saatiyle
  • Medya ve belge ekleri
  • Herkese açık doğrulama özellikleri

Parti Adımları

Parti yürütme sürecindeki bireysel adımlar; her biri kendi durumu, zaman damgaları ve destekleyici belgeleriyle.

  • Durum takibi (beklemede, devam ediyor, tamamlandı, başarısız)
  • Her durum değişikliği için zaman damgası kaydı
  • Konum verileri ve GPS koordinatları
  • Dosya ekleri ve notlar

İşletme Profilleri

Kullanıcı hesaplarına bağlı şirket bilgileri; çok taraflı iş birliği ve rol tabanlı erişim sağlar.

  • Şirket tanımlama ve doğrulama
  • İş kategorisi sınıflandırması
  • İletişim bilgileri ve tercihler
  • Erişim izni yönetimi

Kullanıcı Rolleri ve İzinleri

Rol İzinler Tipik Kullanım Senaryosu
Üretici Şablon oluşturma, parti başlatma, tüm adımları yürütme Ürün üreten ve yöneten orijinal üreticiler
Distribütör Belirli adımları yürütme, konumları güncelleme, belge ekleme Ürünleri taşıyan lojistik ve dağıtım şirketleri
Perakendeci Parti bilgilerini görüntüleme, son adımları yürütme, müşteriye yönelik doğrulama Son tüketicilere satış yapan mağazalar ve satış noktaları
Denetçi Tüm verileri görüntüleme, sertifika ekleme, kalite kontrol belgeleri Düzenleyici kurumlar ve kalite güvence ekipleri
Tüketici UUID/QR kodları aracılığıyla herkese açık doğrulama Bir ürünün kaydedilen yolculuğunu görüntüleyen son müşteriler

API Entegrasyonu

Kimlik Doğrulama

ZincirX, API belirteci ile kimlik doğrulama (Laravel Sanctum) kullanmaktadır. API'mize entegre olmak için:

  1. E-posta adresinizi ve parolanızı /api/auth/login adresine göndererek bir belirteç alın
  2. Bu belirteci her isteğin Authorization başlığında bearer belirteci olarak gönderin
  3. /api/public altındaki herkese açık doğrulama uç noktaları belirteç gerektirmez

Temel Uç Noktalar

Parti İşlemleri

  • GET /api/batches
  • POST /api/batches
  • GET /api/batches/{id}
  • POST /api/batches/{id}/steps/{stepId}/complete

Şablon Yönetimi

  • GET /api/templates
  • POST /api/templates
  • PUT /api/templates/{id}

Herkese Açık Doğrulama

  • GET /verify/{uuid}
  • GET /qr/{uuid}/image

Kayıtlar ve Doğrulama

Verileriniz Nerede Tutuluyor

  • Saklama: İşlettiğimiz sunucularda, ZincirX'in kendi veritabanı
  • Pasaport revizyonları: Yalnızca eklenir — değişiklik yeni bir revizyon olarak kaydedilir, öncekiler saklanır
  • Kanıt dosyaları: Her yükleme SHA-256 parmak izi taşır; böylece dosyanın değişmediği gösterilebilir
  • Erişilebilirlik: Pasaport, satın alınan süre boyunca erişilebilir kalır; varsayılan olarak düzenlendiği günden itibaren on yıl

Doğrulama Özellikleri

Tedarik zinciri kayıtları, ZincirX'in kendi sunucularındaki kendi veritabanında tutulur. Platform, bu kayıtların üçüncü taraflarca doğrulanabilir olması üzerine kuruludur:

  • Şablon kaydı; ürün için isteğe bağlı GTIN dahil
  • Zaman damgalarıyla birlikte parti oluşturma ve adım tamamlama kayıtları
  • Yüklenen her dosya için SHA-256 parmak izi; böylece bir dosyanın değişmediği gösterilebilir
  • Yalnızca ekleme yapılan Dijital Ürün Pasaportu sürümleri: bir değişiklik yeni bir sürüm olarak kaydedilir ve öncekiler saklanır

En İyi Uygulamalar

Güvenlik

  • ZincirX hesabınız için güçlü ve benzersiz bir parola kullanın, oturum açma bilgilerinizi asla paylaşmayın
  • İşletmenizin üyelerini düzenli olarak gözden geçirin ve artık gerekmeyen erişimleri kaldırın
  • Bir adımı tamamlandı olarak işaretlemeden önce adımın ayrıntılarını ve eklenen dosyaları kontrol edin
  • İşletme e-posta hesabınız için güçlü parolalar kullanın

Veri Yönetimi

  • Her adım için doğru ve eksiksiz bilgi sağlayın
  • Doğrulama için net ve ilgili medya dosyaları yükleyin
  • Partiler ve şablonlar için tutarlı adlandırma kuralları kullanın
  • İşletme profilinizi düzenli olarak gözden geçirin ve güncelleyin

İş Birliği

  • İlgili tedarik zinciri ortaklarıyla parti erişimini paylaşın
  • Adım gereksinimlerini tüm katılımcılara açıkça iletin
  • Son müşteriler tarafından kolay doğrulama için QR kodları kullanın
  • Tedarik zinciri ağınızla düzenli iletişimi sürdürün

Sorun Giderme

Oturum Açma Sorunları

  • E-posta adresinizi ve parolanızı doğru girdiğinizden emin olun
  • Google veya Facebook ile kayıt olduysanız, aynı sağlayıcıyla oturum açın
  • Tarayıcı önbelleğini ve çerezleri temizleyin
  • Parolanızı hatırlamıyorsanız oturum açma sayfasındaki parola sıfırlama bağlantısını kullanın

Parti ve Yükleme Hataları

  • Parti oluşturmadan önce kullanılabilir ön ödemeli pasaportunuz (UUID) olduğunu kontrol edin
  • Ağ bağlantısının kararlı olduğundan emin olun
  • Yeni bir yükleme başlatmadan önce önceki yüklemenin tamamlanmasını bekleyin
  • Yüklenen her dosyanın, yükleme formunda belirtilen boyut sınırı içinde olduğunu kontrol edin

Performans Sorunları

  • Modern tarayıcılar kullanın (Chrome, Firefox, Safari)
  • Gereksiz tarayıcı sekmelerini ve uygulamalarını kapatın
  • İnternet bağlantı hızınızı kontrol edin
  • Gerekirse tarayıcı verilerini temizleyin ve yeniden başlatın

Destek ve Kaynaklar

Topluluk Desteği

Diğer ZincirX kullanıcılarıyla bağlantı kurun ve sorularınız ile zorluklarınız için topluluk odaklı destek alın.

  • Kullanıcı forumları ve tartışmalar
  • En iyi uygulama paylaşımları
  • Özellik talepleri ve geri bildirim

Teknik Destek

Entegrasyon ve platforma özgü sorunlar için teknik ekibimizden doğrudan yardım alın.

  • API entegrasyon desteği
  • Dijital Ürün Pasaportu ve GS1 Digital Link rehberliği
  • Özel çözüm danışmanlığı
Şimdi Başlayın