KRX Exture 시장접속프로토콜 V1.5

KRX EXTURE 시장접속 프로토콜 (Krx Market Access Protocol)

2009. 01 . 30

증권선물거래소

V1.5

2/85

변경이력

버전 개정일자 변 경 내 용 비 고

V1.0

2008.02.04 초안작성2008.02.22 Header 에 ms(1/1000) 반영 -> 자릿수 변경 , 유관기관 일괄송신 추가 7,33,37~52pag

e

2008.04.04

주문시각관련 수정제공 서비스의 전문 송 / 수신 조정 (PG 매매사전공시 , 대량매매주문서거절 )주문요청 / 응답시 Header 일련번호 Set

p12~19,

p51,

p7, p572008.04.10 프로세스별 TR 매핑 36p~42p

V1.1

2008.06.13

- 청산결제 실시간 서비스 추가

-종목마감 처리 추가 ( 체결 서비스 )

-요청 서비스의 설명 추가 ( 요청시 흐름 )- 실시간 서비스 추가- 프로세스별 TR 매핑 삭제 ( 시장접속 프로토콜 ( 전문 ) 으로 Move)- 거부사유코드 추가- 회원사 Port 배정안 추가- Header 의 일련번호 자릿수 변경 (10 -> 11)

5,6p

23,24p

26,27p

30,31p

57p

69p

41 ~ 56p

2008.06.24

- 주문마감처리방법에서 공개장운영 수정- 거부사유코드 추가 및 변경- 회원사 Port 배정안 수정-FIX 메시지 삭제

19p

57p

65p

-

2008.07.08

~

2008.07.18

- 그림수정- 그림수정 ( 거부코드 , 일련번호 순서변경 )- 일괄수신 , 일괄송신 Session 메시지 Format 추가- 오타 수정 및 거부사유 코드 조정- 요청 / 조회 중 조회 관련 수정 및 대표 Tr-Code 정의- 요청 / 조회 관련 추가

16p

33~35p

57~60p

54p,61p

25p,27p,

57~60p

2008.07.30

-그림 오류 수정-오류거부코드 추가-실시간 Session 메시지 Format 추가

16p

65p

61p

3/85

변경이력


V1.2 2008.09.19

- 서비스 분리적용 ( 적용일 : 2008.10.06)

- 기타마감처리 방안 보완- 종목마감 처리변경 ( 현 / 선물 주문과 체결 프로세스 1:1 구조로 변경 )

- 요청 / 조회 서비스 분리 및 요청을 신고로 명칭 변경 ( 적용일 : 2008.10.06)

- 회선시험요청 및 응답 Body 에 거부사유코드 추가 ( 적용일 : 2008.10.06)

- 일련번호 응답 Body 에 거부사유코드 추가 ( 적용일 : 2008.10.06)

- 거부사유코드 추가 ( 적용일 : 2008.10.06)

- 사용자 ID 정책 추가

6,7p

22p

26p

27~30p

50~51p

55p

71p

80p

V1.3

2008.10.01

- 신고 관련 변경 ( 처리흐름 보완 및 추가 ) ( 적용일 : 2008.10.06)

- 암호화 관련 변경 (Header 구조 , Logon Body, 거부코드 ) ( 적용일 : 2008.10.06)

- 거부사유코드 추가 ( 암호화 관련 ) ( 적용일 : 2008.10.06)

12,28,29p

9,47~71p

72p

2008.10.22-1 회 전문 전송 길이 제한 ( 암호화 적용 전 길이 ) - 일괄송신 서비스 업무흐름도 ( 유관기관만 해당 ) 장표 삭제

8p

42p

2008.12.01

-1 회 전문 전송 길이 제한 ( 암호화 적용 전 길이에서 => 암호화 변경 후로 변경 )

-일련번호 처리시 장개시 전 / 호가접수중지 시 데이터 Retry 표기

-서비스 별 프로세스 종료 시점 추가 ( 적용일 : 2008.12.08)

-일괄 송 / 수신 데이터 종료 처리의 Case 별 처리 추가

-거부사유코드 “ 0012” 추가 .( 데이터 Body 에 Null 데이터 값이 포함 , 적용일 : 2008.12.08) ※ 장표내 파란색 글짜는 변경 부분을 표시한 내용입니다 .

8p

19p

23p

43p( 추가 )

73p

2008.12.17- 장운영 인터페이스 종료 TrCode 변경 - 대량매매주문서 송신 프로세스 표기

23p

24p2008.12.30 - 채널 Active 프로세스 구성 추가 83~84p

V1.4 2009.01.30

-주문서비스로 대량주문서 거절 송신시 기술

-0009 사용인 경우 비고란에 추가

-Port 정책 체계 변경 및 프로세스 번호 변경 ( 적용일 : 2009.2.13)

14p

73p

81,82,84p

4/85

변경이력


V1.5 2009.06.18

- 장운영서비스 송신 데이터 ( 공개장운영 , 종목마감 ) 분리 ( 적용일 : 2009.06.08)- 채널 서비스 구성 변경- 장운영 서비스 업무 흐름도 내용 변경-Session 메시지 Format 예시 변경-TCP/IP PORT 정책 추가 ( 장운영 #1: 공개장운영 [80], 장운영 #2: 종목마감 [90] )- 사용자 ID 정책 예시 변경-Active process 구성 추가

8p

34p

64p

83p

84p

85p

5/85

Contents

KRX KRX 차세대 시스템 차세대 시스템

접속 프로토콜접속 프로토콜설명자료설명자료

1. 차세대 접속시스템 개요

2. 메시지 타입별 업무 흐름도

3. Session 메시지 Format

4. Session 메시지 흐름의 적용 ( 예 )

5. 차세대 적용 원칙

1) 메시지 Format 적용

2) Tcp/Ip Port 정책

3) 사용자 ID 정책

4) Active 프로세스 구성

6/85

시장참여자

차세대 시스템의 논리적인 서비스 위치

채널 Backend System

차세대 시스템의 위치는 기능별로 분리되어 배치되며 , 통합업무는 서울 센타에서 지원하게 됩니다 . 채널시스템은 통합환경으로 개발을 하나 Deploy 는 논리적인 환경에 따라 서비스를 합니다

KRX( 서울센타 )

회원사 테스트시스

템 ( 현 /선물 )

DR (선물 )

선물 /옵션 G/W

증권사

선물사

예탁결제

원

협회

한국은행

결제은행

유가증권 매매시스템 코스닥

매매시스템

통합청산 결제시스템 정보분배

시스템 종합감리

시스템

선물 /옵션

매매시스템

공통관리

유가증권 G/W

코스닥 G/W

통합청산결제

G/W

거래소업무 G/W

정보분배 G/W

공통관리 G/W

KRX( 부산센타 ) 해외거래소

DR ( 유가/ 코스닥 /

정보분배 / 상장공시 )

KRXNetwork

7/85

Member 채널 Backend System

매매체결

장운영

청산결제

RDS

시장관리

매매지원

S

A

A

S

S

S

S

Sync

Async

송 / 수신

채널시스템 서비스 구성

신고

장운영

수신수신주문

수신수신체결

조회

일괄송신

채널시스템의 서비스 구성은 업무요건에 따라 다음과 같이 분리하여 적용함 , 주문 /시간외 / / 체결 / 장운영은 시장별로 분리하여 지원함 . 통합업무는 하나의 서비스에서 업무를 처리 함

송신

수신수신수신

수신수신송신

수신

수신

수신

송 / 수신

오전시간외

유관기관

수신

실시간수신송신

일괄수신

종합감리수신

종합감리송신

송신

수신

송신

S

A 시간외체결 송신매매체결

S

S

A

종합감리

8/85

채널시스템 서비스 구성

채널시스템의 서비스 구성은 업무요건에 따라 다음과 같이 분리하여 적용함 , 통합업무는 시장 참여자별로 하나의 서비스에서 업무를 처리 함 .

구분 수량 모드 비고주문 ( 정규장 , 오후시간외

포함 ) N 개N – 1 개 Sync

유가 / 코스닥 / 선물 시장별로 구성

오전시간외 주문 1 개 Sync

체결 ( 정규장 , 오후시간외 포함 ) N 개

N – 1 개 Async

오전시간외 체결 1 개 Async

장운영 2 개 Async

신고 1 개 Sync

시장 참여자별로 1 개( 유가 시장에서 통합업

무 )

조회 1 개 Sync

일괄송신 1 개 Sync

일괄수신 1 개 Sync

실시간 수신 1 개 Async

종합감리 수신 1 개 Sync

종합감리 송신 1 개 Sync

※ 서비스명 ( 회원사 기준 )

9/85

채널서비스 구분 업무구분 외부시스템 ( 시장참여자 ) 과 통신 방식

KRX 내부시스템과 통신방식

Session 메세지 Sync -

Business 메세지

송신 G/W

주문 Sync R/R오전시간외 주문 Sync R/R신고 Sync R/R조회 Sync Pub/Sub일괄송신 Sync Pub/Sub종합감리 송신 Sync Pub/Sub

수신 G/W

체결 Async Pub/Sub오전시간외 체결 Async Pub/Sub장운영 Async Pub/Sub실시간수신 Async Pub/Sub일괄수신 Sync Pub/Sub종합감리 수신 Sync Pub/Sub

-주문은 6 개 , 체결 및 장운영은 10 개의 Business Data 를 가변길이 형태로 송수신함-수신인 경우 Header 의 Trcode 자리에 대표 TR 로 주문인 경우 TCHODR00000, 조회에서 조회는 TCHQEY00000 로 송수신함-송신인 경우 Header 의 Trcode 자리에 대표 TR 로 체결은 TCHTDP00000, 장운영은 TCHMIP00000 로 송신함-일괄 송 / 수신 및 종합감리 송 / 수신의 1 회 송수신 메시지는 4096Byte(Header 포함 ) 이하로 제한( 암호화 적용 후 길이 )

