본문 바로가기

클레임 API/반품 API5

반품조회 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/Returns 고객이 반품신청한 주문을 조회합니다. 반품요청 / 반품수거완료 / 반품환불보류 / 반품환불완료 / 반품철회 / 직권환불완료 반품 상태별로 조회할 수 있습니다. 직권환불(CS고객센터)을 통한 반품환불건은 주기적으로 호출하여 내부 상태값과 Sync 관리할 수 있습니다. Request Description 항목 항목명 필수여부 Type Description SiteType 사이트 구분 Y int 1 : 옥션 2 : G마켓 ReturnStatus 반품상태 Y int 1 : 반품요청 2 : 반품수거완료 3 : 반품환불보류 4 : 반품환불완료 5 : 반품철회 6 : 사이트 직권 환불건(반품완료건 중, 고..
반품승인 API Description [PUT] https://sa2.esmplus.com/claim/v1/sa/return/{orderNo} 반품 승인 시 자동으로 반품 보류 해제 및 반품수거송장의 배송 완료가 처리되며 구매자 환불 진행됩니다. 바로 환불 처리가 되는 것이 아니고, 고객 결제 수단 및 타 장바구니 클레임 진행 여부에 따라 실제 고객 환불 진행됩니다. 고객과의 분쟁으로 추가 커뮤니케이션이 필요한 경우는 양사 CS를 통해 분쟁 건으로 조정되어야 합니다. Request Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 SiteType 사이트구분 Y int 처리하려는 주문번호 사이트구분 선택 1 : 옥션 2 : G마켓 JSON { "SiteType": int } Response..
판매자 직접 반품 신청 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/Return/{orderNo}/Request 판매자가 직접 반품 처리시 호출하는 API 입니다. 반품 요청 상태로 주문 상태 변경 되며 반품 완료 처리시에는 반품 승인 API 호출 되어야 합니다. ※ 지마켓만 가능하며 옥션은 추후 지원 예정입니다. 옥션 가능시 별도 안내 예정입니다. Request Description 항목 항목명 필수여부 Type Description orderNo 주문번호 Y path siteType 사이트 구분 Y int 1 : 옥션(추후 지원) 2 : 지마켓 payNo 장바구니(결제) 번호 Y long reason 반품 사유 Y string NC : 구매자변심 BG : 선택사항 변경 ..
반품수거 송장등록 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/return/{orderNo}/pickup 반품요청 주문에 대해 G마켓/옥션 지정택배(G마켓/옥션에서 직접 택배사 수거 요청)를 이용하지 않고 판매자 지정택배(판매자가 직접 택배사 수거 요청)을 하는 경우라면 반품수거 송장등록을 필수로 등록합니다. 등록된 반품송장은 업데이트 가능합니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y Path 처리하려는 주문번호 입력 DeliveryCompCode 택배사코드 Y int 택배사별 5자리 코드 (택배사 코드 참고) InvoiceNo 송장번호 Y string SiteType 사이트구분 Y int 처..
반품보류 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/return/{orderNo}/hold 반품 주문에 대해 배송비 및 반품미입고 관련 이슈 있을 경우 보류 설정하는 API입니다. 반품보류는 수거지시 이전, 수거완료 이후 시점만 처리 가능합니다. (택배 Tracking중 보류 불가) 보류사유 업데이트 가능하나 동일한 사유로의 업데이트는 불가합니다. 반품보류 해제는 반품승인 API 호출 시 해제되며 아래 케이스 경우도 해제될 수 있습니다. 1. G마켓, 옥션 CS 인입으로 고객 or 셀러요청 시 2. 보류사유 > 반품배송비 추가로 설정한 경우, 고객이 결제하면 보류해제됨 3. 보류해제 처리가 지연될 경우, 30일 초과 시 System으로 자동으로 보류해제됨 R..