본문 바로가기

클레임 API/교환 API9

교환조회 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/Exchanges 고객이 교환신청한 주문건에 대해 조회합니다. 교환요청 / 교환수거완료 / 교환보류 / 교환완료 / 교환철회 상태별로 조회할 수 있습니다. Request Description 항목 항목명 필수여부 Type Description SiteType 사이트구분 Y int 조회하려는 사이트구분 선택 1 : 옥션 2 : G마켓 Type 조회기준 구분 Y int 조회조건 선택 0 : 주문번호 1 : 장바구니 번호 2 : 교환신청일 3 : 교환완료일(교환 상태 완료 - ApproveDate/철회 주문 조회시 - WithdrawDate) 4 : 교환보류일 ExchangeStatus 교환상태 Y int 1 :..
교환수거 송장등록 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/pickup 교환요청 주문 건에 대해, G마켓/옥션 지정 택배(G마켓/옥션에서 직접 택배사 수거 요청)를 이용하지 않고 판매자 지정 택배(판매자가 직접 택배사 수거 요청)을 하는 경우라면 교환수거 송장등록을 필수로 등록합니다. 교환 송장등록은 업데이트 가능합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 DeliveryCompCode 택배사코드 Y int 택배사별 5자리 코드 (택배사 코드 참고) InvoiceNo 송장번호 Y string SiteType 사이트구분 Y..
교환 수거완료 처리 API Description [PUT] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/pickup 교환수거송장의 배송완료처리합니다. 교환수거송장의 배송완료가 정상적으로 처리되지 않으면 정산 누락될 수 있습니다. 택배 Tracking 되지 않는 주문의 경우 해당 수거완료처리를 진행합니다. 옥션의 경우 재발송 송장처리를 하면 자동으로 교환수거 완료처리되므로, 교환수거 송장처리 ->교환수거 완료처리 -> 재발송 송장처리 -> 재발송 배송완료처리 순으로 처리합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 PickupCompleteDate 수거완료일자 strin..
교환재발송 송장등록 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/resend 교환 주문 건에 대해, 교환 재발송 송장등록을 필수로 등록합니다. 교환 송장등록은 업데이트 가능합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 DeliveryCompCode 택배사코드 Y int 택배사별 5자리 코드 (택배사 코드 참고) InvoiceNo 송장번호 Y string SiteType 사이트구분 Y int 처리하려는 주문번호 사이트구분 선택 1 : 옥션 2 : G마켓 JSON { "SiteType": int, "DeliveryCompCode":..
교환재발송 배송완료 API Description [PUT] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/resend 교환 재발송 송장 배송완료 처리합니다. 택배 Tracking 되지 않는 주문의 경우 해당 송장 배송완료처리를 진행합니다. 교환수거 송장처리 → 교환수거 완료처리 → 재발송 송장처리 → 재발송 배송완료처리 순으로 처리합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 PickupCompleteDate 배송완료일자 string 배송완료된 일자 YYYY-MM-DD 형식 SiteType 사이트구분 Y int 처리하려는 주문번호 사이트구분 선택 1 : 옥션 2 : G마..
교환보류 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/hold 교환배송비 및 교환 물품 미입고 관련해서 이슈가 있을 때 보류 설정하는 별도 권한이 필요한 제한 API입니다. 교환보류 시, 고객 알람 전송되므로 명확한 보류 사유가 있을 경우에만 호출합니다. 보류 사유는 업데이트 할 수 있으나 동일한 사유로 업데이트는 불가합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 HoldReason 보류사유 Y int 보류사유 코드 입력 0 : 기타유보사유 1 : 교환배송비청구 4 : 교환입고미확인 * 교환 배송비 청구 시, G마켓은..
교환보류해제 API Description [DELETE] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/hold 교환 보류한 주문에 대해 해제 처리를 합니다. G마켓 교환 보류 주문은 교환 재발송 처리와 함께 보류 해제 처리 되어야 합니다. 옥션 주문 경우 교환 재발송 처리시 자동으로 보류 해제 됩니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 SiteType 사이트구분 Y int 처리하려는 주문번호 사이트구분 선택 2 : G마켓 JSON { "SiteType": int } Response Description 항목 항목명 Type Description ResultC..
교환건 반품전환 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderno}/return 교환 주문을 반품으로 전환합니다. 교환 사유가 판매자 귀책이면 전환 시 판매자 귀책으로 전환되고 구매자 귀책이면 구매자 귀책으로 전환됩니다. (결제수단은 “판매자 직접결제”로 내려감) G마켓 주문일 경우 “반품신청” 상태로 전환되며(반품보류 및 반품승인은 API 각기 처리해야함), 옥션 주문일 경우 바로 반품 환불 승인된 상태로 전환됩니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 DeliveryCompCode 재배송 택배사코드 int Sitetype > ..
반품건 교환전환 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/return/{orderno}/exchange 반품주문 건을 교환으로 전환합니다. 반품 사유가 판매자 귀책이면 교환 전환시 판매자 귀책으로 전환되고, 반품 사유가 구매자 귀책이면 교환 전환시 구매자 귀책으로 전환됩니다. (결제수단은 “판매자 직접결제”로 내려감) G마켓 주문 경우 “교환신청”상태로 전환되며, 옥션 주문 경우 “교환재발송 송장등록” 상태(재발송완료는 아님)로 전환됩니다. 옥션 주문일 경우 재발송택배사 및 송장번호를 필수로 입력해야 합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 Deli..