전문 공통부

모든 VAVS 업무 전문은 공통부와 업무별 개별부로 구성됩니다. 아래 위치는 통신 Length 헤더를 제외한 200바이트 VAVS 전문에서 0부터 시작하는 바이트 오프셋입니다.

NOTE

실제 TCP 프레임 앞에는 별도의 4바이트 통신 Length 헤더(0200)가 추가됩니다. 아래 표의 위치에 4를 더하면 TCP 프레임 기준 위치가 됩니다. 예를 들어 기관코드는 전문 위치 4, TCP 프레임 위치 8입니다.

필드 구성

No	항목	MODE	길이	위치	요구	응답	설명
1	LENGTH	N	4	0	●	○	공통부 LENGTH 자신을 포함한 VAVS 전문 전체 길이. `0200` 고정
2	기관코드	AN	8	4	●	○	헥토파이낸셜에서 부여한 기관코드
3	거래종류코드	N	4	12	●	⊙	업무별 요구·응답 코드
4	송수신코드	N	1	16	●	⊙	전문 송수신 방향
5	거래일자	N	8	17	●	○	`YYYYMMDD`
6	거래시간	N	6	25	●	⊙	`HHMMSS`
7	개설은행코드	AN	2	31	●	○	구 은행코드
8	거래번호	AN	7	33	●	○	헥토파이낸셜 거래 일련번호
9	응답코드	AN	4	40	●	⊙	업무 처리 결과
10	신개설은행코드	AN	3	44	●	○	금융회사 3자리 코드
11	예약영역 1	AN	4	47	●	○	VAVS 예약영역
12	예약영역 2	AN	7	51	●	○	VAVS 예약영역
13	사용자거래번호	N	7	58	-	-	이용기관이 생성하는 일별 고유 번호
14	발생구분	AN	1	65	●	○	최초 거래 발생 주체
15	전문전송방식구분	A	1	66	●	○	IR 또는 거래통보 방식
16	예약영역 3	AN	2	67	●	○	VAVS 예약영역
17	자동취소여부	A	1	69	●	○	자동취소이면 `A`

● 요구 전문 설정, ○ 응답 전문 전달, ⊙ 응답 시 변경 또는 반영

이용기관이 응답 또는 요청 전문을 헥토파이낸셜로 보낼 때는 3을 설정합니다.

값	방식
`Y`	IR(수취조회) 방식
`N`	거래통보(SAF) 방식

IR/거래통보 방식을 선택할 수 있는 은행은 다음과 같습니다.

입금·수취조회·취소 거래는 다음 조합으로 중복 여부를 판단합니다.

거래일자(8) + 기관코드(8) + 거래번호(7)

송금·성명조회·집계를 이용기관에서 요청할 때는 사용자거래번호를 당일 중복되지 않게 생성해야 합니다.

자동취소 전문은 공통부 자동취소여부에 A가 설정됩니다.

자동취소가 발생할 수 있는 은행은 다음과 같습니다. (2026년 7월 24일 기준)

자동취소는 은행에서 이미 취소가 완료된 통지 거래입니다. 이용기관의 응답 성공 여부와 관계없이 원 입금 거래를 취소 상태로 반영해야 합니다.

더 궁금한 내용이 있나요?

기술지원이 필요한가요?

코드 샘플