기능별 통신방식 및 메시지 구성 시장참여자와의 Session 메시지는 Sync( 요청 / 응답 ) 방식으로 적용하며 , 비즈니스

메시지는 기능별로 Sync 와 Async 2 가지의 통신방식을 지원함

Header

메시지 구성

Body

Size,seq, 송수신시간 ,Trcode 등

기능별 통신방식

SEQ + TrCode ...

Data 1 Data 2 Data 3 Data N

… … …

※ 서비스명 ( 회원사 기준 )

10/85

Header 및 Trcode 체계

항목 명 영문명 (Fix 와 동일 ) Format 설 명 전문유형 BeginString String(8) API 프로토콜의 버전 메시지길이 BodyLength Long(6)

Body 전체 길이 ( 암호화된 길이 . 단 , 평문시는 평문길이 )

메시지 타입 MsgType String(11)

Logon 등 세션 메시지 타입 및 Transaction Code 를 포함 메시지타입 : “S” + “CH” + Type(3) + 일련번호 (5)

일련번호 MsgSeqNum Long(11) 데이터 ( 주문 등 ) 요청시 Body 첫번째 데이터 항목의 일련번호데이터 ( 주문 등 ) 응답시 수신측 ( 채널 ) 최종 처리 일련번호

회원번호 SenderCompID String(5) 거래소에서 부여하는 회원사번호 연계시도착회원사번호

DeliverToCompID String(10)

향후 연계거래시 사용 회신시송신회원사번호

OnBehalfOfCompID String(10)

향후 연계거래시 사용

전송일시 SendingTime String(17)

YYYYMMDDHHMMSSMS

데이터 건수 Datacnt Long(3) Body 중 데이터 건수 암호화 유무 Encrypt String(1) 암호화 유무

Session 과 Business 메시지의 Header 는 동일 ,TR Code 는 비지니스별로 정의하여 사용함

Header 구조

Trcode 체계

T System Code(2) Object Code(3) 일련번호 (5)

구 분 요 청 응 답메시지 세션 타입

세션 메시지

키교환 세션 전문 SCHLIQ00101 ~ SCHLIQ00105Logon SCHLIQ00000 SCHLIR00000

Heartbeat SCHHEQ00000 SCHHER00000Opening SCHOPQ00000 SCHOPR00000Logout SCHLOQ00000 SCHLOR00000

Sequence SCHSQQ00000 SCHSQR00000Resend SCHRSQ00000 SCHRSR00000

비지니스 메시지 Transaction TR-Code ( 업무별로 별도 정의 )

11/85

Contents












12/85

TCP Connect & Logon

Opening Req/Res

Sequence Req/Res

Heartbeat Req/Res

Transaction Req/Res( 주문 TR)

Logout Req/Res & TCP Disconnect

SessionMessage

BusinessMessage

M

O

M

M

M

M

시장참여자 채널

메시지 Type 별 업무 흐름도

Resend Req/ResO

시장참여자 요청 (UserID, Password 입력 )

데이터 발생원에서 데이터 송신이 없을 경우 10 초 간격으로 발생하며 30 초 이상 응답 또는 데이터 없는경우 Session Close-> 재 Logon

채널에서만 업무개시 요청 (Logon 후 반드시 수행 )데이터 수신시스템을 기준으로 일련번호 동기화거부시는 시장참여자의 준비가 미완료인 경우 1 회 /10초 발생하며 3 회이상 무응답시 Session Close

시장참여자에서 요청

주문에서만 사용

장운영 , 체결전송 , 실시간 수신에서만 사용 . 단 , 채널내부에 보관된 정보만 재전송 가능

TRcode 로 분류가능Async 일때는 응답메시지 없음

M O필수 메시지 종류에 따라 선택가능

세션키 교환 처리

13/85


업무개시 흐름도

최종일련번호0

Logon 요청 사용자 검증

업무개시 요청H

Body0정상

업무개시 응답 업무개시 요청정상

Outbound 업무시작업무개시가 안된 경우 Inbound 업무 거부

H0 업무개시전

Logon 응답

업무개시 비 정상시

업무개시 현황비정상

업무개시 응답

Inbound 업무시작 안함

청산결제

매매지원

시장지원

종합감리

매칭

거래소에서 요청거래소의 최종 일련번호 제공

업무개시 및 일련번호 처리원칙

Logon 후 반드시 업무 개시 요청 (1 일 N 번

수행 )

1 회 /10 초 간격으로 발생하며 3 회 이상 응답 없는 경우 Session Close

TR

0 정상TR

TRBody

BodyH

구 분 ( 회원사 입장 )

예 시 일련번호 처리 원칙

Outbound 메세지

주문 / 요청 / 일괄송신 등

거래소 일련번호 반드시 준수

신고 (Outbound 예외 )

회원사 일련번호 우선 ( 업무 개시응답시 회원사 요청일련 번호로 업무 시작 ) - 단 , 회원사 업무 개시요청 번호가 거래소 일련번호보다 큰 경우 거래소 최종 일련번호로 업무 개시 , 회원사 요청번호가 0 인경우 처음부터 시작 Inbound 메세지

체결 / 장운영 /실시간수신 등

14/85


업무개시 흐름도 ( 계속 )

최종일련번호20

Logon 요청 사용자 검증

업무개시 요청

거래소에서 요청거래소의 최종 일련번호 제공

업무개시 응답 업무개시 요청정상

Outbound 업무

Logon 응답

업무응답

청산결제

매매지원

시장관리

종합감리

매매체결

문제발생

최종일련번호10

H11121314최종일련번호

20

HBody

20거부 일련번호 맞을때 까지 업무거부

Inbound 업무14131211H 최종일련번호

10

H Body20정상

Body10 거부

거래소 일련번호 우선

18171615H

회원사에서 처리하고자 하는 ( 회원사 입장에서

Inbound 메시지 ) 일련번호 요청

회원사 요청 일련번호 우선처리 후 , 거래소 업무처리 반복 ( 재전송 )

212019H

Pub

Tcp/ip 연결을 위해서는 Logon 필수

Outbound 업무

업무응답

H21222324최종일련번호

24

Body24정상

업무 수신

업무 수신

TR

TRH

※ 주문인 경우는 응답시 각각의 건별로 거부코드 , 처리일련번호 , 시각을 만들어 한번에 응답을 송신

H

주문 ( 시간외포함 ), 체결 ( 시간외 포함 ), 장운영 , 실시간 수신 , 신고 시 Body 부분의 거부코드 , 일련번호 Check

주문 ( 시간외포함 ) 일 경우는 Header 에 최종일련번호 , Body 는 수신 최초 일련번호 Set

일련번호오류

15/85

신규호가 , 정정호가 , 취소호가 , 대량 ( 협의대량 ) 신규호가 , 대량 ( 협의대량 ) 취소호가 , 프로그램매매사전공시 ,

대량매매주문서거절 ( 오전시간외 대량주문서거절은 오전시간외주문 , 정규장 대량주문서거절은 정규장 주문으로 송신 )

주문 서비스 업무 흐름도

해당 Trcode

TCP Connect & Logon

Opening Req/Res

Sequence Req/Res

일련번호 조회요청 / 응답 (R/R)

Heartbeat Req/Res

Transaction Req/Res( 주문 TR) 주문 요청 / 응답 (Request/Reply)


매칭엔진

SessionMessage

BusinessMessage

일련번호 조회요청 / 응답 (R/R)

M

O

M

M

M

M


업무 흐름도

16/85

수신 GW( 주문 )

Tcp connect & 로그인

주문요청

Block msg분할

회원사주문송신

MR#1

MR#2

MR#3

MR#N

…

MRSeq

MR#END

1. TR 권한 Check2. data field Check3. 일련번호 Check

Mapper변환

종목별라우팅

FWH신규1

FWH정정2

FWH신규3

주문응답

일련번호요청 4

일련번호응답

Request/Reply


1. 일련번호는 MR 처리일련번호 기준2. MR 에서 준 접수시각을 기준으로 사용 ( 장운영 상태를 반영한 자료 아님 )

주문 서비스 업무 흐름도 ( 계속 )

FWH신규4

H주문

1신규

2정정

3신규

4신규

6정정

7취소

일련번호오류

H

H 4

일련번호 저장4

최종 처리된 정상처리 수신측 일련번호

Header 일련번호에 Set

최종 처리된 정상처리 일련번호

H주문

Body거부정상 시각 6

1~4 번 반복

1~4 -

17/85


Session Msg

문제발생

일련번호 요청

일련번호 요청 세션 TrCode 요청후 일련번호 확인


거부코드 시스템 오류시 처리

주문요청

주문응답

H1234

최종일련번호4

H주문

Body정상 시각

1~4 번 반복

1~4

MR#1

MR#2

MR#3

MR#N

종목별라우팅

주문요청

주문응답H5

H주문

Body거부 시각5

거부코드 : 0090

종목별라우팅

내부시스템 문제 발생으로 인한 응답을 받지 못함

Session Msg일련번호 응답 Body

정상 4

최종일련번호4

주문요청

주문응답H5

H주문

Body정상 시각5

18/85

주문응답 방법

Member 채널 매매체결

6 5 4 3 2 1 H주문 수신 ME

7 6 5 3 2 1 H주문 수신 ME

3 2 1

6 5 4 3 2 1H

일련번호오류

최종으로 처리된 정상처리 수신일련번호

Body1정상 시각 6정상 시각••

H Body1정상 시각 3정상 시각••

Blocking 주문에 대한 각각의 주문 메시지 도달 시각을 제공하기 위하여 주문시 응답 시각 ( 장운영 상태를 반영한 자료 아님 ) 제공

Body1정상 시각 2정상 시각 3정상 시각

채널

최종 정상 일련번호3

H

주문에 대한 도착시각

응답코드는 거부된 일련번호에 대한 거부코드

일련번호 거부시 시각 제공 안함

※ 블록 주문에 대한 응답시 각각의 건별로 거부코드 , 처리일련번호 , 시각을 만들어 한번에 응답을 송신

