| 분류체계 | 일반공공행정 - 일반행정 | 제공기관 | 조달청 |
|---|---|---|---|
| 관리부서명 | 전자조달기획과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | JSON+XML |
| 활용신청 | 3548 | 키워드 | 나라장터,낙찰,낙찰정보 |
| 등록일 | 2018-05-11 | 수정일 | 2024-03-22 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 이용허락범위 | |||
| 참고문서 | 조달청_OpenAPI활용가이드_나라장터_낙찰정보서비스_1.4.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지 번호 |
| 서비스키 | ServiceKey | 400 | 필수 | 공공데이터포털에서 받은 인증키 | 공공데이터포털에서 받은 인증키 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1.둥록일시, 2.공고일시, 3.개찰일시, 4.입찰공고번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201605010000 | 검색하고자하는 시작일시 ‘YYYYMMDDHHMM', 조회구분 1,2,3일 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201605052359 | 검색하고자하는 종료일시 'YYYYMMDDHHMM', 조회구분 1,2,3일 경우 필수 |
| 입찰공고번호 | bidNtceNo | 40 | 옵션 | 20160439522 | 검색하고자하는 입찰공고번호. 조회구분 4인 경우 필수 |
| 타입 | type | 4 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 'json' 으로 지정 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메세지 | resultMsg | 50 | 필수 | 정상 | 결과메세지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 4 | 필수 | 17 | 데이터 총 개수 |
| 입찰공고번호 | bidNtceNo | 40 | 필수 | 20160439522 | 입찰공고를 관리하기 위한 번호이며 조달청나라장터 공고건의 형식은 년도(4)+월(2)+순번(5)이며 자체전자조달시스템 보유기관은 각 기관별 형식 별도 사용 |
| 입찰공고차수 | bidNtceOrd | 2 | 필수 | 00 | 입찰공고차수는 해당 입찰공고에 대한 재공고 및 재입찰 등이 발생되었을 경우 증가되는 수 (제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기 |
| 입찰분류번호 | bidClsfcNo | 5 | 필수 | 1 | 동일한 입찰공고번호에 대한 집행일련번호 (제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 재입찰번호 | rbidNo | 2 | 필수 | 1 | 재입찰번호(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 공고구분코드 | ntceDivCd | 1 | 필수 | 1 | 공고구분 1 : 조달청 또는 나라장터 자체 공고건, 2 : 연계 기관 공고건(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 입찰공고명 | bidNtceNm | 100 | 필수 | 30톤급 감시정 조달구매(건조) 요청 | 공사명 또는 사업명이라고도 하며 입찰공고 내용을 요약한 이름(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 참가업체수 | prtcptCnum | 6 | 옵션 | 1 | 참가업체수(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체명 | bidwinnrNm | 100 | 필수 | 광동에프.알.피산업 | 최종낙찰된 업체의 명으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체사업자등록번호 | bidwinnrBizno | 10 | 필수 | 6014668311 | 협상이 완료 후 최종낙찰된 업체의 사업자등록번호임(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체대표자명 | bidwinnrCeoNm | 35 | 옵션 | 한갑수 | 최종낙찰된 업체의 대표자명으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 |
| 최종낙찰업체주소 | bidwinnrAdrs | 200 | 옵션 | 부산광역시 강서구 녹산산단382로60번길 42-0 (송정동) | 협상이 완료 후 최종낙찰된 업체의 주소임 |
| 최종낙찰업체전화번호 | bidwinnrTelNo | 25 | 옵션 | 051-831-2266 | 협상이 완료 후 최종낙찰된 업체의 연락 전화번호임 |
| 최종낙찰금액 | sucsfbidAmt | 21 | 옵션 | 2229500000 | 최종낙찰은 개찰순위 순서대로 협상등을 통해 최종 낙찰된정보를 의미하며 최종낙찰금액은 최종낙찰된 금액으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 (원화,원) |
| 최종낙찰률 | sucsfbidRate | 18 | 옵션 | 99.99 | 예정가격대비 최종낙찰금액으로 최종낙찰금액/예정가격 * 100 으로 계산되며 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 (%)(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한 |
| 실개찰일시 | rlOpengDt | 19 | 옵션 | 2016-05-03 12:00:00 | 실제 개찰일시 “YYYY-MM-DD HH:MM:SS”(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 수요기관코드 | dminsttCd | 7 | 옵션 | 1220000 | 실제 수요기관의 코드로 행자부코드(행정자치부에서 부여한 기관코드)가 있는 경우 행자부코드가 행자부코드가 없는 경우 조달청에서 부여한 수요기관 코드가 표기됨(제공 연계기관 : 한국국 |
| 수요기관명 | dminsttNm | 200 | 옵션 | 관세청 | 중앙조달인 경우 조달사업에 관한 법률 제2조(정의)에 따라 수요물자의 구매 공급 또는 시설공사 계약의 체결을 조달청장에게 요청할 수 있도록 조달청장이 인정하여 등록한 기관 또는 자체전 |
| 등록일시 | rgstDt | 19 | 필수 | 2016-05-12 10:24:42 | 등록일시 "YYYY-MM-DD HH:MM:SS" |
| 최종낙찰일자 | fnlSucsfDate | 10 | 옵션 | 2017-12-14 | 최종낙찰된 일자로 개찰완료된 건에 대하여 제공(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국수자원공사) |
| 최종낙찰업체담당자 | fnlSucsfCorpOfcl | 35 | 옵션 | 한갑수 | 최종낙찰된 업체의 담당자명으로 개찰완료된 건에 대하여 제공(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사) |
| 연계기관명 | linkInsttNm | 200 | 옵션 | 한국전력공사 | 나라장터에 연계를 통하여 입찰 및 계약을 등록한 기관명(자체)전자조달시스템을 운영하는 기관명 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 일반공공행정 - 일반행정 | |
|---|---|---|
| 제공기관 | 조달청 | |
| 관리부서명 | 전자조달기획과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | JSON+XML | |
| 활용신청 | 3548 | |
| 키워드 | 나라장터,낙찰,낙찰정보 | |
| 등록일 | 2018-05-11 | |
| 수정일 | 2024-03-22 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | 조달청_OpenAPI활용가이드_나라장터_낙찰정보서비스_1.4.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지 번호 |
| 서비스키 | ServiceKey | 400 | 필수 | 공공데이터포털에서 받은 인증키 | 공공데이터포털에서 받은 인증키 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1.둥록일시, 2.공고일시, 3.개찰일시, 4.입찰공고번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201605010000 | 검색하고자하는 시작일시 ‘YYYYMMDDHHMM', 조회구분 1,2,3일 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201605052359 | 검색하고자하는 종료일시 'YYYYMMDDHHMM', 조회구분 1,2,3일 경우 필수 |
| 입찰공고번호 | bidNtceNo | 40 | 옵션 | 20160439522 | 검색하고자하는 입찰공고번호. 조회구분 4인 경우 필수 |
| 타입 | type | 4 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 'json' 으로 지정 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메세지 | resultMsg | 50 | 필수 | 정상 | 결과메세지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 4 | 필수 | 17 | 데이터 총 개수 |
| 입찰공고번호 | bidNtceNo | 40 | 필수 | 20160439522 | 입찰공고를 관리하기 위한 번호이며 조달청나라장터 공고건의 형식은 년도(4)+월(2)+순번(5)이며 자체전자조달시스템 보유기관은 각 기관별 형식 별도 사용 |
| 입찰공고차수 | bidNtceOrd | 2 | 필수 | 00 | 입찰공고차수는 해당 입찰공고에 대한 재공고 및 재입찰 등이 발생되었을 경우 증가되는 수 (제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기 |
| 입찰분류번호 | bidClsfcNo | 5 | 필수 | 1 | 동일한 입찰공고번호에 대한 집행일련번호 (제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 재입찰번호 | rbidNo | 2 | 필수 | 1 | 재입찰번호(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 공고구분코드 | ntceDivCd | 1 | 필수 | 1 | 공고구분 1 : 조달청 또는 나라장터 자체 공고건, 2 : 연계 기관 공고건(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 입찰공고명 | bidNtceNm | 100 | 필수 | 30톤급 감시정 조달구매(건조) 요청 | 공사명 또는 사업명이라고도 하며 입찰공고 내용을 요약한 이름(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 참가업체수 | prtcptCnum | 6 | 옵션 | 1 | 참가업체수(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체명 | bidwinnrNm | 100 | 필수 | 광동에프.알.피산업 | 최종낙찰된 업체의 명으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체사업자등록번호 | bidwinnrBizno | 10 | 필수 | 6014668311 | 협상이 완료 후 최종낙찰된 업체의 사업자등록번호임(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 최종낙찰업체대표자명 | bidwinnrCeoNm | 35 | 옵션 | 한갑수 | 최종낙찰된 업체의 대표자명으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 |
| 최종낙찰업체주소 | bidwinnrAdrs | 200 | 옵션 | 부산광역시 강서구 녹산산단382로60번길 42-0 (송정동) | 협상이 완료 후 최종낙찰된 업체의 주소임 |
| 최종낙찰업체전화번호 | bidwinnrTelNo | 25 | 옵션 | 051-831-2266 | 협상이 완료 후 최종낙찰된 업체의 연락 전화번호임 |
| 최종낙찰금액 | sucsfbidAmt | 21 | 옵션 | 2229500000 | 최종낙찰은 개찰순위 순서대로 협상등을 통해 최종 낙찰된정보를 의미하며 최종낙찰금액은 최종낙찰된 금액으로 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 (원화,원) |
| 최종낙찰률 | sucsfbidRate | 18 | 옵션 | 99.99 | 예정가격대비 최종낙찰금액으로 최종낙찰금액/예정가격 * 100 으로 계산되며 개찰결과구분명이 “개찰완료”일 경우 필수 입력 항목임 (%)(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한 |
| 실개찰일시 | rlOpengDt | 19 | 옵션 | 2016-05-03 12:00:00 | 실제 개찰일시 “YYYY-MM-DD HH:MM:SS”(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사, 한국전기연구원) |
| 수요기관코드 | dminsttCd | 7 | 옵션 | 1220000 | 실제 수요기관의 코드로 행자부코드(행정자치부에서 부여한 기관코드)가 있는 경우 행자부코드가 행자부코드가 없는 경우 조달청에서 부여한 수요기관 코드가 표기됨(제공 연계기관 : 한국국 |
| 수요기관명 | dminsttNm | 200 | 옵션 | 관세청 | 중앙조달인 경우 조달사업에 관한 법률 제2조(정의)에 따라 수요물자의 구매 공급 또는 시설공사 계약의 체결을 조달청장에게 요청할 수 있도록 조달청장이 인정하여 등록한 기관 또는 자체전 |
| 등록일시 | rgstDt | 19 | 필수 | 2016-05-12 10:24:42 | 등록일시 "YYYY-MM-DD HH:MM:SS" |
| 최종낙찰일자 | fnlSucsfDate | 10 | 옵션 | 2017-12-14 | 최종낙찰된 일자로 개찰완료된 건에 대하여 제공(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국수자원공사) |
| 최종낙찰업체담당자 | fnlSucsfCorpOfcl | 35 | 옵션 | 한갑수 | 최종낙찰된 업체의 담당자명으로 개찰완료된 건에 대하여 제공(제공 연계기관 : 한국국토정보공사, 한국도로공사, 한국지역난방공사, 한국수자원공사) |
| 연계기관명 | linkInsttNm | 200 | 옵션 | 한국전력공사 | 나라장터에 연계를 통하여 입찰 및 계약을 등록한 기관명(자체)전자조달시스템을 운영하는 기관명 |
샘플코드는 PC에서 확인해주세요.