본문 바로가기

클레임 API20

교환보류 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/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..
미수령신고 철회요청 API Description [POST] https://sa2.esmplus.com/shipping/v1/Delivery/ClaimRelease 미수령신고 주문데이터에 대해 미수령신고 철회 신청을 합니다. 철회시 바로 해제되는 것은 아니며 고객에게 안내 후 이의 없을 경우 배송완료일 + 7일차 자동으로 미수령신고 해제됩니다. 미수령신고 철회되어야 정산되며 고객이 또 받지 못할 경우 양사 CS를 통해 처리필요합니다 CS가 강성이 될 수 있으므로 반드시 고객이 실제 물건을 받았는지를 확인한 후 미수령신고철회처리를 요청합니다. Request Description 항목 항목명 필수여부 Type Description orderNo 주문번호 Y long 철회하고자 하는 주문번호 입력 ClaimCancelType 조회기준구..
교환건 반품전환 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..