Ctrlk
X2BEE 바로가기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

주문변경

주문배송지 통관고유부호 변경 (FO)

post

기능 설명

  • [FO전용] 주문배송지 통관고유부호를 변경합니다.

상세 설명

  • 주문번호, 배송지순번 기준으로 주문배송지 통관고유번호를 업데이트합니다.

Header parameters
AuthorizationanyOptional

Access Token

Body

주문배송지 통관고유부호 변경 Request

ordNostringRequired

주문번호

dlvpSeqstringRequired

배송지순번

persCstmCdstringRequired

통관고유번호

Responses
200

성공

No content
post/v1/claim/orderChange/ordDlvpPcccChangeFo
POST /api/order/v1/claim/orderChange/ordDlvpPcccChangeFo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "ordNo": "text",
  "dlvpSeq": "text",
  "persCstmCd": "text"
}
No content

주문 배송지 수정 (BO)

post

기능 설명

  • [BO전용] 주문 배송지를 변경합니다.

상세 설명

  • 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.

  • 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.

  • 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.

특이사항

  • ST008 cd 92번(배송지변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.

수정번호

  • Release v1.05_231204 : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행

  • Release v2.00_240711 : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정

Header parameters
AuthorizationanyOptional

Access Token

Body

주문 배송지 변경/등록 DTO

ordNostringRequired

주문번호

Example: 20230809O007943
clmNostringOptional

클레임번호

Example: 20230801C008072
systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:
mbrNostringOptional

회원번호

Example: 10000001
deliNostringRequired

배송번호

Example: 100008491
deliPolcNostringRequired

배송정책번호

Example: 10000431
dlvpNmstringRequired

배송지명

Example: 집
rcvmnNmstringRequired

수취인명

Example: 홍길동
zipNoSeqinteger · int32Optional

우편번호순번

Example: 1
zipNostringRequired

변경후우편번호

Example: 08739
originZipNostringOptional

변경전우편번호

Example: 05837
orginDlvpSeqstringOptional

변경전배송지순번

Example: 1
zipAddrstringRequired

우편주소

Example: 서울 송파구 법원로9길
dtlAddrstringOptional

상세주소

Example: 에이치비지니스파크 D동 6층23
rcvmnCellSctNostringRequired

수취인휴대폰구분번호

Example: 010
rcvmnCellTxnoNostringRequired

수취인휴대폰국번번호

Example: 1234
rcvmnCellEndNostringRequired

수취인휴대폰끝번호

Example: 5678
deliMsgstringOptional

배송메시지

Example: 문 앞에 두고 가주세요.
deliMsgCdstringOptional

배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력

Example: 10
comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 자유출입가능
comnFrdrPwdstringOptional

공동현관비밀번호

Example: 1234
comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타

Example: 10
deliGbCdstring · enumOptional

LO001(배송구분코드) * 10 : 출하 * 20 : 회수

Example: 10Possible values:
dlvpSeqstringOptional

배송순번

Example: 1
rcvmnEmailAddrstringOptional

수취인이메일

Example: test@plateer.com
rcvmnTelRgnNostringOptional

수취인전화지역번호

Example: 02
rcvmnTelTxnoNostringOptional

수취인전화국번번호

Example: 1234
rcvmnTelEndNostringOptional

수취인전화끝번호

Example: 5678
frgnDirPurGoodsYnstringOptional

해외직구상품여부

Responses
200

성공

No content
post/v1/claim/orderChange/ordDlvChange
POST /api/order/v1/claim/orderChange/ordDlvChange HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 721

{
  "ordNo": "20230809O007943",
  "clmNo": "20230801C008072",
  "systemType": "10",
  "mbrNo": "10000001",
  "deliNo": "100008491",
  "deliPolcNo": "10000431",
  "dlvpNm": "집",
  "rcvmnNm": "홍길동",
  "zipNoSeq": 1,
  "zipNo": "08739",
  "originZipNo": "05837",
  "orginDlvpSeq": "1",
  "zipAddr": "서울 송파구 법원로9길",
  "dtlAddr": "에이치비지니스파크 D동 6층23",
  "rcvmnCellSctNo": "010",
  "rcvmnCellTxnoNo": "1234",
  "rcvmnCellEndNo": "5678",
  "deliMsg": "문 앞에 두고 가주세요.",
  "deliMsgCd": "10",
  "comnFrdrEtcMethod": "자유출입가능",
  "comnFrdrPwd": "1234",
  "comnFrdrCogoMethodCd": "10",
  "deliGbCd": "10",
  "dlvpSeq": "1",
  "rcvmnEmailAddr": "test@plateer.com",
  "rcvmnTelRgnNo": "02",
  "rcvmnTelTxnoNo": "1234",
  "rcvmnTelEndNo": "5678",
  "frgnDirPurGoodsYn": "text"
}
No content

주문 배송지 수정 (FO)

post

기능 설명

  • [FO전용] 주문 배송지를 변경합니다.

상세 설명

  • 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.

  • 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.

  • 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.

특이사항

  • ST007 cd 92번(배송지변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.

수정번호

  • Release v1.05_231204 : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행

  • Release v2.00_240711 : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정

Header parameters
AuthorizationanyOptional

Access Token

Body

주문 배송지 변경/등록 DTO

ordNostringRequired

주문번호

Example: 20230809O007943
clmNostringOptional

클레임번호

Example: 20230801C008072
systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:
mbrNostringOptional

회원번호

Example: 10000001
deliNostringRequired

배송번호

Example: 100008491
deliPolcNostringRequired

배송정책번호

Example: 10000431
dlvpNmstringRequired

배송지명

Example: 집
rcvmnNmstringRequired

수취인명

Example: 홍길동
zipNoSeqinteger · int32Optional

우편번호순번

Example: 1
zipNostringRequired

변경후우편번호

Example: 08739
originZipNostringOptional

변경전우편번호

Example: 05837
orginDlvpSeqstringOptional

변경전배송지순번

Example: 1
zipAddrstringRequired

우편주소

Example: 서울 송파구 법원로9길
dtlAddrstringOptional

상세주소

Example: 에이치비지니스파크 D동 6층23
rcvmnCellSctNostringRequired

수취인휴대폰구분번호

Example: 010
rcvmnCellTxnoNostringRequired

수취인휴대폰국번번호

Example: 1234
rcvmnCellEndNostringRequired

수취인휴대폰끝번호

Example: 5678
deliMsgstringOptional

배송메시지

Example: 문 앞에 두고 가주세요.
deliMsgCdstringOptional

배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력

Example: 10
comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 자유출입가능
comnFrdrPwdstringOptional

공동현관비밀번호

Example: 1234
comnFrdrCogoMethodCdstringOptional

공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타

Example: 10
deliGbCdstring · enumOptional

LO001(배송구분코드) * 10 : 출하 * 20 : 회수

Example: 10Possible values:
dlvpSeqstringOptional

배송순번

Example: 1
rcvmnEmailAddrstringOptional

수취인이메일

Example: test@plateer.com
rcvmnTelRgnNostringOptional

수취인전화지역번호

Example: 02
rcvmnTelTxnoNostringOptional

수취인전화국번번호

Example: 1234
rcvmnTelEndNostringOptional

수취인전화끝번호

Example: 5678
frgnDirPurGoodsYnstringOptional

해외직구상품여부

Responses
200

성공

No content
post/v1/claim/orderChange/ordDlvChangeFO
POST /api/order/v1/claim/orderChange/ordDlvChangeFO HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 721

{
  "ordNo": "20230809O007943",
  "clmNo": "20230801C008072",
  "systemType": "10",
  "mbrNo": "10000001",
  "deliNo": "100008491",
  "deliPolcNo": "10000431",
  "dlvpNm": "집",
  "rcvmnNm": "홍길동",
  "zipNoSeq": 1,
  "zipNo": "08739",
  "originZipNo": "05837",
  "orginDlvpSeq": "1",
  "zipAddr": "서울 송파구 법원로9길",
  "dtlAddr": "에이치비지니스파크 D동 6층23",
  "rcvmnCellSctNo": "010",
  "rcvmnCellTxnoNo": "1234",
  "rcvmnCellEndNo": "5678",
  "deliMsg": "문 앞에 두고 가주세요.",
  "deliMsgCd": "10",
  "comnFrdrEtcMethod": "자유출입가능",
  "comnFrdrPwd": "1234",
  "comnFrdrCogoMethodCd": "10",
  "deliGbCd": "10",
  "dlvpSeq": "1",
  "rcvmnEmailAddr": "test@plateer.com",
  "rcvmnTelRgnNo": "02",
  "rcvmnTelTxnoNo": "1234",
  "rcvmnTelEndNo": "5678",
  "frgnDirPurGoodsYn": "text"
}
No content

주문 상품 옵션변경 (BO)

post

기능 설명

  • [BO전용] 주문 옵션을 변경합니다.

상세 설명

  • 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.

  • 다건의 옵션 변경이 가능합니다.

  • 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.

  • 동일단품, 예약상품의 단품은 변경 불가능합니다.

특이사항

  • ST008 cd 91번(옵션변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.

수정번호

  • Release v2.00_241202: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)

Header parameters
AuthorizationanyOptional

Access Token

Bodyobject · OrdGoodsInfoRequest[]

주문 옵션 변경 DTO

ordNostringRequired

주문번호

Example: 20230809O007943
ordSeqinteger · int32Required

주문순번

Example: 1
ordProcSeqinteger · int32Required

주문처리순번

Example: 1
goodsNostringRequired

상품번호

Example: 10002552
itmNostringRequired

단품번호

Example: 001
chngItmNostringRequired

변경단품번호

Example: 002
ordQtyinteger · int32Optional

수량

Example: 1
salePrcinteger · int64Optional

판매가

Example: 5000
goodsNmstringOptional

상품명

Example: 청바지
systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:
Responses
200

성공

No content
post/v1/claim/orderChange/ordChange
POST /api/order/v1/claim/orderChange/ordChange HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 174

[
  {
    "ordNo": "20230809O007943",
    "ordSeq": 1,
    "ordProcSeq": 1,
    "goodsNo": "10002552",
    "itmNo": "001",
    "chngItmNo": "002",
    "ordQty": 1,
    "salePrc": 5000,
    "goodsNm": "청바지",
    "systemType": "10"
  }
]
No content

주문 상품 옵션변경 (FO)

post

기능 설명

  • [FO전용] 주문 옵션을 변경합니다.

상세 설명

  • 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.

  • 단건의 옵션 변경만 가능합니다.

  • 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.

  • 동일단품, 예약상품의 단품은 변경 불가능합니다.

특이사항

  • ST007 cd 91번(옵션변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.

수정번호

  • Release v2.00_241202: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)

Header parameters
AuthorizationanyOptional

Access Token

Body

주문 옵션 변경 DTO

ordNostringRequired

주문번호

Example: 20230809O007943
ordSeqinteger · int32Required

주문순번

Example: 1
ordProcSeqinteger · int32Required

주문처리순번

Example: 1
goodsNostringRequired

상품번호

Example: 10002552
itmNostringRequired

단품번호

Example: 001
chngItmNostringRequired

변경단품번호

Example: 002
ordQtyinteger · int32Optional

수량

Example: 1
salePrcinteger · int64Optional

판매가

Example: 5000
goodsNmstringOptional

상품명

Example: 청바지
systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:
Responses
200

성공

No content
post/v1/claim/orderChange/ordChangeFO
POST /api/order/v1/claim/orderChange/ordChangeFO HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 172

{
  "ordNo": "20230809O007943",
  "ordSeq": 1,
  "ordProcSeq": 1,
  "goodsNo": "10002552",
  "itmNo": "001",
  "chngItmNo": "002",
  "ordQty": 1,
  "salePrc": 5000,
  "goodsNm": "청바지",
  "systemType": "10"
}
No content
이전주문반품
다음주문취소

마지막 업데이트