기본정보
| url |
https://{서버도메인}/rtapi/ws_v2.aspx |
| method |
POST |
| 요청데이터 타입 |
form-data |
| 응답데이터 타입 |
JSON |
파라미터 기호 설명
요청 파라미터 이름은 a~z 알파벳 문자와 언더스코어(_)만 사용합니다. 이외의 특수문자(?, ,, |, &, @, $,...)는 파라미터 설명을 위해 사용되었습니다.
| A? |
파라미터 A 생략가능 |
| A, |
파라미터 A의 값을 콤마(,)로 구분해서 여러개 가능. 파라미터 값이 1개일때는 콤마(,)를 생략합니다. |
| A | B |
파라미터 A와 B 중 하나만 사용. |
| A & B |
파라미터 A와 B 모두 사용. |
| a@b |
파라미터 값: 회사명(a)과 모델번호(코드)(b) 결합 |
| a$b |
파라미터 값: 회사코드(a)과 모델번호(코드)(b) 결합 |
V1과 달라진 주요내용
-
가능차량검색의 응답결과에 차량정보, 자차옵션 내용이 추가되었습니다.
(cmd = carsearch, carsearch_r, carNblocksearch, carNblocksearch_r, ...)
-
예약접수할 때 기타상품을 추가할 수 있습니다.
-
자차보험목록, 기타상품목록을 조회할 때 자차요금, 기타상품요금을 계산하여 반환합니다. (sd, ed 필수)
-
모든 응답결과의 내용 중 데이터 타입이 숫자인 경우 따옴표("")가 붙지 않습니다.
(V1) ...,"R모델번호":"1234","R기본입금가":"50000",...
(V2) ...,"R모델번호":1234,"R기본입금가":50000.0000,...
API 목록과 비용
API 비용은 쿼리당 조회하는 렌트사수(R)에 곱하여 계산하며, 모델을 특정하는 경우 모델수(M)을 추가로 곱합니다. 렌트사를 특정하지 않으면 여행사에 연결된 렌트사 수만큼 곱해집니다.
| 작업 |
cmd |
API비용
R:렌트사수, M:모델수 |
| 연결렌트카회사목록 |
companylist |
1/10 |
| 가능차량검색 |
carsearch
carNblocksearch |
1/10 x R
1/8 x R |
| 가능차량검색(모델코드) |
carsearchbymodelcodes
carNblocksearchbymodelcodes |
1/100 x R x M
1/80 x R x M |
| R가능차량검색 |
carsearch_r
carNblocksearch_r |
1/10 x R
1/8 x R |
| R가능차량검색(모델번호) |
carsearchbymodelnumbers_r
carNblocksearchbymodelnumbers_r |
1/100 x R x M
1/80 x R x M |
| 자차보험목록 |
inslist |
1/40 x R |
| R자차보험목록 |
inslist_r |
1/40 x R |
| R기타상품목록 |
etclist_r |
1/20 x R |
| 예약접수 |
revadd |
1/2 |
| 예약변경 |
revupdate |
1/2 |
| 예약취소 |
revcancel |
1/2 |
| 기타상품추가 |
addetcitem |
1/2 |
| 기타상품삭제 |
deletcitem |
1/2 |
| 예약목록 |
revlist |
1/10 |
| 예약정보 |
revdetail |
1/5 |
연결렌트카회사목록
여행사와 연결되어 있는 렌트카회사 목록 조회.
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
companylist
|
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 회사목록 |
list |
|
| 연결번호 |
num |
|
| R렌트회사 |
text |
|
| R거래처 |
text |
렌트사에서 등록한 거래처명으로 API가 연결됨.
|
| 거래상태 |
text |
"정상"이 아닌 경우 노출안됨.
|
| L렌트회사코드 |
text |
|
| R차량수수료 |
num |
백마진 수수료. 입금가의 % |
| R자차수수료 |
text |
백마진 수수료. 입금가의 % |
| R트래픽비용처리 |
text |
API비용 처리방법 |
| R취소가능시간 |
num |
api로 예약의 변경/취소가 가능한 시간 (출발 N시간 전까지 가능) |
| R당일취소허용시간 |
num |
출발당일에 접수한 예약의 취소 가능한 시간 (출발 N분 전까지 가능)
0보다 작으면 취소 불가 |
가능차량검색
렌트사의 해당기간에 이용가능한 "여행사의 차량과 매칭된" 차량목록만 조회.
여행사-렌트카 차량 매칭작업 필수
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
carsearch
carNblocksearch(블럭포함)
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| option_ins? |
num |
0: 자차옵션 제외(기본값)
1: 자차옵션 포함 |
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 차량목록 |
list |
|
| L모델번호 |
num |
|
| L모델명 |
text |
|
| L모델코드 |
text |
|
| L분류 |
text |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R모델번호 |
num |
"예약접수"할 때 mid 값 |
| R모델명 |
text |
|
| R가능수 |
num |
|
| R정요금 |
num |
|
| R입금가 |
num |
자차옵션 미포함 기본 차량요금. "예약접수"할 때 carfeechk 값
|
| R옵션1입금가 |
num |
자차옵션1이 포함된 차량요금. "예약접수"할 때 carfeechk 값
|
| R옵션2입금가 |
num |
자차옵션2가 포함된 차량요금. "예약접수"할 때 carfeechk 값
|
| R자차옵션 |
text |
차량의 자차옵션 설정. "자차옵션1이름/자차옵션2이름" 형식. 값이 없으면 자차옵션이 설정되지 않음.
|
| R모델옵션 |
text |
차량의 각종 옵션 목록. 콤마(,)로 구분됨. |
| R연료 |
text |
휘발유,경유,전기,LPG,하이브리드 |
| R승차인원 |
num |
|
| R연식 |
text |
숫자범위: 최대~최소. |
| R변속기 |
text |
자동,수동 |
| R구동방식 |
text |
4륜,전륜,후륜 |
| R배기량 |
num |
|
| R가능연령 |
num |
나이 |
| R운전경력 |
num |
년 단위 |
| R자차옵션목록 |
list |
|
| R보험명 |
text |
|
| R보상한도 |
text |
|
| R면책금 |
text |
|
| R휴차보상료 |
text |
|
| R가능나이 |
num |
|
| R운전경력 |
num |
|
| R옵션포함요금 |
num |
자차옵션이 포함된 차량요금. "예약접수"할 때 carfeechk 값. |
| R예약접수코드 |
num |
"예약접수"할 때 option_ins 값 |
가능차량검색(모델코드)
렌트사의 해당기간에 이용가능하고 "해당 모델코드와 매칭된" 차량목록만 조회.
여행사-렌트카 차량 매칭작업 필수
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
carsearchbymodelcodes(모델코드)
carNblocksearchbymodelcodes(블럭포함,모델코드)
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| option_ins? |
num |
0: 자차옵션 제외(기본값)
1: 자차옵션 포함 |
| mcode, |
text |
여행사 모델코드. 아래와 같이 회사명(또는 회사코드)와 결합하여 사용할 수 있다. |
mcode 회사명(또는 회사코드) 결합방법:
회사명a@모델코드1,회사명b@모델코드2,회사명c@모델코드3 또는
회사코드a$모델코드1,회사코드b$모델코드2,회사코드c$모델코드3
이때 rcname | rccode와 함께 사용할 수 없음.
|
| Response |
|
가능차량검색 응답항목과 동일
|
R가능차량검색
렌트사의 해당 기간에 이용 가능한 "모든" 차량목록 조회.
여행사-렌트카 차량 매칭작업 불필요.
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
carsearch_r
carNblocksearch_r(블럭포함)
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| option_ins? |
num |
0: 자차옵션 제외(기본값)
1: 자차옵션 포함 |
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 차량목록 |
list |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R모델번호 |
num |
"예약접수"할 때 mid 값 |
| R모델명 |
text |
|
| R가능수 |
num |
|
| R정요금 |
num |
|
| R입금가 |
num |
자차옵션 미포함 기본 차량요금. "예약접수"할 때 carfeechk 값
|
| R옵션1입금가 |
num |
자차옵션1이 포함된 차량요금. "예약접수"할 때 carfeechk 값
|
| R옵션2입금가 |
num |
자차옵션2가 포함된 차량요금. "예약접수"할 때 carfeechk 값
|
| R자차옵션 |
text |
차량의 자차옵션 설정. "자차옵션1이름/자차옵션2이름" 형식. 값이 없으면 자차옵션이 설정되지 않음.
|
| R모델옵션 |
text |
차량의 각종 옵션 목록. 콤마(,)로 구분됨. |
| R연료 |
text |
휘발유,경유,전기,LPG,하이브리드 |
| R승차인원 |
num |
|
| R연식 |
text |
숫자범위: 최대~최소. |
| R변속기 |
text |
자동,수동 |
| R구동방식 |
text |
4륜,전륜,후륜 |
| R배기량 |
num |
|
| R가능연령 |
num |
나이 |
| R운전경력 |
num |
년 단위 |
| R자차옵션목록 |
list |
|
| R보험명 |
text |
|
| R보상한도 |
text |
|
| R면책금 |
text |
|
| R휴차보상료 |
text |
|
| R가능나이 |
num |
|
| R운전경력 |
num |
|
| R옵션포함요금 |
num |
자차옵션이 포함된 차량요금. "예약접수"할 때 carfeechk 값. |
| R예약접수코드 |
num |
"예약접수"할 때 option_ins 값 |
R가능차량검색(모델번호)
렌트사의 해당 기간에 이용 가능하고 “해당 모델번호의” 차량목록 조회.
여행사-렌트카 차량 매칭작업 불필요.
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
carsearchbymodelnumbers_r(모델번호)
carNblocksearchbymodelnumbers_r(블럭포함,모델번호)
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| option_ins? |
num |
0: 자차옵션 제외(기본값)
1: 자차옵션 포함 |
| mid, |
text |
렌트사 모델번호. 아래와 같이 회사명(또는 회사코드)와 결합하여 사용할 수 있다. |
mid 회사명(또는 회사코드) 결합방법:
회사명a@모델번호1,회사명b@모델번호2,회사명c@모델번호3 또는
회사번호a$모델번호1,회사번호b$모델번호2,회사번호c$모델번호3
이때 rcname | rccode와 함께 사용할 수 없음.
|
| Response |
|
R가능차량검색 응답항목과 동일
|
자차보험목록
렌트사의 해당 기간에 이용가능하고 "여행사의 보험과 매칭된" 자차보험만 조회.
여행사-렌트카 자차보험 매칭작업 필수.
(new)보험요금계산
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
inslist
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| mocode,? |
text |
여행사 차량코드와 연결된 자차보험 조회 |
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 보험목록 |
list |
|
| L보험번호 |
num |
|
| L모델번호 |
num |
|
| L모델코드 |
text |
|
| L보험명 |
text |
|
| L보험코드 |
text |
|
| L보험내용 |
text |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R보험번호 |
num |
"예약접수"할 때 insid 값
|
| R보험명 |
text |
|
| R보험타입 |
text |
|
| R보상한도 |
text |
|
| R면책금 |
text |
|
| R휴차보상료 |
text |
|
| R가입제한 |
text |
|
| R보험내용 |
text |
|
| R가능나이 |
num |
|
| R운전경력 |
num |
|
| R보험요금 |
num |
"예약접수"할 때 insfeechk 값.
|
| R적용모델 |
text |
보험가능 R모델번호(콤마(,)구분). "예약접수"할 때 mid가 포함 확인. |
R자차보험목록
렌트사의 해당 기간에 이용가능하고 "모든" 자차보험 조회.
여행사-렌트카 자차보험 매칭작업 불필요.
(new)보험요금계산
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
inslist
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| mid,? |
text |
렌트사 모델번호 관련 자차보험 조회 |
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 보험목록 |
list |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R보험번호 |
num |
"예약접수"할 때 insid 값
|
| R보험명 |
text |
|
| R보험타입 |
text |
|
| R보상한도 |
text |
|
| R면책금 |
text |
|
| R휴차보상료 |
text |
|
| R가입제한 |
text |
|
| R보험내용 |
text |
|
| R가능나이 |
num |
|
| R운전경력 |
num |
|
| R보험요금 |
num |
"예약접수"할 때 insfeechk 값.
|
| R적용모델 |
text |
보험가능 R모델번호(콤마(,)구분). "예약접수"할 때 mid가 포함 확인. |
R기타상품목록
렌트사의 해당 기간에 이용가능하고 "모든" 기타상품 목록 조회.
자차특약 상품: 기타상품 목록중에서 'R상품분류' = "자차특약"
(new)상품요금계산
| Request |
| uid |
text |
api 관리자 로그인 id |
| passcode |
text |
api 관리자 여행사 정보 참고 |
| cmd |
text |
etclist_r
|
| (rcname | rccode),? |
text |
렌트회사명 | 렌트회사코드. 기본값 모든 회사. |
| sd |
text |
출발일시. yyyymmddhhmm 형식. |
| ed |
text |
반납일시. yyyymmddhhmm 형식. |
| mid,? |
text |
rcname | rccode와 같이 사용 불가. '회사명@모델번호' 또는 '회사코드$모델번호'를 콤마(,)로 구분하여 배열 사용. |
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| 상품목록 |
list |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R상품번호 |
num |
"예약접수"할 때 gid 값
|
| R상품분류 |
text |
|
| R상품명 |
text |
|
| R상품내용 |
text |
|
| R상품요금 |
num |
"예약접수"할 때 etcfeechk 값 |
| R적용모델 |
text |
"전체" 또는 R모델번호 배열 |
예약접수
렌트회사에 새예약 접수. 접수시점 새로 계산된 현재요금으로 예약이 접수됩니다.
예약요금 체크: 현재요금과 체크값이 같아야 예약접수 가능. 차량료(자차옵션포함)=carfeechk, 자차료=insfeechk, 기타요금합=etcfeechk
예약요금 체크 무시: 요청 파라미터 ignorefeechkunder 참고. 현재요금이 체크값보다 작을 때만 적용.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
revadd
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| sd |
text |
|
출발일시. yyyymmddhhmm 형식.
|
| ed |
text |
|
반납일시. yyyymmddhhmm 형식.
|
| mid |
num |
|
렌트사 R모델번호.
|
| (option_ins | insid)? |
num |
|
자차옵션 접수코드 | 자차보험 R보험번호.
option-ins: 가능차량검색 결과에서 'R자차옵션접수코드'. (1~2)
|
| gid,? |
num |
|
기타상품 R상품번호. 복수 가능.
|
| carfeechk |
num |
|
차량요금 체크
|
| etcfeechk? |
num |
|
기타요금합 체크. 기타상품이 여러개일 때 합계 요금. gid가 있을 때 필수.
|
| insfeechk? |
num |
|
자차요금 체크. 자차보험이 추가된 경우 (insid>0) 필수.
|
| ignorefeechkunder? |
num |
0~1 |
0: 요금체크 실행 (기본값)
1: 요금체크 무시 (현재요금이 체크값보다 작을 때만 적용)
|
| custfee? |
num |
|
직불예정금액 (기본값: 요금합계). 주의직불금액이 0일 때 반드시 custfee=0 보내야 함.
|
| uname |
text |
~50 |
예약자 이름.
|
| phone |
text |
|
예약자 전화번호.
|
| email? |
text |
~100 |
예약자 이메일?
|
| sp? |
text |
~100 |
출발장소
|
| ep? |
text |
~100 |
반납장소
|
| memo? |
text |
~300 |
전달사항 메모
|
| revstate? |
text |
|
예약상태. 예약대기(기본값),예약중,예약확정 중 택1.
|
| uname1? |
text |
~50 |
추가 예약자 이름.
|
| phone1? |
text |
|
추가 예약자 전화번호.
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호
|
| blockrev? |
num |
0~1 |
0: 일반예약 우선 (기본값)
1: 블럭예약 우선
|
| Response (예약접수, 예약변경, 예약정보, 기타상품추가/삭제 공통) |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| L회사코드 |
text |
|
| R렌트회사 |
text |
|
| R예약번호 |
text |
|
| R예약상태 |
text |
|
| R예약일시 |
date |
|
| R예약변경가능시간 |
date |
|
| R이름 |
text |
|
| R전화번호 |
text |
|
| R전달사항 |
text |
|
| R모델번호 |
num |
|
| R모델명 |
text |
|
| R자차옵션 |
text |
|
| R자차보험 |
text |
|
| R기타상품 |
text |
상품명을 콤마(,)로 구분 |
| R출발일시 |
date |
|
| R반납일시 |
date |
|
| R출발장소 |
text |
|
| R반납장소 |
text |
|
| R차량료 |
num |
|
| R자차료 |
num |
|
| R기타요금 |
num |
|
| R요금합계 |
num |
|
| R직불예정금액 |
num |
|
| R후불금액 |
num |
|
| R거래처납입 |
num |
|
| R거래처미납 |
num |
|
예약변경
렌트회사의 기존 예약된 예약내용을 변경. 예약정보에서 반환되는 'R예약변경가능시간' 이전에 가능.
요금관련 업데이트(mid 포함하는 경우)는 렌트사의 권한이 필요합니다.
예약의 요금합계 요금체크(feesumchk) 필요.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
revupdate
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| revnum |
text |
|
예약번호
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호.
|
| memo? |
text |
~300 |
전달사항 메모. 기존 내용을 '덮어쓰기'하므로 전체 내용을 보내야 합니다.
|
| revstate? |
text |
|
예약상태. 예약대기(기본값),예약중,예약확정 중 택1.
|
| sp? |
text |
~100 |
출발장소
|
| ep? |
text |
~100 |
반납장소
|
| mid? |
num |
|
렌트사 모델번호.
|
| sd? |
text |
|
출발일시. yyyymmddhhmm 형식.
|
| ed? |
text |
|
반납일시. yyyymmddhhmm 형식.
|
| (option_ins | insid)? |
num |
|
자차옵션 접수코드 | 자차보험 R보험번호.
값을 생략하면 (자차옵션|자차보험) 삭제.
|
| custfee? |
num |
|
직불예정금액.
|
| feesumchk? |
num |
|
요금합계 요금체크. mid 또는 custfee 값이 있으면 필수.
|
| ignorefeechkunder? |
num |
0~1 |
0: 요금체크 실행 (기본값)
1: 요금체크 무시 (현재요금이 체크값보다 작을 때만 적용)
|
주위 차종(mid) 또는 예약시간(sd,ed) 또는 자차옵션(보험)(option_ins | insid) 변경일 때,
차종, 예약시간, 자차옵션(보험)의 "최종상태" (mid, sd, ed, (option_ins | insid)?)를 보내야 합니다.
mid, sd, ed는 필수이며, (option_ins | insid)는 자차옵션(보험)을 삭제할때는 생략 가능.
mid 값이 있고 (option_ins | insid) 값이 없으면 자차옵션(보험)은 삭제됩니다.
|
| Response |
|
예약접수 응답항목과 동일
|
예약취소
렌트회사의 기존의 예약을 취소. 예약정보에서 반환되는 'R예약변경가능시간' 이전에 가능.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
revcancel
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| revnum |
text |
|
예약번호
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호.
|
| cancelmemo? |
text |
~200 |
예약취소 사유.
|
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R예약번호 |
text |
|
| R예약상태 |
text |
|
| R취소사유 |
text |
|
기타상품추가
렌트회사의 기존 예약에 기타상품을 추가.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
addetcitem
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| revnum |
text |
|
예약번호
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호.
|
| gid |
num |
|
기타상품 R상품번호
|
| etcfeechk |
num |
|
상품요금 요금체크.
|
| ignorefeechkunder? |
num |
0~1 |
0: 요금체크 실행 (기본값)
1: 요금체크 무시 (현재요금이 체크값보다 작을 때만 적용)
|
| iscustfee? |
num |
0~1 |
해당 상품요금이 직불/후불 선택
0: 후불
1: 직불 (기본값)
|
| Response |
|
예약접수 응답항목과 동일
|
기타상품삭제
렌트회사의 기존 예약에서 기타상품 삭제.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
deletcitem
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| revnum |
text |
|
예약번호
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호.
|
| gname |
num |
|
예약된 기타상품 상품명
|
| Response |
|
예약접수 응답항목과 동일
|
예약목록
렌트회사에 예약된 해당 기간의 예약목록을 조회.
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
revlist
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| (sd & ed)? |
text |
|
시작일 & 종료일. yyyymmdd 형식. (기본값: 오늘)
|
| acceptdate? |
num |
0~1 |
0: 출발일 기준(기본값)
1: 접수일 기준
|
| withcancel? |
num |
0~1 |
0: 취소 제외(기본값)
1: 취소 포함
|
| page? |
num |
|
페이지 번호 (기본값: 1).
|
| pagecount? |
num |
|
한 번에 읽어오는 예약수 (기본값: 100).
|
| Response |
| resCode |
text |
응답코드
|
| resMsg |
text |
응답코드
|
| resId |
text |
요청고유번호
|
| resTime |
text |
응답시간
|
| Page |
num |
페이지 번호 |
| PageCount |
num |
한 번에 읽어오는 예약수 |
| TotalCount |
num |
해당 기간의 전체 예약수 |
| 예약목록 |
list |
|
| L렌트회사코드 |
text |
|
| R렌트회사 |
text |
|
| R예약번호 |
text |
|
| R모델번호 |
num |
|
| R모델명 |
text |
|
| R출발일시 |
date |
|
| R반납일시 |
date |
|
| R이름 |
text |
|
| R전화번호 |
text |
|
| R예약일시 |
date |
|
| R예약상태 |
text |
|
| R차량료 |
num |
|
| R자차료 |
num |
|
| R기타요금 |
num |
|
| R요금합계 |
num |
|
| R직불예정금액 |
num |
|
| R거래처미납 |
num |
|
| R예약경로 |
text |
"실시간API": api를 통해서 접수한 예약
|
| R거래처예약번호 |
text |
|
예약정보
렌트회사에 기존 예약의 상세정보 조회
| Request |
| uid |
text |
|
api 관리자 로그인 id |
| passcode |
text |
|
api 관리자 여행사 정보 참고 |
| cmd |
text |
|
revdetail
|
| rcname | rccode |
text |
|
렌트회사명 | 렌트회사코드
|
| revnum |
text |
|
예약번호
|
| dealerrevnum? |
text |
~50 |
여행사 예약번호.
|
| Response |
|
예약접수 응답항목과 동일
|
응답코드,메시지
| resCode |
resMsg |
설명 |
| 0000 |
성공 |
|
| 1000 |
NO AUTH |
uid, passcode 확인. 그리고 요청 파라미터의 데이터 타입이 form-date인지 확인. |
| 1002 |
NO AUTH (IP 인증회수 초과) |
하나의 IP에서 인증이 10회 이상 실패. 이때 IP 차단됨. |
| 1003 |
NO AUTH (미등록 IP) |
미등록 IP에서 요청할 때 |
| 2000 |
작업명령 없음 |
cmd 확인 |
| 3000 |
호출수 제한 |
정해진 호출수를 초과할 때 |
| 0111 |
예약가능시간 확인(a~b) |
하루중 a시부터 b시까지 출발/반납 가능 |
| 0112 |
예약가능기간 확인(a~b) |
a일부터 b일까지 예약가능 |
| 0113 |
최대사용시간(a) |
사용시간이 a시간을 초과할 때 |
| 0114 |
당일예약 가능시간 확인(a) |
출발시간이 '현재시간 + a분'보다 커야 함. |
| 0120 |
렌트회사정보 없음 |
rename | rccode 확인 |
| 0121 |
차량모델 확인 |
mid 확인 |
| 0122 |
자차보험 없음 |
insid 확인 |
| 0123 |
차량모델의 자차옵션 없음 |
예약기간에 자차옵션이 설정되지 않음 |
| 0124 |
자차보험 사용기간 초과 |
일부 자차보험 요금계산법(357일, 12345일)은 최대 사용일이 7일. |
| 0125 |
자차보험 중복 |
option_ins와 insid 동시 사용 불가. |
| 0126 |
차량모델 중복 |
mid, carnum 동시사용 불가 |
| 0127 |
기타상품 없음 |
새로 추가되는 기타상품(gid) 정보가 없거나 차종 제한. |
| 0128 |
기타상품 중복 |
새로 추가되는 기타상품(gid)이 이미 추가됨. |
| 0129 |
자차보험 중복 |
예약에 자차보험이 2개이상 예약된 경우 예약변경 불가. |
| 0130 |
거래처 예약번호 중복 |
|
| 0131 |
거래처 예약번호 글자수 제한 |
최대 50자 |
| 0200 |
예약마감 |
|
| 0300 |
예약요금 계산 오류 |
|
| 0310 |
예약요금 체크 오류 |
carfeechk, insfeechk, etcfeechk, feesumchk 확인. 현재요금과 체크값이 다른 경우. (오차범위 100원) |
| 0311 |
예약요금 오류 |
요금설정 안됨. 현재요금이 0원일 때 |
| 0320 |
예약요금 직접입력 불가 |
렌트사로부터 요금입력 권한 필요. |
| 0321 |
예약변경 권한 필요 |
요금관련 예약변경 권한 필요 |
| 0400 |
예약접수/변경/취소 DB처리 오류 |
|
| 0500 |
예약정보 없음 |
rcname | rccode | revnum 확인 |
| 0501 |
예약정보 없음(dealerrevnum) |
dealerrevnum 확인 |
| 0510 |
기타상품 예약없음 |
삭제하는 상품명(gname)으로 예약된 기타상품 없음 |
| 0511 |
기타상품 예약 중복(2개이상) |
삭제하는 상품명(gname)으로 예약된 기타상품 2개 이상일 때 |
| 0601 |
예약취소/변경 불가(취소가능시간) |
예약정보에서 반환되는 R예약변경가능시간 이후 불가 |
| 0610 |
예약취소/변경 불가(예약상태) |
이미 취소 또는 대여중인 예약은 취소 불가 |
| 0611 |
예약변경 불가(기타상품) |
변경 차종이 기타상품 제한으로 차종 변경불가. |
| 0612 |
예약변경 불가(자차보험) |
예약에 자차보험이 2개이상 예약된 경우 예약변경 불가. |
| 0620 |
취소사유 글자수 제한 |
최대 200자 |
| 0700 |
서버점검 중 |
매일 04:00 ~ 04:30까지 접수/변경/취소 불가 |
| 9100 |
파라미터 오류 (param) |
해당 파라미터(param)이 없거나 데이터 형식 오류 |
| 9200 |
API 권한 필요 |
|
| 9800 |
NO Result |
|
| 9999 |
서버 내부 오류 |
|