외화잔액조회 (7000/900)
외화계좌의 잔액을 조회하는 전문입니다.
전문 정보
| 항목 | 요청 | 응답 |
|---|---|---|
| 전문코드 | 7000 | 7100 |
| 업무구분 | 900 | 900 |
| 방향 | 업체→은행 | 은행→업체 |
| 전문 크기 | 2000 바이트 (공통부 100 + 개별부 1900) |
NOTE
하나은행 단일통화계좌
하나은행의 경우 외화계좌가 38로 끝나는 다통화계좌가 아닌 단일통화계좌는 통화코드를 체크하지 않습니다. 예: 단일통화(JPY) 계좌에 USD로 요청해도 JPY 잔액이 리턴됩니다.
공통부 (100 바이트)
모든 실시간 펌뱅킹 전문의 공통 헤더입니다.
| No | 항목 | 위치 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별코드 | 0 | 9 | Y | 수신자의 TRANSACTION CODE (SETTLEBNK 또는 SPACE) |
| 2 | 업체번호 | 9 | 12 | Y | 헥토파이낸셜에서 부여한 업체번호 |
| 3 | 은행코드 | 21 | 3 | Y | 펌뱅킹 계약된 개설은행코드 |
| 4 | 전문구분코드 | 24 | 4 | Y | 전문코드 (요청: 7000, 응답: 7100) |
| 5 | 업무구분코드 | 28 | 3 | Y | 업무구분 (900) |
| 6 | 송신회수 | 31 | 1 | Y | '1' 고정 |
| 7 | 전문번호 | 32 | 6 | Y | 일별 Unique 전문번호 (MAX 950,000) |
| 8 | 전송일자 | 38 | 8 | Y | 전문전송 일자 (YYYYMMDD) |
| 9 | 전송시간 | 46 | 6 | Y | 전문전송시간 (hhmmss) |
| 10 | 응답코드 | 52 | 4 | - | 응답코드 (에러코드), 요청 시 SPACE |
| 11 | 예비영역 | 56 | 44 | - | 헥토파이낸셜 고유영역 |
개별부 (1900 바이트)
요청/응답 파라미터
| No | 항목 | 위치 | 길이 | 요청 | 응답 | 설명 |
|---|---|---|---|---|---|---|
| 1 | 출금외화계좌번호 | 100 | X(16) | Y | - | 은행에 사전 등록된 계좌번호 |
| 2 | 출금외화계좌통화 | 116 | X(3) | - | Y | ISO CODE (예: USD, YEN) |
| 3 | 출금외화계좌잔액 | 119 | 9(15) | - | Y | 소수점 이하 3자리 포함 (12,3) |
| 4 | 예비 | 134 | X(1866) | - | - | SPACE |
전문 구조
요청 전문 (2000 바이트)2000 bytes
공통부100B · offset 0
식별코드9 · 0
업체번호12 · 9
은행코드3 · 21
전문구분코드4 · 24
업무구분코드3 · 28
송신회수1 · 31
전문번호6 · 32
전송일자8 · 38
전송시간6 · 46
응답코드4 · 52
예비영역44 · 56
개별부1900B · offset 100
출금외화계좌번호16 · 100
출금외화계좌통화3 · 116
출금외화계좌잔액15 · 119
예비1866 · 134
필수
선택
응답전용 / 예비
길이 · 위치응답 코드
응답코드는 은행별로 상이하며, 코드 리스트는 해당 은행이나 헥토파이낸셜에 요청할 수 있습니다.
- 공통부 응답코드 항목은 요청 전문에는 SPACE로 세팅하며, 응답 전문에는 해당 에러코드를 세팅합니다.
- 응답코드 중 VTIM의 경우 응답시간초과 세션에러이므로 오류응답이 아닙니다. (3000/700이 안 올 경우, 3000/800으로 확인)
