API 및 ERP 연동
DGAssistant를 ERP, WMS 또는 운송 플랫폼에 연동하는 방법을 안내합니다.
API를 사용하려면 별도의 모듈이 필요합니까?
그렇습니다. API는 표준 라이선스에 추가하여 별도로 라이선스를 받는 모듈입니다. 연동을 결정하실 때 구독에 추가하시면 됩니다.
API 사용량은 어떻게 산정되며 가격은 어떻게 정해집니까?
API 사용량은 라이선스 단위로 산정됩니다. 라이선스 하나당 연간 탁송화물 1,500건과 서비스 호출 10,000회가 포함되며, 데이터베이스에는 탁송화물 외의 객체(제품, 그리고 수하인, 공급자, 운전자 등의 관계자)를 최대 5,000개까지 보관할 수 있습니다. 더 많은 사용량이 예상되면 라이선스를 추가하기만 하면 됩니다. API 모듈의 정확한 단가는 스토어에서 다른 제품과 함께 표시되며, 맞춤 견적에도 포함할 수 있습니다.
API를 사용하는 두 가지 방식인 일괄 처리와 대화형은 어떻게 다릅니까?
일괄 처리 방식은 한 번의 서비스 호출로 탁송화물의 전체 명세를 받습니다. ERP가 물품, 관계자 및 수량을 이미 알고 있는 경우에 적합합니다. 대화형 방식에서는 물품을 추가할 때마다 검증하면서 탁송화물을 단계별로 구성할 수 있습니다. 웹 애플리케이션의 작동 방식에 더 가까우며, API 위에서 사용자가 주도하는 작업 흐름이 필요할 때 유용합니다.
제품과 관계자는 미리 등록해야 합니까, 아니면 "즉시" 정의해야 합니까?
두 방식 모두 지원됩니다. 권장하는 방식은 "사전 정의 데이터"입니다. 웹 애플리케이션에서 물품과 관계자를 한 번 등록하거나 가져온 다음, API 호출에서 코드로 참조합니다. "즉시 정의" 방식은 매 호출에 모든 데이터를 함께 전송하는 방식으로, ERP가 해당 데이터의 기준 시스템이어서 데이터를 미리 등록해 두고 싶지 않을 때 편리합니다.
API를 통해 생성된 PDF는 어떻게 받습니까?
두 가지 방법이 있습니다. API 응답에서 base64로 인코딩된 PDF(운송서류, 송하인 신고서, 점검표, 포장물 표시 등)로 서류를 받거나, 플랫폼이 설정된 주소로 서류를 이메일로 자동 발송하도록 할 수 있습니다.
API로 생성한 서류를 자동으로 인쇄할 수 있습니까?
그렇습니다. 효과적인 방식은 두 가지입니다. (a) ERP가 API에서 PDF를 내려받아 자체 인쇄 대기열로 보내는 방식과, (b) DGAssistant가 전용 메일함으로 서류를 이메일로 보내고 고객 측의 간단한 자동 인쇄 유틸리티가 이를 해당 프린터로 인쇄하는 방식입니다. ERP 측에 추가 코드가 필요하지 않기 때문에 많은 고객이 이메일 방식을 사용합니다.
API 명세는 어디에서 볼 수 있습니까?
전체 OpenAPI 명세는 위험물 API 문서에 공개되어 있습니다. 또한 실제와 같은 테스트 호출이 미리 구성된 SoapUI 프로젝트를 제공하므로, 개발자는 몇 분 만에 API를 살펴볼 수 있습니다.
requestGuid란 무엇이며 왜 필요합니까?
모든 API 호출에는 고유한 requestGuid를 포함해야 합니다. requestGuid는 당사 로그에서 요청을 식별하며, 문제를 신고하시면 지원팀이 해당 트랜잭션을 정확히 찾을 수 있게 해 줍니다. 고유한 영숫자 값이면 무엇이든 사용할 수 있으며, 클라이언트 측에서 표준 UUID/GUID를 생성하는 방식을 권장합니다.
API 호출이 처음에 실패하는 가장 흔한 원인은 무엇입니까?
가장 흔한 원인은 서비스가 받아들이지 않는 자격 증명입니다. HTTP Basic 인증(Authorization) 헤더가 없거나 잘못된 경우, 또는 OAuth2로 인증하는 호출에서 액세스 토큰을 발급받지 않았거나, 다른 환경의 토큰이거나, 이미 만료된 경우입니다. API가 정상적으로 작동하는지와 자격 증명이 유효한지 확인할 수 있는 전용 지원 URL이 있습니다. 해결이 되지 않는 경우 전체 HTTP 요청과 응답(requestGuid 포함), 그리고 기대한 동작에 대한 설명을 보내 주십시오. 이렇게 하는 것이 문제를 가장 빠르게 해결하는 방법입니다.