Transcript 기업간연계 및 API 소개 - 계약고객시스템

계약고객전용 계약EMS
기업간연계 및 API 소개
1. 기업간연계 소개
2. Open API 소개
- Open API 시스템 소개 및 방식, 종류
- Open API 이용 방법 안내 및 신청 절차
- Open API 동작방법 설명 및 sample
Ⅰ. 기업간연계(EMS/K-packet)
1. 기업간연계 서비스란?
O (서비스체계) 우체국 서버와 고객 서버를 연계해서 ems 신청정보를 전송, 신청된 데이터는 실시간으로
우편물류시스템으로 연동되어 우체국에서 픽업 및 접수 가능하며 고객에게는 배송결과를 제공함.
O (대상고객)
- 우체국과 국제우편물 계약을 한 업체로, 자체시스템을 통해 데이터 연계 및 운송장 출력까지 가능하며,
연계를 위한 환경구축이 가능한 업체
※ 운송장 자체출력을 원할 경우 기표지모듈 제공가능하나 다국어(중국어, 일본어 등)를 이용시에는
자체기표지 출력 개발이 필요함.
신청
연계 Agent 설치
▶
계약업체
정보 전송
계약업체
운송장출력
▶
계약고객시스템/
업체자체출력
집하 및 접수
▶
우편물류
시스템
배송결과 전송
▶
연계담당
Ⅰ. 기업간연계(EMS/K-packet)
2. 신규업체 기업간연계 업무처리 절차
① 우체국은 업체와 발송물량 등 계약체결 후 해당 우정청 소포팀에 연계요청
② 해당우정청 담당은 정보센터 업무담당과 연계협의 후 연계요청 공문 발송
- 연계협의사항 : 연계형식, 시스템OS, 일정협의 등
- 문서내용 : 고객번호, 승인번호, 월물량, 관리국 등이 포함
- 연계일정 : 문서접수일로부터 3주정도 소요
③ 정보센터 담당이 연계에 필요한 서버사양서 및 연계 레이아웃 등을 업체에
제공하고 세부사항 협의
- 연계업체는 레이아웃 대로 시스템 개발 완료
④ 연계담당은 반영 2~3일전 업체에 연계 Agent 제공
⑤ 업체 환경이 구축되면 테스트 진행 후 실환경 반영
Ⅰ. 기업간연계(EMS/K-packet)
2. 신규업체 기업간연계 업무처리 절차- 서버사양서 샘플
Ⅰ. 기업간연계(EMS/K-packet)
2. 신규업체 기업간연계 업무처리 절차- 연계 레이아웃 샘플
Ⅰ. 기업간연계(EMS/K-packet)
2. 신규업체 기업간연계 업무처리 절차- 업체 전송 샘플
Ⅱ. Open API 시스템(EMS/K-packet)
1. open API 시스템 소개
계약고객전용시스템 계약EMS 에서 제공하는 접수 open API는 실제 주문이 발생한 (자사)사이트에서
발급받은 해당 API를 사용하여 EMS접수신청 및 종추적 조회가 가능한 시스템입니다.
현재의 파일 업로드 방식의 수작업 형태를 벗어나 픽업이 필요한 신청 정보를
계약고객전용시스템 및 우편물류시스템으로 바로 연계 하는 시스템 입니다.
픽업 요청이 필요한 시점에 해당 API 를 호출 하면 신청결과 값(등기번호,요금등)을 바로 리턴하며
이를 이용하여 기표지 출력 및 종추적이 원 사이트에서 가능합니다.
API 시스템은 결과를 xml로 생성하여 해당 사이트에서는 결과 자료를 이용한 화면 구성
및 자료 관리를 사이트가 원하는 방식으로 가공하여 사용하실 수 있는 잇점이 있습니다.
2. open API 신청방식
2
1
고객
주문
쇼핑몰 시스템
신청 API
호출
기표지 출력
종추적 조회
3 계약고객전용시스템
ePOST
계약 EMS
자동연계
4
PostNet
접수시스템
Ⅱ. Open API 시스템(EMS/K-packet)
3. 제공API 종류
o 조회용 : 7종, 접수용 : 4종
1
2
3
4
5
6
7
1
2
3
4
Ⅱ. Open API 시스템(EMS/K-packet)
4. API 이용방법 안내
① 계약고객전용시스템 ( http://biz.epost.go.kr ) > 오픈API > 오픈API이용방법> EMS/K-packet 접수(로그인 없이도 가능)
② [요청변수 및 출력항목 매뉴얼 다운로드] API를 호출하는 방법에 대한 설명서입니다.
③ [기표지출력 프로그램 및 매뉴얼 다운로드] 상대기관 사이트에서 기표지를 출력 할 수 있도록 도와줄 ActiveX 프로그램입니다.
 상대기관은 2,3번의 매뉴얼을 참고 하여 API 를 호출할 수 있는 화면 및 프로그램을 자체 개발 하셔야 합니다.
Ⅱ. Open API 시스템(EMS/K-packet)
5. Open API 신청절차 (신규업체)
① 우체국에서 우편창구 고객등록 (고객번호 획득) 및 계약처리(계약승인번호획득)
② 인터넷우체국 회원가입 및 고객번호유효성검증
Ⅱ. Open API 시스템(EMS/K-packet)
5. Open API 신청절차 (신규업체)
③ 계약고객전용시스템 접속(http://biz.epost.go.kr) > 로그인 > 시스템사용설정
Ⅱ. Open API 시스템(EMS/K-packet)
5. Open API 신청절차 (신규업체)
④ 오픈 API사용 신청: 메인의 Open API> 오픈API 사용신청
Ⅱ. Open API 시스템(EMS/K-packet)
5. Open API 신청절차 (신규업체)
⑤ 오픈API 신청결과 (암호키와 보안키를 확인)
- 인증키는 시스템에 의해 자동으로 바로 생성되며, 보안키는 생성을 통해 클립보드에 저장됨
- 국제 EMS 관련된 정보 조회는 인증키만으로 사용가능하며, 접수를 위해서는 데이터 암호화를 위한 보안키를 발급받아야함.
Ⅱ. Open API 시스템(EMS/K-packet)
6. API 동작방법 설명
상대기관
요청 데이타
eShop
Mall
고객번호=0000062815&
승인번호=89958H1125&
발송인명=Song Lee &
발송인우편번호=402701&
발송인주소1=Jng 123&
발송인주소2=Gieoul&
발송인전화1=82&
발송인전화2=2&
발송인전화3=123&
발송인전화4=4567&
발송인핸드폰전화1=82&
발송인핸드폰전화1=10&
발송인핸드폰전화2=1234&
발송인핸드폰전화3=4567&
발송인이메일[email protected]&
발송메시지=ts&……
암
호
화
http://eship.epost.go.kr/api.EmsApplyInsertReceiveTempCmdNew.ems?key=7
1138e637fe5d7dec1344508085605&regData=eb16769af730a6c6dce5c20794
ca32ec15c00236ae7bdba585e7d62cf8bf9a1e65fd487e9d4e5b5b0c0be48378
e4a18643fa37f0aae73358f685949101cd8c2056f6ab2bc3774c3e74366cab91d
53ab8a084c4f2a6cf27ba6706d0792c5181b4c08e57d11fa1077226805603707
c84f3346fa32dea9849ac5e4e463cff781ed630ce675cf94176d64b247c5ed23cf
0895a4fd2089e77503a3fab7937a187d01f8df59d85b4a4a2ac839180b65cbd3
dfd00beb5c9ea6664d5ca8c97addfdaaef57db6cbd645b64fb0179a6c2dd13480
5……….
수신 받은 결과 데이터를 이용
하여 기표지출력 , 데이터 관리,
화면등은 상대기관이 관리
계약고객전용
계약EMS
API
(복호화)
<?xml version="1.0" encoding=“UTF-8" ?>
- <xsync>
- <receiveseq>
- <![CDATA[ S2012082057155 ]]>
</receiveseq>
<prerecevprc>62100</prerecevprc>
…………
- <prcpaymethcd>
- <![CDATA[ 12 ]]>
</prcpaymethcd>
- <![CDATA[ MG100000034KR ]]>
</regino>
</xsync>
결과 데이타
Ⅱ. Open API 시스템(EMS/K-packet)
7. API 이용 샘플( 국가별 발송조건 조회)
(인증키)
“UTF-8”
조회성 API 종류(암호화 불필요)
1. 발송가능 국가 조회
2. 국가별 발송 조건
3. 영문주소 조회
4. KPG 주도코드
5. KPG 시도코드
6. KPG 우편번호
7. 배송예상비용
Ⅱ. Open API 시스템(EMS/K-packet)
8. API 이용 샘플( 접수(픽업지시)요청)
(암호화된 데이타)
(인증키)
“UTF-8”
접수관련 API(암호화 필요->Seed128방식)
1.고객번호조회
2.계약승인번호 조회
3.접수(픽업지시)요청
4.접수내역조회(연계여부)확인