스마트축산 빅데이터 제공 서비스 API

스마트축산 빅데이터 제공 서비스 API

기술명세서

http://www.smartfarmkorea.net

문서 정보

프로젝트	스마트축산 정보공유시스템 구축사업
단 계	완료
활 동	완료
작 업	서비스명세서 작성
산출물	서비스명세서
파일명	스마트축산 빅데이터 제공 서비스 API 기술명세서.hwp

개정 이력

버 전	변경일	변경 사유	변경 내용	작성자	승인
1.0	-	-	최초 작성	김민호	이강훈

목 차

서비스 개요 ------------------------------------------------------------------------4

서비스 목록 ------------------------------------------------------------------------4

Provide 서비스 명세  ---------------------------------------------------------------4

#1 장애코드(별첨) ------------------------------------------------------------------50

#2 항목코드(별첨) ------------------------------------------------------------------50

서비스 개요

본 문서는 ‘스마트축산 빅데이터 제공 서비스’의 API 서비스 목록을 정의하고 서비스의 상세 구현 정보를 기술하는 문서이다.

서비스 목록

일련번호	서비스명 (국문)	서비스명 (영문)
1	스마트축산 빅데이터 제공 서비스	Smart LiveStock Bigdata Service

Provide 서비스 명세

스마트축산 빅데이터 제공 서비스

서비스 정보	서비스명(국문)	스마트축산 빅데이터 제공 서비스
	서비스명(영문)	Smart LiveStock Bigdata Service
	서비스 설명	스마트축산 빅데이터 제공 서비스
서비스 제공자정보	기관명	농림수산식품교육문화정보원			담당자명/부서			스마트농업실
	담당자 연락처	044-861-8770			담당자 e-Mail			smartlivestock@epis.or.kr
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
서비스 WSDL	운영환경	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/?wsdl
서비스 URL	운영환경	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/
서비스 배포 정보	서비스 버전	1.0
	유효일자			배포 일자
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공	[O] Body			실패	[O] Body

오퍼레이션 목록

일련번호	오퍼레이션명(영문)	오퍼레이션명(국문)	메시지명(영문)
1	getInspctDataList	낙농 분석용 데이터 유성분검사성적서 데이터 정보	getInspctDataList
2	getMilkingDataList	낙농 분석용 데이터 로봇착유기 데이터	getMilkingDataList
3	getIctDataList	낙농 분석용_데이터 ICT착유기 데이터	getIctDataList
4	getSowDataList	양돈 모돈 데이터 셋 데이터	getSowDataList
5	getMoPigDataList	양돈 포유모돈 급이 데이터	getMoPigDataList
6	getLayingDataList	양계 일일생산 데이터	getLayingDataList
7	getCowDataList	한우 EPD 정보	getCowDataList
8	getShipmntDataList	한우 등급판정정보	getShipmntDataList
9	getIctMkFdDataList	낙농 ICT착유기_군사급이기	getIctMkFdDataList
10	getRoboMkFdDataList	낙농 로봇착유기_착유군사급이기	getRoboMkFdDataList
11	getMoPigFdBrdDataList	양돈 포유모돈 급이 번식 데이터	getMoPigFdBrdDataList

공통 요청 메시지

필드 명	필드 타입	내용	필수여부
serviceKey	String	오픈 API신청을 통하여 발급받은 서비스 키 공통 메시지 serviceKey 는 요청 객체의 첫번째(arg0)에 담아서 전송 요청하여야 함.	필수
startDate	String	API 서비스 요청시 리턴받을 요청 시작일 공통 메시지 startDate 는 요청 객체의 두번째(arg1)에 담아서 전송 요청하여야 함.	필수
endDate	String	API 서비스 요청시 리턴받을 요청 종료일 공통 메시지 endDate 는 요청 객체의 두번째(arg1)에 담아서 전송 요청하여야 함.	필수

공통 응답 메시지

