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 düzenlemeye göre denetlenmiş olarak döndürür. Ticari veriler sizin sisteminizde kalır; düzenlemelere ilişkin bilgiyi 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ü düzenlemelere 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

API, uygulamanın ürettiği belgelerin aynısını döndürür. Sevkiyatın ve konsolidasyonun belgeleri PDF, XLSX veya DOCX olarak alınır, sevkiyatın belgeleri ayrıca doğrudan hizmetin içinden elektronik postayla gönderilebilir; taşıma senedinin belgeleri ise PDF olarak alınır.

• Her sevkiyat için: uygulanacak düzenlemenin taşıma belgesi —ADR taşıma belgesi, IMO tehlikeli madde beyanı ya da IMDG multimodal formu ve IATA gönderen beyanı—, kontrol listesi, tam boyutta veya küçük özel boyutta ambalaj işaretlemesi ve hava yolunda hava yolu senedi veri föyü.
• Ana sevkiyat için: konsolidasyon manifestosu, konteyner listesi, her birimin ambalaj listesi, gönderene göre yükleme föyü ve ana belge veri föyü.
• Taşıma birimi için: konteyner/araç ambalajlama sertifikası, tehlikeli maddeler için multimodal form, birimin ayrım raporu, sertifikanın imzalanmasından önceki kontrol listesi ve konsolidasyon etiketi.
• Sefer için: tehlikeli mallar manifestosu, gemideki birimler arası ayrım raporu, ADR 1.1.3.6 muafiyet eşiği raporu, sefer kısıtlama föyü, yükleme föyü, kaptana bildirim (NOTOC) ve aracın konsolide taşıma belgesi.
• Taşıma senedi için: taslak, imzalı nüsha, ekli ADR taşıma belgesi ve kanıt raporu.

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 düzenlemeler ve taşıma türleri

Kara için ADR, deniz için IMDG, hava için IATA ve 49 CFR. Üç ana düzenleme 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, Sınıf 1 patlayıcılar —ambalaj başına net patlayıcı kütleleriyle— 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.