배송조회 API와 배송 접수 API의 차이
- 배송조회 API는 이미 발급된 운송장번호의 집화, 이동, 배송완료 상태를 읽는 용도입니다.
- 배송 접수 API는 주문의 수취인, 주소, 상품, 운임 정보를 택배사에 전달해 접수와 송장 생성을 요청하는 용도입니다.
- 조회 API만 연결해도 송장이 자동으로 발급되는 것은 아니며, 접수 API는 택배사 계약과 필수 입력값 확인이 필요합니다.
WHATTA 실무 가이드
이 가이드에서 확인할 내용택배 API를 검토할 때는 배송 상태를 읽는 조회 API와 실제 주문을 택배사에 접수하는 접수 API를 먼저 구분해야 합니다.
WHATTA는 현재 영카트의 CJ대한통운·우체국 연동을 지원하며, 독립몰과 추가 택배사는 쇼핑몰 구조, 택배사 API 제공 여부와 계약 조건을 확인한 뒤 연동 가능 여부를 검토합니다.
주문 전달부터 송장 반영까지
- 쇼핑몰 주문의 주문번호, 수취인, 주소, 연락처, 상품 정보를 WHATTA 배송 접수 데이터로 전달합니다.
- WHATTA에서 계약정보와 입력값을 확인한 뒤 택배 접수를 진행하고 송장번호를 생성합니다.
- 생성된 송장을 라벨로 출력하고 배송조회에서 상태를 확인합니다.
- 영카트 연동에서는 확인된 송장번호를 주문의 배송 정보에 반영하는 흐름까지 연결합니다.
현재 지원 범위
- 영카트 주문·배송 연동은 CJ대한통운과 우체국 계약소포를 중심으로 지원합니다.
- CJ대한통운은 계약정보 확인, 배송 접수, 송장 생성·출력과 배송조회 흐름을 연결합니다.
- 우체국은 계약소포 인증정보, 접수 입력값, C형 라벨과 배송조회 흐름을 확인합니다.
- 지원 범위에 없는 택배사나 쇼핑몰은 API 제공 여부와 계약 조건을 확인한 뒤 추가 연동을 검토합니다.
독립몰 연동 전 확인할 것
- 주문번호, 상품 목록, 수량, 수취인, 주소, 연락처, 배송메시지의 저장 구조를 확인합니다.
- 주문을 외부로 전달할 API 문서와 인증 방식, 응답 형식, 중복 요청 처리 규칙을 확인합니다.
- 사용하려는 택배사의 계약 여부, 접수 API 제공 여부, 송장 발급 조건을 확인합니다.
- 운영 환경에서 callback 또는 송장번호 반영이 필요한지와 실패 시 재처리 방법을 정리합니다.
추가 연동 상담 시 준비할 자료
- 쇼핑몰 종류와 주문·배송 테이블 또는 API 문서의 필드 설명을 준비합니다.
- 사용 중인 택배사와 계약 상태, 접수·반품·배송조회 중 필요한 업무 범위를 알려주세요.
- 송장번호를 쇼핑몰에 반영하는 방식과 callback, 관리자 확인 등 필요한 결과를 정리합니다.
- API 키, 비밀번호, 실제 고객정보는 공개 문의글에 입력하지 말고 필요한 전달 방식은 상담 과정에서 안내받으세요.
중복·실패 처리와 도입 FAQ
- 같은 주문을 다시 보내면 중복 접수로 처리될 수 있으므로 외부 주문번호와 재전송 기준을 먼저 정해야 합니다.
- 주소나 상품이 바뀐 주문을 다시 전송할 때 기존 접수를 수정하는지 새 주문으로 처리하는지 확인해야 합니다.
- HTTP 응답이 성공이어도 본문에 중복 또는 검토 필요 상태가 담길 수 있어 응답 본문을 함께 확인해야 합니다.
- 현재 지원하지 않는 택배사도 API와 계약 조건을 확인한 뒤 추가 연동 가능 여부를 문의할 수 있습니다.
관련 페이지
설정, 요금, 조회, FAQ를 함께 확인하세요.
