위험물 REST API

API의 기능

탁송화물. DGAssistant의 JSON REST API는 자체 관리 시스템이나 물류 시스템에서 위험물 탁송화물을 생성하고, 적용 규정에 따라 이미 검증된 송하인 신고서, 점검표 및 포장물 표시를 반환합니다. 상거래 데이터는 자체 시스템이 보유하고, 규정에 관한 지식과 서류는 DGAssistant가 제공합니다.

콘솔리데이션. API는 여러 송하인의 탁송화물 통합도 두 가지 축으로 지원합니다. 계약상의 축은 마스터 탁송화물입니다. 마스터 탁송화물에는 — 부킹이든, 해상 또는 항공 콘솔리데이션이든, 도로 콘솔리데이션이든 — 관계자, 참조번호, 연결된 탁송화물, 상태 전환 및 이력이 포함됩니다. 물리적인 축은 운송장비(컨테이너, 차량, 트레일러 또는 단위탑재용기)와 기항지를 포함한 운송편(항해, 항공편 또는 운행)이며, 계정에 등록된 선박, 차량 및 장소도 여기에 포함됩니다. 서비스의 절반 이상이 이 부분에 할애되어 있습니다.

위험물 API 명세 열기

두 가지 작업 방식: 일괄 처리와 대화형

일괄 처리. 한 번의 호출로 모든 물품을 포함한 탁송화물의 전체 명세를 전송합니다. 이미 구성이 끝난 탁송화물을 통째로 전송하는 관리 시스템과 물류 시스템을 위한 방식입니다.

대화형. 먼저 탁송화물을 생성한 뒤 물품을 하나씩 추가합니다. 각 응답에는 방금 추가한 항목에 대한 검증 메시지가 포함되므로, 탁송화물을 준비하는 동안 자체 애플리케이션에서 이를 사용자에게 표시할 수 있습니다.

사전 정의 데이터 또는 즉시 정의 데이터

사전 정의 데이터. 제품과 관계자를 미리 등록해 두면 — 관계자에는 송하인, 운송인, 수하인, 적재자 및 운전자가 포함됩니다 — API는 해당 코드를 사용합니다. 규정에 따른 분류를 한 번 확정하여 모든 탁송화물에 재사용하므로 가장 간단한 작업 방식이며, 당사가 권장하는 방식입니다.

즉시 정의 데이터. 제품과 관계자를 탁송화물을 생성하는 호출 안에서 함께 정의합니다. 자체 카탈로그를 보유하지 않거나 비정기적으로 물품을 발송하는 시스템에 적합합니다.

반환되는 서류

API는 애플리케이션이 작성하는 것과 동일한 서류를 반환합니다. 탁송화물 및 콘솔리데이션 서류는 PDF, XLSX 또는 DOCX 형식으로 받을 수 있고, 탁송화물 서류는 서비스에서 직접 이메일로 보낼 수도 있습니다. 화물운송장 서류는 PDF로 제공됩니다.

• 탁송화물별: 적용 규정에 따른 운송서류(ADR 운송서류, IMO 위험물신고서 또는 IMDG 복합운송 위험물 서식, IATA 위험물 송하인 신고서), 점검표, 전체 크기 또는 사용자 지정 소형 크기의 포장물 표시, 그리고 항공운송의 경우 항공화물운송장 데이터 시트.
• 마스터 탁송화물별: 콘솔리데이션 적하목록, 컨테이너 목록, 운송단위별 포장명세서, 송하인별 적재명세서, 마스터 서류 데이터 시트.
• 운송단위별: 컨테이너·차량 수납검사증, 복합운송 위험물 서식, 운송단위 격리 보고서, 수납검사증 서명 전 점검표, 콘솔리데이션 라벨.
• 운송편별: 위험물명세서, 적재된 운송단위 간 격리 보고서, ADR 1.1.3.6 면제 기준값 보고서, 운행 제한사항 명세서, 적재명세서, 기장 통보서(NOTOC), 차량 통합 운송서류.
• 화물운송장별: 초안, 서명본, 첨부된 ADR 운송서류, 증적 보고서.

API의 검증 항목

탁송화물. 함께 운송하는 물품 간의 격리, 적용되는 포장지침과 제한수량 및 소량 제도의 수량 한도, 해당 운송방식에 대한 물품의 운송 허용 여부, 포장의 적법성, 신고 내용의 완전성을 검증합니다. 요건을 충족하지 않는 경우 응답에 충족되지 않은 규칙과 해당 값이 명시되므로, 그 메시지를 자체 애플리케이션에 표시할 수 있습니다.

콘솔리데이션. 운송단위 내부의 격리, 같은 운송편에 적재된 운송단위 간의 격리, 운송편에 대한 ADR 1.1.3.6 기준값 산정과 그 내역을 검증하며, 터널 제한 코드나 고위험 위험물의 적재 여부 등 운행 제한사항을 데이터로 반환합니다.

적용 규정 및 운송 유형

도로운송은 ADR, 해상운송은 IMDG, 항공운송은 IATA, 그리고 49 CFR을 지원합니다. 세 가지 주요 규정을 별도 모듈이 아닌 하나로 통합하여 관리하므로, 운송방식이 바뀌는 탁송화물을 다시 작성할 필요가 없습니다.

혼합포장, 오버팩, 탱크, 산적운송, 세척하지 않은 빈 포장용기, 폐기물, 제1급 폭발물(포장물당 폭발물 순질량 포함), 제7급 방사성물질을 모두 지원하며, 각각에 필요한 데이터를 처리합니다. 서류의 문구는 19개 언어로 발행됩니다.

가용성

이 서비스는 세 지역에서 제공되며 — 유럽, 미주, 아시아·태평양 — 지역마다 고유한 주소가 있으므로, 계정이 개설된 지역을 대상으로 연동이 이루어집니다. 인프라는 이중화되어 있으며 24시간 모니터링됩니다.

시작 방법

2주 무료 체험을 신청하시면 서비스 자격 증명도 함께 발급해 드립니다. 인증에는 OAuth 2.0의 클라이언트 자격 증명 그랜트 방식을 사용하며, 자체 시스템이 액세스 토큰을 발급받아 모든 요청에 포함하여 전송합니다.

전체 명세는 OpenAPI 형식으로 공개되어 있으므로, 연동 코드를 한 줄도 작성하기 전에 명세를 읽고 살펴보며, 사용하는 프로그래밍 언어로 클라이언트를 생성할 수 있습니다.