LCSV2 전자상거래 API

국제특송 수입 관세사용 API

관세사용 솔루션 XML / HTTPS Live

LCSV2 전자상거래 API

로그인네트웍의 LCSV2(관세사무소 솔루션)에서 제공하는 전자상거래 시스템과 특송사 시스템 간 연계 API 입니다. 확정 주문 정보 전송과 통관 정보 조회를 위한 전송 항목·송수신 방법·문서 규격을 정의합니다.

Version
v2.0
Author
개발팀
Endpoints
2
Format
XML

송수신 방법

표준화된 XML 메시지를 HTTP(S) POST 로 송수신합니다.

HTTP 헤더
  • MethodPOST
  • Content-Typeapplication/xml
  • Accept-CharsetUTF-8
본문 형식
  • HTTP Body 에 표준 XML 문서를 탑재
  • M 필수값 / C 선택값
  • 개인정보 파라미터는 암호화 후 전달
  • Sample code 와 Key 는 별도 제공

인증

발급받은 파트너 고유 키를 HTTP Header 에 담아 호출합니다.

항목 위치 타입 필수 설명
X-API-KEY Header String M 발급받은 파트너 고유 API Key
X-API-SECRET Header String M 발급받은 파트너 고유 비밀키 
# Request example
POST /v01/customs/customsShipmentRequest HTTP/1.1
Host: api.tlogin.net
Content-Type: application/xml
Accept-Charset: UTF-8
X-API-KEY: {your_api_key}
X-API-SECRET: {your_api_secret}
POST /v01/customs/customsShipmentRequest Bulk · 최대 500건

수입 신고 요청 정보 전송

특송사 → 관세사. 확정된 주문 정보를 일괄 전송합니다 (최대 500개 주문).

필드 Type Size 필수 설명
POST /v01/customs/customsInfoRequest Query

통관 정보 요청

특송사 → 관세사. 운송장번호 목록에 대한 통관 결과 및 부속 정보를 조회합니다.

필드 Type Size 필수 설명

별첨 1 · 관세사무소 목록

API 연동이 가능한 관세사무소와 GroupId 매핑입니다.

15개 사무소
GroupId 상호명

별첨 2 · 개인정보 암호화

ENCRYPTED 표시된 파라미터는 AES 알고리즘으로 암호화하여 전송합니다.

Encryption Key
y8jvsoqluzrgkyb4
Initial Vector (IV)
0123456789abcdef
Java Sample · AES/CBC/PKCS5Padding
참고용 
// AES/CBC/PKCS5Padding 으로 개인정보 암호화 후 Base64 인코딩
String raw    = "홍길동";
SecretKeySpec key   = new SecretKeySpec("y8jvsoqluzrgkyb4".getBytes(), "AES");
IvParameterSpec iv  = new IvParameterSpec("0123456789abcdef".getBytes());
Cipher cipher       = Cipher.getInstance("AES/CBC/PKCS5Padding");
cipher.init(Cipher.ENCRYPT_MODE, key, iv);
byte[] enc        = cipher.doFinal(raw.getBytes("UTF-8"));
String encoded    = Base64.getEncoder().encodeToString(enc);

별첨 3 · 요청 XML Sample

실제 API 호출에 사용되는 XML 메시지의 전체 예시입니다.

POST customsShipmentRequest
수입 신고 요청 정보 전송 

                            

                        

                    


                    

                        

                            

                                POST
                                customsInfoRequest
                            

                            통관 정보 요청
                        

                        

                            

                                
                                

                            

                        

                    

                

            


            
            

                
변경 이력

                

                    

                        
                            

                                시간
                                버전
                                수정인
                                설명
                            

                        
                        
                            
2021.07.10v1.0개발팀초안 작성

                            
2023.11.05v1.1조재식API 테스트 데이터 기반으로 문서 작성

                            
2026.04.28v2.0개발팀API 인증방식 변경 및 전송데이터중 개인정보 항목 전체 암호화