FaxProject Team – fax - KLXFer 메뉴얼 Ver.1.4 · 2015. 5. 21. · KLXFer Install 및Setup...

케이엘넷

KLXFer 메뉴얼

Ver.1.4.0

2010년 11월 25일

KLXFer Install 및 Setup Manual본매뉴얼은 Microsoft Windows 용 KLXFer 설치및셋업매뉴얼입니다.

- 목차 -

※ KLXFer 간단매뉴얼…………………...…...3

1. KLXFer 의설치 …………………….…… 4

2. KLXFer 의환경설정…………..………… 8

3. KLXFer 의고급설정…………..………… 15

4. KLXFer 의운영………………………….. 17

• [부록첨부]…………………..………...….. 19

케이엘넷

KLXFer Install 및 Setup Manual

케이엘넷- 3 -

□설치

○ KL-Net Cyberdesk(http://cyberdesk.klnet.co.kr) 자료실>프로그램에서실행파일다운로드

- klxfer_install_[version].exe

○ klxfer_install_[version].exe 실행

○설치

- 경로 설정(ERP별) : 설정 경로명은 영문으로 설정

- klxfer₩bin₩initialize.bat 를 실행하여 설치위치에 따른 환경설정을 자동처리※윈도우비스타의경우 program files 이외디렉터리설치

□환경설정및테스트

○ initialize.bat가실행되면환경설정을초기화시킨후환경설정화면이실행됨.

○사용자정보변경

- 좌측하단 ‘추가’ 클릭 : ID, PW추가, Service Mode "A" => 선택 => 저장

* type : TCP, Address : 203.236.120.117, Port : 7761- 기존샘플(테스트) ID/PW 반드시삭제

※단일서버에다수사업자번호설정필요시 KLXFer 에각 ID 별로처리가능

○테스트 : 테스트탭에서연결테스트및송신테스트

□실행

○데몬방식일경우 klxfer\bin 디렉터리밑의 “klxferWindow.bat” 실행(더블클릭)○ Windows Service 일경우 klxfer\bin 디렉터리밑의 “klxferService.bat” 실행(더블클릭)

□ ERP연계사용자의전송오류확인방법

○계산서처리절차

1) ERP(데이터생성/전송) -> 2) KLXFER(로지스빌통신 S/W) -> LogisBill

○오류유형별처리절차

- klxfer\data\send 에파일이남아있는경우

․파일이 ERP에서 klxfer로전송되었으나 klxfer이실행되지않은경우로서,․klxfer를데몬방식으로구동하는경우에는실행파일(klxferwindow.bat) 실행

․klxfer에서 LogisBill 로정상전송된파일은 klxfer\data\send_save 하위에전송날짜별로

생성된디렉터리내에존재하게됨.따라서해당디렉터리에파일이존재할경우, 로지스빌처리오류

※ KLXFer 간단매뉴얼※


케이엘넷- 4 -

1. KL-Net Cyberdesk 자료실>프로그램에서실행파일다운로드

http://cyberdesk.klnet.co.kr 에접속후 자료실 > 프로그램 > klxfer_install_[version].exe2. 다운받은실행파일을실행합니다. 3. 사용할언어를선택합니다.

1. KLXFer 의설치

4. 설치를위한설정작업을시작합니다.


케이엘넷- 5 -

6. 구성요소를선택하고 [다음]을클릭합니다.

5. 사용권계약에대해 [동의함]을클릭합니다.


케이엘넷- 6 -

8. [설치]를클릭하여설치를시작합니다.

7. KLXFer 가설치될폴더를선택합니다.


케이엘넷- 7 -

10. [마침]을클릭하여설치를종료합니다.

9. KLXFer 가설치됩니다.


케이엘넷- 8 -

1. KLXFer 가설치된디렉터리밑에있는 bin 디렉터리의 initialize.bat 를실행합니다.2. 아래와같이 command 창이뜨면서 KLXFer 의환경설정을시작합니다.3. 환경설정시 default 사용자가등록되어있습니다.4. default 사용자와같은형태로부여받으신사용자 ID 와 Password 를등록합니다.※실제사용시에는 default 사용자를삭제하셔야합니다.