필드 명	필드 타입	내용	예시
statusCode	String (2)	장애 코드(별첨 #1 장애코드 참조)	장애코드 참조
statusMessage	String (100)	장애 메시지(별첨 #1 장애코드 참조)	장애코드 참조

오퍼레이션 명세

(1) 낙농 분석용 데이터 유성분검사성적서 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	1	오퍼레이션 명(국문)		낙농 분석용 데이터 유성분검사성적서 데이터 정보
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getInspctDataList
	오퍼레이션 설명	낙농 분석용 데이터 유성분검사성적서 데이터 정보를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getInspctDataList
	메시지 타입	변수 타입
	메시지 설명	낙농 분석용 데이터 유성분검사성적서 데이터 정보를 조회 한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getInspctDataList
	메시지 타입	리스트 타입
	메시지 설명	낙농 분석용 데이터 유성분검사성적서 데이터 정보를 제공 한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getInspctDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getInspctDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getInspctDataListResponse
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장아이디	String( 40)	필수	PF_0001750_01	농장아이디
milkingSn	착유일련번호	INT	선택	1319	착유일련번호
indvdNo	개체번호	String(14)	선택	20180301010326	개체번호
pedigreeNo	혈통번호	String(20)	선택	500964302	혈통번호
athrzDe	검정일자	String(8)	선택	20150130	검정일자
accmltMilkingDe	누적착유일(연계)	INT	선택	120	누적착유일(연계)
milkFatRt	유지방율	INT	선택	0.5	유지방율
milkProtein	유단백	INT	선택	3.43	유단백
snf	무지고형분	INT	선택	9.77	무지고형분
smtcelCo	체세포수	INT	선택	178	체세포수
mun	우유내요소태질소	INT	선택	26.4	우유내요소태질소
milkQy305De	305일유량	INT	선택	10098	305일유량
milkFatQy305De	305일유지량	INT	선택	306	305일유지량
milkProtein305De	305일유단백	INT	선택	55	305일유단백
snf305De	305일무지고형분	INT	선택	32	305일무지고형분
adultMilkQy	성년유량	INT	선택	55	성년유량
adultMilkFatQy	성년유지량	INT	선택	32	성년유지량
adultMilkProteinQy	성년유단백량	INT	선택	53	성년유단백량
adultSnfQy	성년무지고형분량	INT	선택	42	성년무지고형분량
bfeParityPolAtrb	전산차비유지속성	INT	선택	50	전산차비유지속성
nowParityPolAtrb	현재산차비유지속성	INT	선택	79.7	현재산차비유지속성
lactationTopReachDeCo	비유최고도달일수	INT	선택	184	비유최고도달일수
lactationAfterTopMilkQy	비유후기최고유량	INT	선택	42.5	비유후기최고유량
ltEryyAvrgMilkFatRt	비유초기평균유지율	INT	선택	50	비유초기평균유지율
ltEryyAvrgProteinRt	비유초기평균단백율	INT	선택	60	비유초기평균단백율
ltEryyAvrgMnu	비유초기평균MNU	INT	선택	50	비유초기평균MNU
topMilkQySmtcel	최고유량체세포	INT	선택	40	최고유량체세포
dryoffBfeLastMilkQy	건유전마지막유량	INT	선택	50	건유전마지막유량
bfeParityDryoffBfeMilkQy	전산차건유전유량	INT	선택	50	전산차건유전유량
indvdNm	개체명	String(80)	선택	수연 칼립소 슈퍼 567호	개체명
farmManageNo	농장관리번호	String(14)	선택	567	농장관리번호
birthDe	출생일자	String(8)	선택	20111227	출생일자
parity	산차	INT	선택	2	산차
recentPartrtnDe	최근분만일(연계)	String(8)	선택	20111227	최근분만일(연계)
recentDryoffDe	최근건유일(연계)	String(8)	선택	20111227	최근건유일(연계)
partrtnAge	분만나이(연계)	INT	선택	3	분만나이(연계)
addiWaterCode	가수제코드(연계)	String(7)	선택	82	가수제코드(연계)
addiWaterDe	가수제일자(연계)	String(8)	선택	20111227	가수제일자(연계)
concentrateCt	농후사료비(연계)	INT	선택	3000	농후사료비(연계)
concentrateSalaryQy	농후사료급여량(연계)	INT	선택	200	농후사료급여량(연계)
npreconDaycnt	공태일수	INT	선택	200	공태일수
lastFrtnDe	최종수정일자(연계)	String(8)	선택	20111227	최종수정일자(연계)
lastFrtnCo	최종수정횟수(연계)	INT	선택	3	최종수정횟수(연계)
lastFrtnSemenCode	최종수정정액코드(연계)	String(10)	선택	7HO10920	최종수정정액코드(연계)
bypScore	체점수(연계)	INT	선택	30	체점수(연계)
partrtnAfterFirstFrtnDe	분만후첫수정일까지일수	String(8)	선택	77	분만후첫수정일까지일수
dataInputCode	데이터입력코드	String(7)	선택	S04303	데이터입력코드
milkQy	유량	INT	선택	30	유량
milkIrdntInspctSn	유성분검사일련번호	INT	필수	49990	유성분검사일련번호
athrzDt	검정일시(ICT)	DATE	선택	2020-11-29 00:00:00	검정일시(ICT)
proteinRt	단백율	INT	선택	50	단백율
solidityRt	고형율	INT	선택	50	고형율
lactose	유당	INT	선택	30	유당
milkFat	유지방	INT	선택	40	유지방

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getInspctDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/StockRestService/getInspctDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0001750_01","milkingSn":null,"indvdNo":"20180301010326","pedigreeNo":"500964302","athrzDe":"20150130","accmltMilkingDe":"120","milkFatRt":"0","milkProtein":"0","snf":"0","smtcelCo":"0","mun":"0","milkQy305De":"7853","milkFatQy305De":"361","milkProtein305De":"263","snf305De":"712","adultMilkQy":"8881","adultMilkFatQy":"413","adultMilkProteinQy":"301","adultSnfQy":"826","bfeParityPolAtrb":"0","nowParityPolAtrb":"94.1","lactationTopReachDeCo":"120","lactationAfterTopMilkQy":"33","ltEryyAvrgMilkFatRt":"4.85","ltEryyAvrgProteinRt":"3.1","ltEryyAvrgMnu":"15","topMilkQySmtcel":"48","dryoffBfeLastMilkQy":"0","bfeParityDryoffBfeMilkQy":"0","indvdNm":"수연 미스터 쉽스 질랜드 586호 ... ... ... {"statusCode":null,"statusMessage":null,"farmId":"PF_0020127","milkingSn":null,"indvdNo":"20191227020068","pedigreeNo":"501352538","athrzDe":"20201012","accmltMilkingDe":"0","milkFatRt":"0","milkProtein":"0","snf":"0","smtcelCo":"0","mun":"0","milkQy305De":"0","milkFatQy305De":"0","milkProtein305De":"0","snf305De":"0","adultMilkQy":"0","adultMilkFatQy":"0","adultMilkProteinQy":"0","adultSnfQy":"0","bfeParityPolAtrb":"0","nowParityPolAtrb":"0","lactationTopReachDeCo":"0","lactationAfterTopMilkQy":"0","ltEryyAvrgMilkFatRt":"0","ltEryyAvrgProteinRt":"0","ltEryyAvrgMnu":"0","topMilkQySmtcel":"0","dryoffBfeLastMilkQy":"0","bfeParityDryoffBfeMilkQy":"0","indvdNm":"화의 타바스코 7731","farmManageNo":"7731","birthDe":"20191227","parity":"0","recentPartrtnDe":null,"recentDryoffDe":null,"partrtnAge":null,"addiWaterCode":"99","addiWaterDe":null,"concentrateCt":"0","concentrateSalaryQy":"0","npreconDaycnt":"0","lastFrtnDe":null,"lastFrtnCo":null,"lastFrtnSemenCode":null,"bypScore":null,"partrtnAfterFirstFrtnDe":null,"dataInputCode":"S04303","milkQy":"0","milkIrdntInspctSn":"55702","athrzDt":null,"proteinRt":null,"solidityRt":null,"lactose":null,"milkFat":null}]

(json)

(2) 낙농 분석용 데이터  로봇착유기 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	2	오퍼레이션 명(국문)		낙농 분석용 데이터 로봇착유기 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getMilkingDataList
	오퍼레이션 설명	낙농 분석용 데이터 로봇착유기 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getMilkingDataList
	메시지 타입	변수 타입
	메시지 설명	낙농 분석용 데이터 로봇착유기 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getMilkingDataList
	메시지 타입	리스트 타입
	메시지 설명	낙농 분석용 데이터 로봇착유기 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMilkingDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMilkingDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getMilkingDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장아이디	String(40)	필수	PF_0001750_01	농장아이디
indvdNo	개체번호	String(14)	필수	1	개체번호
lsindRegistNo	축산업등록번호	String(10)	필수	DD001	축산업등록번호
itemCode	축종코드	String(7)	필수	D00	축종코드
makrId	제조사 아이디	String(40)	필수	hansung	제조사 아이디
eqpmnCode	장비코드	String(7)	필수	PC04	장비코드
eqpmnNo	장비번호	String(40)	필수	1	장비번호
mesureDt	측정일시	DATE	필수	2019-06-01	측정일시
milkingQy	착유량	INT	필수	30	착유량
milkingBeginDt	착유시작일시	DATE	선택	2019-06-01	착유시작일시
milkingEndDt	착유종료일시	DATE	선택	2019-06-01	착유종료일시
milkingTme	착유회차	INT	선택	3	착유회차
conductivity	전도도	INT	선택	5	전도도
smtcel	체세포	String(20)	선택	6	체세포
bloodFlow	혈액흐름	String(20)	선택	3	혈액흐름
color	색상	String(20)	선택	3	색상
tp	온도	INT	선택	3	온도
milkFat	유지방	INT	선택	5	유지방
milkProtein	유단백	INT	선택	5	유단백
airFlow	공기흐름	String(20)	선택	3	공기흐름
colctSe	수집구분	String(7)	선택	S04302	수집구분
colctDe	수집일자	String(8)	선택	20200117	수집일자
colctCo	수집건수	INT	선택	3	수집건수
parity	산차	INT	선택	5	산차
ruminationTime	반추시간	String(20)	선택		반추시간

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMilkingDataList
XML

- 요청/응답 메시지 예제(json)

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMilkingDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0001750","indvdNo":"1","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2019-06-01 23:00:00.0","milkingQy":"51","milkingBeginDt":"2019-06-01 23:00:00.0","milkingEndDt":"2019-06-01 23:12:12.0","milkingTme":"1","conductivity":"1","smtcel":"1","bloodFlow":"2","color":"9","tp":"1","milkFat":"4","milkProtein":"5","airFlow":"9","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"1","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2019-06-01 23:00:00.0","milkingQy":"51","milkingBeginDt":"2019-06-01 23:00:00.0","milkingEndDt":"2019-06-01 ... ... ... {"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"951","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2020-01-22 23:00:00.0","milkingQy":"89","milkingBeginDt":"2020-01-22 23:00:00.0","milkingEndDt":"2020-01-22 23:19:22.0","milkingTme":"1","conductivity":"2","smtcel":"5","bloodFlow":"8","color":"9","tp":"7","milkFat":"4","milkProtein":"3","airFlow":"1","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750","indvdNo":"951","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2020-01-23 23:00:00.0","milkingQy":"97","milkingBeginDt":"2020-01-23 23:00:00.0","milkingEndDt":"2020-01-23 23:10:24.0","milkingTme":"1","conductivity":"3","smtcel":"6","bloodFlow":"8","color":"2","tp":"4","milkFat":"8","milkProtein":"1","airFlow":"10","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"951","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2020-01-23 23:00:00.0","milkingQy":"97","milkingBeginDt":"2020-01-23 23:00:00.0","milkingEndDt":"2020-01-23 23:10:24.0","milkingTme":"1","conductivity":"3","smtcel":"6","bloodFlow":"8","color":"2","tp":"4","milkFat":"8","milkProtein":"1","airFlow":"10","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750","indvdNo":"951","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2020-01-24 23:00:00.0","milkingQy":"31","milkingBeginDt":"2020-01-24 23:00:00.0","milkingEndDt":"2020-01-24 23:27:25.0","milkingTme":"1","conductivity":"1","smtcel":"9","bloodFlow":"3","color":"5","tp":"6","milkFat":"10","milkProtein":"10","airFlow":"4","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"951","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC04","eqpmnNo":"1","mesureDt":"2020-01-24 23:00:00.0","milkingQy":"31","milkingBeginDt":"2020-01-24 23:00:00.0","milkingEndDt":"2020-01-24 23:27:25.0","milkingTme":"1","conductivity":"1","smtcel":"9","bloodFlow":"3","color":"5","tp":"6","milkFat":"10","milkProtein":"10","airFlow":"4","colctSe":"S04302","colctDe":"20200117","colctCo":"1","parity":null}]

