다음을 통해 공유


D&B 최적화 프로그램 [사용되지 않음]

D&B 최적화 프로그램은 Microsoft 애플리케이션 환경 내의 레코드에 펌보그래픽 인텔리전스를 올바르게 식별, 정리 및 삽입하여 비즈니스 데이터의 품질을 향상시키는 Dun & Bradstreet의 기본 데이터 서비스입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
커넥터 메타데이터
게시자 던 & 브래드스트리트

D&B 최적화 프로그램은 사용자가 Common Data Service 환경 및 Dun & Bradstreet 서비스에 대한 활성 구독에 액세스할 수 있어야 합니다.
여기에서 자세한 내용과 시작하는 방법을 알아보세요.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

일치 항목 정리 및 추가[사용되지 않음]

D&B ID 확인은 입력 조건을 사용하여 광범위한 엔터티 데이터베이스에서 가장 적합한 후보를 찾습니다. 독점 알고리즘을 사용하여 최상의 일치 항목을 식별하고 일치 항목을 찾는 데 사용된 조건에 대한 자세한 정보를 사용하여 일치 항목을 반환합니다.

특정 엔터티의 데이터 검색 [사용되지 않음]

Data Products API는 요청된 DUNS에 대한 데이터를 반환합니다. 반환되는 데이터는 요청된 제품과 관련이 있습니다.

일치 항목 정리 및 추가[사용되지 않음]

D&B ID 확인은 입력 조건을 사용하여 광범위한 엔터티 데이터베이스에서 가장 적합한 후보를 찾습니다. 독점 알고리즘을 사용하여 최상의 일치 항목을 식별하고 일치 항목을 찾는 데 사용된 조건에 대한 자세한 정보를 사용하여 일치 항목을 반환합니다.

매개 변수

Name 필수 형식 Description
제품 ID
productId True string

반환할 제품을 식별하는 D&B에서 제공하는 제품 ID입니다.

버전 ID
versionId True string

반환할 제품 버전을 식별하는 버전 ID(예: v1)입니다.

이름
name string

기본 이름, 거래 스타일 이름 또는 이전 이름으로 엔터티를 찾는 데 사용되는 최대 240자입니다.

주소 줄 1
streetAddressLine1 string

엔터티의 거리 주소 첫 줄에 있는 최대 70자입니다.

주소 줄 2
streetAddressLine2 string

엔터티 주소의 두 번째 줄에서 최대 70자

국가 ISO 알파 코드
countryISOAlpha2Code True string

국제표준화기구(ISO) ISO 3166-1 체계에 의해 정의된 2자로 된 국가 코드는 엔터티의 국가를 식별합니다.

우편 번호
postalCode string

해당 주소가 있는 위치를 식별하기 위해 현지 국가의 우편 기관에서 사용하는 식별자의 최대 10자입니다.

주소 지역성
addressLocality string

엔터티가 있는 도시, 마을, 마을, 마을, 자치구 등을 식별하는 1~50자입니다.

주소 지역
addressRegion string

주소가 있는 위치를 식별하기 위해 중앙에서 관리되는 국가의 일부를 구성하는 지역 관리 지역의 이름입니다.

전화번호
telephoneNumber string

전화 번호의 최대 32자- 엔터티와의 음성 통신에 사용되는 숫자 시퀀스입니다. 이 숫자 시퀀스에는 지역 번호 또는 도시 코드와 국내 전화 걸기 코드가 포함됩니다.

URL
url string

전자 메일 도메인으로 엔터티를 식별하는 데 사용되는 URL입니다.

전자 메일
email string

전자 메일 도메인에서 엔터티를 식별하는 데 사용되는 전자 메일 주소입니다.

등록 번호
registrationNumber string

조직을 고유하게 식별하거나 식별하는 데 도움이 되는 외부 본문 또는 D&B에서 할당한 번호입니다.

등록 번호 유형
registrationNumberType string

등록 번호의 유형을 식별하기 위해 D&B에서 할당한 고유 코드입니다.

