seoil-company

회사 검색

회사명, 대표자명, 사업자번호, 지역명, 계열/group 배열 값으로 회사를 검색합니다. 결과는 요약 목록으로 반환합니다. 회사에 계열/계열사를 찾아달라는 요청은 회사 원장 group 배열 값이며, 텍스트 응답과 structuredContent에 group과 affiliates로 포함합니다.

회사 상세조회

회사 ID 또는 사업자번호로 회사 상세 정보를 조회합니다. 회사 ID를 우선 사용합니다. 회사에 계열/계열사를 찾아달라는 요청은 회사 원장 group 배열 값을 조회하는 것이며, group과 affiliates로 반환합니다. isFamily는 별도 boolean 참고값입니다.

공사 검색

여러 공사를 검색합니다. 주로 "최근 총가 50건", "22년도 단가 중 배전", "공고번호 여러 개 한번에 조회", "사정율 -0.5~0.5 구간" 같은 조건 검색에 사용합니다. 검색 대상은 공사명, 공고번호, 발주처, 지역, 종목입니다. 사정율은 응답에서 100 기준(base100)과 0 기준 편차(delta0)를 모두 제공합니다. filters에 JSON 조건을 넣는 방식을 권장합니다. 예: {"filters":{"category":"총가","limit":50}}, {"filters":{"year":22,"category":"단가","keyword":"배전"}}, {"filters":{"numbers":["E01-10-06946","E01-10-06947"]}}, {"filters":{"sajungRateMin":-0.5,"sajungRateMax":0.5,"sajungRateMode":"delta0"}}, {"filters":{"elecType":"배전"}}, {"filter

공사별 전체 투찰 업체 목록 조회

공사별 전체 투찰 업체 목록 조회. 특정 공사에 참여한 업체 전체목록, 투찰 참여업체 순위 전체, 공사별 참여업체 순위, 입찰/투찰 업체 리스트를 조회합니다. rank 기본 오름차순(rankAsc)으로 반환하므로 전체 순위 조회와 동일합니다. 회사 계열/계열사 정보 조회도 함께 제공합니다. 회사에 계열을 찾아달라는 요청은 회사 원장 group 배열 값이며, 업체별 companyGroup/companyAffiliates/affiliates/company.group/company.affiliates로 반환합니다. 공사 참여 링크 기준 linkGroup/linkIsFamily/isInsider도 함께 반환합니다.

회사 참여 공사 조회

회사 ID 또는 사업자번호로 해당 회사가 참여했던 공사 목록을 조회합니다. 기본은 최근 등록순이며 sort로 입찰일/연도/순위/투찰가/사정율 정렬과 offset 페이지네이션을 지원합니다.

여러 회사 참여 공사 일괄 조회

여러 회사의 참여 공사 이력을 한 번에 조회합니다. companyIds(회사 MongoDB ID 목록) 또는 bizNumbers(사업자번호 목록)로 회사를 지정하고, year/category/type/district/사정율 조건으로 공통 필터링합니다. 회사마다 sort 정렬 후 offsetPerCompany부터 limitPerCompany건(기본 20, 최대 100)을 반환하는 회사별 페이지네이션을 지원합니다. 응답은 companies 배열이며 각 항목에 companyId, companyName, count, total, offset, limit, hasMore, constructions(공사 기준 금액 basePrice/aPrice/yega/underLimit/wonga/bidRate/bidCount/sajungRate 포함)가 들어갑니다. 단일 회사만 조회하려면 company_constructions를 사용합니다.

여러 회사 공통 참여 공사 조회

지정한 여러 회사 중 둘 이상이 함께 참여(투찰)한 공사만 반환합니다. companyIds(회사 MongoDB ID 목록) 또는 bizNumbers(사업자번호 목록)로 2곳 이상을 지정하고, minCompanies로 '몇 곳 이상 겹쳐야 하는지'를 정합니다(기본 2, 지정 회사 전부가 들어간 공사만 원하면 회사 수와 동일하게 지정). year/category/type/district/사정율로 공통 필터링하며, 각 공사 항목에 participantCount(겹친 회사 수)와 participants(해당 공사에 참여한 지정 회사들의 순위/투찰가/사정율/낙찰여부)가 포함됩니다. 기본 정렬은 겹친 회사 수 많은 순(overlapDesc)입니다.

적격심사기준 만드는 방법

적격심사기준 PNG를 필드 JSON으로 바꾸기 전에 반드시 호출할 가이드입니다. 제외 규칙, score/bonus/penalty/helper 의미, 공식 규칙, 검증 후 승인·생성 순서를 반환합니다.

적격심사기준 JSON 검증

이미지와 simsa_formula_guide를 바탕으로 만든 JSON을 seoil-backend에서 검증·정규화합니다. 저장하지 않습니다. 성공 시 formula와 기준점수 referenceScore를 반환하므로 사용자에게 보여주고 승인을 받으세요.

적격심사기준 생성

검증된 적격심사기준을 seoil-backend에 실제 저장합니다. simsa_formula_validate의 정상 응답 formula를 사용자에게 보여주고 명시적 승인을 받은 뒤에만 confirmed=true로 호출하세요.