(3) 낙농 분석용 데이터 ICT착유기 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	3	오퍼레이션 명(국문)		낙농 분석용 데이터 ICT착유기 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getIctDataList
	오퍼레이션 설명	낙농 분석용 데이터 ICT착유기 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getIctDataList
	메시지 타입	변수 타입
	메시지 설명	낙농 분석용 데이터 ICT착유기 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getMilkingDataList
	메시지 타입	리스트 타입
	메시지 설명	낙농 분석용 데이터 로봇착유기 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getIctDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getIctDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getIctDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장ID	String(40)	필수	PF_0001750_01	농장ID
indvdNo	개체번호	String(14)	필수	20100531010020	개체번호
lsindRegistNo	축산업등록번호	String(10)	필수	DD001	축산업등록번호
itemCode	축종코드	String(7)	필수	D00	축종코드
makrId	제조사 아이디	String(40)	필수	hansung	제조사 아이디
eqpmnCode	장비코드	String(7)	필수	PC03	장비코드
eqpmnNo	장비번호	String(40)	필수	1	장비번호
mesureDt	측정일시	Date	필수	2020-07-07	측정일시
milkingQy	착유량	INT	필수	98	착유량
milkingBeginDt	착유시작일시	Date	선택	2020-07-07	착유시작일시
milkingEndDt	착유종료일시	Date	선택	2020-07-07	작유종료일시
milkingHour	착유시간	String(10)	선택	6	착유시간
milkingTme	착유회차	INT	선택	1	착유회차
conductivity	전도도	INT	선택	7	전도도
colctSe	수집구분	String(7)	선택	S04302	수집구분
colctDe	수집일자	String(8)	선택	20200710	수집일자
colctCo	수집건수	INT	선택	3	수집건수

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getIctDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getIctDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0001750","indvdNo":"048207098","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-06-01 23:00:00.0","milkingQy":"86","milkingBeginDt":"2019-06-01 23:00:00.0","milkingEndDt":"2019-06-01 23:26:35.0","milkingHour":"27","milkingTme":"1","conductivity":"9","colctSe":"S04302","colctDe":"20200117","colctCo":"1"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"048207098","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-06-01 23:00:00.0","milkingQy":"86","milkingBeginDt":"2019-06-01 23:00:00.0","milkingEndDt":"2019-06-01 23:26:35.0","milkingHour":"27","milkingTme":"1","conductivity":"9","colctSe":"S04302","colctDe":"20200117","colctCo":"1"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"048207098","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-06-02 23:00:00.0","milkingQy":"33","milkingBeginDt":"2019-06-02 23:00:00.0","milkingEndDt":"2019-06-02 23:11:11.0","milkingHour":"11","milkingTme":"1","conductivity":"8","colctSe":"S04302","colctDe":"20200117","colctCo":"1"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750","indvdNo":"048207098","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-06-02 23:00:00.0","milkingQy":"33","milkingBeginDt":"2019-06-02 23:00:00.0","milkingEndDt":"2019-06-02 23:11:11.0","milkingHour":"11","milkingTme":"1","conductivity":"8","colctSe":"S04302","colctDe":"20200117","colctCo":"1"} ... ... ... {"statusCode":null,"statusMessage":null,"farmId":"PF_0001750","indvdNo":"564564564","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-12-30 23:00:00.0","milkingQy":"32","milkingBeginDt":"2019-12-30 23:00:00.0","milkingEndDt":"2019-12-30 23:17:36.0","milkingHour":"18","milkingTme":"1","conductivity":"3","colctSe":"S04302","colctDe":"20200117","colctCo":"1"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750_01","indvdNo":"564564564","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-12-31 23:00:00.0","milkingQy":"90","milkingBeginDt":"2019-12-31 23:00:00.0","milkingEndDt":"2019-12-31 23:26:41.0","milkingHour":"27","milkingTme":"1","conductivity":"3","colctSe":"S04302","colctDe":"20200117","colctCo":"1"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0001750","indvdNo":"564564564","lsindRegistNo":"DD001","itemCode":"D00","makrId":"hansung","eqpmnCode":"PC03","eqpmnNo":"1","mesureDt":"2019-12-31 23:00:00.0","milkingQy":"90","milkingBeginDt":"2019-12-31 23:00:00.0","milkingEndDt":"2019-12-31 23:26:41.0","milkingHour":"27","milkingTme":"1","conductivity":"3","colctSe":"S04302","colctDe":"20200117","colctCo":"1"}]