신뢰도 하위 수준
confidenceLowerLevelThresholdValue string

응답에 반환된 엔터티에 대한 가장 낮은 신뢰도 수준입니다. 유효한 값은 1에서 10이고, 지정하지 않으면 기본값인 4가 사용됩니다.

제외 조건
exclusionCriteria string

여러 속성에 따라 엔터티를 제외하는 기능을 제공합니다.

반환

Name 경로 형식 Description
DUNS 번호
duns string

D-U-N-S 번호는 D&B에서 할당한 ID 번호로, D-U-N-S(Data Universal Numbering System)에 따라 엔터티를 고유하게 식별합니다.

기본 비즈니스 이름
primary_name string

엔터티가 주로 알려지거나 식별되는 단일 이름입니다.

무역 스타일 이름
trade_style string

계약 및 기타 공식적인 상황에 사용되는 등록된 법적 이름은 다른 이름이 될 수 있지만, 법인이 상업적 목적으로 거래하는 이름입니다.

거리 주소
address.streetline1 string

엔터티가 있는 주소의 첫 번째 줄입니다.

주소(2)
address.streetline2 string

엔터티가 있는 주소의 두 번째 줄입니다.

주소 도시
address.city string

이 주소가 있는 도시, 마을, 마을, 마을, 자치구 등의 이름입니다.

지역 코드
address.territory_code string

이 주소가 있는 위치를 식별하기 위해 중앙 집중식으로 관리되는 국가의 일부를 구성하는 지역 관리 지역의 표준 코드입니다.

지역 이름
address.territory_name string

이 주소가 있는 위치를 식별하기 위해 중앙에서 관리되는 국가의 일부를 구성하는 지역 관리 지역의 이름입니다.

우편 번호
address.postal_code string

현지 우편 기관에서 비즈니스 위치를 식별하는 데 사용하는 식별자입니다.

ISO 국가 코드
address.isoalpha2code string

비즈니스 엔터티의 국가를 식별하는 국제 표준화 기구(ISO) ISO 3166-1 체계에 의해 정의된 두 글자 국가 코드입니다.

ISO 국가 이름
address.country_name string

국제표준화기구(ISO) ISO 3166-1 체계에서 정의한 국가 코드는 비즈니스 엔터티의 국가를 식별합니다.

전화 ISD 코드
phone.international_code string

이 숫자 시퀀스에는 ISD(International Subscriber Dialling) 코드가 포함됩니다.

전화번호
phone.number string

엔터티와의 음성 통신에 사용되는 숫자 시퀀스입니다. 이 숫자 시퀀스에는 지역 번호 또는 도시 코드와 국내 전화 걸기 코드가 포함됩니다.

산업 코드
primary_sic string

엔터티가 참여하는 비즈니스 활동을 식별하는 코드입니다.

산업 코드 설명
industrycode.description string

해당 산업 코드에 대한 설명입니다.

직원 수량 세부 정보(로컬)
employees.local integer

해당 작업을 수행하기 위해 엔터티가 참여하는 총 사용자 수입니다. 이 직원 그림의 범위는 informationScopeDescription에서 식별됩니다.

직원 수량 세부 정보(합계)
employees.global integer

해당 작업을 수행하기 위해 엔터티가 참여하는 총 사용자 수입니다. 이 직원 그림의 범위는 informationScopeDescription에서 식별됩니다.

현재까지의 재무제표
financials.todate date-time

회계 기간이 종료된 날짜입니다.  안정성 코드에서 수치가 예상(미래)임을 나타내는 경우 회계 기간이 종료되는 날짜입니다.

USD의 판매 수익 금액
financials_global.value integer

엔터티의 상품 및/또는 서비스를 USD로 판매하여 고객으로부터 받은 수입의 금전적 가치입니다.  이는 총 매출에서 반품, 리베이트/할인, 손해 또는 부족에 대한 수당, 고객에게 전달된 배송 비용을 뺀 금액입니다.

