상품상세 배송정보

결손처리로 인한 단품옵션 품절처리

post

기능설명

• 결손처리로 인한 단품옵션 품절처리를 진행합니다

---

상세설명

• 결손등록시 결손사유가 재고부족일때 상품 단품의 판매상태를 품절 처리

• 결손해제시 재고여부에 따라 판매상태를 변경합니다. .

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

상품 상세 조회 Request DTO

targetOrdDtlStatCdstringOptional

결손처리 구분 22:결손해제, 23:결손등록

Example: 23

Responses

200

OK

*/*

objectOptional

post

/v1/delivery/updatePrItmStockByInsuff

HTTPcURLJavaScriptPython

POST /api/goods/v1/delivery/updatePrItmStockByInsuff HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "targetOrdDtlStatCd": 23,
  "prItms": [
    {
      "goodsNo": 100000001,
      "itmNo": "001",
      "itmSaleStatCd": 10,
      "soutCausCd": 11,
      "userId": "test"
    }
  ]
}

200

OK

{}

배송정책번호별 배송비 조회

post

기능설명

• 협력사+배송비정책번호 기반 배송비정책 기본 API 입니다.

---

상세설명

• 협력사+배송비정책번호 배열 값으로 배송정책기본 정보 목록을 조회합니다.

  • 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.

---

수정번호

Release v1.05_231204 : 거래유형코드(VD002) 추가

Release v2.00_240627 : 추가배송비정보 추가

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

application/json

배송정책기본 Request

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1Example: 1

entrNostringOptional

협력사번호

Default: 10000001

deliPolcNostringOptional

배송정책번호

Default: 10000271

Responses

200

배송비정책 조회 성공

*/*

배송정책기본 Response

deliPolcNostringOptional

배송정책번호

entrNostringOptional

협력사번호

dlexTypCdstringOptional

배송비유형코드(VD005)

dlexTypCdNmstringOptional

배송비유형코드명

stdAmtinteger · int64Optional

기준금액

dlexAmtinteger · int64Optional

배송비금액

wthdRtnAmtinteger · int64Optional

회수반품비

exchDlexinteger · int64Optional

교환배송비

useYnstringOptional

사용여부

trdTypCdstringOptional

거래유형코드(VD002)

900

배송비정책 조회 실패

*/*

post

/v1/delivery/deliProcInfo

HTTPcURLJavaScriptPython

POST /api/goods/v1/delivery/deliProcInfo HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 72

[
  {
    "langCd": "ko",
    "siteNo": 1,
    "entrNo": "10000001",
    "deliPolcNo": "10000271"
  }
]

{
  "deliPolcNo": "text",
  "entrNo": "text",
  "dlexTypCd": "text",
  "dlexTypCdNm": "text",
  "stdAmt": 1,
  "dlexAmt": 1,
  "wthdRtnAmt": 1,
  "exchDlex": 1,
  "addDlexInfoList": [
    {
      "deliRegnGrpNo": "text",
      "deliRegnGrpNm": "text",
      "addDlexAmt": 1
    }
  ],
  "useYn": "text",
  "trdTypCd": "text"
}

협력사별 배송교환반품 정보 조회

get

기능설명

• 반품교환정보를 조회하는 API 입니다.

---

상세설명

• 협력사번호 값으로 배송정책기본 정보 목록을 조회합니다.

  • 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

entrNostringRequired

String

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

협력사별 반품교환정보 조회 성공

*/*

반품교환정보 Response

goodsNostringOptional

상품번호

deliProcTypCdstringOptional

배송처리유형코드(PR008)

deliProcTypCdNmstringOptional

배송처리유형코드명

deliGoodsGbCdstringOptional

배송상품구분코드(PR010)

deliGoodsGbCdNmstringOptional

배송상품구분코드명

deliWayCdstringOptional

배송수단코드(PR009)

deliWayCdBNmstringOptional

배송수단코드명

deliPsbRgnCdstringOptional

배송가능지역코드(PR030)

deliPsbRgnCdNmstringOptional

배송가능지역코드명

deliDdaystringOptional

배송기일

deliPolcNostringOptional

배송정책번호

entrNostringOptional

협력사번호

bpckPsbYnstringOptional

합포가능여부

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

dlexTypCdstringOptional

배송비유형코드(VD005)

dlexTypCdNmstringOptional

배송비유형코드명

stdAmtinteger · int64Optional

기준금액

dlexAmtinteger · int64Optional

배송비금액

wthdRtnAmtinteger · int64Optional

회수반품비

exchDlexinteger · int64Optional

교환배송비

addDlexAmtinteger · int64Optional

추가배송비금액

useYnstringOptional

사용여부

900

협력사별 반품교환정보 조회 실패