1,2,3 번 주문에 대한 응답코드


5거부 -

거부 -5

일련번호 : 채널 최종 정상일련번호 ‘ 3’ 을 SET

19/85


주문거부 처리방법

- 채널 주문 거부사유 이외의 주문거부사유는 체결결과 서비스를 통해 수신됨 - 종목코드 (Routing) 오류 , 사용자권한 오류 등은 매매체결을 통한 체결결과로 송신됨


주문

체결

일련번호 증가 않음

일련번호오류 , 호가접수개시전 ,

매매거래시간 종료후 , 호가접수정지

( 전체 ) 는 채널에서 거부발생

ME

송신기타 오류시 일련번호

증가

수신종목코드오류 , 사용자권한 오류 , 등

20/85

일련번호 처리 방법


Member 채널6 5 4 3 2 1 H

H

일련번호오류

주문요청

주문응답호가접수 개시전

6 5 4 3 2 1 H

H

주문요청

주문응답13 12 11 9 8 7 H

H

주문요청

주문응답10 H

주문요청

주문응답

주문요청

주문응답

••

- 오전시간외 주문 프로세스인 경우 Open(07:30), Close(08:30)- 정규장 주문 프로세스인 경우 Open(08:00), Close(18:00) 이며 정규장 주문으로 시간외종가 / 시간외 단일가 주문 제출

13 12 11 H

19 18 17 16 15 14 H주문요청

주문응답매매거래시간 종료 후

Close

응답 일련번호는 채널 최종 정상처리 수신일련번호

정상 처리 일련번호6




Body1거부

Body

거부

Body10정상

Open



(Block 내 일부증가 )


11 H

H

주문요청

주문응답

정상 처리 일련번호10Body

호가접수정지( 전체 ) 발생 호가접수일시중지


정상 시각 -11

시각

11거부

7~9Body

H 정상정상 시각 시각1311~Body

Body거부 14H

정상 시각1~6

13 12

H

Header 에 최종처리 일련번호 Set(10)

Header 에 최종처리 일련번호 Set(13)

데이터 ( 일련번호 1 ~6 번 )Retry

21/85

오전 시간외 주문 프로세스 거부처리방법


6오전

5오전

4오전

3오전

2오전

1오전 H오전시간외

주문 수신 ME


H

6오전

5오전

4오전

3정규

2오전


주문 수신

Body정상

체결결과ME

08:30

07:30

일련번호 증가

1


16오전

15오전

14오전

13정규

12오전


주문 수신H

Body11거부 ME

16오전

15오전

14오전

13오전

12오전

11정규 H오전시간외

주문 수신ME



매매거래시간 종료 후



2

- , 처럼 오전시간외 주문 프로세스로 정규 주문 송신시 매매시간 종료로 인한 일련번호 증가 없음

1 2

제공되는 오전시간외 주문 서비스는 오전 시간외 주문 데이터만을 제출하는 원칙으로 운용함

시각1~6

HBody

정상 시각1~6

HBody

11거부 매매거래시간 종료 후

Header 에 최종처리 일련번호 Set (10)

Header 에 최종처리 일련번호 Set (10)

22/85

Body

장운영 시간과 주문처리


Member 채널

6 5 4 3 2 1 H주문요청

주문응답

주문요청

주문응답

18 17 16 15 14 13 H

24 23 22 21 20 19 H주문요청

주문응답매매거래시간 종료 후

시간외단일가 장종료

MR#1

MR#2

MR#3

MR#N

…

MRSeq

MR#END

Backend System

종목별라우팅

FWH1

FWH2

FWH3

FWH4

FWH5

FWH6

종목별라우팅

매매거래시간 종료후 거부

FWH19

FWH20

FWH21

FWH22

FWH23

FWH24

동시마감

동시처리

접속처리

08:59:59

17:59:59

HBody

정상 시각1~6

※ 블록 주문에 대한 응답시 각각의 건별로 거부코드 , 처리일련번호 , 시각을 만들어 한번에 응답을 송신

HBody

정상 시각~18

H 정상 시각~21 거부 시각22Header 에 최종처리 일련번호 Set (21)

23/85

주문 마감처리 방법


96 95 94 93 92 91 H주문 수신 ME

장운영

- 오전시간외 주문 및 주문 서비스는 주문요청 후 응답에 주문거부사유가 매매거래시간 종료(“0102”) 후 인 경우 확인시 주문 프로세스 Logout- 오전시간외 주문 서비스는 장운영 서비스로 장운영 구분코드 ( 장개시전 시간외 종료 ) 전문 수신 후 Logout


H

08:30 이후장개시전 시간외

종료

매매거래시간 종료 후

장운영 송신매매거래시간 종료후H


91거부주문 종료회원사에서

처리

시각Body

24/85

서비스 별 마감처리 방법


서 비 스 Logout 처리 기준 비 고주문 -주문요청 후 응답에 주문거부사유가 매매거래시간 종료 후“ 010

2” 확인 시 주문 프로세스 Logout-장운영 인터페이스 종료 Trcode 수신 후 Logout

유가 , 코스닥 , 선물 동일오전시간외 주문

체결- 인터페이스 종료 “ TCHEDP99000” TrCode 수신 후 Logout

-“TCHEDP99000”-“TCHEDP99001” Trcode 는 2008.12.8 일

적용

- 유가 , 코스닥 , 선물 동일

오전시간외 체결

장운영 - 인터페이스 종료 “ TCHEDP99001” TrCode 수신 후 Logout

실시간수신-회원사 최종마감 “ TCSMIH29902“ TrCode 수신 후 회원사에서 Logout※ TCSMIH29901 은 업무마감 TR CODE임

신고 - 실시간수신 서비스에서 최종마감 TrCode 수신 Logout

일괄수신-Trcode 별 종료 ( 데이터 일련번호에 “ 9999~9”) 건수와 송 /수신 할 Trcode 종류의 건수가 동일한 경우 회원사에서 Logout

