| 분류체계 | 일반공공행정 - 일반행정 | 제공기관 | 조달청 |
|---|---|---|---|
| 관리부서명 | 전자조달기획과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 359 | 키워드 | 나라장터,조달청,조달요청 |
| 등록일 | 2016-12-28 | 수정일 | 2021-10-15 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 이용허락범위 | |||
| 참고문서 | 조달청_OpenAPI활용가이드_나라장터_조달요청서비스_1.3.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지 번호 |
| 서비스키 | ServiceKey | 400 | 필수 | 공공데이터포털에서 받은 인증키 | 공공데이터포털에서 받은 인증키 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1:입력일시, 2:조달요청번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201608310000 | 검색하고자하는 입력일시범위 시작 ‘YYYYMMDDHHMM’, 조회구분이 1인 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201608312359 | 검색하고자하는 입력일시범위 종료 ‘YYYYMMDDHHMM’, 조회구분이 1인 경우 필수 |
| 조달요청번호 | prcrmntReqNo | 13 | 옵션 | 121682049300 | 검색하고자하는 조달요청번호(10자리이상입력) 조회구분 2일 경우 필수. 나라장터화면에서 접수번호 |
| 타입 | type | 4 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 ‘json’ 으로 지정 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메세지 | resultMsg | 50 | 필수 | 정상 | 결과메세지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 4 | 필수 | 17 | 데이터 총 개수 |
| 업무구분명 | bsnsDivNm | 30 | 필수 | 물품 | 입찰업무를 구분하는 명으로 물품, 용역, 공사, 외자로 구분함 |
| 조달요청번호 | prcrmntReqNo | 13 | 옵션 | 121682049300 | 발주기관(또는 발주부서)의 계약의뢰 문서를 접수하면서 생성한 관리대장번호 |
| 계약체결형태명 | cntrctCnclsStleNm | 100 | 옵션 | 총액계약 | *총액계약은 계약목적물 전체에 대하여 단가가 아닌 총액으로 체결하는 계약형태, *단가계약은 수요 빈도가 많은 품목에 대하여 단가에 의해 예정수량을 명시하고 체결하는 계약형태, *제3자단가계약은 각 수요기관에서 공통적으로 필요로 하는 수요물자를 계약시 미리 단가만을 정하여 계약을 체결하고 각 수요기관에서 직접 납품요구하여 구매하는 계약형태 |
| 대표납품장소 | rprsntDlvrPlce | 256 | 옵션 | 과업지시서에 의함 | 조달요청의 대표납품장소 |
| 발주기관코드 | orderInsttCd | 7 | 옵션 | 7001105 | 발주기관의 코드로 행자부코드(행정자치부에서 부여한 기관코드)가 있는 경우 행자부코드가 행자부코드가 없는 경우 조달청에서 부여한 발주기관 코드가 표기됨 |
| 발주기관명 | orderInsttNm | 200 | 옵션 | 국민안전처 중앙소방본부 | 발주기관의 명 |
| 리스여부 | leaseYn | 1 | 옵션 | N | 총액 조달요청일 경우 수요기관이 물품대금을 리스계약을 통해 지불할 것인지에 대한 구분(Y/N) |
| 접수일시 | rcptDt | 19 | 옵션 | 2016-08-31 12:00:00 | 담당자가 조달요청서를 접수한 일시 “YYYY-MM-DD HH:MM:SS” |
| 조달요청명 | prcrmntReqNm | 100 | 옵션 | 중앙119구급상황관리센터 구축사업 정보통신 감리용역 | 조달요청의 조달요청명 |
| 대표품명 | rprsntPrdctClsfcNoNm | 200 | 옵션 | 정보통신감리용역 | 물품분류번호 8자리에 해당하는 물품의 한글이름 |
| 대표단가 | rprsntUprc | 25 | 옵션 | 66417000 | 조달요청의 대표단가 |
| 대표수량 | rprsntQty | 25 | 옵션 | 1 | 조달요청의 대표수량 |
| 대표금액 | rprsntAmt | 25 | 옵션 | 66417000 | 조달요청의 대표금액(원화, 원) |
| 예산금액 | bdgtAmt | 21 | 옵션 | 67198720 | 품대에 수수료를 합한금액 (원화, 원) |
| 조달요청담당자사번 | prcrmntReqOfclEmpNo | 8 | 옵션 | ***** | 조달요청시 조달청 담당자의 사번 |
| 조달요청담당자명 | prcrmntReqOfclNm | 35 | 옵션 | 이은주 | 조달요청시 조달청 담당자의 명 |
| 조달요청정보URL | prcrmntReqInfoUrl | 500 | 옵션 | http://www.g2b.go.kr:8091/cm/contstus/selectPpsItemCtrtReqStusDtl.do?procmntReqNo=121682049300&taskClCd=&contractClCd=1 | 나라장터에서 조달요청상세정보를 확인할수 있는 URL |
| 대표단위 | rprsntUnit | 30 | 옵션 | 식 | 조달요청의 대표단위 |
| 대표규격명세내용 | rprsntSpecDtlsCntnts | 200 | 옵션 | 과업지시서에 의함 | 조달요청의 대표규격명세내용 |
| 대표납기일자 | rprsntDedtDate | 10 | 옵션 | 2016-11-30 | 조달요청의 대표납기일자(YYYY-MM-DD) |
| 대표납품일수 | rprsntDlvrDaynum | 5 | 옵션 | 90 | 조달요청의 대표납품일수 |
| 대표물품식별번호 | rprsntPrdctidntno | 8 | 옵션 | 20165060 | 조달요청의 대표물품식별번호 |
| 초년도통합계약식별번호 | frstyearUntyCntrctIdntNo | 19 | 필수 | 2016-08-31 12:00:00 | 장기계약시 초년도 통합계약식별번호, 입력일시 “YYYY-MM-DD HH:MM:SS” |
| 입력일시 | inptDt | 19 | 필수 | 2016-08-31 12:00:00 | 입력일시 “YYYY-MM-DD HH:MM:SS” |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 일반공공행정 - 일반행정 | |
|---|---|---|
| 제공기관 | 조달청 | |
| 관리부서명 | 전자조달기획과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 359 | |
| 키워드 | 나라장터,조달청,조달요청 | |
| 등록일 | 2016-12-28 | |
| 수정일 | 2021-10-15 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | 조달청_OpenAPI활용가이드_나라장터_조달요청서비스_1.3.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지 번호 |
| 서비스키 | ServiceKey | 400 | 필수 | 공공데이터포털에서 받은 인증키 | 공공데이터포털에서 받은 인증키 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1:입력일시, 2:조달요청번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201608310000 | 검색하고자하는 입력일시범위 시작 ‘YYYYMMDDHHMM’, 조회구분이 1인 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201608312359 | 검색하고자하는 입력일시범위 종료 ‘YYYYMMDDHHMM’, 조회구분이 1인 경우 필수 |
| 조달요청번호 | prcrmntReqNo | 13 | 옵션 | 121682049300 | 검색하고자하는 조달요청번호(10자리이상입력) 조회구분 2일 경우 필수. 나라장터화면에서 접수번호 |
| 타입 | type | 4 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 ‘json’ 으로 지정 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메세지 | resultMsg | 50 | 필수 | 정상 | 결과메세지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 4 | 필수 | 17 | 데이터 총 개수 |
| 업무구분명 | bsnsDivNm | 30 | 필수 | 물품 | 입찰업무를 구분하는 명으로 물품, 용역, 공사, 외자로 구분함 |
| 조달요청번호 | prcrmntReqNo | 13 | 옵션 | 121682049300 | 발주기관(또는 발주부서)의 계약의뢰 문서를 접수하면서 생성한 관리대장번호 |
| 계약체결형태명 | cntrctCnclsStleNm | 100 | 옵션 | 총액계약 | *총액계약은 계약목적물 전체에 대하여 단가가 아닌 총액으로 체결하는 계약형태, *단가계약은 수요 빈도가 많은 품목에 대하여 단가에 의해 예정수량을 명시하고 체결하는 계약형태, *제3자단가계약은 각 수요기관에서 공통적으로 필요로 하는 수요물자를 계약시 미리 단가만을 정하여 계약을 체결하고 각 수요기관에서 직접 납품요구하여 구매하는 계약형태 |
| 대표납품장소 | rprsntDlvrPlce | 256 | 옵션 | 과업지시서에 의함 | 조달요청의 대표납품장소 |
| 발주기관코드 | orderInsttCd | 7 | 옵션 | 7001105 | 발주기관의 코드로 행자부코드(행정자치부에서 부여한 기관코드)가 있는 경우 행자부코드가 행자부코드가 없는 경우 조달청에서 부여한 발주기관 코드가 표기됨 |
| 발주기관명 | orderInsttNm | 200 | 옵션 | 국민안전처 중앙소방본부 | 발주기관의 명 |
| 리스여부 | leaseYn | 1 | 옵션 | N | 총액 조달요청일 경우 수요기관이 물품대금을 리스계약을 통해 지불할 것인지에 대한 구분(Y/N) |
| 접수일시 | rcptDt | 19 | 옵션 | 2016-08-31 12:00:00 | 담당자가 조달요청서를 접수한 일시 “YYYY-MM-DD HH:MM:SS” |
| 조달요청명 | prcrmntReqNm | 100 | 옵션 | 중앙119구급상황관리센터 구축사업 정보통신 감리용역 | 조달요청의 조달요청명 |
| 대표품명 | rprsntPrdctClsfcNoNm | 200 | 옵션 | 정보통신감리용역 | 물품분류번호 8자리에 해당하는 물품의 한글이름 |
| 대표단가 | rprsntUprc | 25 | 옵션 | 66417000 | 조달요청의 대표단가 |
| 대표수량 | rprsntQty | 25 | 옵션 | 1 | 조달요청의 대표수량 |
| 대표금액 | rprsntAmt | 25 | 옵션 | 66417000 | 조달요청의 대표금액(원화, 원) |
| 예산금액 | bdgtAmt | 21 | 옵션 | 67198720 | 품대에 수수료를 합한금액 (원화, 원) |
| 조달요청담당자사번 | prcrmntReqOfclEmpNo | 8 | 옵션 | ***** | 조달요청시 조달청 담당자의 사번 |
| 조달요청담당자명 | prcrmntReqOfclNm | 35 | 옵션 | 이은주 | 조달요청시 조달청 담당자의 명 |
| 조달요청정보URL | prcrmntReqInfoUrl | 500 | 옵션 | http://www.g2b.go.kr:8091/cm/contstus/selectPpsItemCtrtReqStusDtl.do?procmntReqNo=121682049300&taskClCd=&contractClCd=1 | 나라장터에서 조달요청상세정보를 확인할수 있는 URL |
| 대표단위 | rprsntUnit | 30 | 옵션 | 식 | 조달요청의 대표단위 |
| 대표규격명세내용 | rprsntSpecDtlsCntnts | 200 | 옵션 | 과업지시서에 의함 | 조달요청의 대표규격명세내용 |
| 대표납기일자 | rprsntDedtDate | 10 | 옵션 | 2016-11-30 | 조달요청의 대표납기일자(YYYY-MM-DD) |
| 대표납품일수 | rprsntDlvrDaynum | 5 | 옵션 | 90 | 조달요청의 대표납품일수 |
| 대표물품식별번호 | rprsntPrdctidntno | 8 | 옵션 | 20165060 | 조달요청의 대표물품식별번호 |
| 초년도통합계약식별번호 | frstyearUntyCntrctIdntNo | 19 | 필수 | 2016-08-31 12:00:00 | 장기계약시 초년도 통합계약식별번호, 입력일시 “YYYY-MM-DD HH:MM:SS” |
| 입력일시 | inptDt | 19 | 필수 | 2016-08-31 12:00:00 | 입력일시 “YYYY-MM-DD HH:MM:SS” |
샘플코드는 PC에서 확인해주세요.