협력사 팝업

협력사 정보 수정

put

기능설명

• 협력사 정보 수정 API 입니다.

---

상세설명

• 협력사 정보를 수정합니다.

  • 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 수정합니다.

---

검증내용

• 수정 시 협력사 정보의 유효성을 검증합니다.

  • 협력사명은 중복이 불가합니다.

• 수정 시 담당자 정보의 유효성을 검증합니다.

  • 추가, 수정 필수 입력: 직무코드, 담당자명

  • 삭제 필수 입력: 담당자 순번

• 수정 시 배송정책 정보의 유효성을 검증합니다.

  • 추가, 수정 필수 입력: 협력사번호, 배송비금액, 배송비형태, 기준금액, 회수반품비, 교환배송비

  • 삭제 필수 입력: 협력사 번호

• 수정 시 배송지 정보의 유효성을 검증합니다.

  • 추가, 수정 필수 입력: 협력사번호, 배송지명, 우편번호순번, 상세주소, 휴대폰번호

  • 삭제 필수 입력: 협력사배송지번호

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

협력사 정보 저장 Request

Responses

200

OK

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

put

/v1/popup/partnerMgmt/updateVendorWithOtherData

HTTPcURLJavaScriptPython

PUT /api/bo/v1/popup/partnerMgmt/updateVendorWithOtherData HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 3416

{
  "createEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "updateEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "deleteEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "createEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "updateEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "deleteEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "createEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "updateEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "deleteEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "etEntrBase": {
    "entrNo": "text",
    "entrNm": "text",
    "entrGbCd": "text",
    "latt": 1,
    "lngt": 1,
    "trdTypCd": "text",
    "buyTypCdNm": "text",
    "trdStatCd": "text",
    "lgcEntrNo": "text",
    "rpstmnNm": "text",
    "bmanNo": "text",
    "bmanKindNm": "text",
    "corpnNo": "text",
    "btyp": "text",
    "bkind": "text",
    "contStrtDy": "2026-02-27",
    "contEndDy": "2026-02-27",
    "aempNm": "text",
    "aempTelRgnNo": "text",
    "aempTelTxnoNo": "text",
    "aempTelEndNo": "text",
    "aempCellSctNo": "text",
    "aempCellTxnoNo": "text",
    "aempCellEndNo": "text",
    "faxRgnNo": "text",
    "faxTxnoNo": "text",
    "faxEndNo": "text",
    "bmanKindCd": "text",
    "zipNoSeq": 1,
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "rmkCont": "text",
    "mrgnRateGbCd": "text",
    "mrgnRate1": 1,
    "mrgnRate2": 1,
    "singleMrgnRate": 1,
    "intervalMrgnRate1": 1,
    "intervalMrgnRate2": 1,
    "ecpnUseYn": "text",
    "ecpnLinkGbCd": "text",
    "ecpnLinkGbNm": "text",
    "entrGbNm": "text",
    "trdStatNm": "text",
    "itmSaleStatCd": 40,
    "saleStatChgCausCd": 43,
    "rtGrpNo": "text",
    "endPartnerSaleAndAuthGroup": "text"
  }
}

200

OK