2. KLXFer 의환경설정

가. Login ID, Password 는 KLNET 담당자로부터미리부여받아야합니다.나. initialize.bat 는최초환경설정시사용을권장하며, 이후에는자동으로생성되는 configuration.bat

를사용하시기바랍니다.(inititialze.bat 는 default 사용환경을자동으로생성하고, 기존의환경설정파일은백업합니다.)


케이엘넷- 9 -

5. 사용자정보탭에서등록한사용자의네트워크정보를수정합니다.※일반적인사용자께서는특별히수정하실일이없습니다.

가. Local Network- Auto-Delivery 사용자인경우에한하여사용됩니다.- Auto-Delivery 사용자인경우에는방화벽을사용하고있다면,사전에방화벽개방여부를반드시네트워크담당자와확인하셔야합니다.

- Address 는내부적으로사용하시는사설 IP 는사용하실수없습니다.반드시외부에서접근가능한공인 IP 를 등록해주셔야합니다.

나. Remote Network- 사용자께서 KLNET 에접속하기위한네트워크정보입니다.※해당정보를수정하시는경우문서의송/수신의정상적인작동을보증할수없습니다.


케이엘넷- 10 -

6. 사용자정보탭에서등록한사용자의디렉터리정보를수정합니다.※일반적인사용자께서는특별히수정하실일이없습니다.

가. Install 시에선택하신 KLXFer 의설치디렉터리를기준으로 default 디렉터리가구성됩니다.- 필요하신경우각각의디렉터리를수정가능합니다.※단 KLXFer 의정상적인작동을위해 2개이상의 ID 를사용하시는경우아래의예와같이

각 ID 별로별도의디렉터리를지정하셔야합니다.(log 디렉터리는공용이가능합니다.)- 네트워크로공유되는디렉터리의사용은정상적인작동을기대하기어렵습니다.


케이엘넷- 11 -

7-1. 사용자정보탭에서등록한사용자의설정된환경을테스트합니다.

가. 연결테스트

- 사용자의 KLXFer 에서 KLNET 의중계시스템까지네트워크상의문제를확인합니다.- 인터넷에연결이안되어있는경우 Fail 이발생할수있으며,인터넷연결여부를확인하시기바랍니다.

- 외부로송신되는패킷에대해방화벽이설정되어있는경우 Fail 이발생할수있으며,네트워크담당자에게방화벽설정에대해문의하시기바랍니다.


케이엘넷- 12 -


가. 송신테스트

- 연결테스트가이상이없는경우진행하시기바랍니다.- 등록하신 ID 에대해순차적으로송신테스트를진행합니다.- 각 ID 의송신디렉터리(예 : …\data\send\) 에있는파일을 KLNET 으로송신하게되며

해당디렉터리에파일이없는경우위와같은오류가발생합니다.- 2개이상의 ID 에대해테스트를진행하는경우송신파일이있는 ID 에대해서만

테스트를진행합니다.- 정상적인송신이이루어진경우해당파일은 …\data\send 디렉터리에서

…\data\send_save\[송신일]\ 로옮겨지게됩니다.


케이엘넷- 13 -


가. 수신테스트

- 연결테스트가이상이없는경우진행하시기바랍니다.- 등록하신 ID 에대해순차적으로수신테스트를진행합니다.- 각 ID 의해당하는 수신대상문서가필요하므로실제문서를받기를원하시면

사전에 KLNET 측과협의하신후테스트를진행하시기바랍니다.- 일반적인경우위와같이수신대상문서가없다는메시지가표출됩니다.- 운영체제가 WindowsXP 이상인경우아래와같이보안경고가나타날수있습니다.[차단해제] 를선택하시면테스트가계속진행됩니다.

- 정상적인수신이이루어진경우해당파일은 …\data\recv 디렉터리에서확인하실수있습니다.