현지 통화로 판매 수익 금액
financials_local.value integer

엔터티의 상품 및/또는 서비스를 현지 통화로 판매하여 고객으로부터 받은 수입의 금전적 가치입니다.  이는 총 매출에서 반품, 리베이트/할인, 손해 또는 부족에 대한 수당, 고객에게 전달된 배송 비용을 뺀 금액입니다.

현지 통화 코드
financials_local.currency string

이 엔터티의 현지 통화 코드입니다.

위치 유형
location_types string

이 엔터티에 대한 위치 형식의 세미콜론으로 구분된 목록입니다.

단일 위치 표시기
is_single_location boolean

엔터티가 단일 위치인지 여부를 나타냅니다.

부모 D-U-N-S 번호
parent.duns string

부모 엔터티의 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 기업입니다. 이러한 소유 회사는 모회사의 자회사입니다. 

상위 비즈니스 이름
parent.name string

부모 엔터티의 비즈니스 이름입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다.

국내 궁극의 D-U-N-S 번호
domestic_ultimate.duns string

요청된 엔터티와 동일한 국가에 거주 중인 회사 패밀리 트리 내에서 가장 높은 수준의 부모 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다. 주제는 자신의 국내 궁극적 일 수있다.

국내 얼티밋 이름
domestic_ultimate.name string

주체와 동일한 국가에 있는 가계도에서 가장 높은 비즈니스의 이름입니다.

글로벌 얼티밋 D-U-N-S 번호
global_ultimate.duns string

회사 패밀리 트리 내에서 가장 높은 수준의 상위 부모의 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다. 주제는 자신의 글로벌 궁극적 일 수있다. 

글로벌 얼티밋 이름
global_ultimate.name string

글로벌 궁극의 비즈니스의 기본 이름입니다.

비즈니스 법적 구조
entity_type integer

해당 비즈니스 법적 구조에 대한 D&B 코드

비즈니스 법률 구조 설명
entity_type.description string

정부 기관에 등록된 법인의 법적 양식 또는 구조 이름(예: 파트너십, 기업, 민간 유한 회사, 정부 부서, 소유자). 정부 기관에 등록된 엔터티의 법적 양식 또는 구조를 식별하기 위해 D&B에서 할당한 고유 코드

신뢰도 일치
match.confidence integer

신뢰 코드는 자세한 MatchGrade 문자열을 기반으로 합니다.™ 4백만 개 이상의 문자열 조합이 10개의 신뢰 코드에 매핑되어 일치하는 레코드를 광범위하게 분류할 수 있습니다. 숫자가 높을수록 정확한 일치 항목이라는 신뢰도가 높아집니다.

일치 프로필
match.profile string

MDP(일치 데이터 프로필) 코드는 반환된 후보에서 각 구성 요소 형식이 일치하는지 여부와 방법을 나타냅니다.

일치 등급
match.grade string

MatchGrade 문자열은 조회 및 참조 구성 요소 간에 정성적 평가를 제공합니다. A - 동일한 것으로 간주, B - 일부 동시성, F - 다른 것으로 간주, Z - 누락 된 정보, 결론을 내릴 수 없습니다.

목록에 없음 표시기
is_delisted boolean

엔터티가 D&B의 마케팅 파일에 잠재 고객을 위해 데이터를 포함하지 않도록 요청했는지 여부를 나타냅니다.

운영 상태
operating_status integer

해당 운영 상태에 대한 D&B 코드

운영 상태 설명
operating_status.description string

엔터티의 기능 상태 또는 거래 상태(예: 활성, 업무 외)입니다. 엔터티의 기능 상태 또는 거래 상태를 식별하기 위해 D&B에서 할당한 고유 코드입니다.

등급 일치 - 조직 이름
match_grade.name string

등급 일치 - 조직 이름

일치 등급 - 거리 번호
match_grade.street_number string

일치 등급 - 거리 번호

Match Grade - Street Name
match_grade.street_name string