(json)

(4) 양돈 모돈 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	4	오퍼레이션 명(국문)		양돈 모돈 데이터 셋 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getSowDataList
	오퍼레이션 설명	양돈 모돈 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getSowDataList
	메시지 타입	변수 타입
	메시지 설명	양돈 모돈 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getSowDataList
	메시지 타입	리스트 타입
	메시지 설명	양돈 모돈 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getSowDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getSowDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getSowDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장ID	String(40)	필수	PF_0001750_01	농장ID
sowId	개체 구분번호	INT	필수	1001	개체 구분번호
parity	산차	INT	필수	1	산차
degree	교배차수	INT	필수	1	교배차수
periodDay	경과일(초교배일,재귀발정일)	INT	필수	5	경과일(초교배일,재귀발정일)
matingDt	교배일	String(8)	필수	20201214	교배일
pregnancyDay	임신 사고기간	INT	선택	5	임신 사고기간
pregnancyNm	임신사고원인	String(200)	선택	공태	임신사고원인
farrowDay	임신기간	INT	선택	120	임신기간
farrowDt	분만일	String(8)	선택	20201214	분만일
totalBorn	총산자수	INT	선택	11	총산자수
mummy	미라	INT	선택	5	미라
stillBorn	사산	INT	선택	3	사산
liveBorn	실산자수	INT	선택	5	실산자수
farrowDie	생시도태두수	INT	선택	11	생시도태두수
adtIn	양자전입두수	INT	선택	42	양자전입두수
adtOut	양자전출두수	INT	선택	23	양자전출두수
bornDead	포유자돈폐사 두수	INT	선택	22	포유자돈폐사 두수
bornWean	부분이유 두수	INT	선택	11	부분이유 두수
weanDay	포유기간	INT	선택	15	포유기간
weanDt	이유일	String(8)	선택	20201214	이유일
weanPigs	이유두수	INT	선택	10	이유두수

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getSowDataList
XML

