주문 API 데이터 타입 – Kakao Shopping Open API

배송비 유형 Code 설명 FREE 무료 PAID 유료 CONDITIONAL_FREE 조건부 무료 QUANTITY_PAID 수량별 부과 더보기

배송지연 사유코드 Code 설명 OUT_OF_STOCK 상품준비중(재고부족) ORDER_MADE 주문제작상품 RESERVED 예약발송 ADDITIONAL_COST 도서산간비 추가입금 ETC 기타 ... 더보기

배송지연 요청 오브젝트 키 타입 필수여부 설명 delayCausation String Y 배송지연 안내사유 delayCausationCode DeliveryCausationCode Y 배송지연사유 코드 deliveryE... 더보기

발송처리 요청 오브젝트 키 타입 필수여부 설명 deliveryInvoiceInfo DeliveryInvoiceInfo Y 배송송장정보 orderId Long Y 주문번호 shippingMethod ShippingMethod Y... 더보기

배송송장정보 오브젝트 키 타입 필수여부 설명 deliveryCompanyCode DeliveryCompanyCode N 택배사코드 invoiceNumber String N 운송장번호 더보기

배송방법 코드 Code 설명 SHIPPING 택배 DIRECT 직접배송 STORE_PICKUP 방문수령 QUICK 퀵서비스 더보기

주문의 기본 정보 오브젝트 키 타입 설명 id Long 주문 번호 paymentId Long 결제 번호 channelType String 채널 구분 값 talkDealOrder String 톡딜여부 groupDiscountRoomId Long 톡딜 그룹번호 status OrderStatus 주문상태 코드 p... 더보기

주문상태 코드 Code 설명 Created 주문 생성 PayRequest 결제 요청 PayWaiting 결제 대기 PayChecking 입금 확인 중 PayFailed 결제 실패 PayComplete 결제 완료 ShippingRequest 배송 요청 P... 더보기

주문의 배송정보 오브젝트 키 타입 설명 confirmedAt DateTime 주문확인 일시 deliveredAt DateTime 배송완료 일시 deliveryCompanyCode DeliveryCompanyCode 택배사코드 deliveryRequestAt DateTime 배송요청 일시 invoiceNumber String ... 더보기

주문의 상품정보 오브젝트 키 타입 설명 id Long 주문 대상 톡스토어/선물하기 상품번호 name String 상품명 sellerItemNo String 판매자가 입력한 판매자 자체 관리용 상품번호 sellerItemOptionCode String 판매자가 입력한 판매자 자체 관리용 옵션 코드 optionContent St... 더보기

주문의 배송지정보 오브젝트 키 타입 설명 필수값 여부 receiverAddress String 수신인 주소 필수 receiverMobileNumber String 수신인 핸드폰번호 필수 receiverName String 수신인 이름 필수 receiverPhoneNumber String 수신인 전화번호 선택 requireme... 더보기

변경 주문내역 조회시 정렬 조건을 제공합니다. Code 설명 ORDER_ID 주문 아이디 MODIFIED_AT 주문 수정일 더보기

변경 주문내역 조회시 정렬 순서를 선택할 수 있습니다. Code 설명 ASC 오름차순 DESC 내림차순 더보기

주문자 정보 오브젝트 키 타입 설명 phoneNumber String 주문자 전화번호 더보기

주문의 이용권/e쿠폰 발송정보 오브젝트 키 타입 설명 ticketConfirmedAt DateTime 주문확인 일시 ticketAcceptedAt DateTime 발송요청 일시 ticketDeliveredAt DateTime 발송처리(완료)일시 더보기

주문의 수신자정보 오브젝트 키 타입 설명 receiverMobileNumber String 수신인 핸드폰번호 receiverName String 수신인 이름 requirement String 요청 사항 더보기

배송비 지불방법 Code 설명 PaymentUponDelivery 착불 PayedToOrder 선불 더보기

클레임 처리 요청 오브젝트 키 타입 필수여부 설명 claimId Long Y 클레임아이디 orderIds Array Y 주문번호 더보기

주문의 취소정보 오브젝트 키 타입 설명 claimId Long 클레임 번호 claimItemId Long 클레임 상세 번호 claimItemStatus ClaimItemStatus 클레임 아이템 상태코드 referType ReferType 클레임요청 경로 createdAt String 취소 요청 일시 형식: yyyyMMdd... 더보기

취소 요청 사유 상품타입 reasonCodeId reasonCodeName 귀책자 배송상품 1 구매의사취소 구매자 배송상품 2 다른상품 잘못주문 구매자 배송상품 3 배송지연 판매자 배송상품 4 상품품절 판매자 배송상품 5 기타(CS 보상) 보상 배송상품 6 배송지 미입력 자동 취소 구매자 배송상품 7 장기 미배송 자동... 더보기

주문의 교환정보 오브젝트 키 타입 설명 claimId Long 클레임 번호 claimItemId Long 클레임 상세 번호 claimItemStatus ClaimItemStatus 클레임 아이템 상태코드 claimRequestUser String 클레임 요청고객 예시: 구매자, 수신자 referType ReferType ... 더보기

교환 요청 사유 reasonCodeId reasonCodeName 귀책자 17 변심에 의한 상품 교환 구매자 18 다른 옵션이나 상품을 잘못 주문함 구매자 19 상품 파손 또는 불량 판매자 20 다른 상품 오배송 또는 구성품 누락 판매자 21 상품정보와 다름 판매자 22 기타(CS 보상) 보상 23 배송지연 판매자 더보기

주문의 반품정보 오브젝트 키 타입 설명 claimId Long 클레임 번호 claimItemId Long 클레임 상세 번호 claimItemStatus ClaimItemStatus 클레임 아이템 상태코드 referType ReferType 접수 경로 reasonCodeName ReturnReasonCodeName 반품 사유 ... 더보기

반품 요청 사유 reasonCodeId reasonCodeName 귀책자 8 변심에 의한 구매의사 취소 구매자 9 다른 옵션이나 상품을 잘못 주문함 구매자 10 배송지연 판매자 11 상품 파손 또는 불량 판매자 12 다른 상품 오배송 또는 구성품 누락 판매자 13 상품정보와 다름 판매자 14 품절로 인한 배송 불가 판... 더보기

교환/반품 배송비 지불 방법 코드 설명 Deducted 환불금에서 차감 AddAmount 상품 반송시 동봉 DirectAmount 판매자에게 직접 송금 BySeller 판매자가 지불 ETC 기타 더보기

수거 방법 Code 설명 AUTO 자동회수 CVS 편의점회수 MANUAL 반송완료 LATER 반송예정 SELLER 판매자 직접 회수 KAKAO 전담택배 NONE 회수 없음(취소) 더보기

클레임 요청 경로 Code 설명 FRONT 사용자 SELLER 판매자 ADMIN 관리자 ETC 기타 더보기

반송 방법 Code 설명 택배 자동수거, 편의점반송, 직접반송완료 반송예정 직접 반송의 송장 정보 미입력 상태 또는 반품 수거방식이 직접배송/퀵배송/방문수령 더보기

보류 사유 Code 설명 RETURN_SHIPPING_FEE 반품배송비 청구 ADDITIONAL_PRICE 추가 비용 청구 DO_NOT_COLLECTED 반품 상품 미수령 EXCHANGE_SHIPPING_FEE 교환배송비 청구 ETC 기타 사유 더보기

이용권/e쿠폰 발송처리 요청 오브젝트 키 타입 필수여부 설명 orderIds Array 필수 주문 번호 더보기