본문 바로가기

클레임 API20

교환조회 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 [POST] https://sa2.esmplus.com/claim/v1/sa/Cancels 취소 주문건에 대해 조회합니다. 취소요청 / 취소중 / 취소완료 / 취소철회 / 지마켓, 옥션 CS직권취소완료 / 옥션송금후취소완료 취소 상태별로 조회할 수 있습니다. 주문확인 이전 고객이 취소 했을 경우 판매자의 승인없이 즉시취소되며 주문확인 이후 고객이 취소신청 했을 경우 판매자 승인 후 최종 취소처리합니다. 취소 신청 후 24시간 이내 판매자 승인 없을 경우 자동으로 취소 됩니다. Request Description 항목 항목명 필수여부 Type Description SiteType 사이트 구분 Y int 1 : 옥션 2 : G마켓 CancelStatus 취소상태 Y int 0 : 전체 ..
취소승인 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마..