Tehlikeli madde REST API

API neler yapar

Sevkiyatlar. DGAssistant REST JSON API'si, tehlikeli madde sevkiyatını kendi yönetim veya lojistik sisteminizden oluşturur ve gönderen beyanını, kontrol listesini ve ambalaj işaretlemesini, uygulanacak mevzuata göre denetlenmiş olarak döndürür. Ticari veriler sizin sisteminizde kalır; mevzuat bilgisini ve belgeleri DGAssistant sağlar.

Konsolidasyon. API, birden çok gönderenin sevkiyatlarının bir araya getirilmesini de iki ekseniyle kapsar. Sözleşme ekseni ana sevkiyattır — bir rezervasyon, bir deniz veya hava konsolidasyonu, bir kara parsiyeli — tarafları, referansları, kendisine bağlı sevkiyatları, durum geçişleri ve geçmişiyle. Fiziksel eksen ise taşıma birimi (konteyner, araç, römork veya birim yükleme ünitesi) ve taşıma hareketidir (sefer, uçuş veya yolculuk); uğrak noktalarıyla ve hesabın gemileri, araçları ve konumlarıyla birlikte. Hizmetin yarısından fazlası bu bölüme ayrılmıştır.

Tehlikeli madde API belirtimini açın

İki çalışma biçimi: toplu ve etkileşimli

Toplu. Tek bir çağrı, sevkiyatın tüm maddeleriyle birlikte eksiksiz tanımını taşır. Hazır oluşturulmuş sevkiyatları gönderen yönetim ve lojistik sistemleri için düşünülmüş yoldur.

Etkileşimli. Önce sevkiyat açılır, sonra maddeler tek tek eklenir. Her yanıt, az önce eklenen maddeye ilişkin doğrulama iletilerini taşır; böylece kendi uygulamanız bunları, sevkiyat hazırlanırken kullanıcıya gösterebilir.

Önceden tanımlı veriler ya da çağrı içinde veriler

Önceden tanımlı veriler. Ürünler ve taraflar — gönderenler, taşıyıcılar, alıcılar, yükleyiciler ve sürücüler — önceden oluşturulur ve API bunların kodlarını kullanır. En yalın çalışma biçimi ve önerdiğimiz yoldur; çünkü mevzuata göre sınıflandırma bir kez çözülür ve her sevkiyatta yeniden kullanılır.

Çağrı içinde veriler. Ürünler ve taraflar, sevkiyatı oluşturan çağrının içinde tanımlanır. Kendi kataloğunu tutmayan ya da ara sıra tehlikeli madde gönderen sistemlere uygundur.

Döndürdüğü belgeler

Her sevkiyat için: uygulanacak mevzuatın gönderen beyanı, kontrol listesi ve ambalaj işaretlemesi. PDF, XLSX veya DOCX olarak alınır ya da doğrudan hizmetin içinden elektronik postayla gönderilir.

Konsolidasyon için: taşıma biriminin belgeleri, hareketin belgeleri — aralarında tehlikeli madde manifestosu ve kaptana bildirim — ve ana sevkiyatın belgeleri.

API neleri denetler

Sevkiyatta. Birlikte taşınan maddeler arasındaki ayrım, uygulanacak ambalajlama talimatının ve sınırlı ile istisnai miktar rejimlerinin miktar sınırları, maddelerin o taşıma türü için kabul edilebilirliği, ambalajın uygunluğu ve beyanın eksiksizliği. Bir husus karşılanmadığında yanıt, hangi kuralın sağlanmadığını ve hangi değerlerle sağlanmadığını belirtir; böylece ileti kendi uygulamanızda gösterilebilir.

Konsolidasyonda. Taşıma birimi içindeki ayrım, aynı harekette yüklenen birimler arasındaki ayrım, hareket için ADR'nin 1.1.3.6 eşiğinin dökümüyle hesaplanması ve yolculuğun kısıtlarının veri olarak döndürülmesi; örneğin tünel kısıtlama kodu ya da yüksek sonuçlu tehlikeli madde bulunması.

Kapsanan mevzuatlar ve taşıma türleri

Kara için ADR, deniz için IMDG, hava için IATA ve 49 CFR. Üç ana mevzuat ayrı modüller olarak değil birlikte yönetilir; böylece taşıma türü değişen bir sevkiyatın yeniden hazırlanması gerekmez.

Birlikte ambalajlama, üst ambalajlar, tanklar, dökme taşıma, boş ve temizlenmemiş ambalajlar, atıklar ve Sınıf 7 radyoaktif maddeler, her birinin gerektirdiği verilerle desteklenir. Belgelerin metinleri on dokuz dilde düzenlenir.

Erişilebilirlik

Hizmet üç bölgede yayımlanır — Avrupa, Amerika ve Asya-Pasifik — her biri kendi adresiyle; böylece tümleştirme, hesabın tutulduğu bölgeye karşı çalışır. Altyapı yedekli ve kesintisiz izlenmektedir.

Nasıl başlanır

İki haftalık ücretsiz deneme ve onunla birlikte hizmetin kimlik bilgilerini talep ediniz. Kimlik doğrulama, «client credentials» yöntemiyle OAuth 2.0 kullanır: sisteminiz bir erişim belirteci alır ve her istekte gönderir.

Eksiksiz belirtim OpenAPI biçiminde yayımlanmıştır; tek satır tümleştirme kodu yazmadan önce okunabilir, incelenebilir ve kendi dilinizde bir istemci üretmek için kullanılabilir.