배송/환불 API – Open APIs

송장 업로드 시 INVALID_STATUS 라는 오류가 반환됩니다. 어떻게 해야 합니까?

주문상태가 상품준비중(INSTRUCT) 상태가 아닌 주문에 송장 업로드 시 아래와 같이 "배송진행상태가 유효하지 않습니다.(INVALID_STATUS)" 라는 오류가 발생합니다. 만일 주문 상태가 결제완료(ACCEPT)일 경우 상품준비중 처리 API를 이용하여 상품준비중(INSTRUCT) 상태로 변경하시기 바랍니다. 배송지시(DEPARTURE) 상태의... 더보기

주문이 상품 준비중 상태일 때 배송지 변경이 가능한가요?

고객에 의한 배송지 변경은 주문이 결제완료 단계에서만 가능합니다. 결제완료 단계에서 주문서를 수집한 경우 상품준비중 처리 이후에 발주서 단건 조회를 통해 배송지 정보가 변경되었는지 반드시 확인 해야합니다. 더보기

상품준비중 처리 API 호출 시 '성공' 메시지를 리턴 받았지만 WING에서는 계속 '결제완료'상태로 노출됩니다.

인입되는 주문량이 급증하여 일부 시스템 지연이 발생하는 경우가 있습니다. 통상적으로는 지연이 발생하더라도 30분 이내에 처리가 되고 있습니다. 상품준비중처리 후 1시간이상 경과 후에도 상태가 변경되지 않는 경우 온라인 문의를 부탁드립니다. 더보기

출고 중지 완료 처리를 하려고 합니다. cancelCount 파라미터에 어떤 숫자를 넣어야 하나요?

cancelCount 파라미터는 출고 중지될 수량입니다. 접수 번호 단위로 카운트를 입력해주시면 됩니다. ex) Q. 고객이 1개의 order에서 A상품 2개, B상품 3개를 출고중지 요청하여 출고 중지 완료 처리를 하려고 합니다. cancelCount 파라미터에 들어갈 값은 5인가요 2인가요?A. 접수 번호 (receiptId) 단위 이기때문에 5를... 더보기

발주서 수집 시, splitShipping과 ableSplitShipping가 노출됩니다. 정확히 무슨차이인지 모르겠습니다.

- splitShipping : 분리배송 처리가 된 건인지를 나타냅니다. - ableSplitShipping : 분리배송 처리가 가능한 건인지를 나타냅니다. 자세한 분리배송 관련된 내용은 FAQ "분리배송을 하고 싶습니다." 항목을 확인해주시기 바랍니다. 더보기

업체직송(DIRECT) 송장 등록 시, 배송완료처리가 되지 않습니다.

택배사 코드를 업체직송(DIRECT)으로 넣으신 경우에는 배송 완료 처리가 되지 않습니다.이는 정상 프로세스이며, 송장 트래킹이 불가능하기 때문입니다.배송 완료 처리가 되지 않더라도, 7일 후 정상적으로 매출 인식 처리됩니다. 더보기

주문 후 부분 취소 시, 발주서에 해당 내용이 반영되나요?

발주서 조회 시 나오는 shippingCount는 반품 수량이 반영되지 않은 최초 구매 수량이 노출됩니다. 반품된 수량은 cancelCount에 표시됩니다. shippingCount = 주문시 item의 구매 수량 holdCountForCancel = 취소가 되어 환불 예정이 수량 cancelCount = 취소가 확정된 수량 발주 가능 수량 = s... 더보기

출고중지 완료 처리 API는 어떤 상황에서 사용하나요?

아직 상품을 발송하지 않아, 고객 요청대로 상품을 출고하지 않을 예정일 때 선택합니다. (이미 상품을 발송했다면 [이미출고 처리 API]를 호출합니다.) 더보기

배송상태를 변경할 수 없습니다. 주문내역을 확인해주세요. 라는 에러가 노출됩니다.

전체 결제 취소 또는 부분 결제 취소를 통해 환불이 진행 중인 주문이 있을 때 노출되는 에러입니다. 해당 발주서 내역을 재확인해주시기 바랍니다. 더보기

발주서 수집 시, shipmentBoxId와 orderId가 노출됩니다. 정확히 무슨차이인지 모르겠습니다.

주문을 생성하면, 한 개의 orderId(주문번호)가 생성됩니다. 해당 주문 건 안에 있는 상품의 묶음 배송 단위마다 shipmentBoxId(묶음배송 번호)가 생성됩니다. 더보기

salesPrice(개당상품가격), orderPrice(결제가격), discountPrice(할인가격)이 각각 무엇을 의미지하는지 잘 모르겠습니다.

- salesPrice : 해당 상품의 1개당 판매 가격입니다. - orderPrice : salesPrice x shippingCount 로 개별 단가와 주문 수량의 곱입니다.- discountPrice : 즉시할인쿠폰, 또는 장바구니/카테고리 쿠폰 등이 반영되어 할인받은 금액입니다.쿠팡은 기본적으로 일반 판매자의 장바구니/카테고리 쿠폰을 적용하지 ... 더보기

출고중지 완료 처리를 receiptId 단위가 아닌, 아이템 단위로는 할 수 없나요?

네, 출고중지를 비롯한 이미출고 처리 API 등은 receiptId 단위로만 처리 가능합니다. 더보기

[INTERNAL_SERVER_ERROR] 취소반품접수수량과 cancelCount가 일치하지 않습니다. 라는 에러가 발생합니다.

해당 취소 접수 건에 설정된 취소 수량과, 출고중지 완료 처리한 수량이 상이합니다. 요청된 수량과 동일한 값을 호출해주시기 바랍니다. 더보기