- 요청/응답 메시지 예제(json)

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getSowDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0020292","sowId":"928","parity":"0","degree":"1","periodDay":"240","matingDt":"20190823","pregnancyDay":"21","pregnancyNm":null,"farrowDay":"109","farrowDt":"20191210","totalBorn":"0","mummy":"0","stillBorn":"0","liveBorn":"0","farrowDie":null,"adtIn":null,"adtOut":null,"bornDead":null,"bornWean":null,"weanDay":null,"weanDt":null,"weanPigs":null},{"statusCode":null,"statusMessage":null,"farmId":"PF_0020246","sowId":"1011","parity":"1","degree":"1","periodDay":"34","matingDt":"20190828","pregnancyDay":"25","pregnancyNm":null,"farrowDay":"112","farrowDt":"20191218","totalBorn":"14","mummy":"0","stillBorn":"2","liveBorn":"1","farrowDie":null,"adtIn":null,"adtOut":null,"bornDead":null,"bornWean":null,"weanDay":"22","weanDt":"20200109","weanPigs":"11"} ... ... ... {"statusCode":null,"statusMessage":null,"farmId":"PF_0020082","sowId":"48268","parity":"3","degree":"1","periodDay":"4","matingDt":"20190906","pregnancyDay":null,"pregnancyNm":null,"farrowDay":"114","farrowDt":"20191229","totalBorn":"13","mummy":"0","stillBorn":"0","liveBorn":"13","farrowDie":null,"adtIn":null,"adtOut":null,"bornDead":"2","bornWean":null,"weanDay":"24","weanDt":"20200122","weanPigs":"11"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0000347_01","sowId":"283","parity":"3","degree":"1","periodDay":"4","matingDt":"20190902","pregnancyDay":null,"pregnancyNm":null,"farrowDay":"116","farrowDt":"20191227","totalBorn":"10","mummy":"0","stillBorn":"0","liveBorn":"10","farrowDie":null,"adtIn":null,"adtOut":null,"bornDead":"2","bornWean":null,"weanDay":"20","weanDt":"20200116","weanPigs":"9"}]

(5) 양돈 포유모돈 급이 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	5	오퍼레이션 명(국문)		양돈 포유모돈 급이 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getMoPigDataList
	오퍼레이션 설명	양돈 모돈 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getMoPigDataList
	메시지 타입	변수 타입
	메시지 설명	양돈 포유모돈 급이 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getMoPigDataList
	메시지 타입	리스트 타입
	메시지 설명	양돈 포유모돈 급이 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMoPigDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMoPigDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getMoPigDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장ID	String(40)	필수	PF_0001750_01	농장ID
sowId	개체 구분번호	INT	필수	1001	개체 구분번호
matingDt	교배일	String(8)	선택	20201214	교배일
farrowDt	분만일	String(8)	선택	20201214	분만일
mesureDt	측정일시	DATE	필수	2020-12-14	측정일시
feedingSetupQy	설정량	INT	선택	5	설정량
feedingQy	섭취량	INT	선택	5	섭취량

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMoPigDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMoPigDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0000347_01","sowId":"100","matingDt":"20190903","farrowDt":"20191227","feedingSetupQy":"10","feedingQy":"3.4"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0000347_01","sowId":"106","matingDt":"20190902","farrowDt":"20191229","feedingSetupQy":"10","feedingQy":"2.8"},{"statusCode":null,"statusMessage":null,"farmId":"PF_0000347_01","sowId":"120","matingDt":"20190903","farrowDt":"20191225","feedingSetupQy":"10","feedingQy":"3.6"} ... ... ... {"statusCode":null,"statusMessage":null,"farmId":"PF_0020239","sowId":"247","matingDt":"20190902","farrowDt":"20191224","feedingSetupQy":"5","feedingQy":"4.8"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"1251","matingDt":"20190902","farrowDt":"20191228","feedingSetupQy":"6","feedingQy":"5.7"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"506","matingDt":"20190902","farrowDt":"20191230","feedingSetupQy":"5.4","feedingQy":"5.1"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"542","matingDt":"20190830","farrowDt":"20191225","feedingSetupQy":"6.9","feedingQy":"6.6"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"1595","matingDt":"20190902","farrowDt":"20191229","feedingSetupQy":"5.7","feedingQy":"5.4"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"104","matingDt":"20190903","farrowDt":"20191227","feedingSetupQy":"6.3","feedingQy":"5.1"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"1648","matingDt":"20190903","farrowDt":"20191225","feedingSetupQy":"7.1","feedingQy":"6.8"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"1672","matingDt":"20190903","farrowDt":"20191223","feedingSetupQy":"7.7","feedingQy":"5.2"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"387","matingDt":"20190903","farrowDt":"20191228","feedingSetupQy":"6","feedingQy":"5.7"},{"statusCode":null,"statusMessage":null,"farmId":"CV_9999994","sowId":"292","matingDt":"20190903","farrowDt":"20191225","feedingSetupQy":"6.9","feedingQy":"6.6"}]

(json)

(6) 양계 일일생산 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	6	오퍼레이션 명(국문)		양계 일일생산 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getLayingDataList
	오퍼레이션 설명	양계 일일생산 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getLayingDataList
	메시지 타입	변수 타입
	메시지 설명	양계 일일생산 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getLayingDataList
	메시지 타입	리스트 타입
	메시지 설명	양계 일일생산 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getLayingDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getLayingDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getLayingDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmCode	농장 구분번호	String(40)	필수	PF_9999999	농장 구분번호