*/*

get

/v1/delivery/tr/{entrNo}

HTTPcURLJavaScriptPython

GET /api/goods/v1/delivery/tr/{entrNo}?returnOrChangeInfo=[object+Object] HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsNo": "text",
  "deliProcTypCd": "text",
  "deliProcTypCdNm": "text",
  "deliGoodsGbCd": "text",
  "deliGoodsGbCdNm": "text",
  "deliWayCd": "text",
  "deliWayCdBNm": "text",
  "deliPsbRgnCd": "text",
  "deliPsbRgnCdNm": "text",
  "deliDday": "text",
  "deliPolcNo": "text",
  "entrNo": "text",
  "bpckPsbYn": "text",
  "rtnPsbYn": "text",
  "exchPsbYn": "text",
  "dlexTypCd": "text",
  "dlexTypCdNm": "text",
  "stdAmt": 1,
  "dlexAmt": 1,
  "wthdRtnAmt": 1,
  "exchDlex": 1,
  "addDlexAmt": 1,
  "useYn": "text",
  "etEntrDlvpInfoList": [
    {
      "entrDlvpNo": 1,
      "entrNo": 1000001,
      "dlvpTypCd": 10,
      "dlvpTypCdNm": "출고지",
      "dlvpNm": "배송지",
      "useYn": "Y",
      "zipNoSeq": 1,
      "zipNo": 123,
      "zipAddr": "서울시 강남구",
      "dtlAddr": "상세주소",
      "utakmnNm": "홍길동",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": 1234,
      "aempTelEndNo": 1234,
      "aempCellSctNo": "010",
      "aempCellTxnoNo": 1234,
      "aempCellEndNo": 1234
    }
  ]
}

상품별 배송교환반품 정보 조회

get

기능설명

• 상품상세 배송/교환/반품 레이어 팝업에서 사용하는 반품교환정보 API 입니다.

---

상세설명

• 상품번호 값으로 배송 정책 기본 정보 및 협력사 배송지 정보 목록을 조회합니다.

  • 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

goodsNostringRequired

String

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품별 반품교환정보 조회 성공

*/*

반품교환정보 Response

goodsNostringOptional

상품번호

deliProcTypCdstringOptional

배송처리유형코드(PR008)

deliProcTypCdNmstringOptional

배송처리유형코드명

deliGoodsGbCdstringOptional

배송상품구분코드(PR010)

deliGoodsGbCdNmstringOptional

배송상품구분코드명

deliWayCdstringOptional

배송수단코드(PR009)

deliWayCdBNmstringOptional

배송수단코드명

deliPsbRgnCdstringOptional

배송가능지역코드(PR030)

deliPsbRgnCdNmstringOptional

배송가능지역코드명

deliDdaystringOptional

배송기일

deliPolcNostringOptional

배송정책번호

entrNostringOptional

협력사번호

bpckPsbYnstringOptional

합포가능여부

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

dlexTypCdstringOptional

배송비유형코드(VD005)

dlexTypCdNmstringOptional

배송비유형코드명

stdAmtinteger · int64Optional

기준금액

dlexAmtinteger · int64Optional

배송비금액

wthdRtnAmtinteger · int64Optional

회수반품비

exchDlexinteger · int64Optional

교환배송비

addDlexAmtinteger · int64Optional

추가배송비금액

useYnstringOptional

사용여부

900

상품별 반품교환정보 조회 실패

*/*

get

/v1/delivery/pd/{goodsNo}

HTTPcURLJavaScriptPython

GET /api/goods/v1/delivery/pd/{goodsNo}?returnOrChangeInfo=[object+Object] HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsNo": "text",
  "deliProcTypCd": "text",
  "deliProcTypCdNm": "text",
  "deliGoodsGbCd": "text",
  "deliGoodsGbCdNm": "text",
  "deliWayCd": "text",
  "deliWayCdBNm": "text",
  "deliPsbRgnCd": "text",
  "deliPsbRgnCdNm": "text",
  "deliDday": "text",
  "deliPolcNo": "text",
  "entrNo": "text",
  "bpckPsbYn": "text",
  "rtnPsbYn": "text",
  "exchPsbYn": "text",
  "dlexTypCd": "text",
  "dlexTypCdNm": "text",
  "stdAmt": 1,
  "dlexAmt": 1,
  "wthdRtnAmt": 1,
  "exchDlex": 1,
  "addDlexAmt": 1,
  "useYn": "text",
  "etEntrDlvpInfoList": [
    {
      "entrDlvpNo": 1,
      "entrNo": 1000001,
      "dlvpTypCd": 10,
      "dlvpTypCdNm": "출고지",
      "dlvpNm": "배송지",
      "useYn": "Y",
      "zipNoSeq": 1,
      "zipNo": 123,
      "zipAddr": "서울시 강남구",
      "dtlAddr": "상세주소",
      "utakmnNm": "홍길동",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": 1234,
      "aempTelEndNo": 1234,
      "aempCellSctNo": "010",
      "aempCellTxnoNo": 1234,
      "aempCellEndNo": 1234
    }
  ]
}

상품 배송비 조회

get

기능설명

• 상품번호 기반 배송비정책 기본 API 입니다.

---

상세설명

• 상품번호 리스트 값으로 배송정책기본 정보 목록을 조회합니다.

  • 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.

---

수정번호

Release v1.04_231120 : 거래유형코드(VD002) 추가

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNosstringRequired

List

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품별 배송비 조회 성공

*/*

배송정책기본 Response

deliPolcNostringOptional

배송정책번호

entrNostringOptional

협력사번호

dlexTypCdstringOptional

배송비유형코드(VD005)

dlexTypCdNmstringOptional

배송비유형코드명

stdAmtinteger · int64Optional

기준금액

dlexAmtinteger · int64Optional

배송비금액

wthdRtnAmtinteger · int64Optional

회수반품비

exchDlexinteger · int64Optional

교환배송비

useYnstringOptional

사용여부

trdTypCdstringOptional

거래유형코드(VD002)

900

상품별 배송비 조회 실패

*/*

get

/v1/delivery/goodsDeliProc

HTTPcURLJavaScriptPython

GET /api/goods/v1/delivery/goodsDeliProc?goodsDeliPolcRequest=[object+Object]&goodsNos=text HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "deliPolcNo": "text",
  "entrNo": "text",
  "dlexTypCd": "text",
  "dlexTypCdNm": "text",
  "stdAmt": 1,
  "dlexAmt": 1,
  "wthdRtnAmt": 1,
  "exchDlex": 1,
  "addDlexInfoList": [
    {
      "deliRegnGrpNo": "text",
      "deliRegnGrpNm": "text",
      "addDlexAmt": 1
    }
  ],
  "useYn": "text",
  "trdTypCd": "text"
}