-예 ) 일괄수신 Trcode 가 10 개 인데 TrCode 별 종료 ( 데이터 일련번호에 “999~9”10 개 수신 시 Logout

일괄송신종합감리 수신

종합감리 송신

조회- 회원사 비상주문 ( 선물만 해당 ) 이 발생한 경우 데이터 요청 및 수신 종료 후 회원사에서 Logout

회원사와 KRX 간 서비스별 프로세스 종료를 위한 마감처리 방법을 기술함 . 서비스명 기준은 회원사 기준으로 작성

25/85

체결데이터 (Pub/Sub)매칭엔진Business

Message

Transaction Req( 체결 TR)

Resend Req/Res(N 건 )

…

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M

O


체결 서비스 업무 흐름도

회원처리호가 ( 정상 , 거부 , 자동취소 ), 회원대량처리호가 ( 정상 , 거부 , 협의정상 , 협의거부 , 협의자동취소처리 ),

회원체결결과 , 회원대량체결결과 , 대량매매주문서

해당 Trcode

업무 흐름도

대량매매주문서 ( 오전시간외 포함 ) 는 체결프로세스 번호 (#01) 로 통합하여 송신함 .

26/85

송신 GW( 체결 )

Tcp connect & 로그인회원사체결수신

ME#1

ME#2

ME#3

ME#N

체결수신

체결 재전송 요청

FWH 003 매수

FWH 002 매도

정상전송은seq, data저장

체결수신

1매도H

2매수

21매도H

22매수

23매도

24매도

체결수신

29매도H

30매수

5매도H

6매수 …

14매도

15매도H …

23매도

24매도

비상주문체결 ( 선물 ) 은 조회기능으로 처리함

일련번호 관리프로세스 ID 별

Mapper변환

*. 프로세스 ID


체결 서비스 업무 흐름도 ( 계속 )

반복 ( 재전송 )

현물 / 선물 시장의 체결결과 전송은 주문 서비스 프로세스번호와 동일하게 체결전송

체결 재전송 응답H

HBody

4

Body정상

체결수신ME

회원사에서 Skip

4

27/85

송신 GW( 체결 )

Tcp connect & 로그인회원사체결수신

ME#1

ME#2

ME#3

ME#N

체결수신

업무개시 응답

체결수신

H

1매도H

2매수

21매도H

22매수

23매도

24매도

체결수신25

매도H26

매수27

매도28

매수

5매도H

6매수 …

14매도

15매도H …

23매도

24매도

일련번호 관리종목그룹

Mapper변환


체결 서비스 업무 흐름도 ( 계속 )


Body24

Logon 요청Logon 응답

업무개시요청정상 처리 일련번호

24

HBody

4 거부


문제발생

거래소와 회원사 일련번호 불일치


정상

체결수신

FWH 003 매수

FWH 002 매도

일련번호 오류

*. 프로세스 ID

28/85

1매도

H체결

2매수

21매도

H체결

22매수

23매도


주문 #1

주문 #2

주문 #3

체결 #1

체결 #2

체결 #3

수신

수신

수신

송신

송신

송신

H주문12345

H주문1234

H주문12345

H체결

22매수

MR#1

MR#2

MR#3

ME#1

ME#2

ME#3

그룹 ( 종목 ) 별 생성

주문 / 체결 1:1 구조

FWH…14

매도

…31

매도32

매수

ME

종목마감 처리

현 / 선물시장의 주문 , 체결 프로세스는 1:1 구조로 체결결과를 송신하며 종목 마감 Trcode 데이터는 장운영 서비스로 송신 .

14매도

FWH23

매도

FWH32

매도

체결 서비스 업무 흐름도 ( 종목마감 처리 – 현 / 선물시장 동일 )

종목마감 TR 전송장운영 장운영TR

종목마감H

장운영 서비스로 전송TR

종목마감

29/85

BusinessMessage

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M


옵션 권리행사 ( 거부 ) 신고 및 접수통보 , 금선물 인수도신고 및 접수통보 , 통화선물 인수도신고 및 접수통보 ,

구분착오정정신고 및 접수통보 , 착오거래정정신고 및 접수통보 , 사후증거금계좌신고 및 접수통보 , 할인계좌헤지 / 차익거래신고 및 접수통보 , 할인계좌미입증포지션처분신고및접수통보 , 계좌 변경 , 인계 신고 및 접수통보

신고 서비스 업무 흐름도

해당 Trcode

업무 흐름도

청산결제

신고는 회원사가 필요시 KRX 시장으로 신고 및 접수통보의 데이터를 송 /수신하는 기능으로

운용함

Transaction Req( 신고 TR)M 신고전송 (Request)

Transaction Res( 신고 TR)M신고응답 (Reply)

30/85


신고 서비스 업무 흐름도 ( 계속 )

신고 서비스는 청산결제로 데이터 입력 및 결과를 통보하는 기능으로 요청 후 데이터 결과

수신 전까지 다른 데이터 입력은 불가함

수신 GW( 신고 )


신고

회원사신고

1.TR 권한 Check2. 일련번호 Check3. data field Check

청산결제

신고DATA

H신고

DATAFWH

응답DATA

FWH

신고 응답

Request

Reply

정상H응답Data

“ 정상”의 의미는 채널상에서의 정상송수신여부임청산결제 업무상 발생한 에러는 응딥 data 내의

거부코드 확인필요

신고

신고DATA

H

신고 응답

거부H

TR 권한오류 / 일련번호오류 등채널상의 오류 발생시

1.TR 권한 Check2. 일련번호 Check3. data field Check

신고DATA

31/85

신고

청산결제

신고DATA

H

신고DATA

FWH

응답DATA

FWH

신고 응답


신고 서비스 업무 흐름도 ( 계속 )

Request

Reply

신고 서비스의 일련번호는 TR 별 처리일련번호가 아닌 전체 신고 / 취소 일련번호를 의미함

거래소 / 회원사간 일련번호가 상이한 경우 , 재 로그인 후 업무개시에서 일련번호의 보정이 원칙

정상0000

H최종 TR

B

청산결제 최종처리완료 일련번호가

‘ 6’ 경우

신고

신고DATA

H

신고 응답

거부0004

H

응답데이터內의 거부코드에‘ 기신고’ 로 통보

최종일련번호6

최종일련번호5

일련번호 ‘ 6’

일련번호오류응답

수신 GW( 신고 )

Tcp connect & 로그인회원사신고

업무개시 요청

신고DATA

최종 Seq6

업무개시 응답H

거부0004

최종 TRA

최종 Seq5

최종일련번호5

일련번호 ‘ 6’

최종일련번호6최종일련번호

6

정상0000

H응답

DATA

응답데이터內의 거부코드에‘ 기신고’ 로 응답

응답데이터 거부코드 기준으로신고처리 완료여부 확인

32/85

Transaction Req( 조회 TR)조회 (Pub)

BusinessMessage

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M


일반비상주문호가 재송신 , 일반비상주문 체결 재송신 , 협의비상주문호가 재송신 , 협의비상주문 체결 재송신

조회 서비스 업무 흐름도

해당 Trcode

업무 흐름도

조회 데이터 (Pub)Transaction Res( 조회 TR)M

조회범위는 일반비상주문 호가 및 체결 재송신 , 협의비상주문 호가 및 체결 재송신을 제공하는

것을 원칙으로 운용하며 , 선물 시장에 한하여 제공함 .

Transaction Req( 조회데이터 )M

매매지원

Transaction Res( 조회데이터 응답 )M

33/85

수신 GW( 조회 )


조회 요청

회원사조회

1. TR 권한 Check2. data field Check

TR 별라우팅

매매지원

H

6계속54321FWH

9999997FWH

6계속54321

H조회 TR

9999997H

조회 TR

조회 요청 응답

Pub


Pub

조회 서비스 업무 흐름도 ( 계속 )

총 8건일

경우

데이터 끝은 표시는 데이터 일련번호에 9999999999 로

송신

조회 데이터 송신 H

조회 TR

8

H조회 TR

데이터 끝은 표시는 데이터 일련번호에 9999999999 로

송신

Body

6 정상

Body

8 정상

조회 서비스는 일반 ( 협의 ) 비상주문호가 및 일반 ( 협의 ) 비상주문체결 재송신을 제공함 .

8

FWH조회 TR

HBody

정상


조회 TR

조회 TR

999999FWH Pub데이터가 없는 경우 9999999 만 송신

999999H

조회 TR

H조회 TR

Body

0 정상

조회 데이터 송 / 수신 Layout 은 호가 입력 및 처리호가 데이터 Layout과 동일

조회 데이터 응답

조회 데이터 송신


조회 데이터 송신


Header 에 해당 조회 TR

34/85

장운영 데이터 (Pub/Sub)장운영Business

Message

Transaction Req( 장운영 TR)

…

Resend Req/Res(N 건 )

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

O

M


장운영 서비스 송신 데이터 종류- 장운영 데이터는 장운영 프로세스 번호 #1( 공개장운영 ), #2( 종목마감 ) 로 분리하여

송신함 .- 장운영 #1 : 공개장운영 데이터 ( 공개장운영 , 공개정보 , 인터페이스 종료 )- 장운영 #2 : 종목마감 데이터 ( 종목마감 , 기준가결정 , 임의종료 , 인터페이스 종료 )

해당 Trcode

업무 흐름도

장운영 서비스 업무 흐름도

35/85

Tcp connect & 로그인회원사장운영수신

장운영FWH 장운영

FWH 장운영

FWH 장운영

FWH 장운영

회원사별 장운영 프로세서로 pub

송신 GW( 장운영 )

일련번호 관리

Mapper변환

장운영 수신

장운영 재전송 요청

장운영 재전송 수신

장운영 수신

장운영 재전송 수신

1장운영H

2장운영

21장운영H

22장운영

23장운영

24장운영

장운영 수신25

장운영H26

장운영27

장운영28

장운영

장운영수신29

장운영H30

장운영

5장운영H

6장운영 …

14장운영

15장운영H … 23

장운영24

장운영


장운영 서비스 업무 흐름도


Pub


장운영 재전송 응답H

HBody

4

Body

정상 4

36/85

실시간 송신 데이터 (Pub)청산결제

BusinessMessage Transaction Req( 실시간 데이터 TR)

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M


해당 Trcode

업무 흐름도

실시간 서비스 업무 흐름도

…실시간 송신 데이터 (Pub)

선물 정산가격 , 옵션증거금기준가격 , 옵션 기준가격적용최대이론가격 , 유지증거금 구간별이론가격 , 당일거래종목의 위탁증거금구간별이론가격 , 익일상장종목의 위탁증거금구간별이론가격 , 당일거래종목의 종목별 내재변동성 , 익일거래종목의 종목별 내재변동성 , 최종결제가격 ,외화평가가격 , 금리 /국채 수익율 , 신고업무운영시간 , 인수도국채선물 안내메시지 , 기준채권정보 , 정정후 거래전문회원 거래내역 , 계좌종목별 미결제약정수량 , 계좌별 거래증거금소요액 , 선물 일일정산 , 옵션 결제차금 , 거래수수료 및 협회비 , 현금결제 옵션 계좌별 권리행사결제내역 , 인수도결제옵션계좌별권리행사및인수도내역 , 통화 / 채권 선물 계좌별 인수도내역 , 금선물 계좌별 인수도내역 , 통화상품 회원별 인수도내역 , 금괴 특정내역 , 거래증거금 과부족내역 통보 , 거래증거금 및 결제대금 변동 통보 , 거래증거금 질권설정말소 ( 입출고 ) 통보 , 거래증거금 입출금 통보 , 결제대금 입출금 통보 , 착오거래정정 승인 통보 , 공동기금과부족금액 통보 , 인수도국채선물 인도불이행 현금결제내역 , 구분착오발생내역 통보 , 위탁자기별 거래증거금소요액 , 수수료 , 종목별 결제내역 , 회원별 결제내역 , 거래전문회원의 종목거래내역 , 주식선물 미결제약정수량 한도 및 예정내역 , 주식선물 미결제수량 조정후 변경내역

Resend Req/Res(N 건 )O

37/85

Tcp connect & 로그인회원사장운영수신

청산결제

송신 GW( 온라인 데이터 )

I/F 일련번호 관리

Mapper변환

실시간 데이터 수신1H


실시간 서비스 업무 흐름도


1FWHTR01

1FWHTR08

1FWHTR05

발생 TR 은 순서 없이 발생되며 ,동일 TR 은 순서적으로 발생됨 (Pub)

TR1 에 데이터 종료는 데이터 항목으로 송신

2FWHTR01

3FWHTR01

회원사 송신 인터페이스 종료 TR 전송 1 회 (1 일 ) 발생

••


TR1 에 데이터 종료는

데이터 항목으로 송신

재전송 요청

재전송 응답H

HBody

2

Body

정상


반복 ( 재전송 )실시간 데이터 수신3H

종료 송신TR

종료H

로그아웃 Req & Ack

2

38/85

Transaction Req( 배치 TR)배치데이터전송 (Pub/Sub)

종합감리

청산결제

BusinessMessage

Transaction Res( 배치 TR)

배치데이터전송 (Pub/Sub)

…

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M

M


유통결제정보 ( 주식시장 ), 지수차익거래잔고 보고 , 현물지점정보 수신 , 선물지점정보 수신 , 신용정보 ( 공통 ), 투자자 구

분별 체결내역 ( 공통 ), 비과세거래내역

일괄수신 (Krx 기준 ) 서비스 업무 흐름도

해당 Trcode

업무 흐름도

매매지원

39/85

수신 GW( 일괄수신 )


배치데이터전송

회원사일괄송신


Mapper변환

TR 별라우팅

HTR01

123456

청산결제

매매지원

시장지원

종합감리

FWHTR01

123456

Pub/Sub


일괄수신 서비스 업무 흐름도

데이터 일련번호가 맞는 경우만 Pub

H

배치전송응답

HTR01

7810111213


H

배치전송응답

일련번호오류

FWHTR01

78

최종으로 처리된 정상처리 수신일련번호


H

배치전송응답

FWHTR01

910111213

HTR01

910111213999999

데이터 끝은 표시는 데이터 일련번호에 9999999999 로 송신

999999

HTR08123456

하나의 TR 종료후다음 TR 전송해야 함배치데이터전송


FWHTR08

123456배치전송응답

Body

6정상

Body

8거부

Body

13정상

HBody

6정상

40/85



TR1 전송



HTR01

12345999999

청산결제

매매지원

시장지원

종합감리

FWHTR01

1234599999

Pub/Sub


일괄수신 서비스 업무 흐름도 ( 계속 )


H

TR1 응답

HTR02

1234599999

TR2 전송

FWHTR02

1234599999TR2 응답

Body

5정상

TR1 정상종료인 (999보낸 경우 ) 경우에는 재전송시 거부 -> 거래소와 협의하여 재전송

해야함 TR1 종료이전 (999 전송 이전은 ) 경우에는 재전송

가능

TR1 데이터가 중복 ( 일련번호 1 부터 ) 인 경우 TR1 데이터를 Clear

한후 다시 수신함

TR1 전송H

TR01123499999

FWHTR01123499999

재전송

H

TR1 응답Body

4정상

TR1 정상종료

TR1 정상종료전

TR1 데이터가 중복인 경우 TR1 데이타를 Clear 한후 다시

수신함

TR1 999 송신 이전시 재송신 경우일련번호 (1) 로 송신시는 이전 데이터

Clear

인 경우 이전 송신 데이터는 Clear 됨

1

1

HBody

5정상

채널은 데이터의 일련번호만 Check 하며 , 데이터의 정합성은 Check 하지 않음

41/85



TR1 전송



HTR1

12345999999

청산결제

매매지원

시장지원

종합감리

FWHTR11234599999

Pub/Sub


일괄수신 서비스 업무 흐름도 ( 계속 )


H

TR1 응답

HTR21234599999

TR2 전송

FWHTR2

1234599999TR2 응답

Body

5정상

HTR3

99999

TR3 전송

TR3 응답

HTR21234599999

TR1 전송

H

TR1 응답Body

0업무 기 마감

TR3 데이터 없음을 반드시 전송

TR1 정상종료 (999 보낸 경우 ) 후 송신 불가능 -> 송신 필요시 거래소와 협의 필요

TR3 정상종료TR03 데이터가 없는 경우 데이터 없음인 9999~

송신FWHTR3

99999

HBody

5정상

HBody

0정상

42/85

Transaction Req(TR)

종합감리

매매지원BusinessMessage

Transaction Res(TR)

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M

M


불공정거래 모니터링 지원정보 , 일별 종목별 주문체결 수량송신 , 회원별약정 , 당일 지수차익거래현황 통보 , 계좌별 종목별 지수차익거래현황 통보 , 전일 지수차익거래잔고 통보 , 거래전문 회원정보 , 결산일정보 , 선물기준가 , 선물옵션 상하한가 , 옵션기준가 , 유동성공급자 , 자사주 신청정보 , 장운영정보 , 주식상품 기초자산 코드정보 , 파생종목정보 , 파생종목 조정 , 현물종목이벤트 , 현물종목정보 , ELW기초자산구성 , 통합회원지점정보 송신 , 종목지수정보

일괄송신 (Krx 기준 ) 서비스 업무 흐름도

해당 Trcode

배치데이터수신 (Pub/Sub)

업무 흐름도

43/85

송신 GW( 일괄송신 )


배치데이터 수신

회원사일괄수신

654321H

TR01

청산결제

매매지원

시장지원

종합감리

654321FWHTR01

654321FWHTR08

9999997FWHTR01

TR 별data 저장

TR 별 수신완료후전송

654321FWHTR05

121110987FWHTR05

121110987FWHTR08

999999151413FWHTR05

내부에서는 TR 이 순서와 상관없이 수신됨 (Pub/Sub)

하나의 TR 종료후다음 TR 전송


TR 별data 저장

TR 별data 저장

일괄송신 서비스 업무 흐름도 회원사 / 채널시스템간 데이터 송신 방법은 일괄수신과 동일함

H

배치전송응답

배치데이터 수신9999997

HTR01

데이터 끝 (TR01) 표시는 데이터 일련번호에 9999999999 로 송신

H

배치전송응답



HTR05

H

배치전송응답

배치데이터 수신

배치전송응답

HTR05

121110987

H

999999151413H

TR05배치전송응답

H

Body6 정상

Body7 정상

Body6 정상

Body12

정상

15

정상Body

회원사에서 업무 개시응답시 TRCode, 데이터 일련번호 Set - 데이터 수신 중 Disconnect 후 재 Login 경우는 수신중 TR, 최종수신 Seq - 종료수신 (‘999~99’) 완료후 재 Login 경우는 TR 은 space, Seq 는 0

44/85

배치데이터 수신999…1110987

HTR01

Member 채널

일괄송신 서비스 업무 흐름도

H배치전송응답 ( 정상 ) Body

11 정상

헤더의 일련번호 : 7, 헤더의 데이터건수 : 6 (9999~ 포함 )

헤더의 일련번호 : 11 ( 최종처리일련번호 ), 거부사유코드 : 0000 ( 정상 )


HTR01


12 정상

헤더의 일련번호 : 7, 헤더의 데이터건수 : 6


배치데이터 수신999…

HTR01


12 정상

헤더의 일련번호 : 9999…, 헤더의 데이터건수 : 1 (9999… 포함 )


배치데이터 수신999…1110987

HTR01

배치전송응답 ( 정상 )

헤더의 일련번호 : 7, 헤더의 데이터건수 : 6 (9999… 포함 )


업무개시 수신

업무개시 응답 ( 정상 )

업무개시 송신 ( 거부사유코드 : 0000, TR : TR01, 일련번호 : 6 ):

HBody

6정상 TR

11 정상TRBody

H

업무개시응답 수신 ( 거부사유코드 : 0000, TR : TR01, 일련번호 : 11 )

아래의 데이터 종료 처리는 일괄수신 서비스 업무 처리 흐름과 동일하게 적용함 . 단 , 일괄수신 (Krx 입장 ) 의 경우는 수신측 기준인 Krx 의 일련번호를 적용함

데이터와 종료 (“999~9”) 가하나의 Block 데이터로 송신하는 경우1

종료 (“999~9”) 데이터가별도의 Block 데이터로 송신하는 경우2

종료 (“999~9”) 가 포함된 Block 데이터를 송신 후 응답을 수신하지 못하고 Session 이 종료된 경우 Opening 처리

3

문제발생

3

45/85

Transaction Req( 배치 TR)배치데이터전송 (Pub/Sub)

종합감리BusinessMessage

Transaction Res( 배치 TR)

배치데이터전송 (Pub/Sub)

…

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M

M


계좌응답정보 (특이위탁자 계좌정보 ), 세부심리자료응답 계좌기본정보 , 유가증권 잔고내역 , 신용거래 잔고내역 , 고객계좌부 , 수표입출금내역 , 이체입출금내역 , 대체입출금내역 , 현금입출금내역 , 유가증권입출고내역 ( 대체 ), 유가증권입출고내역 ( 실물 ), 계좌관리자기본정보 , 파생심리계좌 기본정보 , 파생심리계좌 원장거래내역 중 매매 ( 체결 ) 부문 , 파생심리계좌 원장거래내역 중 예탁금부문 , 파생심리계좌 원장거래내역 중 미결제약정부문 , 파생심리계좌 원장거래내역 중 현금흐름부문

종합감리수신 (Krx 기준 ) 서비스 업무 흐름도

해당 Trcode

업무 흐름도

일괄수신 서비스 업무 처리 흐름과 동일하게 제공함 .(VPN 장비를 통해서 수신 )

46/85

Transaction Req(TR)

종합감리

매매지원BusinessMessage

Transaction Res(TR)

TCP Connect & Logon

Opening Req/Res

Heartbeat Req/Res


SessionMessage

M

M

M

M

M

M


특이 위탁자 계좌 기본정보요청 (1 차 ), 세부심리자료요청 (2 차 ), 파생감리계좌기본정보 및 매매 입출금내역에대한 요청

해당 Trcode

배치데이터수신 (Pub/Sub)

업무 흐름도

종합감리송신 (Krx 기준 ) 서비스 업무 흐름도

일괄송신 서비스 업무 처리 흐름과 동일하게 제공함 .(VPN 장비를 통해서 수신 )

47/85

Active 프로세스

매매체결

Member

채널서버 1

Backend System

장애처리 흐름도

Standby

프로세스

회원사 프로세스 사용자 1 seq, info

Access2 Standby

ActiveAccess1

① 프로세스 기동시 Active Mode

② Logon ③ 회선장애

④ 재 Logon

Standby

Active

채널서버 2

⑤ 정보갱신

⑥ 재 Logon 응답

⑦ 주문

⑦ 주문처리

⑧ 사용자 1 이 채널서버 2 로 접속 중인데 또다시 채널서버 1

로 접속시 ⑤ Standby 로 변경

⑤ Active 로 변경

⑨ Session Close

회원사의 동일한 사용자는 거래소 채널서버 N 개 노드에 동시에 동시에 접속을 할 수 없음

회선복구

48/85

Contents












49/85

Header

구 분 번 호 항 목 Format필수여

부 항목 값 비고

Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 41 Body 길이3 메시지 타입 String(11) M SCHLIQ000004 일련번호 Long(11) M 세션 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6

연계시도착 회원사 번호 String(10) O 향후 연계거래시 사용

7회신시송신 회원사 번호 String(10) O 향후 연계거래시 사용

8 전송일시 String(17) M20071221091022888

년월일시분초MS

9 데이터 건수 Long(3) O 010 암호화유무 String(1) M N 암호화 유무

Body1 UserID String(10) M 거래소에서 부여한 ID2 Password String(30) M3 암호화적용여부 String(1) M Y,N 암호화 적용

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Logon Req( 로그온 요청 )

KMAPv1.0

41 SCHLIQ00000

0 KRX 20071221091022888

0 N

Body

SKRX0101 *****

예 ) KRX증권 - 회원번호 : KRX- UserID : SKRX0101

Logon Req 세션전문 FORMAT ( 예 )

Session 메시지 Format

Y

50/85

Body

Y

구 분 번 호 항 목 Format 필수여부 항목 값 비고

Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 5 Body 길이3 메시지 타입 String(11) M SCHLIR000004 일련번호 Long(11) M 요청 일련번호와 동일하게 응답5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Body1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조2 암호화적용여부 String(1) M Y,N 암호화 적용

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Logon Res( 로그온 응답 )

Logon Res 세션전문 FORMAT ( 예 )

통보시 정상 또는 거부사유코드 SET예 ) 0000 → 정상 0001 → 사용자검증 (ID, Password)오류