케이엘넷- 14 -

송수신확인

프로그램및관련문서

다운에사용

사용자정보에정의된사용자로자동로

그인

8. 테스트완료후문서전송결과를확인하거나, 프로그램의문서및업데이트내용을확인할수

있도록케이엘넷은 cyberdesk를운영합니다.도움말탭의바로가기를클릭하시면사용자정보에정의된사용자문서의송수신결과를

확인하실수있습니다.


케이엘넷- 15 -

가. KLXFer 의동작방식을나타내는 Service Mode 는다음과같습니다.- A : 고급정보탭에서설정한송수신주기마다 1회씩송신과수신을반복합니다.- L : 송신은하지않고, KLNET 으로부터수신을기다립니다.(Auto Delivery)- R : 송신은하지않고, 고급정보탭에서설정한송수신주기마다 1회씩수신을반복합니다.- S : 고급정보탭에서설정한송수신주기마다 1회씩송신을반복합니다.

KLNET 으로부터수신을기다립니다.(Auto Delivery)※ KLNET 으로부터자동으로문서를수신받는 Auto Delivery 사용자는

사전에 KLNET 과협의를해야하며, 방화벽의접근여부에대한확인이반드시필요합니다.나. 송수신방식을나타내는 BS Type 은 KLXFer 의내부적으로사용하는설정입니다.

※최초설치시의설정은변경하지마시기바랍니다.

3. KLXFer 의고급설정

1. 사용자정보탭에서등록한사용자의고급정보를수정합니다.※일반적인사용자께서는 default 설정으로사용하시면됩니다.


케이엘넷- 16 -

2. 사용자정보탭에서등록한사용자의고급정보를수정합니다.※일반적인사용자께서는 default 설정으로사용하시면됩니다.

가. 프로세스호출서버

- 문서의수신과연계하기위해사용자프로세스를등록할경우,프로세스호출서버가 주기적으로사용자프로세스를호출.

나. 제거파일수

- 수신된파일이 recv_temp 디렉터리에저장되면, 호출서버가 recv 디렉터리로

파일을옮기게되는데, 이때한번에옮기는파일의수를지정합니다.다. 사용자프로세스리스트

- 수신된문서를사용자 DB에저장하는작업등과같이, 사용자의필요에따라작업을수행하기

위해프로세스를만들고이를 [사용자프로세스리스트]에등록하게되면, 프로세스호출서버가

호출주기에따라사용자프로세스를호출하여수행하게됩니다.라. 송수신정보

- debug 모드로서송수신과정의로그들을화면에출력합니다.마. 송수신주기

- 송신대상디렉터리의문서를설정하신주기별로처리합니다.바. 프로세스중복체크

- KLXFer를중복실행하는것을방지하기위한통신포트입니다. 사. 자동삭제설정

- 사용자의디스크공간확보를위하여보관일기간이후의로그및송신된문서저장파일을자동으로삭제처리합니다.

- 24시간주기로동작하며삭제시간은 23시 30분 00초에시작됩니다.※필요시삭제이전에백업하시기바랍니다.


케이엘넷- 17 -

4. KLXFer 의운영

1. [KLXFer 의설치디렉터리]\bin 에운영에필요한실행파일이있습니다.

가. configuration.bat- KLXFer 의환경설정을수정합니다.

나. inititialize.bat- KLXFer 의설정을 default 로생성합니다.- 기존의설정파일은 klxferConf_old.xml 로자동백업합니다.

다. JavaService.exe- Windows 의 Service 를이용하기위한필수파일입니다.

라. klxferService.bat- KLXFer 를 Windows 의 Service 를이용하여구동합니다.

마. klxferUnservice.bat- Windows 의 Service 를이용하여구동되는 KLXFer 를등록해제합니다.

바. klxferWindows.bat- KLXFer 의실제구동실행파일입니다.

사. recv.bat- KLXFer 를 1회수신만실행합니다.- 별도의프로그램등에서호출을통해 KLXFer 를실행하고자할때사용합니다.

