본문 바로가기

클레임 API20

교환조회 API Description[POST] https://sa2.esmplus.com/claim/v1/sa/Exchanges 고객이 교환신청한 주문건에 대해 조회합니다.교환요청 / 교환수거완료 / 교환보류 / 교환완료 / 교환철회 상태별로 조회할 수 있습니다.Request Description항목항목명필수여부TypeDescriptionSiteType사이트구분Yint조회하려는 사이트구분 선택1 : 옥션2 : G마켓Type조회기준 구분Yint조회조건 선택0 : 주문번호1 : 장바구니 번호2 : 교환신청일3 : 교환완료일(교환 상태 완료 - ApproveDate/철회 주문 조회시 - WithdrawDate)4 : 교환보류일ExchangeStatus교환상태Yint1 : 교환요청/교환물품반송중2 : 교환수거완료3 : 교환보..
교환수거 송장등록 API Description[POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderNo}/pickup 교환요청 주문 건에 대해, G마켓/옥션 지정 택배(G마켓/옥션에서 직접 택배사 수거 요청)를 이용하지 않고판매자 지정 택배(판매자가 직접 택배사 수거 요청)을 하는 경우라면 교환수거 송장등록을 필수로 등록합니다.교환 송장등록은 업데이트 가능합니다. Request Description항목항목명필수여부TypeDescriptionOrderNo주문번호Ylong처리하려는 주문번호 입력DeliveryCompCode택배사코드Yint택배사별 5자리 코드 (택배사 코드 참고)InvoiceNo송장번호Ystring SiteType사이트구분Yint처리하려는 주문번호 사이트구분 선택1 ..
취소조회 API Description[POST] https://sa2.esmplus.com/claim/v1/sa/Cancels취소 주문건에 대해 조회합니다.취소요청 / 취소중 / 취소완료 / 취소철회 / 지마켓, 옥션 CS직권취소완료 / 옥션송금후취소완료 취소 상태별로 조회할 수 있습니다.주문확인 이전 고객이 취소 했을 경우 판매자의 승인없이 즉시취소되며 주문확인 이후 고객이 취소신청 했을 경우 판매자 승인 후 최종 취소처리합니다. 취소 신청 후 24시간 이내 판매자 승인 없을 경우 자동으로 취소 됩니다.Request Description항목항목명필수여부TypeDescriptionSiteType사이트 구분Yint1 : 옥션 3 : G마켓CancelStatus취소상태Yint0 : 전체1 : 취소요청2 : 취소중3 : 취소..
취소승인 API Description [PUT] https://sa2.esmplus.com/claim/v1/sa/Cancel/{OrderNo} 주문확인 후 고객이 취소요청한 주문에 대해 판매자가 취소 승인합니다. 이미 배송이 되거나 제작중이어서 취소승인할 수 없을 경우 발송처리 API를 호출하면 취소거부 됩니다. 별도 취소거부 API 는 없습니다. Request Description 항목 항목명 필수여부 Type Description SiteType 사이트 구분 Y int 1 : 옥션 2 : G마켓 OrderNo 주문번호 Y path 해당 주문번호 취소(환불) 승인처리 ※ 취소거부는 발송처리 API 연동 시, 취소 거부됨 JSON { "SiteType": int } Response Description 항목 항목명 Ty..
판매취소 API Description 일반 : [POST] https://sa2.esmplus.com/claim/v1/sa/Cancel/{OrderNo}/SoldOut (제한) 비품절용 : [POST] https://sa2.esmplus.com/claim/v1/sa/Cancel/{OrderNo} 재고가 부족하거나 발송을 할 수 없는 주문을 해야 할 경우 판매취소 API를 호출합니다. 판매취소 API를 호출하면 해당 주문이 고객 환불되고 해당 상품(또는 옵션)은 품절처리 됩니다. 발송 처리 전 주문상태 경우만 가능하고 취소요청 주문은 판매취소 할 수 없고 취소승인 API를 호출합니다. 제한 API는 고객 요청 취소 및 기타 이슈로 품절일 경우에만 허용하며 별도 권한 필요합니다. Request Description 항목 항..
옥션 거래완료 후 환불 API Description [POST] https://sa2.esmplus.com/claim/v1/sa/Cancel/{orderNo}/AfterRemittanceBySeller 옥션 주문 중 거래완료(정산 완료) 후 환불 필요한 경우 처리하는 API 입니다. (지마켓은 불가) 자동 수거지시와 배송비 청구가 불가하기 때문에 처리 전 상품 수거는 별도 확인 해야 하며 상품 발송/회수로 인해 발생 배송비는 구매자와 협의 후 진행 되어야 합니다. 처리 이후에는 고객에게 환불 알림이 발송됩니다. 환불할 금액이 예치금 내 있어야 처리 가능하며 예치금 부족시 충전 후 처리 하시길 바랍니다. Request Description 항목 항목명 필수여부 Type Description OrderNo 주문번호 Y path SiteT..
교환 수거완료 처리 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/shipping/v1/Delivery/ClaimList 미수령신고 주문을 조회합니다. 미수령신고된 주문은 정산되지 않기 때문에 구매자와 연락하여 배송사고가 발생했는지 등 확인해야 합니다. Request Description 항목 항목명 필수여부 Type Description SearchType 조회기준구분 Y string 0: 주문번호 조회 1: 미수령신고일 조회 orderNo 주문번호 Y long 조회하고자 하는 주문번호 입력 StartDate 조회기준시작일 Y date YYYY-MM-DD형태 EndDate 조회기준종료일 Y date YYYY-MM-DD형태 JSON { "SearchType":0, "OrderNo":0, "St..
교환재발송 송장등록 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마..