Header

0KMAPv1.0

5 SCHLIR00000

0 KRX 20071221091022888

0 N

51/85



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 26 Body 길이3 메시지 타입 String(11) M SCHOPQ00000

4 일련번호 Long(11) M최종처리 일련번호 (Body 일련번호와 동일 )

5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Body1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조

2 TR-Code String(11) M초기는 Space,

재 업무개시는 이전 송 / 수신 TR-Code3 일련번호 Long(11) M 0 최종 처리 일련번호 Set

Opening Req( 업무개시 요청 )

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Opening Req 세션전문 FORMAT ( 예 )

예 ) KRX 증권 - 회원번호 : KRX


Header Body

최초 업무개시 요청시 일련번호 → 0 재 업무개시 요청시 (최종일 련번호가 300 일 경우 ) 일련번호 → 300

0000 0TR-CodeKMAPv1.0

26

SCHOPQ00000

0 KRX

20071221091022888

0 N

52/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 26 Body 길이3 메시지 타입 String(11) M SCHOPR00000

4 일련번호 Long(11) M최종처리 일련번호 (Body일련번호와 동일 )




8 전송일시 String(17) M20071221091022888



Body

1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조

2 TR-Code String(11) M초기는 Space, 재 업무개시는 이전 송 / 수신 TR-Code