아. send.bat- KLXFer 를 1회송신만실행합니다.- 별도의프로그램등에서호출을통해 KLXFer 를실행하고자할때사용합니다.

자. KLXFer 의실행종료

- KLXFer 의일반적인실행은 Windows 의 command 창에서실행됩니다.- KLXFer 의종료는 command 창에서 CTRL+C 를입력하여종료하게됩니다.


케이엘넷- 18 -

2. KLXFer 의작동모습입니다.

가. KLXFer 가송수신주기에의해송신과수신을실행하고있는것을확인할수있습니다.나. 2개이상의 ID 를사용하는경우각 ID 의실행을확인할수있습니다.다. KLXFer 의동작에이상이있는경우위화면상에나타나는오류메시지를확인할수있습니다.라. Windows 의 Service 를이용하여실행한경우에는해당로그를실시간으로확인이불가능합니다.

단, KLXFer 를중지하거나, 날짜가변경되는경우에는그동안누적된로그가생성됩니다.그러나 Windows 의 Service 를이용하는경우에는 KLXFer 의실행창을실수로닫는경우등의

위험요소를배제할수있습니다.


케이엘넷

내부시스템(ERP등)와연계하여로지스빌이용시, 부가문서(거래명세표, 입금표, Copy B/L 등)에대한파일첨부방법 (통신 S/W인 “Klxfer” 이용)

• 첨부문서를전송하기위해서는, 사전에 KLNET 의서비스담당자와처리가능여부에대해

협의가필요합니다.

(첨부파일처리가능여부, 첨부파일사이즈, 각첨부파일당최대사이즈, 총첨부파일사이즈

제한포함)

- 19 -

[부록첨부]1. 로지스빌파일첨부안내

1.1 첨부방법가. Naming Rule1) EDI 파일명에 첨부파일 개수를 기재한다.예컨대 첨부파일이 2개라고 하면 2009052600001-2.edi 와 같이 파일명의 맨 끝에 “-(하이픈)”+“첨부파일 갯수” 로 Naming한다.

* 첨부파일이 없을 경우에는 2009052600001.edi 또는 2009052600001-0.edi

2) 첨부파일은 해당 EDI 문서명 + “_(밑줄)”+“첨부파일 순번”으로 Naming한다.

예) 2009052600001_1.jpg, 2009052600001_2.xls※ EDI파일에는 -(하이픈), 첨부파일에는 _(밑줄)임을 주의

3) KLXFer 송신 디렉터리(send)에 "EDI 파일"과 "첨부파일"을 함께 넣어줘야 한다. (순서는 상관없으나, 첨부파일을 먼저 넣어줄 것을 권장) ※ 첨부파일은 각 1Mbyte이하로 EDI 파일당 4개까지 가능

나. 1개 (EDI) : 1개 또는 수개 (첨부파일)상기 Naming Rule로 인하여 세금계산서 한 장에 첨부파일이 1개 이상 첨부되는 형식이 되어야 한다. 다시 말해 여러 장의 세금계산서를 하나의 EDI문서에 넣은 후, 파일을 첨부할 수는 없다.

(즉, UNB~UNZ내 UNH~UNT가 한번만 들어와야지 수회 루핑 돌아서는 아니된다)* 단, 과세/영세 2장을 연계문서로 묶을 경우에는 예외

다. 연계문서 불필요일반적인 EDI 발행은, 연계문서(KLADDI)를 추가로 전송해 주어야만 하지만, EDI 파일 첨부는

연계문서 없이 가능하다. (즉, 세금계산서 1장에 부가문서를 첨부파일로 전송하는 경우에는 KLADDI문서가 필요없고,따라서 세금계산서 BGM SEGMENT 내 한정어 “COINTX”를 넣어서는 아니된다)

라. 예외사항

