상품공급협력사

협력사 정보 조회

post

기능설명

• 협력사 정보를 조회하는 API 입니다.

---

상세설명

• 협력사번호 배열 값으로 해당 협력사 정보 목록을 조회합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

협력사 조회관련 조건 Request

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호

Default: 1Example: 1

entrNosstring[]Optional

협력사번호

Default: 1000001

Responses

200

협력사 정보 조회 성공

*/*

협력사 기본 Response

entrNostringOptional

협력사번호

entrNmstringOptional

협력사명

entrGbCdstringOptional

협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자

entrGbCdNmstringOptional

협력사구분코드명

lattstringOptional

위도

lngtstringOptional

경도

trdTypCdstringOptional

거래유형코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사

trdTypCdNmstringOptional

거래유형코드명

trdStatCdstringOptional

거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료

trdStatCdNmstringOptional

거래상태코드명

lgcEntrNostringOptional

기간계협력사번호

rpstmnNmstringOptional

대표자명

bmanNostringOptional

사업자등록번호

corpnNostringOptional

법인번호

btypstringOptional

업태

bkindstringOptional

업종

contStrtDystringOptional

계약시작일자

contEndDystringOptional

계약종료일자

aempNmstringOptional

담당자명

aempTelRgnNostringOptional

담당자전화지역번호

aempTelTxnoNostringOptional

담당자전화국번번호

aempTelEndNostringOptional

담당자전화끝번호

aempCellSctNostringOptional

담당자휴대폰구분번호

aempCellTxnoNostringOptional

담당자휴대폰국번번호

aempCellEndNostringOptional

담당자휴대폰끝번호

faxRgnNostringOptional

팩스지역번호

faxTxnoNostringOptional

팩스국번번호

faxEndNostringOptional

팩스끝번호

bmanKindCdstringOptional

사업자종류코드(VD004) 10:면세업자, 20:일반과세자

zipNoSeqstringOptional

우편번호순번

zipNostringOptional

우편번호

zipAddrstringOptional

우편주소

dtlAddrstringOptional

상세주소

rmkContstringOptional

비고내용

mrgnRateGbCdstringOptional

마진율구분코드(VD008) 10:고정마진, 20:구간마진

mrgnRateGbCdNmstringOptional

마진율구분코드명

mrgnRate1stringOptional

마진율1

mrgnRate2stringOptional

마진율2

900

협력사 정보 조회 실패

*/*

post

/v1/vendor/list

HTTPcURLJavaScriptPython

POST /api/goods/v1/vendor/list HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "langCd": "ko",
  "siteNo": 1,
  "entrNos": "1000001"
}

[
  {
    "entrNo": "text",
    "entrNm": "text",
    "entrGbCd": "text",
    "entrGbCdNm": "text",
    "latt": "text",
    "lngt": "text",
    "trdTypCd": "text",
    "trdTypCdNm": "text",
    "trdStatCd": "text",
    "trdStatCdNm": "text",
    "lgcEntrNo": "text",
    "rpstmnNm": "text",
    "bmanNo": "text",
    "corpnNo": "text",
    "btyp": "text",
    "bkind": "text",
    "contStrtDy": "text",
    "contEndDy": "text",
    "aempNm": "text",
    "aempTelRgnNo": "text",
    "aempTelTxnoNo": "text",
    "aempTelEndNo": "text",
    "aempCellSctNo": "text",
    "aempCellTxnoNo": "text",
    "aempCellEndNo": "text",
    "faxRgnNo": "text",
    "faxTxnoNo": "text",
    "faxEndNo": "text",
    "bmanKindCd": "text",
    "zipNoSeq": "text",
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "rmkCont": "text",
    "mrgnRateGbCd": "text",
    "mrgnRateGbCdNm": "text",
    "mrgnRate1": "text",
    "mrgnRate2": "text"
  }
]

협력사 평가등급 조회

get

기능설명

• 협력사 평가등급을 조회하는 API 입니다.

---

상세설명

• 협력사번호에 따라 협력사의 '전월' 평가등급을 조회합니다.

• 해당 업체의 월집계 테이블의 정보가 1건도 없을 시 (조회결과가 없는 경우)

• '평가등급코드 = 우수' (VD009)

• '통합점수 = 95'

---

수정번호

• Release v2.00_240613: FO 협력사 평가등급 조회 기능 신규 개발

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNostringRequired

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

협력사 평가등급 조회 성공

*/*

협력사 평가등급 Response

evltGradeCdstringOptional

평가등급코드(VD009)

cmbnScrinteger · int32Optional

통합점수

900

협력사 평가등급 조회 실패

*/*

get

/v1/vendor/getEvltGrade

HTTPcURLJavaScriptPython

GET /api/goods/v1/vendor/getEvltGrade?entrNo=text HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "evltGradeCd": "text",
  "cmbnScr": 1
}