3 일련번호 Long(11) M 0 최종 처리 일련번호 Set

Opening Res( 업무개시 응답 )

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Opening Res 세션전문 FORMAT ( 예 )

Header



Body

최초 업무개시 요청시 일련번호 → 0 재 업무개시 요청시 (최종일 련번호가 300 일 경우 ) 일련번호 → 300

0000 0TR-CodeKMAPv1.0

26

SCHOPR00000

0 KRX

20071221091022888

0 N

53/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 4 Body 길이3 메시지 타입 String(11) M SCHHEQ000004 일련번호 Long(11) M 세션 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Body 1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조

Heartbeat Req( 회선시험 요청 )

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Heartbeat Req 세션전문 FORMAT ( 예 )

Header



회선시험 요청은 데이터 발생원에서 데이터 송수신이 없을 경우 10 초 간격으로 발생함

Body

0000KMAPv1.0

4 SCHHEQ00000

0 KRX

20071221091022888

0 N

54/85

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Heartbeat Res( 회선시험 응답 )

Heartbeat Res 세션전문 FORMAT ( 예 )

Header




Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 4 Body 길이3 메시지 타입 String(11) M SCHHER00000

4 일련번호 Long(11) M요청 일련번호와 동일하게 응답




8 전송일시 String(17) M20071221091022888




Body

0000KMAPv1.0

4 SCHHER00000

0 KRX

20071221091022888

0 N

55/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 0 Body 길이 -> 03 메시지 타입 String(11) M SCHLOQ000004 일련번호 Long(11) M 세션 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Logout Req( 로그아웃 요청 )

Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Logout Req 세션전문 FORMAT ( 예 )

Header



KMAPv1.0

0 SCHLOQ00000

0 KRX

20071221091022888

0 N

56/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 4 Body 길이 3 메시지 타입 String(11) M SCHLOR000004 일련번호 Long(11) M 요청 일련번호와 동일하게 응답5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888




Logon Req/Res

Opening Req/Res

Heartbeat Req/Res

Logout Req/Res

M

M

M

M

Member

채널

Sessio

nM

essag

e

Logout Res( 로그아웃 응답 )

Logout Res 세션전문 FORMAT ( 예 )

Header


Body

0000


KMAPv1.0

4 SCHLOR00000

0 KRX

20071221091022888

0 N

57/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 0 Body 길이 -> 03 메시지 타입 String(11) M SCHSQQ000004 일련번호 Long(11) M 세션 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Sequence Req( 일련번호 요청 )

Sequence Req 세션전문 FORMAT ( 예 )

HeaderSequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O



KMAPv1.0

0 SCHSQQ00000

0 KRX

20071221091022888

0 N

58/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 15 Body 길이3 메시지 타입 String(11) M SCHSQR000004 일련번호 Long(11) M 요청 일련번호와 동일하게 응답5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888




2 일련번호 Long(11) M 30채널 최종 정상 처리 일련번호 Set

Sequence Res( 일련번호 응답 )

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

Sequence Res 세션전문 FORMAT ( 예 )

Header


예 ) 채널 최종 정상처리 일련번호 30


Body

300000KMAPv1.0

15

SCHSQR00000

0 KRX

20071221091022888

0 N

59/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 11 Body 길이3 메시지 타입 String(11) M SCHRSQ000004 일련번호 Long(11) M 세션 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6

연계시도착 회원사 번호 String(10) O Space(10) 향후 연계거래시 사용

7회신시송신 회원사 번호 String(10) O Space(10) 향후 연계거래시 사용

8 전송일시 String(17) M20071221091022888



Body 1 일련번호 Long(11) M 50 최종 정상처리 일련번호 Set

Resend Req(재송신 요청 )

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

Resend Req 세션전문 FORMAT ( 예 )

Header


예 ) 일련번호 51 ~ 끝까지


Body

50KMAPv1.0

11

SCHRSQ00000

0 KRX

20071221091022888

0 N

60/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 15 Body 길이3 메시지 타입 String(11) M SCHRSR000004 일련번호 Long(11) M 요청 일련번호와 동일하게 응답5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888




2 일련번호 Long(11) M 50거래소 최종 정상처리 일련번호 Set

Resend Res( 재송신 응답 )

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

Resend Res 세션전문 FORMAT ( 예 )

Header



Body

0000 50KMAPv1.0

15

SCHRSR00000

0 KRX

20071221091022888

0 N

61/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 600 Body 길이3 메시지 타입 String(11) M TCHODR00000 예 ) 주문인 경우

4 일련번호 Long(11) M 1Body 중 첫번째 데이터 항목의 일련번호




8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) M 2 Body 중 데이터 건수10 암호화유무 String(1) M Y,N 암호화 유무

Body 1 TR-Code 별 메시지 길이 ( 업무별로 별도 정의 )

Transaction ( 예시 – 주문요청 )

Transaction Req 세션전문 FORMAT ( 예 )

Header

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

신규호가 : TMEODR10001

Body

1

Data 1

Data 정보 ( 신규호가 )

데이터 일련번호 (1 번 )

2

Data 2

Data 정보 ( 신규호가 )

데이터 정보

Body 의 데이터 건수

Body 의 첫번째 일련번호

KRX 증권 ( 회원번호 :KRX)



KMAPv1.0

600 TCHODR00000

1 KRX

20071221091022888

2 Y

62/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 48 Body 길이 ( 예 -2 건인 경우 )3 메시지 타입 String(11) M TCHODR00000 요청 TR-Code 와 동일하게 응답

4 일련번호 Long(11) M채널 ( 수신측 ) 최종 처리 일련번호




8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) O 2 데이터 건수10 암호화유무 String(1) M Y,N 암호화 유무

Body1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조2 일련번호 Long(11) M 채널 정상 처리 데이터 일련번호3 메시지도달시간 String(9) M 시분초MS

Transaction ( 예시 – 주문응답 )

Transaction Res 세션전문 FORMAT ( 예 )

Header

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

신규호가 : TMEODR10001

정상 처리 일련번호

정상KRX 증권 ( 회원번호 :KRX)


Body

0000 0910248881

도달시각 ( 시분초MS)

0004 -2

채널 ( 수신측 ) 최종처리 일련번호

KMAPv1.0

48 TCHODR00000

1 KRX

20071221091022888

2 Y

63/85


Header

1 전문유형 String(8) M KMAPv1.0 API Version

2 메시지길이 Long(6) M 600Body 길이 예 ) 길이 300byte

3 메시지 타입 String(11) M TCHTDP00000 예 ) 체결인 경우





8 전송일시 String(17) M20071221091022888



Body 1 TR-Code 별 메시지 ( 업무별로 별도 정의 )

Transaction ( 예시 – 체결 )


Header

Sequence Req/Res

Resend Req/Res

Transaction Req

O

Member

채널

Sessio

nM

essag

e

O

O

대표 TR : TCHTDP00000

Body

1Data 1

Data 정보 ( 체결 )


2Data 2

Data 정보 ( 정정확인 )

데이터 정보






KMAPv1.0

600 TCHTDP00000

1 KRX

20071221091022888

2 Y

64/85


Header



3 메시지 타입 String(11) M TCHMIP00000 예 ) 장운영인 경우





8 전송일시 String(17) M20071221091022888




Transaction ( 예시 – 장운영 )


Header

Sequence Req/Res

Resend Req/Res

Transaction Req

O

Member

채널

Sessio

nM

essag

e

O

O

대표 TR : TCHMIP00000

Body

1Data 1


2

Data 2

Data 정보

데이터 정보






KMAPv1.0

400 TCHMIP00000

1 KRX

20071221091022888

2 Y Data 정보

65/85

