외화송금의뢰(MX) (2000/401)
외화 자금을 해외 또는 국내 외화계좌로 송금하는 MX 전문입니다. SWIFT MT 전문(2000/400) 사용 종료에 따라 MX 전문(XML 형태)으로 신설되었습니다.
NOTE
MX 전문 신설 배경
당·타발송금 거래 시 사용되던 SWIFT MT전문(2000/400)의 사용 종료로 MX전문(2000/401) 신규 전문 신설. MT전문(Text) 형태 → MX전문(XML) 형태로 변경되어 더 다양한 메시지 교환이 가능합니다.
전문 정보
| 항목 | 요청 | 응답 |
|---|---|---|
| 전문코드 | 2000 | 2100 |
| 업무구분 | 401 | 401 |
| 방향 | 업체→은행 | 은행→업체 |
| 전문 크기 | 2500 바이트 (공통부 100 + 개별부 2400) |
NOTE
송금결과 확인
해외송금(1), 국내송금(2) 시에는 외화송금결과통지(MX)(3000/701)를 최종 확인해야 합니다. 당행이체(3), 금결원 경유(4)는 송금응답으로 처리가 완료됩니다.
우리은행 당행거래 주의
우리은행은 이체구분코드가 3(당행이체)일 때 전문응답을 못 받았을 경우 은행 또는 헥토파이낸셜에 유선으로 확인해야 합니다.
공통부 (100 바이트)
모든 실시간 펌뱅킹 전문의 공통 헤더입니다.
| No | 항목 | 위치 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별코드 | 0 | X(9) | Y | 수신자의 TRANSACTION CODE (SETTLEBNK 또는 SPACE) |
| 2 | 업체번호 | 9 | X(12) | Y | 각 개설은행에서 부여한 업체번호 |
| 3 | 은행코드 | 21 | 9(3) | Y | 펌뱅킹 계약된 개설은행코드 |
| 4 | 전문구분코드 | 24 | X(4) | Y | 전문코드 (요청: 2000, 응답: 2100) |
| 5 | 업무구분코드 | 28 | X(3) | Y | 업무구분 (401) |
| 6 | 송신회수 | 31 | 9(1) | Y | '1' 고정 |
| 7 | 전문번호 | 32 | 9(6) | Y | 일별 Unique 전문번호 (MAX 950,000) |
| 8 | 전송일자 | 38 | 9(8) | Y | 전문전송 일자 (YYYYMMDD) |
| 9 | 전송시간 | 46 | 9(6) | Y | 전문전송시간 (hhmmss) |
| 10 | 응답코드 | 52 | X(4) | - | 응답코드 (에러코드), 요청 시 SPACE |
| 11 | 예비영역 | 56 | X(44) | - | 헥토파이낸셜 고유영역 |
개별부 (2400 바이트)
| No | 항목 | 위치 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| 1 | 고객번호 | 100 | 9(10) | 조건부 | 사업자번호 |
| 2 | 출금계좌번호 | 110 | X(16) | Y | 은행에 사전등록된 계좌번호 |
| 3 | 복기부호 | 126 | X(6) | 조건부 | 은행과 협의 후 사용 |
| 4 | 거래금액 | 132 | 9(15) | Y | 소수점 이하 3자리 포함 (12,3) |
| 5 | 통화코드 | 147 | X(3) | Y | ISO CODE (예: USD, JPY) |
| 6 | 이체구분코드 | 150 | X(1) | Y | 1:해외송금, 2:국내송금(SWIFT), 3:당행이체, 4:국내송금(금결원) - 특정은행만 사용가능 |
| 7 | 송금인명 | 151 | X(140) | Y | 영문 |
| 8 | 송금국가코드 | 291 | X(2) | Y | 송금인 국가코드 |
| 9 | 송금인주소 도시명 | 293 | X(35) | 조건부 | |
| 10 | 송금인주소 도로명 | 328 | X(70) | 조건부 | |
| 11 | 송금인주소 층명 | 398 | X(70) | 조건부 | |
| 12 | 송금목적코드 | 468 | X(4) | 조건부 | |
| 13 | 송금목적지시사항 | 472 | X(70) | 조건부 | |
| 14 | 송금인 LEI | 542 | X(20) | 조건부 | |
| 15 | 수취인명 | 562 | X(140) | Y | 영문 |
| 16 | 입금계좌번호 | 702 | X(35) | Y | |
| 17 | 입금국가코드 | 737 | X(2) | Y | 수취인 국가코드(주소지 기준) |
| 18 | 수취인주소 도시명 | 739 | X(35) | Y | |
| 19 | 수취인주소 도로명 | 774 | X(70) | 조건부 | 수취인주소 상세주소1 |
| 20 | 수취인주소 층명 | 844 | X(70) | 조건부 | 수취인주소 상세주소2 |
| 21 | 수취인우편번호 | 914 | X(16) | 조건부 | |
| 22 | 수취인 앞 지시사항 | 930 | X(140) | 조건부 | |
| 23 | 수취인 LEI | 1070 | X(20) | 조건부 | 수취인 법인식별기호 |
| 24 | 적성국가송금여부 | 1090 | X(1) | Y | 기본 N / 적성국가송금 시 Y |
| 25 | 입금 BIC 은행코드 | 1091 | X(11) | Y | BIC CODE. 하나은행 금결원거래의 경우 은행코드 3자리 |
| 26 | 입금은행명 | 1102 | X(140) | 조건부 | BIC코드 입력한 경우 생략 가능 |
| 27 | 입금은행 국가코드 | 1242 | X(2) | 조건부 | BIC코드 입력한 경우 생략 가능 |
| 28 | 입금은행주소 도시명 | 1244 | X(35) | 조건부 | BIC코드 입력한 경우 생략 가능 |
| 29 | 입금은행주소 도로명 | 1279 | X(70) | 조건부 | BIC코드 입력한 경우 생략 가능 |
| 30 | 입금은행주소 층명 | 1349 | X(70) | 조건부 | BIC코드 입력한 경우 생략 가능 |
| 31 | 국가별 은행코드 | 1419 | X(5) | 조건부 | NCC코드 영문 5자리 (예: 미국 USABA) |
| 32 | 국가별 은행코드 내용 | 1424 | X(28) | 조건부 | Member Identification (수취국가 로컬결제망 은행식별코드) |
| 33 | 송금경유은행 1 | 1452 | X(70) | 조건부 | SC제일은행 (중계은행명35 + 중계은행 도시명35) |
| 34 | 송금경유은행 2 | 1522 | X(70) | 조건부 | SC제일은행 (중계은행 도로명) |
| 35 | 송금경유은행 3 | 1592 | X(70) | 조건부 | SC제일은행 (중계은행 층명 - 선택값) |
| 36 | 수수료계좌번호 | 1662 | X(16) | 조건부 | SC제일은행 공백 세팅 |
| 37 | 수수료부담자구분코드 | 1678 | X(1) | Y | 1:송금인부담, 2:수취인부담, 3:양쪽부담(일부은행만) |
| 38 | 수수료인출구분코드 | 1679 | X(1) | Y | 1:출금계좌, 2:수수료인출계좌 |
| 39 | 지급사유코드 | 1680 | X(5) | Y | 이체구분코드 1,2인 경우 필수 |
| 40 | 지급사유 | 1685 | X(35) | 조건부 | 지급사유코드 입력한 경우 세팅 불필요 |
| 41 | 가격조건코드 | 1720 | X(3) | 조건부 | 사후금방식 송금으로 USD 1,000 초과하는 경우 세팅 |
| 42 | H.S CODE | 1723 | X(10) | 조건부 | 사후금방식 송금으로 USD 1,000 초과하는 경우 세팅 |
| 43 | 수입신고서 번호 | 1733 | X(22) | 조건부 | 사후금방식 송금으로 USD 1,000 초과하는 경우 세팅 |
| 44 | 수입용도 | 1755 | X(1) | 조건부 | 사후금방식 송금으로 USD 1,000 초과하는 경우 세팅 |
| 45 | 적요 | 1756 | X(14) | 조건부 | 이체구분코드 3(당행이체)인 경우 사용 |
| 46 | 입금계좌 예금주명 | 1770 | X(22) | 조건부 | 이체구분코드 3(당행이체)인 경우 사용 |
| 47 | 출금계좌 잔액 | 1792 | X(15) | 조건부 | 응답 시 세팅 |
| 48 | 수취인 이메일주소 1 | 1807 | X(50) | 조건부 | SC제일은행 사용불가 |
| 49 | 수취인 이메일주소 2 | 1857 | X(50) | 조건부 | SC제일은행 사용불가 |
| 50 | 수취인 이메일주소 3 | 1907 | X(50) | 조건부 | SC제일은행 사용불가 |
| 51 | 대응수입예정일 구분코드 | 1957 | X(1) | 조건부 | 하나은행. 사전송금방식 이용 시 사용. 1:1년이내, 2:1년초과 |
| 52 | 중계무역수출거래여부 | 1958 | X(1) | 조건부 | 하나은행 (Y/N) |
| 53 | 입금은행코드 | 1959 | X(3) | 조건부 | 우리은행 & 이체구분코드 4(국내송금 금결원) 필수 |
| 54 | 취급점코드 | 1962 | X(7) | 조건부 | 우리은행 & 이체구분코드 4(국내송금 금결원). 수취점 지로코드 |
| 55 | 거주구분코드 | 1969 | X(2) | 조건부 | 우리은행 & 이체구분코드 4(국내송금 금결원) |
| 56 | 예금주조회 전문번호 | 1971 | X(6) | 조건부 | 송금 전 상대계좌 예금주조회 선조회한 전문번호 |
| 57 | 거래외국환은행 지정코드 | 1977 | X(2) | 조건부 | 우리은행 전용 |
| 58 | 거래외국환은행 지정 실명번호 | 1979 | X(13) | 조건부 | 우리은행 전용 |
| 59 | 재정통화코드 | 1992 | X(3) | 조건부 | 우리은행 전용 |
| 60 | 중계 BIC 은행코드 | 1995 | X(11) | 조건부 | SC제일은행 전용. 중계은행정보 세팅 시 필수 |
| 61 | 중계은행 국가코드 | 2006 | X(2) | 조건부 | SC제일은행 전용 |
| 62 | 원화 출금금액 | 2008 | X(15) | 조건부 | SC제일은행 전용 |
| 63 | 적용환율 구분코드 | 2023 | X(1) | 조건부 | SC제일은행 전용. 1:system rate, 2:contracted rate |
| 64 | 취급수수료부담 코드 | 2024 | X(1) | 조건부 | SC제일은행 전용. 1:수취인부담(BEN), 2:송금인부담(OUR) |
| 65 | 입금은행 BIC 코드 구분 | 2025 | X(1) | 조건부 | SC제일은행 전용(필수). 1:BIC, 2:NON-BIC |
| 66 | 중계은행 BIC 코드 구분 | 2026 | X(1) | 조건부 | SC제일은행 전용(중계은행 입력 시 필수). 1:BIC, 2:NON-BIC |
| 67 | 예비 | 2027 | X(473) | - | SPACE |
전문 구조
요청 전문 (2500 바이트)2500 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
개별부2400B · offset 100
고객번호10 · 100
출금계좌번호16 · 110
복기부호6 · 126
거래금액15 · 132
통화코드3 · 147
이체구분코드1 · 150
송금인명140 · 151
송금국가코드2 · 291
송금인주소 도시명35 · 293
송금인주소 도로명70 · 328
송금인주소 층명70 · 398
송금목적코드4 · 468
송금목적지시사항70 · 472
송금인 LEI20 · 542
수취인명140 · 562
입금계좌번호35 · 702
입금국가코드2 · 737
수취인주소 도시명35 · 739
수취인주소 도로명70 · 774
수취인주소 층명70 · 844
수취인우편번호16 · 914
수취인 앞 지시사항140 · 930
수취인 LEI20 · 1070
적성국가송금여부1 · 1090
입금 BIC 은행코드11 · 1091
입금은행명140 · 1102
입금은행 국가코드2 · 1242
입금은행주소 도시명35 · 1244
입금은행주소 도로명70 · 1279
입금은행주소 층명70 · 1349
국가별 은행코드5 · 1419
국가별 은행코드 내용28 · 1424
송금경유은행 170 · 1452
송금경유은행 270 · 1522
송금경유은행 370 · 1592
수수료계좌번호16 · 1662
수수료부담자구분코드1 · 1678
수수료인출구분코드1 · 1679
지급사유코드5 · 1680
지급사유35 · 1685
가격조건코드3 · 1720
H.S CODE10 · 1723
수입신고서 번호22 · 1733
수입용도1 · 1755
적요14 · 1756
입금계좌 예금주명22 · 1770
출금계좌 잔액15 · 1792
수취인 이메일주소 150 · 1807
수취인 이메일주소 250 · 1857
수취인 이메일주소 350 · 1907
대응수입예정일 구분코드1 · 1957
중계무역수출거래여부1 · 1958
입금은행코드3 · 1959
취급점코드7 · 1962
거주구분코드2 · 1969
예금주조회 전문번호6 · 1971
거래외국환은행 지정코드2 · 1977
거래외국환은행 지정 실명번호13 · 1979
재정통화코드3 · 1992
중계 BIC 은행코드11 · 1995
중계은행 국가코드2 · 2006
원화 출금금액15 · 2008
적용환율 구분코드1 · 2023
취급수수료부담 코드1 · 2024
입금은행 BIC 코드 구분1 · 2025
중계은행 BIC 코드 구분1 · 2026
예비473 · 2027
필수
선택
응답전용 / 예비
길이 · 위치응답 코드
응답코드는 은행별로 상이하며, 코드 리스트는 해당 은행이나 헥토파이낸셜에 요청할 수 있습니다.
- 공통부 응답코드 항목은 요청 전문에는 SPACE로 세팅하며, 응답 전문에는 해당 에러코드를 세팅합니다.
- 응답코드 중 VTIM의 경우 응답시간초과 세션에러이므로 오류응답이 아닙니다. (3000/701이 안 올 경우, 3000/801로 확인)
VTIM 응답
응답코드 VTIM은 응답시간 초과를 의미합니다. 이 경우 세션 에러이므로 오류응답이 아닙니다. 외화송금결과통지(MX)(3000/701)가 오지 않을 경우 3000/801(결번조회)로 확인하세요.
