가격 책정 API의 판매 CRM 외부 ID 지원
가격 책정 API는 판매 CRM 가격 책정 요청에서 외부 ID를 지원합니다. 선택한 참조 필드에 대해 sys_id 대신 고유한 사용자 지정 식별자 또는 코드를 사용할 수 있습니다 ServiceNow .
예를 들어, 가격 책정 호출은 특정 객체에 대해 서로 다른 식별자를 가질 수 있는 다른 CRM 또는 ERP 시스템에서 시작될 수 있습니다. 이러한 고유 식별자는 외부 ID, 코드 또는 기타 사용자 지정 필드를 사용하여 참조 필드에 ServiceNow 매핑할 수 있습니다. 그런 다음 외부 시스템에서 사용할 수 있는 이러한 고유 식별자를 사용하여 가격 책정 호출을 수행할 수 있습니다.
- 제품 오퍼링
- 최상위 제품 오퍼링
- 측정 단위
- 가격 목록
- 비용 장부
- 특성 및 특성 옵션
- 가격 조정 유형
- 계정
가격 책정 요청에서 외부 ID가 작동하는 방식
외부 ID는 참조 테이블의 ServiceNow 참조 필드에 매핑됩니다. 관리자는 가격 책정 요청을 제출하기 전에 지정된 참조 테이블의 열에 매핑되는 외부 ID 또는 코드에 대한 참조 필드를 정의하는 컨텍스트 변수를 생성합니다. 자세한 내용은 외부 ID에 대한 컨텍스트 변수 구성 문서를 참조하십시오.
- 요청 접수
- 호출자는 다음을 포함할 수 있는 가격 책정 REST API 요청을 보냅니다.
- 외부 ID 또는 코드
- sys_ids
- 외부 ID와 sys_ids의 조합
요청에서 외부 ID 지원을 활성화하는 요청 플래그("
use_external_code:true")를 설정합니다. - 해결
- 구성된 각 참조 필드에 대해 시스템은 외부 값을 내부 sys_id로 확인하려고 시도합니다.
- 해결은 컨텍스트 변수 구성에 의해 구동됩니다.
- 해결에 실패하고 sys_id가 제공되지 않으면 요청이 실패합니다.
- 외부 식별자를 사용한 계정 확인
- 계정은 요청 페이로드 필드가 아닌 컨텍스트 변수를 사용하여 해결됩니다.
- 가격 책정 실행 전에 외부 계정 식별자가 확인됩니다.
- 해결된 계정 sys_ids은 가격 책정 실행을 위해 내부적으로 사용됩니다.
- 원본 외부 식별자는 응답 구성을 위해 유지됩니다.
- 가격 책정 실행
- 모든 다운스트림 가격 책정 논리는 해결된 sys_ids에서만 실행됩니다. 가격 책정 논리는 원래 값이 외부 코드인지 sys_id인지를 인식하지 못합니다.
- 응답 생성
- 응답은 요청에 제공된 식별자(외부 코드 또는 sys_ids)를 반영합니다. 해결된 sys_ids가 호출자에게 노출되지 않습니다.
- 오류 처리
- 시스템은 요청을 처리하는 동안 모든 참조 식별자의 유효성을 검사합니다. 일반적인 오류에는 다음과 같은 시나리오가 포함됩니다.
- 외부 식별자가 참조 테이블에 없습니다.
- 외부 코드 사용이 활성화되었지만 활성화된 필드에 대한 컨텍스트 변수 매핑이 없습니다.
- sys_id 코드나 외부 코드가 제공되지 않습니다.
- 식별자 값이 잘못되었습니다.
오류는 라인 수준에서 보고되고 실패한 라인 항목을 식별합니다. 오류 메시지는 구성 및 확인 컨텍스트에 따라 다를 수 있습니다.
오류가 발생하면 다음 항목을 확인합니다.- 컨텍스트 변수 매핑
- 외부 식별자 값
- 요청 플래그 사용
컨텍스트 변수 구성 및 매핑
관리자는 외부 ID를 사용하는 REST API 가격 책정 요청을 제출하기 전에 선택한 ServiceNow 참조 테이블의 열에 매핑되는 컨텍스트 변수를 생성합니다. 자세한 내용은 외부 ID에 대한 컨텍스트 변수 구성 문서를 참조하십시오.