FAQ

커머스 API 연동 시 자주 묻는 질문에 대한 내용을 확인할 수 있습니다.

1. 개발 연동

Q. 개발 진행 시 발생하는 문의 사항은 어떤 채널을 통해 전달할 수 있나요?

A. 다음과 같은 채널을 통해 개발 문의 및 지원 요청을 할 수 있습니다.

Q. 연동 테스트는 어떻게 진행하나요?

A. 원활한 개발 진행을 위해 아래와 같이 샌드박스(테스트) 환경을 지원하고 있습니다.
　 샌드박스 파트너 오피스 계정은 이메일 store-api@ssts.co.kr 로 신청 가능합니다.

2. 인증

Q. 인증 실패로 요청 오류가 발생해요.

A. 자주 발생하는 인증 실패 사유는 아래와 같습니다.

  • 인증키 잠김 / 사용중지 : 인증키가 잠김 상태이거나 사용중지 된 경우

    • 굿웨어몰 정책에 위배되거나 부적절한 행위를 시도할 경우, 관리자에 의해 해당 키는 잠금처리 됩니다.

  • Signed Date 이슈 : 요청 시 인증헤더의 Signed Date가 만료되었거나 Signature 생성분과 불일치하는 경우

    • 요청 헤더의 Signed Date와 Signature 생성 시, Signed Date가 불일치하거나 인증정보 생성 후 3분이 지나 만료될 경우 인증에 실패합니다.

3. 상품

Q. 개발 중 등록된 상품을 확인하고 싶어요.

A. 개발 API를 통해 등록된 상품은 샌드박스 굿웨어몰에서 확인 가능합니다.

Q. KC안전인증 대상 여부에 따른 설정값은 어떻게 되나요?

A. KC안전인증 대상 여부(KcCertificationTargetType)에 따른 설정값은 아래와 같습니다.

이 설정에 맞춰 적절한 정보를 입력해주세요.

Q. 옵션 구성 코드(OptionType)에 따른 옵션 작성 구조는 어떻게 되나요?

A. 옵션 구성 코드(OptionType)에 따른 옵션 작성 구조는 아래와 같습니다.

  • 자동구성(AUTO) 인 경우 : 옵션1값과 옵션2값의 조합으로 단품이 자동 생성됩니다.
    • 예시:
      opt: {
  type: "AUTO",
  opt1: {
    nm: "컬러",
    values: ["BK", "WH", "GR"]
  },
  opt2: {
    nm: "사이즈",
    values: ["90", "95", "100", "105"]
  }
}
      이 경우, BK/90, BK/95, GR/105와 같은 총 12개의 단품이 생성됩니다.
  • 조합형 구성(MANUAL) 인 경우 : items 수대로 단품이 생성됩니다.
    • 예시:
      opt: {
  type: "MANUAL",
  opt1: {
    nm: "컬러"
  },
  opt2: {
    nm: "사이즈"
  },
  items: [
    { opt1: "BK", opt2: ["90", "95", "100", "105"] },
    { opt1: "WH", opt2: ["S", "M", "L"] }
  ]
}
      이 경우, BK/90, BK/95, WH/L와 같은 총 7개의 단품이 생성됩니다.
  • 단품없음(NONE) 인 경우 : 임의값(F)으로 1개의 단품이 생성됩니다.
  • 수정(MODIFY) 인 경우 : 굿웨어몰 단품코드(ItmNo) 기준으로 금액과 판매 상태를 변경할 수 있습니다.
    • 예시:
      opt: {
  type: "MODIFY",
  modItems: [
    { "itmNo": ..., amt: ..., status: ... },
    { "itmNo": ..., amt: ..., status: ... }
  ]
}
  • 추가(ADD) 인 경우 : MANUAL 구조와 유사한 리스트(addItems)로 작성됩니다.
    • 예시:
      opt: {
  type: "ADD",
  addItems: [
    { opt1: "BR", opt2: ["90", "95", "100", "105"] }
  ]
}
      이 경우, BK/90, BK/95, WH/L와 같은 총 7개의 단품이 생성됩니다.
  • 상품 등록 후 수정 시 승인 상태에 따른 제한 :
    • 승인 전 : 삭제 후 등록 가능합니다.
    • 승인 후 : 삭제는 불가능하며, 옵션가와 판매 상태 변경이나 옵션 추가에 한해 가능합니다.

이 구조에 맞게 옵션을 작성하고 수정/추가 작업을 진행해 주세요.

4. 주문

Q. 주문 테스트를 하고 싶어요.

A. 등록된 상품으로 주문 테스트를 진행하고자 할 경우 아래의 절차로 진행 가능합니다.

  • 샌드박스 굿웨어몰 접속
  • 샌드박스(테스트) 환경에서 회원가입 진행
  • 등록 상품 주문(테스트 환경에서 카드 결제 시 실결제는 이루어지지 않습니다.)

5. 배송

Q. 주문이 어떤 상태일 때 주문 운송장 등록을 할 수 있나요?

A. 주문 운송장은 아래와 같은 경우에 등록 가능합니다. 이외의 경우에는 송장 처리 대상에서 제외됩니다.

  • 배송 상태가 출고지시 인 경우
  • 배송 상태가 출고완료 면서 집하 처리가 되지 않아 집하일시가 없는 경우
  • 기존에 등록된 송장 번호와 신규 등록할 송장 번호가 불일치 하는 경우

Q. 클레임이 어떤 상태일 때 회수 운송장 등록을 할 수 있나요?

A. 회수 운송장은 아래와 같은 경우에 등록 가능합니다. 이외의 경우에는 송장 처리 대상에서 제외됩니다.

  • 회수 상태가 회수지시대기 인 경우
  • 회수 상태가 회수지시 면서 집하 처리가 되지 않아 집하일시가 없는 경우
  • 기존에 등록된 송장 번호와 신규 등록할 송장 번호가 불일치 하는 경우