Product Catalog Data Model

• Data Loader 또는 Bulk API 2.0을 사용하여 Salesforce에 완전히 새로운 제품 카탈로그를 로드하고 있으며, Product2, Standard PricebookEntry, 커스텀 PricebookEntry 전반에 걸쳐 올바른 삽입 순서가 필요합니다.
• 누락된 standard price book entry에 관한 FIELD_INTEGRITY_EXCEPTION으로 인해 대량 PricebookEntry 삽입이 실패하고 있으며, 전제 조건 제약을 이해하고 해결해야 합니다.
• 다양한 지역, 고객 세그먼트 또는 채널에 대해 여러 pricebook을 모델링하고 있으며, UseStandardPrice 상속 또는 pricebook별 명시적 가격 책정 중 무엇을 사용할지 결정해야 합니다.
• 조직, 샌드박스, 스크래치 조직 전반에 걸쳐 Standard Pricebook ID를 안정적으로 식별하거나, 하드코딩되거나 쿼리된 Standard Pricebook ID로 인해 실패하는 Apex 테스트를 디버그해야 합니다.

• Salesforce CPQ(Steelbrick) 제품 및 가격 구성 작업을 하고 있다면 — 대신 cpq-vs-standard-products-decision 스킬을 사용하세요.
• Industries CPQ(Vlocity) 카탈로그 항목 모델 작업을 하고 있다면 — 대신 industries-cpq-vs-salesforce-cpq 스킬을 사용하세요.
• 질문이 기본 Product Catalog Data Model이 아닌 Opportunity Line Item 메커니즘에 관한 것이라면.

세 가지 핵심 객체 간의 전체 관계를 다룹니다. 가격 정보가 없는 카탈로그 마스터인 Product2, 가격 목록 컨테이너인 Pricebook2, 그리고 특정 가격표 내에서 제품에 실제 UnitPrice를 할당하는 연결 레코드인 PricebookEntry로 구성됩니다. 각 객체의 역할과 상호 연결 방식을 명확하게 설명합니다.

표준 가격표(Standard Pricebook)에 제품에 대한 PricebookEntry가 존재해야만 해당 제품에 대한 커스텀 PricebookEntry를 삽입할 수 있다는, 우회 불가능한 플랫폼 규칙을 문서화합니다. 정확한 DML 오류 메시지, 이 제약이 존재하는 이유, 그리고 어떠한 API나 도구를 통해서도 이를 억제할 수 없는 이유를 포함합니다.

필수 4단계 로드 순서를 제공합니다: Product2 → 표준 PricebookEntries → 사용자 정의 Pricebook2 레코드 → 사용자 정의 PricebookEntries. 모든 PricebookEntries를 단일 Bulk API 작업으로 로드할 수 없는 이유와 표준 PBE 작업과 사용자 정의 PBE 작업 사이에 검증 단계가 필요한 이유를 설명합니다.

사용자 정의 PricebookEntry에서 UseStandardPrice = true와 false를 각각 언제 설정해야 하는지, 플래그가 true일 때 표준 가격표(Standard Pricebook)에서 가격 상속이 자동으로 이루어지는 방식, 그리고 UseStandardPrice = true와 함께 명시적인 UnitPrice를 함께 지정하면 필드 오류가 발생하는 이유에 대해 설명합니다.

런타임 시 표준 가격표 ID를 하드코딩하는 대신 항상 SELECT Id FROM Pricebook2 WHERE IsStandard = true를 쿼리해야 하는 요구사항을 다룹니다. 표준 가격표 ID는 모든 프로덕션 조직, 샌드박스, 스크래치 조직, Developer Edition마다 서로 다릅니다. 또한 Apex 테스트 클래스를 위한 Test.getStandardPricebookId() 패턴도 문서화합니다.

로드 순서 정렬, UseStandardPrice 필드 상호 배타성, PricebookEntry당 Product2Id + Pricebook2Id 조합의 고유성, 비활성 제품/항목 처리 등을 포함한 완료 전 검토 체크리스트를 제공합니다. 실제 프로덕션 장애를 유발하는 문서화된 플랫폼 동작이 포함되어 있습니다.

실무자는 Data Loader 또는 Bulk API 2.0을 사용하여 여러 가격 장부에 걸쳐 가격이 포함된 수백 또는 수천 개의 제품을 로드해야 합니다. 이 스킬은 표준 PBE 전제 조건 오류를 방지하고 모든 사용자 지정 PricebookEntry가 성공적으로 생성되도록 올바른 CSV 준비, 순차적 작업 순서 지정 및 검증 단계를 제공합니다.

FIELD_INTEGRITY_EXCEPTION: pricebook entry in standard price book required before this entry can be created 오류와 함께 대량 로드 작업이 실패하고 있습니다. 이 스킬은 근본 원인 — 영향을 받는 제품에 대한 표준 PricebookEntry 누락 — 을 파악하고 해결 순서를 제공합니다.

조직은 지역별 또는 고객 등급별로 별도의 가격표가 필요하며, 일부 가격표는 표준 가격을 상속받고 다른 가격표는 제품별 할인을 적용해야 합니다. 이 스킬에서는 UseStandardPrice = true를 사용하는 경우와 사용자 정의 가격표별로 명시적인 UnitPrice 값을 사용하는 경우를 다루며, 상속이 활성화된 경우 가격 업데이트가 어떻게 전파되는지도 설명합니다.

팀이 여러 org에 걸쳐 제품 카탈로그 로드 스크립트 또는 Apex 코드를 배포하는 과정에서 하드코딩된 Standard Pricebook ID로 인한 오류가 발생할 수 있습니다. 이 스킬은 Standard Pricebook ID가 org별로 고유한 이유, 런타임 시 안정적으로 쿼리하는 방법, 그리고 CI 오류를 방지하기 위해 Apex 테스트 클래스에서 Test.getStandardPricebookId()를 사용하는 방법을 설명합니다.