{
  "timestamp": "2026-02-27T18:20:46.901Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

협력사 정보 저장

post

기능설명

• 협력사 정보 저장 API 입니다.

---

상세설명

• 협력사 정보를 저장합니다.

• 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 저장합니다. --- ## 수정번호 * Release v2.00_240627: 추가 배송비 정보 등록 기능 추가

---

검증내용

• 저장 시 협력사 정보의 유효성을 검증합니다.

  • 협력사명은 중복이 불가합니다.

  • 필수 입력: 협력사명, 사업자종류코드, 사업자번호, 거래형태코드, 거래상태코드, 계약시작일자, 계약종료일자, 담당자휴대폰번호, 대표자명, 우편번호순번, 우편번호, 우편주소, 상세주소

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

협력사 정보 저장 Request

Responses

200

OK

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post

/v1/popup/partnerMgmt/saveVendorWithOtherData

HTTPcURLJavaScriptPython

POST /api/bo/v1/popup/partnerMgmt/saveVendorWithOtherData HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 3416

{
  "createEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "updateEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "deleteEtEntrAempInfoList": [
    {
      "entrNo": "1000002",
      "aempSeq": 1,
      "dutyCd": "text",
      "aempNm": "엑스투비",
      "telRgnNo": "02",
      "telTxnoNo": "554",
      "telEndNo": "4668",
      "cellSctNo": "010",
      "cellTxnoNo": "1111",
      "cellEndNo": "1111",
      "emailAddr": "[e-mail]"
    }
  ],
  "createEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "updateEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "deleteEtDeliPolcBaseList": [
    {
      "entrNo": "text",
      "entrNm": "text",
      "deliPolcNo": "text",
      "dlexTypCd": "text",
      "stdAmt": 1,
      "dlexAmt": 1,
      "wthdRtnAmt": 1,
      "exchDlex": 1,
      "addDlexAmt": 1,
      "useYn": "text",
      "goodsCnt": 1,
      "deliRegnGrpNo": "text"
    }
  ],
  "createEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "updateEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "deleteEtEntrDlvpInfoList": [
    {
      "entrDlvpNo": "10000000",
      "entrNo": "1000002",
      "dlvpTypCd": "10",
      "dlvpNm": "배송지명",
      "useYn": "Y",
      "zipNoSeq": 5836,
      "zipNo": "05836",
      "zipAddr": "우편주소",
      "dtlAddr": "상세주소",
      "utakmnNm": "담당자명",
      "aempTelRgnNo": "02",
      "aempTelTxnoNo": "554",
      "aempTelEndNo": "4668",
      "aempCellSctNo": "010",
      "aempCellTxnoNo": "1111",
      "aempCellEndNo": "1111"
    }
  ],
  "etEntrBase": {
    "entrNo": "text",
    "entrNm": "text",
    "entrGbCd": "text",
    "latt": 1,
    "lngt": 1,
    "trdTypCd": "text",
    "buyTypCdNm": "text",
    "trdStatCd": "text",
    "lgcEntrNo": "text",
    "rpstmnNm": "text",
    "bmanNo": "text",
    "bmanKindNm": "text",
    "corpnNo": "text",
    "btyp": "text",
    "bkind": "text",
    "contStrtDy": "2026-02-27",
    "contEndDy": "2026-02-27",
    "aempNm": "text",
    "aempTelRgnNo": "text",
    "aempTelTxnoNo": "text",
    "aempTelEndNo": "text",
    "aempCellSctNo": "text",
    "aempCellTxnoNo": "text",
    "aempCellEndNo": "text",
    "faxRgnNo": "text",
    "faxTxnoNo": "text",
    "faxEndNo": "text",
    "bmanKindCd": "text",
    "zipNoSeq": 1,
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "rmkCont": "text",
    "mrgnRateGbCd": "text",
    "mrgnRate1": 1,
    "mrgnRate2": 1,
    "singleMrgnRate": 1,
    "intervalMrgnRate1": 1,
    "intervalMrgnRate2": 1,
    "ecpnUseYn": "text",
    "ecpnLinkGbCd": "text",
    "ecpnLinkGbNm": "text",
    "entrGbNm": "text",
    "trdStatNm": "text",
    "itmSaleStatCd": 40,
    "saleStatChgCausCd": 43,
    "rtGrpNo": "text",
    "endPartnerSaleAndAuthGroup": "text"
  }
}

200

OK

{
  "timestamp": "2026-02-27T18:20:46.901Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

협력사 정보 조회

get

기능설명

• 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.

상세설명

• 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadbooleanOptional

payload

errorbooleanOptional

is error

get

/v1/popup/partnerMgmt/isDuplicateWithBusinessNo

HTTPcURLJavaScriptPython

GET /api/bo/v1/popup/partnerMgmt/isDuplicateWithBusinessNo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "timestamp": "2026-02-27T18:20:46.901Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": true,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

협력사 정보 조회

get

기능설명

• 협력사 번호 기준으로 협력사 정보를 조회합니다.

상세설명

• 협력사 번호 기준으로 협력사 정보를 조회합니다.

• 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보, 등록된 사업자번호 목록을 조회합니다. --- ## 수정번호 * Release v2.00_240627: 배송비 정책 정보 조회 시 추가 배송비 조회 추가

---

특이사항

• 등록된 협력사의 사업자 번호를 조회하여 저장 시, 사업자 번호 중복 체크에 사용합니다.

---

코드정리

• 선택구분 : C:등록, RU:상세조회 및 수정

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNostringRequired

협력사번호

Responses

200

OK

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get

/v1/popup/partnerMgmt/getPartnerDetailWithOtherData

HTTPcURLJavaScriptPython

GET /api/bo/v1/popup/partnerMgmt/getPartnerDetailWithOtherData?entrNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "timestamp": "2026-02-27T18:20:46.901Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "etEntrBase": {
      "entrNo": "text",
      "entrNm": "text",
      "entrGbCd": "text",
      "latt": 1,
      "lngt": 1,
      "trdTypCd": "text",
      "buyTypCdNm": "text",
      "trdStatCd": "text",
      "lgcEntrNo": "text",
      "rpstmnNm": "text",
      "bmanNo": "text",
      "bmanKindNm": "text",
      "corpnNo": "text",
      "btyp": "text",
      "bkind": "text",
      "contStrtDy": "2026-02-27",
      "contEndDy": "2026-02-27",
      "aempNm": "text",
      "aempTelRgnNo": "text",
      "aempTelTxnoNo": "text",
      "aempTelEndNo": "text",
      "aempCellSctNo": "text",
      "aempCellTxnoNo": "text",
      "aempCellEndNo": "text",
      "faxRgnNo": "text",
      "faxTxnoNo": "text",
      "faxEndNo": "text",
      "bmanKindCd": "text",
      "zipNoSeq": 1,
      "zipNo": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "rmkCont": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1,
      "singleMrgnRate": 1,
      "intervalMrgnRate1": 1,
      "intervalMrgnRate2": 1,
      "ecpnUseYn": "text",
      "ecpnLinkGbCd": "text",
      "ecpnLinkGbNm": "text",
      "entrGbNm": "text",
      "trdStatNm": "text",
      "itmSaleStatCd": 40,
      "saleStatChgCausCd": 43,
      "rtGrpNo": "text"
    },
    "etDeliPolcBaseList": [
      {
        "entrNo": "text",
        "entrNm": "text",
        "deliPolcNo": "text",
        "dlexTypCd": "text",
        "stdAmt": 1,
        "dlexAmt": 1,
        "wthdRtnAmt": 1,
        "exchDlex": 1,
        "addDlexAmt": 1,
        "useYn": "text",
        "goodsCnt": 1,
        "deliRegnGrpNo": "text"
      }
    ],
    "etEntrAempInfoList": [
      {
        "entrNo": "text",
        "aempSeq": 1,
        "dutyCd": "text",
        "aempNm": "text",
        "telRgnNo": "text",
        "telTxnoNo": "text",
        "telEndNo": "text",
        "cellSctNo": "text",
        "cellTxnoNo": "text",
        "cellEndNo": "text",
        "emailAddr": "text",
        "telNo": "text",
        "cellNo": "text"
      }
    ],
    "etEntrDlvpInfoList": [
      {
        "entrDlvpNo": "text",
        "entrNo": "text",
        "dlvpTypCd": "text",
        "dlvpNm": "text",
        "useYn": "text",
        "zipNoSeq": 1,
        "zipNo": "text",
        "zipAddr": "text",
        "dtlAddr": "text",
        "utakmnNm": "text",
        "aempTelRgnNo": "text",
        "aempTelTxnoNo": "text",
        "aempTelEndNo": "text",
        "aempCellSctNo": "text",
        "aempCellTxnoNo": "text",
        "aempCellEndNo": "text",
        "aempTelNo": "text",
        "aempCellNo": "text"
      }
    ],
    "bmanNoList": [
      "text"
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}