송장 업로드가 되지 않습니다 - "이미 저장된 송장번호가 있어, 송장번호 등록이 불가능합니다. (동일송장번호 업로드 조건 : 수취인정보 동일)"

쿠팡은 6개월 내에 동일한 송장번호가 등록되었는지 유효성 체크를 하고 있습니다.만약, 유효한 송장번호를 입력하였으나 해당 오류로 인해 등록이 불가한 경우에는 택배사 코드를 DIRECT로 넣고, 송장 업로드를 진행해주시기 바랍니다. "deliveryCompanyCode": "DIRECT",<DIRECT로 입력한 경우>송장 트래킹이 불가능합니다. 다만,... 더보기

분리배송을 하고 싶습니다.

분리배송을 위한 예시문을 작성하였습니다. ex) 주문 예시 상황 <고객이 2개의 다른 상품을 한번에 묶음배송으로 구매하였으나 분리 배송 처리가 필요한 경우> 먼저 보낼 상품A(vendorItemId A),나중에 보낼 상품B (vendorItemId B)라고 가정 { "vendorId": "A00011111", "orderSheetInvoiceApp... 더보기

주문에 운송장을 업로드할 때 "500 internal exception" 에러가 발생합니다.

"500 internal exception" 오류는 잘못된 택배사 코드를 입력했을 경우에 발생했을 가능성이 큽니다. 운송장 업로드 시 deliveryCompanyCode 필드에 아래 페이지의 택배사코드 중 하나를 사용하고 있는지 확인하십시오. 택배사 코드 더보기

발주서 수집 시, 배송지를 표시하는데 있어 지번/도로명의 구분이 따로 없는건가요?

네, 지번/도로명 구분은 따로 없습니다. 더보기

발주서 목록에서 반품 내용을 확인할 수 없습니다.

반품 내용은 [반품 / 취소 요청 조회 목록 API] 를 이용해야 합니다. 만약, A오더 건이 배송 완료 이후에 반품이 이뤄졌다면, 발주서 목록과 반품 요청 목록 조회 두 곳에 A오더 건에 대한 정보가 남아 있습니다. 더보기

분리배송 설정한 상품을 다시 합포장 설정할 수 있나요?

이미 분리배송 처리된 주문 건을 다시 합포장 처리할 수 없습니다. 더보기

배송진행상태가 유효하지 않습니다. 에러가 발생합니다.

배송상태가 "상품준비중" 상태가 아닐 때 송장을 업로드 하면 해당 에러가 발생합니다. 송장을 업로드하려는 상품의 상태가 "상품준비중(INSTRUCT)" 인지 확인해주시기 바랍니다. 더보기

조건부 무료배송을 설정하고 싶습니다.

<조건부 무료배송 설정 시>- 기본배송비와 반품배송비 금액을 설정해야 합니다.- 초도반품배송비는 0원으로 설정해야합니다. - 반품 시, 고객에게 청구되는 배송비는 "기본배송비 + 반품배송비"입니다. <배송비 종류> 3가지 모두 편도이며, 배송비 조건에 맞는 배송비를 설정해주셔야 합니다. - 초도반품배송비 (deliveryChargeOnReturn) ... 더보기

주문을 만들고 조회를 해보았는데, 주문건이 조회되지 않습니다.

일반적으로 결제 완료 후, 주문 조회까지 10분 정도 소요됩니다. (발주서 목록 조회)빠르게 조회하기 원하실 경우, 발주서 단건 조회를 통해 조회가 가능합니다. 더보기

주문 제작 상품의 경우 상품 생성시 extraInfoMessage(주문제작 안내 메시지) 를 입력합니다. 해당 값을 발주서에서는 확인할 수 없나요?

발주서의 etcInfoHeader 파라미터에 표시되며, 고객이 입력한 개별 입력 항목은 etcInfoValues 파라미터로 노출됩니다. 더보기

이미출고 처리 API는 어떤 상황에서 사용하나요?

반품 요청 목록 조회 시 취소진행 상태가 출고중지요청(RELEASE_STOP_UNCHECKED) 일 경우에 사용 가능합니다. 이미 상품을 발송한 상태일 때 사용합니다. 이미출고 처리 시, 반품접수가 진행됩니다. 이미 출고 처리를 진행하시더라도 "상품준비중" 상태부터 반품 배송비는 판매자 부담입니다. 더보기

발주서 목록 조회 API 에서 일 단위 / 분 단위 페이징 / shipmentBoxId / orderId 의 차이가 무엇인가요?

모두 같은 정보를 얻으실 수 있습니다.조회하는 방법에 있어 아래의 차이점을 확인하셔서, 필요에 따라 선택 개발해주시면 됩니다. ※ 발주서 목록 조회 각 API 별 안내 <일 단위 페이징>- 최대 31일 까지 조회 가능- 페이지 당, 최대 발주서 노출 갯수 제한 가능 (maxPerPage)<분 단위 페이징>- 해당 일자 내, 24시간 이내로 조회 가능-... 더보기

상품 연동중 아래와 같은 에러가 발생하고 있습니다. [code: VALIDATION , error : 일반배송상품의 경우, 반품배송비는 초도반품비의 100%~150%까지만 입력가능합니다. 반품배송비를 변경해주세요]

무료배송 상품의 반품 시, 고객에게 청구되는 배송비는 "초도 반품배송비 + 반품배송비"입니다. 반품배송비가 초도 반품배송비보다 과도하게 청구 될 경우 해당 에러가 발생합니다. 입력하신 금액이 정확한지 확인하여 주시기 바랍니다. <배송비 종류>3가지 모두 편도이며, 배송비 조건에 맞는 배송비를 설정해주셔야 합니다. - 초도반품배송비 (deliveryC... 더보기

OPENAPI 관련 안내