Body



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 300 Body 길이 ( 예 : 300)3 메시지 타입 String(11) M 해당 신고 Tr-Code Set4 일련번호 Long(11) M 데이터 항목의 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) M 110 암호화유무 String(1) M Y,N 암호화 유무


Transaction ( 예시 – 신고 )


Header

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

TR 별 메시지



KMAPv1.0

300 해당 신고 TR - KRX

20071221091022888

1 Y

66/85

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 300 Body 길이 ( 예 : 300)3 메시지 타입 String(11) M 해당 신고 Tr-Code Set4 일련번호 Long(11) M 데이터 항목의 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) O 110 암호화유무 String(1) M Y,N 암호화 유무

Body1 거부사유코드 X(4) M 별도의 거부사유코드 표 참조2 TR-Code 별 응답메시지 ( 업무별로 별도 정의 )

Transaction ( 예시 – 신고응답 )


Header



Body

0000TR 별 응답메시지KMAPv1.0

300 해당 신고 TR - KRX

20071221091022888

1 Y

67/85



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 11 Body 길이3 메시지 타입 String(11) M TCHQEY00000 예 ) 조회인 경우4 일련번호 Long(11) M5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) M 110 암호화유무 String(1) M Y,N 암호화 유무

Body 1 TR-Code X(11) M

일반비상주문호가재송신 (TTSSDP20004)

일반비상주문체결재송신 (TTSSDP20005)

협의비상주문호가재송신 (TTSSDP20006)

협의비상주문체결재송신 (TTSSDP20007)

Transaction ( 예시 – 조회 )


Header

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O

Body

TR-Code



KMAPv1.0

11 TCHQEY00000 0 KRX

20071221091022888

1 Y

68/85

Sequence Req/Res

Resend Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 15 Body 길이

3 메시지 타입 String(11) M TCHQEY00000요청 TR-Code 와 동일하게 응답

4 일련번호 Long(11) M 요청 일련번호와 동일하게 응답5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Body

1 거부사유코드 X(4) M 별도의 거부사유코드 표 참조

2 TR-Code X(11) M

비상주문호가내역조회 (TTSSDP20004)

비상주문체결내역조회 (TTSSDP20005)

협의비상주문호가내역조회 (TTSSDP20006)

협의비상주문체결내역조회 (TTSSDP20007)

Transaction ( 예시 – 조회응답 )


Header



Body

0000 TR-CodeKMAPv1.0

15 TCHQEY00000 0 KRX

20071221091022888

1 Y

69/85


Header



3 메시지 타입 String(11) M 해당 실시간송신 Tr-Code Set4 일련번호 Long(11) M 1 Body 데이터 항목의 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888


9 데이터 건수 Long(3) M 1 실시간송신은 1 건 임10 암호화유무 String(1) M Y,N 암호화 유무


Transaction ( 예시 – 실시간송신 )


Sequence Req/Res

Resend Req/Res

Transaction Req

O

Member

채널

Sessio

nM

essag

e

O

O

Body

1

Data 1

Data 정보 ( 청산결제 실시간데이터 )


데이터 정보


Body 의 일련번호



KMAPv1.0

1200

해당 실시간송신 TR

1 KRX

20071221091022888

1 Y

Header

70/85

Transaction ( 예시 – 일괄수신 )


Opening Req/Res

HeartBeat Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O KRX 증권 ( 회원번호 :KRX)



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M Body 길이3 메시지 타입 String(11) M 해당 일괄수신 Tr-Code Set





8 전송일시 String(17) M20071221091022888





Body

1

Data 1

Data블럭 1


2

Data 2

Data블럭 2

데이터 정보



KMAPv1.0

- 해당 실시간송신 TR

1 KRX

20071221091022888

2 Y

Header

71/85

Opening Req/Res

HearBeat Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 15 Body 길이3 메시지 타입 String(11) M 해당 일괄수신 Tr-Code Set4 일련번호 Long(11) M 채널측 최종 일련번호5 회원번호 String(5) M 거래소에서 부여한 회원번호6



8 전송일시 String(17) M20071221091022888



Body1 거부사유코드 String(4) M 별도의 거부사유코드 표 참조2 최종 정상처리 일련번호 Long(11) M 채널 정상 처리 데이터 일련번호

Transaction ( 예시 – 일괄수신응답 )


Header



Body

0000 2

최종 정상처리 일련번호

KMAPv1.0

15 해당 일괄수신 TR 1 KRX

20071221091022888

1 Y

72/85

Transaction ( 예시 – 일괄송신 )


Header

Opening Req/Res

HeartBeat Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O KRX 증권 ( 회원번호 :KRX)



Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M Body 길이3 메시지 타입 String(11) M 해당 일괄송신 Tr-Code Set





8 전송일시 String(17) M20071221091022888





Body

1

Data 1

Data블럭 1


2

Data 2

Data블럭 2

데이터 정보



KMAPv1.0

해당 일괄송신 TR 1 KRX

20071221091022888

2 Y

73/85

Opening Req/Res

HearBeat Req/Res

Transaction Req/Res

O

Member

채널

Sessio

nM

essag

e

O

O


Header

1 전문유형 String(8) M KMAPv1.0 API Version2 메시지길이 Long(6) M 15 Body 길이3 메시지 타입 String(11) M 해당 일괄송신 Tr-Code Set

4 일련번호 Long(11) M회원사 정상처리 최종 일련번호




8 전송일시 String(17) M20071221091022888




2최종 정상처리 일련번호 Long(11) M

회원사 정상처리 데이터 일련번호

Transaction ( 예시 – 일괄송신응답 )


Header



Body

0000 2

최종 정상처리 일련번호

KMAPv1.0

15 해당 일괄송신 TR 0 KRX

20071221091022888

1 Y

74/85

거부 시스템 구분 코드 값 코드값 명 비 고

채널

세션

0000 정상0001 사용자 검증 (ID, Password) 오류0002 세션 Message 전문 순서 오류0003 Header 회원번호 오류0004 데이터 일련번호 오류0005 데이터 건수 오류

0006 업무 기 마감일괄송 / 수신 , 종합감리 송 / 수시 TR 별 종료 (999~) 전송 후 동일 TR 재송신 시 사용

0007 온라인 개시 이전회원사 Back-end 시스템 준비가 안된경우( 회원사 FEP 사용 – Opening 응답시만 사용 )

0008 세션 전문 Message Type 오류 정의된 Type 이 아닌 경우 예 )LOGON(SCHLIQ00000)

0009 업무 처리 중

- 요청 / 조회시 특정 TR 요청 중에 응답을 못 받은 상태에서 다른 별도 TR 요청시 채널에서 발생- 일괄송 / 수신중 다른 TRCode 를 송 /수신하는경우-Standby -> Active 로 전환 중인경우

0010 Header 의 정의된 Msg 길이와 수신 길이가 틀린 경우

0011 암 /복호화 관련 오류

0012 수신된 Message Body 내에 Null 데이터가 존재할 경우 적용일 2008.12.8 일

공통 0090 시스템 오류

주문 제출시 Krx 내부 시스템으로부터 채널이 응답을 받지 못하였을 경우 Set.회원사는 일련번호요청 후 일련번호 확인 및 데이터 재송신

업무0101 호가접수개시전0102 매매거래시간 종료후0103 호가접수정지

매매체결 체결결과채널 외 거부사유 코드 별도의 ‘호가거부사유코드’ 참조


거부사유코드

75/85

Contents












76/85

데이터 발생원이 채널서비스인 경우

Logon req(SCHLIQ00000)

Opening Req(SCHOPQ00000)

Heartbeat Res(SCHHER00000)


Logout Req(SCHLOQ00000)

SessionMessage

BusinessMessage

M

M

M

O


시장참여자 요청 (UserID, Password 입력 )거부시는 User ID, Password 검증 오류

데이터 발생원에서 데이터 송신 없을 경우 10 초 간격으로 발생하며 30 초 이상응답 또는 데이터 없는 경우 Session Close-> 재 Logon


TR code 로 분류가능장운영 , 체결 , 실시간 전송일 경우 응답은 해당 없음 (Res)


Logon res(SCHLIS00000)M

Opening Res(SCHOPR00000)M

M

SessionMessage Logout Res(SCHLOR00000)M

Resend Req(SCHRSQ00000)O장운영 , 체결 , 실시간 전송에서 사용 . 단 , 채널내부에 보관된 정보만 재전송 가능Resend Res(SCHRSR00000)O

Session 메시지 흐름의 적용 ( 예 )

정상 처리 절차

업무 흐름도

Heartbeat Req(SCHHEQ00000)M

채널에서만 업무개시 요청 (1 일 N 번 수행 가능 )데이터 수신시스템을 기준으로 일련번호 동기화거부시는 시장참여자의 온라인 준비가 미완료인 경우1 회 /10초 발생하며 3 회이상 무응답시 Session Close


77/85



Heartbeat Req(SCHHEQ00000)


SessionMessage

BusinessMessage

M

M

M

M






SessionMessage Logout Res(SCHLOR00000)M

Sequence Req(SCHSQQ00000)O


Transaction Req( 주문 TR)O

TR code 로 분류가능Transaction Res( 주문 TR)M

OSequence Res(SCHSQR00000)


데이터 발생원이 시장참여자인 경우정상 처리 절차

업무 흐름도

Heartbeat Res(SCHHER00000)M


데이터 발생원에서 데이터 송신 없을 경우 10 초 간격으로 발생하며 30 초 이상응답 또는 데이터 없는 경우 Session Close-> 재 Logon

채널에서만 업무개시 요청 (1 일 N 번 수행 가능 )데이터 수신시스템을 기준으로 일련번호 동기화거부시는 시장참여자의 온라인 준비가 미완료인 경우1 회 /10초 발생하며 3 회이상 무응답시 Session Close


78/85





M

M

M

O

시장참여자 요청 (UserID, Password 입력 )거부시는 User ID, Password 검증 오류채널에서만 업무개시 요청 (1 일 N 번 수행 가능 )일정간격 (10초 ) 으로 업무 개시를 요구 또는거부시는 시장참여자의 온라인 준비가 미완료인 경우 3 회이상 무응답시 Session Close체결 , 장운영 , 실시간 응답 없음