단일(B/L등) 거래 건에 과세/영세 2건의 세금계산서가 연계되어 발급되는 경우에는 예외적으로UNB~UNZ 내 UNH~UNT가 3번 루핑도는 것을 허용한다. (이 경우에는 첨부파일 유무에 상관없이 반드시 연계문서(KLADDI)를 전송해 주어야 하고, 과세/영세각각의 세금계산서 및 연계문서 EDI의 BGM SEGMENT에 COINTX 한정어를 넣어주어야만 한다)


케이엘넷- 20 -

1.2 CASE 별설명

Case 1. 세금계산서 한 건에 부가문서를 파일형태로 첨부하는 경우 (일반적인 경우)

(1) 세금계산서 (EDI)

UNBUNH세금계산서UNTUNZ

(2) 나머지 문서들 (모두 첨부파일)


케이엘넷- 21 -

UNB+KECA:1+TESTSEND:KL+TESTBILL:KL+20090108:105523+20090108105523'UNH+1+VATDEC:D:00A:UN'BGM+938+20090427-TEST-00003+9+1'NAD+II++인천광역시 중구 항동 7가 31-4 경기도 안양시 동안구 영업소+㈜흥아로지스틱스인 천 영 업 소:서비스:육상화물대행:최문흠'CTA+AK+:고은비'[email protected]:EM'COM+032-885-6604:TE'RFF+XA:2208102504'FTX+AAI+++TWS:화재보험료?:1000'RFF+VA:1'RFF+AMT:A'RFF+CNO:2'RFF+APG:S'DTM+131:20090106:102'DMS+1::'MOA+23:60000:KRW'DMS+2'MOA+124:6000:KRW'LIN+1++.'NAD+1++20090106::1000원'MOA+1'ARD+.:::창고료'DMS+1:+:::'MOA+23:60000:KRW'GIS+1'DMS+2'MOA+124:6000:KRW'GIS+1'NAD+IV++서울 중구 충무로2가 51-3 인성빌딩 5:5층+씨레일코리아(주):서비스:복합운송주선:허 종'CTA+AK+:고은비'[email protected]:EM'RFF+XA:2208102504'NAD+OF'RFF+XA:2208102504'UNT+34+1'UNZ+1+20090108105523'

(3) EDI 샘플

-단독 세금계산서 발행과 똑같다.


케이엘넷- 22 -

Case 2. 거래명세서(EDI) 한 건에, 다른 문서를 파일 첨부한 경우 (세금계산서가 없는 경우)

(1)거래명세서(EDI)

UNBUNHBGM+780+20090301-TEST-00001+9+1'거래명세서UNTUNZ



케이엘넷- 23 -

UNB+KECA:1+TESTSEND:KL+TESTBILL:KL+20090108:105523+20090108105523'UNH+1+VATDEC:D:00A:UN'BGM+780+20090427-TEST-00026-4+9+1'NAD+II++인천광역시 중구 항동 7가 31-4 경기도 안양시 동안구 영업소+㈜흥아로지스틱스인 천 영 업 소:서비스:육상화물대행:최문흠'CTA+AK+:고은비'[email protected]:EM'COM+032-885-6604:TE'RFF+XA:2208102504'FTX+AAI+++STD:화재보험료?:1000'RFF+VA:1'RFF+AMT:A'RFF+CNO:2'RFF+APG:S'DTM+131:20090106:102'DMS+1::'MOA+23:60000:KRW'DMS+2'MOA+124:6000:KRW'LIN+1++.'NAD+1++20090106::1000원'MOA+1'ARD+.:::창고료'DMS+1:+:::'MOA+23:60000:KRW'GIS+1'DMS+2'MOA+124:6000:KRW'GIS+1'NAD+IV++서울 중구 충무로2가 51-3 인성빌딩 5:5층+씨레일코리아(주):서비스:복합운송주선:허 종'CTA+AK+:고은비'[email protected]:EM'RFF+XA:2208102504'NAD+OF'RFF+XA:2208102504'UNT+34+1'UNZ+1+20090108105523'

(3) EDI 샘플

-단독 거래명세서 발행과 똑같다.


케이엘넷- 24 -

Case 3. 세금계산서 과세/영세 2건에 부가문서가 첨부된 경우 (예외적인 경우)