eggSn	계사 구분번호	INT	필수	1	계사 구분번호
breedNm	품종명	String(200)	선택	하이라인	품종명
beginDt	입추일	String(10)	선택	2020-12-14	입추일
ilryung	일령	INT	선택	112	일령
layingDt	산란일자	String(10)	선택	2020-12-14	산란일자
beginCo	현재수수	INT	필수	219643	현재수수
dCo	도폐사 수수	INT	선택	435	도폐사 수수
kCo	왕란	INT	선택	43663	왕란
xCo	특란	INT	선택	117573	특란
lCo	대란	INT	선택	23529	대란
mCo	중란	INT	선택	455	중란
sCo	소란	INT	선택	380	소란
gCo	경란	INT	선택	3044	경란
oCo	오란	INT	선택	5656	오란
bCo	파란	INT	선택	568	파란
etcCo	기타 산란수	INT	선택	1016	기타 산란수
totalCo	총 산란수	INT	선택	195884	총 산란수

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getLayingDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getLayingDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmCode":"PF_0012345","eggSn":"5","breedNm":"로만브라운라이트","beginDt":"2018-06-19","ilryung":"549","layingDt":"2019-12-23","beginCo":"2342342","dCo":"31","kCo":null,"xCo":null,"lCo":null,"mCo":null,"sCo":null,"gCo":null,"oCo":null,"bCo":null,"etcCo":"0","totalCo":"0"},{"statusCode":null,"statusMessage":null,"farmCode":"PF_0012345","eggSn":"5","breedNm":"로만브라운라이트","beginDt":"2018-06-19","ilryung":"557","layingDt":"2019-12-31","beginCo":"2342342","dCo":"19","kCo":null,"xCo":null,"lCo":null,"mCo":null,"sCo":null,"gCo":null,"oCo":null,"bCo":null,"etcCo":"0","totalCo":"0"} ... ... ... {"statusCode":null,"statusMessage":null,"farmCode":"PF_9999999","eggSn":"6","breedNm":"하이라인","beginDt":"2019-11-05","ilryung":"-57","layingDt":"2019-12-03","beginCo":"223856","dCo":"35","kCo":null,"xCo":null,"lCo":null,"mCo":null,"sCo":null,"gCo":null,"oCo":null,"bCo":null,"etcCo":"0","totalCo":"0"},{"statusCode":null,"statusMessage":null,"farmCode":"PF_9999999","eggSn":"6","breedNm":"하이라인","beginDt":"2019-11-05","ilryung":"-58","layingDt":"2019-12-02","beginCo":"223856","dCo":"33","kCo":null,"xCo":null,"lCo":null,"mCo":null,"sCo":null,"gCo":null,"oCo":null,"bCo":null,"etcCo":"0","totalCo":"0"},{"statusCode":null,"statusMessage":null,"farmCode":"PF_9999999","eggSn":"6","breedNm":"하이라인","beginDt":"2019-11-05","ilryung":"-59","layingDt":"2019-12-01","beginCo":"223856","dCo":"29","kCo":null,"xCo":null,"lCo":null,"mCo":null,"sCo":null,"gCo":null,"oCo":null,"bCo":null,"etcCo":"0","totalCo":"0"}]

(json)

(7) 한우 EPD 정보 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	7	오퍼레이션 명(국문)		한우 EPD 정보 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getCowDataList
	오퍼레이션 설명	한우 EPD 정보 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getCowDataList
	메시지 타입	변수 타입
	메시지 설명	한우 EPD 정보 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getCowDataList
	메시지 타입	리스트 타입
	메시지 설명	한우 EPD 정보 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getCowDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getCowDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20200101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20201231	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getCowDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장아이디	String(40)	필수	PF_0002321_01	농장아이디
indvdNo	개체식별번호	String(12)	필수	002102651634	개체식별번호
brthdy	생년월일	DATE	선택	2016-08-05	생년월일
sexdstnSe	성별구분	String(1)	선택	1	성별구분
indvdSe	계대	String(2)	선택	2	계대
epdGradeColdCarcassWt	냉도체중등급	String(6)	선택	D	냉도체중등급
epdIdexColdCarcassWt	냉도체중지수	String(14)	선택	4.96	냉도체중지수
epdGradeLoinEyeSctionAr	배최장근단면적 등급	String(6)	선택	A	배최장근단면적 등급
epdIdexLoinEyeSctionAr	배최장근단면적 지수	String(14)	선택	3.24	배최장근단면적 지수
epdGradeBkFatThick	등지방두께 등급	String(6)	선택	A	등지방두께 등급
epdIdexBkFatThick	등지방두께 지수	String(14)	선택	0.90040	등지방두께 지수
epdGradeIntMusFat	근내지방도 등급	String(6)	선택	A	근내지방도 등급
epdIdexIntMusFat	근내지방도 지수	String(14)	선택	0.74120	근내지방도 지수
epdUpdtDe	자료 갱신일자	String(20)	선택	2020-02-01	자료 갱신일자

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getCowDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getCowDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","indvdNo":"002102651634","brthdy":"2016-08-05 00:00:00.0","sexdstnSe":"1","indvdSe":"2","epdGradeColdCarcassWt":"D ","epdIdexColdCarcassWt":"4.96700","epdGradeLoinEyeSctionAr":"A ","epdIdexLoinEyeSctionAr":"3.24090","epdGradeBkFatThick":"A -","epdIdexBkFatThick":"0.86380","epdGradeIntMusFat":"A ","epdIdexIntMusFat":"0.74120","epdUpdtDe":"2020-02-01"} ... ... ... {"statusCode":null,"statusMessage":null,"indvdNo":"002152919730","brthdy":"2020-08-11 00:00:00.0","sexdstnSe":"2","indvdSe":"4","epdGradeColdCarcassWt":"C ","epdIdexColdCarcassWt":"9.55550","epdGradeLoinEyeSctionAr":"B ","epdIdexLoinEyeSctionAr":"3.18420","epdGradeBkFatThick":"B -","epdIdexBkFatThick":"0.45800","epdGradeIntMusFat":"D ","epdIdexIntMusFat":"0.12510","epdUpdtDe":"2020-08-01"}

(json)

(8) 한우 등급판정정보 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	8	오퍼레이션 명(국문)		한우 등급판정정보 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getShipmntDataList
	오퍼레이션 설명	한우 등급판정정보 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getShipmntDataList
	메시지 타입	변수 타입
	메시지 설명	한우 등급판정정보 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getShipmntDataList
	메시지 타입	리스트 타입
	메시지 설명	한우 등급판정정보 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getShipmntDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getShipmntDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getShipmntDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