Match Grade - Street Name

매치 그레이드 - 타운/시티
match_grade.city string

매치 그레이드 - 타운/시티

Match Grade - State/Region
match_grade.state string

Match Grade - State/Region

일치 등급 - PO 상자
match_grade.po_box string

일치 등급 - PO 상자

Match Grade - 전화 번호
match_grade.phone string

Match Grade - 전화 번호

등급 일치 - 우편 번호
match_grade.postal_code string

등급 일치 - 우편 번호

일치 등급 - 밀도
match_grade.density string

일치 등급 - 밀도

일치 등급 - 고유성
match_grade.uniqueness string

일치 등급 - 고유성

등급 일치 - SIC 코드
match_grade.industry string

등급 일치 - SIC 코드

특정 엔터티의 데이터 검색 [사용되지 않음]

Data Products API는 요청된 DUNS에 대한 데이터를 반환합니다. 반환되는 데이터는 요청된 제품과 관련이 있습니다.

매개 변수

Name 필수 형식 Description
D-U-N-S 번호
duns True string

D-U-N-S 번호는 D&B에서 할당한 ID 번호로, D-U-N-S(Data Universal Numbering System)에 따라 엔터티를 고유하게 식별합니다.

제품 ID
productId True string

반환할 제품을 식별하는 D&B에서 제공하는 제품 ID입니다.

버전 ID
versionId True string

반환할 제품 버전을 식별하는 버전 ID(예: v1)입니다.

반환

Name 경로 형식 Description
DUNS 번호
duns string

D-U-N-S 번호는 D&B에서 할당한 ID 번호로, D-U-N-S(Data Universal Numbering System)에 따라 엔터티를 고유하게 식별합니다.

기본 비즈니스 이름
primary_name string

엔터티가 주로 알려지거나 식별되는 단일 이름입니다.

무역 스타일 이름
trade_style string

계약 및 기타 공식적인 상황에 사용되는 등록된 법적 이름은 다른 이름이 될 수 있지만, 법인이 상업적 목적으로 거래하는 이름입니다.

거리 주소
address.streetline1 string

엔터티가 있는 주소의 첫 번째 줄입니다.

주소(2)
address.streetline2 string

엔터티가 있는 주소의 두 번째 줄입니다.

주소 도시
address.city string

이 주소가 있는 도시, 마을, 마을, 마을, 자치구 등의 이름입니다.

지역 코드
address.territory_code string

이 주소가 있는 위치를 식별하기 위해 중앙 집중식으로 관리되는 국가의 일부를 구성하는 지역 관리 지역의 표준 코드입니다.

지역 이름
address.territory_name string

이 주소가 있는 위치를 식별하기 위해 중앙에서 관리되는 국가의 일부를 구성하는 지역 관리 지역의 이름입니다.

우편 번호
address.postal_code string

현지 우편 기관에서 비즈니스 위치를 식별하는 데 사용하는 식별자입니다.

ISO 국가 코드
address.isoalpha2code string

비즈니스 엔터티의 국가를 식별하는 국제 표준화 기구(ISO) ISO 3166-1 체계에 의해 정의된 두 글자 국가 코드입니다.

ISO 국가 이름
address.country_name string

국제표준화기구(ISO) ISO 3166-1 체계에서 정의한 국가 코드는 비즈니스 엔터티의 국가를 식별합니다.

전화 ISD 코드
phone.international_code string

이 숫자 시퀀스에는 ISD(International Subscriber Dialling) 코드가 포함됩니다.

전화번호
phone.number string

엔터티와의 음성 통신에 사용되는 숫자 시퀀스입니다. 이 숫자 시퀀스에는 지역 번호 또는 도시 코드와 국내 전화 걸기 코드가 포함됩니다.

산업 코드
primary_sic string

엔터티가 참여하는 비즈니스 활동을 식별하는 코드입니다.

산업 코드 설명
industrycode.description string

해당 산업 코드에 대한 설명입니다.