Logout Res(SCHLOR00000)M

Resend Req(SCHRSQ00000)O데이터 일련번호가 상이 할 경우 ( 정상 수신한 최종 일련번호 통보 )장운영 , 체결 , 실시간 전송에서 사용 .

Resend Res(SCHRSR00000) O

• •

장애발생 & TCP/IP Close Logon req(SCHLIQ00000)M 재 logon 시도 ( 시장참여자에서 요청 )


Transaction Req( 체결 TR)O

TR code 로 분류가능


데이터 발생원이 채널서비스인 경우비정상 처리 절차

업무 흐름도


• • 이후 정상 처리 흐름으로 전환

채널에서만 업무개시 요청 (1 일 N 번 수행 가능 )데이터 수신시스템을 기준으로 일련번호 동기화

Opening Req(SCHOPQ00000) M


세션키 교환 처리 시장참여자 채널

79/85




M

M

M


채널에서만 개시 요청 (1 일 N 번 수행 가능 )거부시는 시장참여자의 온라인 준비가 미완료인 경우




Logout Res(SCHLOR00000)M

Sequence Req(SCHSQQ00000)O


Transaction Req( 주문 TR)O TR code 로 분류가능주문 , 조회 / 요청 , 일괄수신에서만 응답 사용Transaction Res( 주문 TR)M

OSequence Res(SCHSQR00000)

장애발생 & TCP/IP Close Logon req(SCHLIQ00000)M


Transaction Req( 주문 TR)OTR code 로 분류가능

Transaction Res( 주문 TR)M

• • 이후 정상 처리 흐름으로 전환


데이터 발생원이 시장참여자인 경우비정상 처리 절차

업무 흐름도


재 logon 시도 ( 시장참여자에서 요청 )

채널에서만 업무개시 요청 (1 일 반복 사용 가능 )데이터 수신시스템을 기준으로 일련번호 동기화

Opening Req(SCHOPQ00000) M


세션키 교환 처리 시장참여자 채널

80/85

Contents



3. Session 메시지 Format KRX KRX 차세대 시스템 차세대 시스템








81/85

메시지 TYPE 기준 허용 ASCII 남는부분 예시String 왼쪽 숫자 , 문자 SPACE String(5) [ABC__]Long 오른쪽 숫자 0 Long(5) [00123]Float 오른쪽 부호 , 소수점 0 Float(11) [-

0001234.56]

메시지 항목 ( 호가가격 ) 에 대한 원칙 ( 예시 )

※ 상품별 호가가격에 대한 예시는 별첨 자료 “ KRX 차세대 시장접속 프로토콜 (전문 )

별첨 - 전문내 호가가격 정의” 참조

차세대 적용 원칙 – 메시지 Format 적용

- 11 자리 : 부호 (±) 1 자리 , 소수점 1 자리 , 유효숫자 9 자리- 부호 : 양수는 숫자 0, 음수는 “ -” 로 표기- 소수점 : 실제 소수점 위치에 표기- 유효숫자 : 상품별 정수 / 소수의 자릿수를 정의하고 사용하지 않는 자리는 숫자 0 으로

표기

호가가격 정의

부호 유효숫자

호가가격 형식

± 1 2 3 4 5 6 7 . 8 9

1 2 3 4 5 6 7 8 9 10 11 자릿수

82/85

구 분 내 용

체계 Port No 자릿수 (5)

회원번호 자릿수 (3) +300 I/F 번호 자릿수 (2)

예제

예 )- 001(교보증권 ) => 301 - 046(HI증권 ) => 346

00 ~ 39: 주문 (00 : 오전시간외 주문 , 01 : 주문 #01( 정규장주문 ) , )40 ~ 79: 체결 (40 : 오전시간외 체결 , 41 : 체결 #01( 정규장 체결 ), )

회원사 Port 체계

적용 예시 ( 시장구분 : IP-Address 로 구분 ) ( 예 1) 대우증권 (005) 에서 정규장 주문 #02 번인 경우 TCP 포트 번호 : 3 0 5 0 2 [305 - 300 = 05( 회원번호 ), 02 ( 정규장 주문 #02)]

( 예 2) KB 선물 (091) 에서 체결 #01 번인 경우 TCP 포트 번호 : 3 9 1 4 1 [391 - 300 = 91( 회원번호 ), 41 ( 정규장 체결 #01)]

시장 구분은 Node 의 IP-ADDRESS 로 구분 주문 / 체결 프로세스를 40 개로 할당

차세대 적용 원칙 – Tcp/Ip Port 정책

83/85

회원 번호 (3) I/F 번호 (2) 비 고

001~ ( 회원번호 )- 001 : 교보- 002 : 굿모닝신한- …- 000 : 외국인

※ 회원번호 + 300

00 오전시간외 주문

시장별 구성

01 ~ 39주문 #1 ~ 주문 #39

40 오전시간외 체결

41 ~ 79체결 #1 ~ 체결 #39

80 장운영 #1

90 장운영 #2

81 신고

시장 참여자별 1개( 유가시장에만 구성 )

82 실시간수신

83 일괄수신

84 일괄송신

85 조회

86 종합감리수신

87 종합감리송신

회원사 Port 배정안

차세대 적용 원칙 – Tcp/Ip Port 정책

적용 예시 (Port No) - 301 00 ⇒ 301 – 300 = 01(교보증권 ), 00 = 오전시간외 주문

- 301 29 ⇒ 301 – 300 = 01(교보증권 ), 29 = 정규장 주문 #29

- 387 52 ⇒ 387 – 300 = 87( 동양선물 ), 52 = 체결 #12 번째

※ 시장구분은 Node 의 IP-Address 로 구분함 .

84/85

시장구분 (1) 회원 번호 (3) I/F 번호 (2) 일련번호 (2) FILLER(2)

1: 유가2: 코스닥3: 선물0: 공통업무

001~ 999 ( 회원번호 )- 001 : 교보- 002 : 굿모닝신한- …

KO : 주문

00~99 Space 처리

KT : 체결

KM : 장운용

KQ : 신고

KR : 일괄수신

KS : 일괄송신

KA : 실시간송신

KI : 조회

KG : 종합감리 수신

KH : 종합감리 송신

회원사 사용자 ID 구성안

차세대 적용 원칙 – 사용자 ID 정책

사용자 ID 는 프로세스 별로 할당하는 것을 기준으로 함

적용 예시

- 교보증권 1 번째 유가시장 주문 사용자

: 1 + 001 + KO + 01 = 1001KO01

- 키움증권 일괄송신 사용자 : 0 + 050 + KS + 01 = 0050KS01

- HI 투자증권 종합감리 송신 사용자 : 0 + 046 + KH + 01 = 0046KH01

- 교보증권 장운영 #1 ( 공개장운영 ) 사용자

: 1 + 001 + KM + 01 = 1001KM01

- 교보증권 장운영 #2 ( 종목마감 ) 사용자

: 1 + 001 + KM + 02 = 1001KM02

85/85

시장별 가동 시스템 IP 및 프로세스 정책 ( 프로세스 수는 회원사에 공지된 배정기준에 따라 적용 )

차세대 적용 원칙 – Active 프로세스 구성

시장구분시스템

Active 프로세스 기준 프로세스명 PortNode IP Address

유가

A10.11.110.1

01

*주문 / 체결 서비스 - 프로세스번호 홀수 => 홀수 (Node A) - 프로세스번호 짝수 => 짝수 (Node B)

*나머지 서비스 - 회원사 번호 홀수 => 홀수 (Node A) - 회원사 번호 짝수 => 짝수 (Node B)

주문 ( 오전시간외 )

[300+ 회원번호 (3)]+00

주문 [300+ 회원번호 (3)]+01~

체결 ( 오전시간외 ) [300+ 회원번호 (3)]+40

B10.11.110.1

02

체결 [300+ 회원번호 (3)]+41 ~

장운영 [300+회원번호 (3)]+80,90

코스닥

A 10.11.120.101

주문 ( 오전시간외 ) [300+ 회원번호 (3)]+00

주문 [300+ 회원번호 (3)]+01 ~

체결 ( 오전시간외 )

[300+ 회원번호 (3)]+40

B10.11.120.102 체결 [300+ 회원번호 (3)]+41 ~

장운영 [300+회원번호 (3)]+80,90

선물

A10.21.110.101

주문 [300+ 회원번호 (3)]+01 ~

체결 [300+ 회원번호 (3)]+41 ~

B10.21.110.102

장운영 [300+회원번호 (3)]+80,90

Active 프로세스 구성

86/85

프로세스 구성은 Active 와 Standby 형태로 구성되어 있습니다 .

회원사

채널서버 1 회원사 프로세

스구 분 Mode

주문 0(오전시간외 )

Standby

주문 1 Active

주문 2 Standby

주문 3 Active

주문 4 Standby

체결 0(오전시간외 )

Standby

체결 1 Active

체결 2 Standby

체결 3 Active

체결 4 Standby

장운영 Active

신고 Active

실시간수신 Active

일괄수신 Active

일괄송신 Active

조회 Active

종합감리수신 Active

종합감리송신 Active

채널서버 2

거래소 프로세

스

거래소 프로세

스

예 ) 유가시장 교보증권 (001) - 주문 프로세스 수 : 5

구 분 Mode

주문 0(오전시간외 ) Active

주문 1 Standby

주문 2 Active

주문 3 Standby

주문 4 Active

체결 0(오전시간외 ) Active

체결 1 Standby

체결 2 Active

체결 3 Standby

체결 4 Active

장운영 Standby

신고 Standby

실시간수신 Standby

일괄수신 Standby

일괄송신 Standby

조회 Standby

종합감리수신 Standby

종합감리송신 Standby

차세대 적용 원칙 – Active 프로세스 구성Active 프로세스 구성

Documents

KRX Exture 시장접속프로토콜 V1.5