farmId	농장ID	String(40)	필수	PF_0002321_01	농장ID
indvdNo	개체번호	String(14)	필수	20080125010079	개체번호
histNo	이력제번호	String(20)	선택	002012120006	이력제번호
shipmntDe	출하일자	String(8)	선택	20120801	출하일자
slauIpla	도축장	String(40)	선택	김해축공	도축장
slauDe	도축일자	String(8)	선택	20190828	도축일자
meatQuantityGrade	육량등급	String(7)	선택	S06901	육량등급
meatQualityGrade	육질등급	String(7)	선택	S06803	육질등급
carcassWt	도체중량	INT	선택	300	도체중량
backFatThick	등지방두께	INT	선택	7	등지방두께
auctionCost	경락가격	INT	선택	19210	경락가격
gradJdgmntDe	등급판정일자	String(10)	선택	2019-08-28	등급판정일자
meatQuantityIdex	육량지수	INT	선택	66.79	육량지수
loinEyeAr	등심면적	INT	선택	65	등심면적
gradRevisn	등급보정	String(10)	선택	하향	등급보정
marbling	근내지방	INT	선택	4	근내지방
meatColor	육색	INT	선택	5	육색
fatColor	지방색	INT	선택	3	지방색
contextDgree	조직감	INT	선택	1	조직감
mtrdg	성숙도	INT	선택	7	성숙도
lastGrad	최종등급	String(10)	선택	1+A	최종등급

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getShipmntDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getShipmntDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","farmId":"PF_0002321_01","histNo":"002065071669","shipmntDe":"20200801","slauIpla":null,"slauDe":"20200801","meatQuantityGrade":"S06903","meatQualityGrade":"S06804","carcassWt":null,"backFatThick":null,"auctionCost":null,"gradJdgmntDe":null,"meatQuantityIdex":null,"loinEyeAr":null,"gradRevisn":null,"marbling":null,"meatColor":null,"fatColor":null,"contextDgree":null,"mtrdg":null,"lastGrad":null} ... ... ... "meatQuantityIdex":"61.92","loinEyeAr":"87","gradRevisn":null,"marbling":"4","meatColor":"5","fatColor":"3","contextDgree":"2","mtrdg":"3","lastGrad":"1B"}]

(json)

(9) 낙농 ICT착유기_군사급이기 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	9	오퍼레이션 명(국문)		낙농 ICT착유기_군사급이기 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getIctMkFdDataList
	오퍼레이션 설명	낙농 ICT착유기_군사급이기 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getIctMkFdDataList
	메시지 타입	변수 타입
	메시지 설명	낙농 ICT착유기_군사급이기 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getIctMkFdDataList
	메시지 타입	리스트 타입
	메시지 설명	낙농 ICT착유기_군사급이기 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getIctMkFdDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getIctMkFdDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210101	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210131	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getIctMkFdDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
admNm	지역	varchar(100)	필수	경기도	지역
lvNm	규모	varchar(60)	선택	300~400두	규모
farmId	농가ID	varchar(40)	필수	0021134	농가ID
indvdNo	개체번호	varchar(14)	필수	20110618010010	개체번호
markrId	제조사아이디(착유기)	varchar(40)	필수	드라발(주)	제조사아이디(착유기)
mesureDe	측정일자(착유기)	varchar(10)	필수	2021-01-11	측정일자(착유기)
milkingQy	착유량(kg)	numeric	필수	35.34	착유량(kg)
milkingTme	착유횟수	numeric	선택	2	착유횟수
conductivity	전도도	numeric	선택	7.25	전도도
makrId2	제조사아이디(급이기)	varchar(40)	선택	드라발(주)	제조사아이디(급이기)
mesureDe2	측정일자(급이기)	varchar(10)	선택	2021-01-10	측정일자(급이기)
ntkQy	섭취량(kg)	numeric	선택	0.63	섭취량(kg)

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getIctMkFdDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getIctMkFdDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","admName":"경기도","lvNm":"300~400두","farmId":"0021134","indvdNo":"20110618010010","makrId":"드라발(주)","mesureDe":"2021-01-11","milkingQy":"35.34","milkingTme":"2","conductivity":"7.25","makrId2":"드라발 (주)","mesureDe2":"2021-01-10","ntkQy":"0.63"}, ... ... ... "makrId":"드라발(주)","mesureDe":"2021-01-01","milkingQy":"11.67","milkingTme":"1","conductivity":"0","makrId2":"드라발 (주)","mesureDe2":"2020-12-31","ntkQy":"4.56"}]

(json)

(10) 낙농 로봇착유기_착유군사급이기 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	10	오퍼레이션 명(국문)		낙농 로봇착유기_착유군사급이기 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getRoboMkFdDataList
	오퍼레이션 설명	낙농 로봇착유기_착유군사급이기 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getRoboMkFdDataList
	메시지 타입	변수 타입
	메시지 설명	낙농 로봇착유기_착유군사급이기 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getRoboMkFdDataList
	메시지 타입	리스트 타입
	메시지 설명	낙농 로봇착유기_착유군사급이기 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getRoboMkFdDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getRoboMkFdDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20210201	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20210228	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getRoboMkFdDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
admNm	지역	varchar(100)	필수	충청북도 괴산군	지역
lvNm	규모	varchar(60)	선택	100~200두	규모
farmId	농가ID	varchar(40)	필수	0020279	농가ID
indvdNo	개체번호	varchar(14)	필수	20110421010013	개체번호
markrId	제조사아이디(착유기)	varchar(40)	필수	(주)애그리로보텍	제조사아이디(착유기)
mesureDe	측정일자(착유기)	varchar(10)	필수	2022-01-03	측정일자(착유기)
milkingQy	착유량(kg)	numeric	필수	17	착유량(kg)
milkingTme	착유횟수	numeric	선택	3	착유횟수
conductivity	전도도	numeric	선택	7.27	전도도
smtcel	체세포수	varchar(20)	선택		체세포수
color	색상	varchar(20)	선택		색상
tp	온도	numeric	선택	36	온도
milkFat	유지방	numeric	선택	4.5	유지방
milkProtein	유단백	numeric	선택	3.5	유단백
parity	산차	numeric	선택	7	산차
makrId2	제조사아이디(급이기)	varchar(40)	선택	(주)애그리로보텍	제조사아이디(급이기)
mesureDe2	측정일자(급이기)	varchar(8)	선택	2022-01-02	측정일자(급이기)
ntkQyEnrichedFeed	농후사료 섭취량(kg)	numeric	선택	5.44	농후사료 섭취량(kg)
ntkQyEtcFeed	기타사료 섭취량(kg)	numeric	선택	0.69	기타사료 섭취량(kg)

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getRoboMkFdDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getRoboMkFdDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","admName":null,"lvNm":"100~200두","farmId":"0020279","indvdNo":"20110421010013","makrId":"(주)애그리로보텍","mesureDe":"2022-01-03","milkingQy":"17","milkingTme":"3","conductivity":"7.27","smtcel":null,"color":null,"tp":"36","milkFat":"4.5","milkProtein":"3.5","parity":null,"makrId2":"(주)애그리로보텍","mesureDe2":"2022-01-02","ntkQyEnrichedFeed":"5.44","ntkQyEtcFeed":"0.69"}, ... ... ... "color":null,"tp":"37.63","milkFat":"3.48","milkProtein":"3.45","parity":null,"makrId2":"(주)애그리로보텍","mesureDe2":"2022-01-30","ntkQyEnrichedFeed":"5.01","ntkQyEtcFeed":"0.2"}]