(1)거래명세서(EDI)

UNBUNHBGM+938+20090301-TEST-00001::COINTX+9+1' (※ BGM에 COINTX를 붙인다)세금계산서(과세)UNTUNHBGM+938+20090301-TEST-00001::COINTX+9+1' (※ BGM에 COINTX를 붙인다)세금계산서(영세)UNTUNHBGM+6KQ:::COINTX+20050728H7003+9+1'연계문서UNTUNZ



케이엘넷- 25 -

UNB+KECA:1+TESTSEND:KL+TESTBILL:KL+20090108:105523+20090108105523'UNH+1+VATDEC:D:00A:UN'BGM+938+20090427-TEST-00025-1::COINTX+9+1'NAD+II++인천광역시 중구 항동 7가 31-4 경기도 안양시 동안구 영업소+(주)흥아로지스틱스 인 천영 업 소:서비스:육상화물대행:최문흠'CTA+AK+:고은비'[email protected]:EM'COM+032-885-6604:TE'RFF+XA:2208102504'FTX+AAI+++TWS:화재보험료?:1000'RFF+VA:1'RFF+AMT:A'RFF+CNO:2'RFF+APG:S'DTM+131:20090106:102'DMS+1::'MOA+23:60000:KRW'DMS+2'MOA+124:6000:KRW'LIN+1++.'NAD+1++20090106::1000원'MOA+1'ARD+.:::창고료'DMS+1:+:::'MOA+23:60000:KRW'GIS+1'DMS+2'MOA+124:6000:KRW'GIS+1'NAD+IV++서울 중구 충무로2가 51-3 인성빌딩 5:5층+씨레일코리아(주):서비스:복합운송주선:허 종'CTA+AK+:고은비'[email protected]:EM'RFF+XA:2208102504'NAD+OF'RFF+XA:2208102504'UNT+34+1'

(3) EDI 샘플

- (1)번의 주의사항을 유념해서 개발한다. UNH 가 3개이다.


케이엘넷- 26 -

UNH+1+VATDEC:D:00A:UN'BGM+938+20090427-TEST-00025-2::COINTX+9+1'NAD+II++인천광역시 중구 항동 7가 31-4 경기도 안양시 동안구 영업소+(주)흥아로지스틱스 인 천영 업 소:서비스:육상화물대행:최문흠'CTA+AK+:고은비'[email protected]:EM'COM+032-885-6604:TE'RFF+XA:2208102504'FTX+AAI+++TWS:화재보험료?:1000'RFF+VA:2'RFF+AMT:A'RFF+CNO:2'RFF+APG:S'DTM+131:20090106:102'DMS+1::'MOA+23:60000:KRW'DMS+2'MOA+124:6000:KRW'LIN+1++.'NAD+1++20090106::1000원'MOA+1'ARD+.:::창고료'DMS+1:+:::'MOA+23:60000:KRW'GIS+1'DMS+2'MOA+124:6000:KRW'GIS+1'NAD+IV++서울 중구 충무로2가 51-3 인성빌딩 5:5층+씨레일코리아(주):서비스:복합운송주선:허 종'CTA+AK+:고은비'[email protected]:EM'RFF+XA:2208102504'NAD+OF'RFF+XA:2208102504'UNT+34+1'UNH+20050728H7003+KLADDI:D:00A:UN'BGM+6KQ:::COINTX+20050728H7003+9+1'RFF+XA: 2208102504'LIN+1++20090427-TEST-00025-1'FTX+ACB+++.'LIN+2++20090427-TEST-00025-2'FTX+ACB+++.'UNT+8+20050728H7003'UNZ+3+20090108105523'

FaxProject Team – fax - KLXFer 메뉴얼 Ver.1.4 · 2015. 5. 21. · KLXFer Install 및Setup...

Documents

Transcript of FaxProject Team – fax - KLXFer 메뉴얼 Ver.1.4 · 2015. 5. 21. · KLXFer Install 및Setup...