직원 수량 세부 정보(로컬)
employees.local integer

해당 작업을 수행하기 위해 엔터티가 참여하는 총 사용자 수입니다. 이 직원 그림의 범위는 informationScopeDescription에서 식별됩니다.

직원 수량 세부 정보(합계)
employees.global integer

해당 작업을 수행하기 위해 엔터티가 참여하는 총 사용자 수입니다. 이 직원 그림의 범위는 informationScopeDescription에서 식별됩니다.

현재까지의 재무제표
financials.todate date-time

회계 기간이 종료된 날짜입니다.  안정성 코드에서 수치가 예상(미래)임을 나타내는 경우 회계 기간이 종료되는 날짜입니다.

USD의 판매 수익 금액
financials_global.value integer

엔터티의 상품 및/또는 서비스를 USD로 판매하여 고객으로부터 받은 수입의 금전적 가치입니다.  이는 총 매출에서 반품, 리베이트/할인, 손해 또는 부족에 대한 수당, 고객에게 전달된 배송 비용을 뺀 금액입니다.

현지 통화로 판매 수익 금액
financials_local.value integer

엔터티의 상품 및/또는 서비스를 현지 통화로 판매하여 고객으로부터 받은 수입의 금전적 가치입니다.  이는 총 매출에서 반품, 리베이트/할인, 손해 또는 부족에 대한 수당, 고객에게 전달된 배송 비용을 뺀 금액입니다.

현지 통화 코드
financials_local.currency string

이 엔터티의 현지 통화 코드입니다.

위치 유형
location_types string

이 엔터티에 대한 위치 형식의 세미콜론으로 구분된 목록입니다.

단일 위치 표시기
is_single_location boolean

엔터티가 단일 위치인지 여부를 나타냅니다.

부모 D-U-N-S 번호
parent.duns string

부모 엔터티의 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 기업입니다. 이러한 소유 회사는 모회사의 자회사입니다. 

상위 비즈니스 이름
parent.name string

부모 엔터티의 비즈니스 이름입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다.

국내 궁극의 D-U-N-S 번호
domestic_ultimate.duns string

요청된 엔터티와 동일한 국가에 거주 중인 회사 패밀리 트리 내에서 가장 높은 수준의 부모 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다. 주제는 자신의 국내 궁극적 일 수있다.

국내 얼티밋 이름
domestic_ultimate.name string

주체와 동일한 국가에 있는 가계도에서 가장 높은 비즈니스의 이름입니다.

글로벌 얼티밋 D-U-N-S 번호
global_ultimate.duns string

회사 패밀리 트리 내에서 가장 높은 수준의 상위 부모의 D-U-N-S 번호입니다. 부모는 다른 회사의 자본 주식의 50% 이상을 소유하는 회사입니다. 주제는 자신의 글로벌 궁극적 일 수있다. 

글로벌 얼티밋 이름
global_ultimate.name string

글로벌 궁극의 비즈니스의 기본 이름입니다.

비즈니스 법적 구조
entity_type integer

해당 비즈니스 법적 구조에 대한 D&B 코드

비즈니스 법률 구조 설명
entity_type.description string

정부 기관에 등록된 법인의 법적 양식 또는 구조 이름(예: 파트너십, 기업, 민간 유한 회사, 정부 부서, 소유자). 정부 기관에 등록된 엔터티의 법적 양식 또는 구조를 식별하기 위해 D&B에서 할당한 고유 코드

목록에 없음 표시기
is_delisted boolean

엔터티가 D&B의 마케팅 파일에 잠재 고객을 위해 데이터를 포함하지 않도록 요청했는지 여부를 나타냅니다.

운영 상태
operating_status integer

해당 운영 상태에 대한 D&B 코드

운영 상태 설명
operating_status.description string

엔터티의 기능 상태 또는 거래 상태(예: 활성, 업무 외)입니다. 엔터티의 기능 상태 또는 거래 상태를 식별하기 위해 D&B에서 할당한 고유 코드입니다.