카카오 T 비즈 퀵 호출 가이드

카카오 T 비즈 퀵 호출 이란?
카카오 T 앱 & 웹에 접속하지 않고 고객사 시스템으로 직접 퀵을 호출하고 픽업 & 배송 상태를 확인하실 수 있습니다.
비즈 퀵 호출로 이용, 결제한 내역은 모두 카카오 T 비즈니스 관리 시스템에서 확인할 수 있으며, 관리시스템에서 지정한 예산, 그룹, 결제 수단은 비즈 퀵 호출시 동일하게 적용됩니다.
관리 시스템이란

1. 비즈 퀵 호출

1.1 퀵 이용 프로세스

1.
비즈 퀵 호출을 이용하려면 먼저 그룹을 등록하고, 이용사유 수집 방식을 설정해야 합니다.
그룹 등록
이용사유 사용 여부 설정
그룹 관리 바로가기 → (관리시스템 > 그룹관리 > 그룹등록 > 그룹 및 이용 사유 설정)
2.
그룹 등록, 이용사유 사용 여부 설정이 완료되었다면, 고객사 시스템에서 퀵을 호출할 수 있습니다.
3.
고객사 시스템에서 비즈 퀵을 호출하면 카카오 모빌리티 시스템에서는 픽커를 배정합니다.
픽커란 카카오 T 퀵, 비즈퀵을 배송해주는 전문 배송 기사님입니다.
4.
배정된 픽커는 출발지로 이동하여 물품을 수령(픽업)합니다.
5.
픽커가 물품을 수령(픽업)한 후 도착지로 이동하여 물품을 배송합니다.
6.
대면 배송할 경우 인수자가 인수 서명을 완료했을 때, 비대면 배송할 경우 픽커가 배송 인증 사진을 찍었을 때 퀵 호출이 완료 됩니다.

1.2 퀵 호출 방법

1.
퀵 호출 : 고객사 시스템에서 비즈 퀵을 호출하려면 다음의 항목을 필수로 전달해주셔야 합니다.
배송 상품 : 배송 상품 및 안전 배송 이용 여부를 선택해 주세요.
물품 크기 : 물품 크기를 선택해 주세요.
배송 수단 : 물품 크기에 따라 배송 수단을 선택해 주세요.
출발지 작성 : 출발지 정보를 입력해 주세요.
도착지 작성 : 도착지 정보를 입력해 주세요.
결제 수단 : 퀵 이용요금 결제 수단을 선택해 주세요.
유의 사항: 퀵 호출 시 물품 유의 사항을 입력해 주세요.
상차 옵션 (물품 크기가 대형인 경우)
하차 옵션 (물품 크기가 대형인 경우)
2.
호출 정보 변경 : 퀵 호출 후 정보 변경은 불가합니다. 정보 변경이 필요할 경우 퀵 취소 후 재 호출 해주셔야 합니다.
3.
퀵 호출 취소 : 픽커 배정 전까지는 고객사 시스템에서 호출 취소 가능하며, 픽커 배정 이후부턴 고객센터에 전화주시면 취소 가능합니다.
상태
취소 수수료
취소 방법
픽커 배정 전
없음
고객사 시스템에서 취소
픽커 배정 후 픽커가 (물품 기준) 출발지로 이동하기 전
없음
고객센터에서 취소
픽커가 출발지로 이동 시작 - 출발지 도착 전
배송 요금의 15%
고객센터에서 취소
픽커가 출발지 도착한 이후
배송 요금의 100%
고객센터에서 취소
픽커 취소 : 픽커가 출발지에 도착하기 전까지 픽커앱에서 퀵 주문을 취소할 수 있으며, 고객에게 취소 수수료가 부과되지 않습니다.
취소 불가 : 픽커가 물품을 도착지에 배송 완료 한 경우, 고객사와 픽커 모두 퀵 주문을 취소할 수 없습니다.
4.
픽커 배정 후 취소 시 자동 재배정 : 픽커 배정 후 픽커가 배정 취소 시 퀵 주문이 취소 되지 않고, 최대 3회 까지 자동 재 배정 됩니다.

1.3 퀵 호출 상태

퀵 호출 후 배송 상태 변경 시 Callback Event 가 발생합니다.
1. 픽커 배정 : 픽커 배정 상태 입니다.
2. 픽업 상태 : 픽업 상태 입니다.
3. 배송 상태 : 배송 상태 입니다.

1.4 알림톡, 예상 도착 시간 (ETA)