(json)

(11) 양돈 포유모돈 급이 번식 데이터 오퍼레이션 명세

오퍼레이션 정보	오퍼레이션 번호	11	오퍼레이션 명(국문)		양돈 포유모돈 급이 번식 데이터
	오퍼레이션 유형	조회	오퍼레이션 명(영문)		getMoPigFdBrdDataList
	오퍼레이션 설명	양돈 포유모돈 급이 번식 데이터를 조회하는 기능
호출 메시지정보	메시지 명(영문)	getMoPigFdBrdDataList
	메시지 타입	변수 타입
	메시지 설명	양돈 포유모돈 급이 번식 데이터를 조회한다.
	선행 오퍼레이션	N/A
응답 메시지정보	메시지 명(영문)	getMoPigFdBrdDataList
	메시지 타입	리스트 타입
	메시지 설명	양돈 포유모돈 급이 번식 데이터를 제공한다.
	선행 오퍼레이션	N/A
서비스 보안	서비스 인증/권한	[ O ] 서비스 Key
적용 기술 수준	인터페이스 표준	[O] SOAP [O] REST (GET) [O] EXCEL
	교환 데이터 표준	[ O ] XML [ O ] JSON [ O ] EXCEL
메시지 교환 유형		[ O ] Request-Response
메시지 로깅 수준		성공		[O] Body		실패	[O] Body

메시지 명	SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMoPigFdBrdDataList?wsdl
	REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMoPigFdBrdDataList/
항목명(영문)		항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey		서비스 키	String(255)	필수	SERVICE_KEY	서비스 인증 키
startDate		요청 시작일자	String(255)	필수	20211001	요청 시작일자
endDate		요청 종료일자	String(255)	필수	20211031	요청 종료일자

- 요청 메시지 명세

- 응답 메시지 명세

메시지 명	getMoPigFdBrdDataList
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
admNm	지역	varchar(100)	필수	전국	지역
lvNm	규모	varchar(60)	선택	1000두 이상	규모
farmId	농가ID	varchar(40)	필수	PF_0020082	농가ID
breedNm	품종	varchar(20)	필수	F1	품종
parity	산차	numeric	필수	17	산차
fc	급이 횟수	numeric	필수	2	급이 횟수
fsq	급이 설정량	numeric	필수	3.8	급이 설정량
fq	섭취량	numeric	필수	3.8	섭취량
mDt	급이 일자	varchar(10)	필수	2022-01-13	급이 일자
gigan	분만일로부터의 기간	numeric	필수	-5	분만일로부터의 기간
fDt	분만일	varchar(10)	필수	2022-02-05	분만일
tb	총산	numeric	필수	11	총산
lb	실산	numeric	필수	9	실산
fbcs	분만 시 bcs	numeric	선택	16	분만 시 bcs
wDt	이유일	varchar(10)	선택	2022-03-03	이유일
wp	이유두수	numeric	선택	9	이유두수
wk	이유총체	numeric	선택	62.1	이유총체
wka	이유평체	numeric	선택	6.9	이유평체
pd	재귀발정일	numeric	선택	5	재귀발정일

- 요청/응답 메시지 예제(xml)

SOAP	http://www.smartfarmkorea.net/Agree_WS/webservices/StockService/getMoPigFdBrdDataList
XML

- 요청/응답 메시지 예제

REST	http://www.smartfarmkorea.net/Agree_WS/webservices/StockRestService/getMoPigFdBrdDataList/{serviceKey}/{startDate}/{endDate}
JSON
[{"statusCode":"00","statusMessage":"NORMAL_CODE","admName":"전국","lvNm":"1000두 이상","farmId":"PF_0020082","breedNm":"F1","parity":"17","fc":"2","fsq":"3.8","fq":"3.8","mDt":"2022-01-31","gigan":"-5","fDt":"2022-02-05","tb":"11","lb":"9","fbcs":"16","wDt":"2022-03-03","wp":"9","wk":"62.1","wka":"6.9","pd":null}, ... ... ... "farmId":"PF_0020082","breedNm":"F1","parity":"9","fc":"3","fsq":"8.5","fq":"0","mDt":"2022-01-09","gigan":"23","fDt":"2021-12-17","tb":"9","lb":"9","fbcs":"17","wDt":"2022-01-06","wp":"9","wk":"58.5","wka":"6.5","pd":"5"}]

(json)

#1 장애코드

코드	코드내용	비고
01	어플리케이션 에러
02	데이터베이스 에러
03	데이터없음 에러
04	HTTP 에러
05	서비스 연결실패 에러
10	잘못된 요청 파라메터 에러
11	필수요청 파라메터가 없음
12	해당 오픈API서비스가 없거나 폐기됨
20	서비스 접근거부
21	일시적으로 사용할 수 없는 서비스 키
22	서비스 요청제한횟수 초과에러	일별 요청한도 등
30	등록되지 않은 서비스키
31	기한만료된 서비스키
32	등록되지 않은 IP주소
33	서명되지 않은 호출
99	기타

#2 품목코드

CODE	CODE_NM
080200	참외
080300	토마토
080400	딸기
090100	오이
090300	가지
132600	파프리카
230000	다육
26E800	국화
415000	양계
412200	낙농
050100	감자
060300	포도
061400	감귤
061504	한라봉
063600	망고
065900	블루베리
080100	수박
080500	메론
090200	호박
100500	상추
100900	미나리
101000	부추
120500	고추
170000	버섯
180000	인삼
201900	수국
202600	장미
220000	호접란
237900	선인장
260000	관엽
263300	안스리움
290200	육묘