본문 바로가기

전체 글163

교환보류 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 [GET] https://sa2.esmplus.com/item/v1/categories/site-cats/{siteCatCode} (하위카테고리 개별 조회시) [GET] https://sa2.esmplus.com/item/v1/categories/site-cats (대분류 전체 조회시) G마켓, 옥션 사이트 카테고리 조회하여 상품 등록시 필수로 입력합니다. (leaf 카테고리로 상품 등록 가능) 사이트별 개별 조회시 해당 사이트 ID 1개만 입력된 인증토큰으로 호출 해주시면 됩니다. 참고 url ) 옥션 카테고리 xml 링크 : https://script.auction.co.kr/category/categories.xml (IsLeaf="true" 경우 상품 등록 가능) 지마켓 카테..
ESM 카테고리조회 API Description [GET] https://sa2.esmplus.com/item/v1/categories/sd-cats/0 (전체 조회시) [GET] https://sa2.esmplus.com/item/v1/categories/sd-cats/{sdCatCode} (하위카테고리 개별 조회시) ESM 카테고리 조회하여 상품 등록/수정시 필수 입력합니다.(상품 등록/수정시에는 최종 leaf 카테고리로 입력) 조회된 ESM 카테고리 기준으로 매칭된 지마켓, 옥션 카테고리 확인 가능합니다. Request Description 항목 항목명 필수여부 Type Description siteCatCode ESM 카테고리코드 Y path 조회한 카테고리코드 기준 하위 카테고리 확인 가능 JSON URL만 호출 / Re..
Site-ESM 카테고리매칭조회 API Description [GET] https://sa2.esmplus.com/item/v1/categories/sd-cats/{sdCatCode}/site-cats ESM카테고리는 등록 가능한 G마켓/옥션 카테고리가 지정되어 있습니다. Site카테고리와 매칭된 ESM카테고리를 조회하여 입력해주세요 Request Description 항목 항목명 필수여부 Type Description sdCatCode ESM 카테고리코드 (최하위 카테고리코드) Y path ESM 카테고리 기준 G마켓/옥션 카테고리가 매칭되어 있음 ESM 카테고리 입력시 매칭 G마켓/옥션 카테고리 입력하여 등록/수정 조회한 카테고리 기준 매칭 카테고리 확인 가능 URL만 호출 / Request Body 없음 [GET] https://sa2...