| 분류체계 | 일반공공행정 - 일반행정 | 제공기관 | 조달청 |
|---|---|---|---|
| 관리부서명 | 전자조달기획과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | JSON+XML |
| 활용신청 | 104 | 키워드 | 민간개방, 나라장터, 조달청 |
| 등록일 | 2018-04-05 | 수정일 | 2019-06-19 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 이용허락범위 | |||
| 참고문서 | 조달청_OpenAPI활용가이드_누리장터_민간계약정보서비스_1.2.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 타입 | type | 5 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 'json' 으로 지정 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1:등록일시, 2:통합계약번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201608310 | 검색하고자하는 등록일시 범위 시작 'YYYYMMDDHHMM' 조회구분이 1인 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201608312359 | 검색하고자하는 등록일시범위 종료 'YYYYMMDDHHMM' 조회구분이 1인 경우 필수 |
| 통합계약번호 | untyCntrctNo | 13 | 옵션 | 2016050000077 | 검색하고자하는 통합계약번호 조회구분이 2인 경우 필수 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 통합계약번호 | untyCntrctNo | 13 | 필수 | 2016050000077 | 연계 데이터 입력시 등록되는 계약번호로 계약현황 데이터의 식별자 |
| 업무구분명 | bsnsDivNm | 30 | 필수 | 물품 | 누리장터 업무를 구분하는 명으로 물품, 용역, 공사, 기타로 구분함 |
| 확정계약번호 | dcsnCntrctNo | 35 | 옵션 | 2016050001800 | 계약번호(11)+ 계약수정차수(2) |
| 계약참조번호 | cntrctRefNo | 35 | 옵션 | 2016050001800 | 계약번호(11)+ 계약수정차수(2) |
| 계약명 | cntrctNm | 100 | 옵션 | 종합경기장 제1종 육상트랙 보수용 관급 탄성포장재 구매설치 | 공사명 또는 사업명이라고도 하며 계약내용을 요약한 이름 |
| 공동계약여부 | cmmnCntrctYn | 1 | 필수 | N | 공동계약의 경우 공사/제조 기타의 계약에 있어서 필요하다고 인정할 때 계약 상대자를 2인 이상과 체결하는 계약이며 단독계약은 계약상대자를 1인으로 하는 통상적인 계약을 미함.(Y/N) |
| 계약체결일자 | cntrctCnclsDate | 10 | 옵션 | 2016-05-02 | 계약이 성립된 체결일자 ”YYYY-MM-DD” |
| 계약기간 | cntrctPrd | 70 | 옵션 | 2016.05.02 ~ 2016.06.03 | 계약의 효력이 있는 기간 |
| 총계약금액 | totCntrctAmt | 25 | 필수 | 0 | 장기계속계약의 경우에만 발생되며 장기계속계약 전체 계약금액(총부기금액) 을 의미함(원화,원) |
| 금차계약금액 | thtmCntrctAmt | 25 | 옵션 | 153977000 | 계약의 금차계약금액(원화,원) |
| 보증금률 | grntymnyRate | 25 | 옵션 | 10 | 계약의 보증금율(%) |
| 하자보증금률 | dfctGrntymnyRate | 25 | 옵션 | 10 | 계약의 하자보증금율(%) |
| 계약정보URL | cntrctInfoUrl | 500 | 옵션 | http://www.g2b.go.kr | 계약정보가 등록 되어 있는 사이트URL |
| 지급구분명 | payDivNm | 30 | 옵션 | 직불 | 계약의 지급구분명 |
| 계약기관코드 | cntrctInsttCd | 7 | 필수 | 4230000 | 누리장터 계약건의 계약기관정보(민간수요자코드) |
| 계약기관명 | cntrctInsttNm | 200 | 옵션 | 강원도 속초시 | 누리장터 계약건의 계약기관명(민간수요자명) |
| 계약담당부서명 | cntrctInsttChrgDeptNm | 100 | 옵션 | 회계과 | 누리장터 계약건의 계약기관 담당 부서명(민간수요자담당부서명) |
| 계약담당자명 | cntrctInsttOfclNm | 100 | 옵션 | 김형일 | 누리장터 계약건의 계약기관 담당자명(민간수요자담당자명) |
| 계약담당자전화번호 | cntrctInsttOfclTelNo | 25 | 옵션 | 033-639-2272 | 계약기관의 담당자 전화번호 핸드폰번호일 경우 '*'처리 |
| 계약담당자팩스번호 | cntrctInsttOfclFaxNo | 25 | 옵션 | 033-639-2396 | 계약기관담당자팩스번호 핸드폰번호일 경우 '*'처리 |
| 업체목록 | corpList | 4000 | 옵션 | [1^주계약업체^단독^삼성포리머 주식회사^대한민국^100^김평기^임득재] | 업체목록 [순번^업체구분^공동도급방식구분^업체명^대표자명^국적명^지분율^채권자명^담당자성명],[순번^업체구분^공동도급방식구분^업체명^대표자명^국적명^지분율^채권자명^담당자성명], |
| 계약상세정보URL | cntrctDtlInfoUrl | 500 | 옵션 | http://www.g2b.go.kr:8067/contract/contDetail.jsp?Union_number=2016050000077 | 나라장터화면에서 계약상세정보를 확인 할 수 있는 URL |
| 채권자명 | crdtrNm | 200 | 옵션 | 속초시장 | 계약의 채권자명 |
| 계약체결방법명 | cntrctCnclsMthdNm | 30 | 옵션 | 일반경쟁 | 계약체결의 방법을 구분하는 명 |
| 등록일시 | rgstDt | 19 | 필수 | 2016-10-09 12:00:00 | 등록일시 "YYYY-MM-DD HH:MM:SS" |
| 변경일시 | chgDt | 19 | 옵션 | 2016-10-09 12:00:00 | 변경일시 "YYYY-MM-DD HH:MM:SS" |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 일반공공행정 - 일반행정 | |
|---|---|---|
| 제공기관 | 조달청 | |
| 관리부서명 | 전자조달기획과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | JSON+XML | |
| 활용신청 | 104 | |
| 키워드 | 민간개방, 나라장터, 조달청 | |
| 등록일 | 2018-04-05 | |
| 수정일 | 2019-06-19 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | 조달청_OpenAPI활용가이드_누리장터_민간계약정보서비스_1.2.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 타입 | type | 5 | 옵션 | json | 오픈API 리턴 타입을 JSON으로 받고 싶을 경우 'json' 으로 지정 |
| 조회구분 | inqryDiv | 1 | 필수 | 1 | 검색하고자하는 조회구분 1:등록일시, 2:통합계약번호 |
| 조회시작일시 | inqryBgnDt | 12 | 옵션 | 201608310 | 검색하고자하는 등록일시 범위 시작 'YYYYMMDDHHMM' 조회구분이 1인 경우 필수 |
| 조회종료일시 | inqryEndDt | 12 | 옵션 | 201608312359 | 검색하고자하는 등록일시범위 종료 'YYYYMMDDHHMM' 조회구분이 1인 경우 필수 |
| 통합계약번호 | untyCntrctNo | 13 | 옵션 | 2016050000077 | 검색하고자하는 통합계약번호 조회구분이 2인 경우 필수 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 통합계약번호 | untyCntrctNo | 13 | 필수 | 2016050000077 | 연계 데이터 입력시 등록되는 계약번호로 계약현황 데이터의 식별자 |
| 업무구분명 | bsnsDivNm | 30 | 필수 | 물품 | 누리장터 업무를 구분하는 명으로 물품, 용역, 공사, 기타로 구분함 |
| 확정계약번호 | dcsnCntrctNo | 35 | 옵션 | 2016050001800 | 계약번호(11)+ 계약수정차수(2) |
| 계약참조번호 | cntrctRefNo | 35 | 옵션 | 2016050001800 | 계약번호(11)+ 계약수정차수(2) |
| 계약명 | cntrctNm | 100 | 옵션 | 종합경기장 제1종 육상트랙 보수용 관급 탄성포장재 구매설치 | 공사명 또는 사업명이라고도 하며 계약내용을 요약한 이름 |
| 공동계약여부 | cmmnCntrctYn | 1 | 필수 | N | 공동계약의 경우 공사/제조 기타의 계약에 있어서 필요하다고 인정할 때 계약 상대자를 2인 이상과 체결하는 계약이며 단독계약은 계약상대자를 1인으로 하는 통상적인 계약을 미함.(Y/N) |
| 계약체결일자 | cntrctCnclsDate | 10 | 옵션 | 2016-05-02 | 계약이 성립된 체결일자 ”YYYY-MM-DD” |
| 계약기간 | cntrctPrd | 70 | 옵션 | 2016.05.02 ~ 2016.06.03 | 계약의 효력이 있는 기간 |
| 총계약금액 | totCntrctAmt | 25 | 필수 | 0 | 장기계속계약의 경우에만 발생되며 장기계속계약 전체 계약금액(총부기금액) 을 의미함(원화,원) |
| 금차계약금액 | thtmCntrctAmt | 25 | 옵션 | 153977000 | 계약의 금차계약금액(원화,원) |
| 보증금률 | grntymnyRate | 25 | 옵션 | 10 | 계약의 보증금율(%) |
| 하자보증금률 | dfctGrntymnyRate | 25 | 옵션 | 10 | 계약의 하자보증금율(%) |
| 계약정보URL | cntrctInfoUrl | 500 | 옵션 | http://www.g2b.go.kr | 계약정보가 등록 되어 있는 사이트URL |
| 지급구분명 | payDivNm | 30 | 옵션 | 직불 | 계약의 지급구분명 |
| 계약기관코드 | cntrctInsttCd | 7 | 필수 | 4230000 | 누리장터 계약건의 계약기관정보(민간수요자코드) |
| 계약기관명 | cntrctInsttNm | 200 | 옵션 | 강원도 속초시 | 누리장터 계약건의 계약기관명(민간수요자명) |
| 계약담당부서명 | cntrctInsttChrgDeptNm | 100 | 옵션 | 회계과 | 누리장터 계약건의 계약기관 담당 부서명(민간수요자담당부서명) |
| 계약담당자명 | cntrctInsttOfclNm | 100 | 옵션 | 김형일 | 누리장터 계약건의 계약기관 담당자명(민간수요자담당자명) |
| 계약담당자전화번호 | cntrctInsttOfclTelNo | 25 | 옵션 | 033-639-2272 | 계약기관의 담당자 전화번호 핸드폰번호일 경우 '*'처리 |
| 계약담당자팩스번호 | cntrctInsttOfclFaxNo | 25 | 옵션 | 033-639-2396 | 계약기관담당자팩스번호 핸드폰번호일 경우 '*'처리 |
| 업체목록 | corpList | 4000 | 옵션 | [1^주계약업체^단독^삼성포리머 주식회사^대한민국^100^김평기^임득재] | 업체목록 [순번^업체구분^공동도급방식구분^업체명^대표자명^국적명^지분율^채권자명^담당자성명],[순번^업체구분^공동도급방식구분^업체명^대표자명^국적명^지분율^채권자명^담당자성명], |
| 계약상세정보URL | cntrctDtlInfoUrl | 500 | 옵션 | http://www.g2b.go.kr:8067/contract/contDetail.jsp?Union_number=2016050000077 | 나라장터화면에서 계약상세정보를 확인 할 수 있는 URL |
| 채권자명 | crdtrNm | 200 | 옵션 | 속초시장 | 계약의 채권자명 |
| 계약체결방법명 | cntrctCnclsMthdNm | 30 | 옵션 | 일반경쟁 | 계약체결의 방법을 구분하는 명 |
| 등록일시 | rgstDt | 19 | 필수 | 2016-10-09 12:00:00 | 등록일시 "YYYY-MM-DD HH:MM:SS" |
| 변경일시 | chgDt | 19 | 옵션 | 2016-10-09 12:00:00 | 변경일시 "YYYY-MM-DD HH:MM:SS" |
샘플코드는 PC에서 확인해주세요.