1.
알림톡 발송 시점 및 대상
알림톡 발송 리스트
발송 시점
발송 대상
예약 도래 -1차
D-1 18시 D-day 예약 주문이 있을 경우
발신자(출발지)
예약취소
예약 상태에서 취소 시
발신자(출발지)
주문 접수
주문 접수 시
발신자(출발지)
픽업 지연
도착 예정 시간 5분 후 1번 발송
발신자(출발지)
픽업 완료
픽업 완료 시
발신자(출발지) 수신자(도착지)
배송 완료
배송 완료 시
발신자(출발지) 수신자(도착지)
배송 취소
시스템, 기사 취소 시
발신자(출발지) 수신자(도착지)
2.
예상 도착 시간 (ETA)
오더 생성 시 : 주문 시간 + 고정값 전달
주문 시간 + 00분 (이용 상품에 따라 + 값은 변동 됨)
기사 출발 ~ 배송 완료 : ETA 전달 (실시간 변경)
예상 도착 시간 (ETA)은 오더 상세 조회 API 를 통해 조회 가능

1.5 퀵 호출 요청 처리

퀵 호출 : 퀵 호출 시 운행 요금 안내
퀵 호출(예약) : 퀵 호출 예약 옵션 설정 가능
퀵 호출 상세 : 호출한 퀵의 상세 정보를 확인 할 수 있습니다.
퀵 호출 리스트 : 퀵 호출 ID, 일자를 통해 조회할 수 있습니다

1.6 주소 처리

1.
주소(문자열) + 위/경도를 모두 전달 하는 경우, 유효성 체크 없이 퀵을 호출합니다.
주소(문자열) : 경기도 성남시 분당구 판교역로 152
상세 주소(문자열) : 알파돔 타워 1층
위도 : 37.4354059
경도 : 126.74551
주소(문자열)과 위/경도가 불일치 할 경우 위/경도를 기준으로 퀵 호출
2.
주소(문자열)만 전달 하는 경우, 카카오 모빌리티 시스템에서 주소 유효성을 체크하며, 체크 후 퀵 호출 가능 여부를 응답합니다.
주소(문자열) : 경기도 성남시 분당구 판교역로 152
상세 주소(문자열) : 알파돔 타워 1층
주소가 유효할 경우, 주소 기준으로 퀵이 호출됩니다.
주소가 유효하지 않을 경우 퀵 호출에 실패하니, 다른 주소로 다시 퀵을 호출해주셔야 합니다.
주소(문자열)만 전달하기로 하였으나 위/경도도 같이 전달 할 경우 주소(문자열) 기준으로 퀵 호출

1.7 정산 처리

상품 이용 요금 결제 방법 : 카카오 T 비즈니스 관리시스템에서 그룹별로 지정한 결제 수단으로 상품 이용 요금이 결제 됩니다.
공용 법인카드 : 상품 이용 요금 발생 시 법인카드로 자동 결제
개인 법인카드 (가상계좌) : 1일 ~ 말일까지 이용 건에 대하여 월 1회 가상계좌를 통해 상품 이용 요금 일괄 결제. 이 방식으로 진행할 시 실제로 개인카드로 결제되는 금액은 없음.
상품 이용 요금을 가상계좌로 납부하려면 별도 계약이 필요합니다.
상품 이용 요금 예산 설정 : 카카오 T 비즈니스 그룹 생성 시, 그룹별로 상품 이용 요금 예산을 설정하실 수 있습니다.

2. 제공 예정된 기능

2.1 추가 요금, 추가 요금 발생 사유

추가 요금이 발생 할 경우 추가 요금 발생 사유 안내 기능 개발 예정
as-is : 추가 요금 발생 시 운임료에 포함해서 결제되며, 부과 금액과 사유 표기되지 않음.

2.2 대형 상품 연동

대형 상품 연동 개발 예정
as-is : 대형 상품 (다마스, 라보, 1톤) 연동 안되고 있음.

3. 개발 연동 방법

개발 가이드 문서와 API 스펙은 API 연동 작업 진행이 확정되면 제공됩니다.
키발급 / ACL : 개발서버 IP, 로컬 작업 PC IP 전달 필요
인증 : 간소화된 HMAC 인증
용어 설명

4. 자주 묻는 질문

퀵 서비스 이용 자주 묻는 질문 → 바로가기
주소만 전송 해도 될까요? 위/경도 전송이 필요 할까요?
API 로 비즈 퀵 호출 시 운행 요금을 사전에 확인할 수 있을까요?
비즈 퀵 오픈 오더 API 이용 시 추가 비용이 발생 할까요?
대형 화물도 접수할 수 있나요?
오토바이 / 승용차로 지정 배차할 수 있나요?
예약 퀵 호출 후 예약 일자를 변경할 수 있나요?
저희가 원하는 기능이 현재 제공되지 않는 것 같아요. 어디에 문의 해야 할까요?
비즈 퀵 오픈 오더 API 연동에는 어느정도 기간이 필요한가요?

5. 비즈 퀵 호출 연동 신청

이메일 문의 : biz.cs@kakaomobility.com 상담 가능 시간 : 평일 10시 - 17시 (주말, 공휴일 제외)