서비스 계약 API

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기275분
  • 서비스 계약 API는 서비스 계약 기록을 만들고 검색하는 엔드포인트를 제공합니다.

    주:
    이 API는 애플리케이션의 고객 계약 및 권리 테이블에 데이터를 작성하기 위한 것입니다. 범용 API가 아닙니다.
    이 API에 접근하려면 연결된 인스턴스에서 다음 플러그인을 활성화해야 합니다.
    • 고객 계약 및 권리(com.sn_pss_core)
    • Customer Service Install Base Management(com.snc.install)
    • 제품 카탈로그 관리 코어(com.sn_prd)

    또한 이 API를 성공적으로 호출하려면 sn_pss_core.pss_integrator 역할이 있어야 합니다. 이 API는 sn_pss_core 네임스페이스에서 실행됩니다.

    이 API를 사용하려면 다음 테이블에 연결된 데이터가 있어야 합니다. 자세한 내용은 Create service contracts 문서를 참조하십시오.

    • 계정 [customer_account]
    • 소비자 [csm_consumer]
    • 세대 [csm_household]
    • 설치 기반 [sn_install_base_item]
    • 제품 오퍼링 [sn_prd_pm_product_offering]
    • 제품 모델 [cmdb_model]
    • 판매된 제품 [sn_install_base_sold_product]

    서비스 계약 - GET /sn_pss_core/servicecontract/{id}

    지정된 서비스 계약 기록을 조회합니다.

    이 엔드포인트는 요청을 처리할 때 다음 테이블의 데이터를 검색합니다.
    • 특성 [sn_pss_core_entitlement_characteristic]
    • 권리 [service_entitlement]
    • 권리 사용 [sn_pss_core_entitlement_usage]
    • 판매된 제품 [sn_install_base_m2m_contract_sold_product] - 이 테이블에는 판매된 제품과 포함된 설치 기반 항목 모두에 대한 정보가 포함되어 있습니다.
    • 서비스 계약 [sn_pss_core_service_contract]
    • 서비스 계약 라인 [sn_pss_core_service_contract_line]

    URL 형식

    버전이 지정된 URL: /api/sn_pss_core/v1/servicecontract/{id}

    기본 URL: /api/sn_pss_core/servicecontract/{id}

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열

    id 검색할 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    표 2. 쿼리 매개변수
    이름 설명
    display_value 반환할 데이터의 유형입니다.
    유효한 값은 다음과 같습니다.
    • false: 모든 필드의 값을 반환합니다. 예를 들어 "state":"draft"입니다.
    • true: 모든 필드에 대한 display_value 반환합니다. 예 : "state":"Draft"
    • all: 모든 필드에 대한 모든 정보를 반환합니다.
      "state": { 
        "name": "state",
        "label": "State",
        "value": "draft",
        "display_value": "Draft",
        "type": "string"
      }

    데이터 유형: 문자열

    기본값: false

    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    없음

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 4. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    403 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    계정
    서비스 계약이 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    소비자
    서비스 계약이 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    종료
    서비스 계약이 종료되는 날짜입니다.

    데이터 유형: 문자열

    household
    서비스 계약과 연결된 세대의 Sys_id입니다. 세대[csm_household]에 위치합니다.

    데이터 유형: 문자열

    install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    install_base_items_covered.추가
    연결된 서비스 계약이 설치 기반 항목을 포함하기 시작하는 날짜입니다.

    데이터 유형: 문자열

    install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.제거
    연결된 서비스 계약이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    번호 자동 생성된 서비스 계약 번호입니다.

    데이터 유형: 문자열

    service_contract_lines 서비스 계약과 연결된 서비스 계약 라인(서비스)의 목록입니다.

    데이터 형식: 객체 배열

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines 서비스 계약 라인과 연결된 하위 서비스 계약 라인의 목록입니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.child_contract_lines 하위 서비스 계약 라인과 연결된 하위 서비스 계약 라인의 목록입니다. 에서와 동일한 매개 변수입니다 child_contract_lines.
    service_contract_lines.child_contract_lines.계약 하위 서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.끝납니다 하위 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.child_contract_lines.권리 하위 서비스 계약 라인과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String"
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.계약 권리가 속한 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.자격 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage 연결된 제품에 대한 사용량 값 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.service_contract_line 현재 권리 사용이 속한 서비스 계약 라인의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.total_units 연결된 권리 특성의 총 범위 값입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage.used_units 와 사이에 계정 또는 소비자 period_start 가 사용하는 단위 수입니다 period_end.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.service_contract_line 현재 권리 특성이 속한 하위 계약 라인입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_created_by 권리 특성을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_created_on 권리 특성이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_updated_by 권리 특성을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_updated_on 권리 특성이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.가족
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered 하위 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.service_contract_line 권리와 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.sold_products_covered.추가
    연결된 서비스 계약이 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.권리.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.제거
    연결된 서비스 계약이 연결된 제품의 적용 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.권리.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.sold_product 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered.sys_updated_on 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.start_date
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.권리.상태
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_created_by 권리 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_created_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_id 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_updated_by 권리 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_updated_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics 권리와 연결된 특성의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.child_contract_lines.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.자격 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered 하위 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.이름 하위 서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.parent_contract_line 하위 서비스 계약 라인과 연결된 상위 계약 라인 기록의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.product_model 하위 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.product_offering 하위 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_product 하위 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.child_contract_lines.sold_products_covered.추가
    연결된 서비스 계약이 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.제거
    연결된 서비스 계약이 연결된 제품의 적용 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sold_product 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered.sys_updated_on 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.시작 하위 서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.sys_created_by 하위 서비스 계약 라인 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sys_created_on 하위 서비스 계약 라인 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sys_id 하위 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sys_updated_by 하위 서비스 계약 라인 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sys_updated_on 하위 서비스 계약 라인 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.계약
    서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.끝납니다 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.권리 서비스 계약과 연결된 권리의 목록입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.계약 권리가 속한 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array]
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.권리.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.자격 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage 연결된 제품에 대한 사용량 값 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.total_units 연결된 권리 특성의 총 범위 값입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.used_units 와 사이에 계정 또는 소비자 period_start 가 사용하는 단위 수입니다 period_end.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.가족
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.service_contract_line 권리와 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.권리.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.제거됨 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.권리.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sold_product 권리에 포함되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered.sys_updated_on 판매된 제품 대상 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.start_date
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.권리.상태
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.권리.sys_created_by 권리 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sys_created_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sys_id 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sys_updated_by 권리 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sys_updated_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics 서비스 계약 라인과 연결된 특성의 목록입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.자격 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage 연결된 제품에 대한 사용량 값 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String", 
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.total_units 구매한 총 단위 수입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage.used_units 사용된 단위 수입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.value
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.install_base 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.이름
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.parent_contract_line 현재 서비스 계약 라인이 하위인 서비스 계약 라인의 Sys_id입니다.

    계약에 따라 생성된 계약 라인의 경우 Null입니다.

    데이터 유형: 문자열

    service_contract_lines.product_model 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.product_offering 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sold_product 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.sold_products_covered.추가 판매된 관련 제품이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.제거됨 판매된 관련 제품이 서비스 계약 라인에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sold_product 권리에 포함되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered.sys_updated_on 판매된 제품 대상 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.시작
    서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.상태
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.sys_created_by 서비스 계약 라인 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.sys_created_on 서비스 계약 라인 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    service_contract_lines.sys_id 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sys_updated_by 서비스 계약 라인 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.sys_updated_on 서비스 계약 라인 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    short_description
    서비스 계약에 대한 간략한 설명 또는 이름입니다.

    데이터 유형: 문자열

    sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    sold_products_covered.추가 판매된 관련 제품이 계약에 추가된 날짜입니다.

    데이터 유형: 문자열

    sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.제거 판매된 관련 제품이 계약에서 제거된 날짜입니다.

    데이터 유형: 문자열

    sold_products_covered.service_line_contract 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.sold_product 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_updated_on 판매된 제품 대상 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    시작
    서비스 계약이 시작되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 승인되는 즉시 시작됩니다.

    상태
    서비스 계약의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료

    데이터 유형: 문자열

    sys_created_by 서비스 계약 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    sys_created_on 서비스 계약 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sys_id 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    sys_updated_by 서비스 계약 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    sys_updated_on 서비스 계약 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    vendor_contract
    연결된 외부 계약의 고유 식별자입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 이 끝점을 호출하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/fc73d2de89226110f877430a4e008add" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    응답:

    {
        "result": {
            "sys_id": "d8641151d1f53110f8776589fa411fde",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:27:29",
            "sys_updated_on": "2023-10-09 11:27:29",
            "account": "4c325111d1f53110f8776589fa411f3d",
            "consumer": null,
            "household": null,
            "number": "CNTR0010004",
            "state": "active",
            "starts": "2022-12-03",
            "ends": "",
            "short_description": null,
            "vendor_contract": "External Reference",
            "service_contract_lines": [
                {
                    "sys_id": "d4641d91d1f53110f8776589fa411fbb",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "name": "CLI",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "parent_contract_line": null,
                    "sold_product": null,
                    "starts": "2022-12-03",
                    "ends": "",
                    "product_offering": null,
                    "product_model": null,
                    "child_contract_lines": [
                        {
                            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "name": "Child CLI",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "parent_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "sold_product": null,
                            "starts": "2022-12-03",
                            "ends": "",
                            "product_offering": null,
                            "product_model": null,
                            "child_contract_lines": [],
                            "entitlements": [
                                {
                                    "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "entitlement_name": "Child CLI - ENTL",
                                    "account": "4c325111d1f53110f8776589fa411f3d",
                                    "consumer": null,
                                    "household": null,
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                                    "state": "active",
                                    "product_offering": null,
                                    "sold_entitlement": null,
                                    "product": null,
                                    "start_date": "2022-12-03",
                                    "end_date": "",
                                    "entitlement_characteristics": [],
                                    "sold_products_covered": [],
                                    "install_base_items_covered": []
                                }
                            ],
                            "sold_products_covered": [
                                {
                                    "sys_id": "dfb62e9c4c6843009be02a68f65b9118",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "install_base_items_covered": [
                                {
                                    "sys_id": "2583912e81964501b52a2e44d4797a28",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "install_base": "a1731551d1f53110f8776589fa411f8d",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "entitlement_characteristics": [
                                {
                                    "sys_id": "3a00c975bb49412cae169200c7f6236e",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                                    "value": "5",
                                    "characteristic": "63418db7539e61106bfcddeeff7b1238",
                                    "type": "coverage"
                                }
                            ]
                        }
                    ],
                    "entitlements": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fc0",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "entitlement_name": "ENTL",
                            "account": "4c325111d1f53110f8776589fa411f3d",
                            "consumer": null,
                            "household": null,
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "state": "active",
                            "product_offering": null,
                            "sold_entitlement": null,
                            "product": null,
                            "start_date": "2022-12-03",
                            "end_date": "",
                            "sold_products_covered": [
                                {
                                    "sys_id": "a0641d91d1f53110f8776589fa411fc2",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "sold_product": "da23d151d1f53110f8776589fa411f27",
                                    "added": "",
                                    "removed": ""
                                }
                            ],
                            "install_base_items_covered": [
                                {
                                    "sys_id": "e0641d91d1f53110f8776589fa411fc3",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "install_base": "43739151d1f53110f8776589fa411fc1",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "entitlement_characteristics": [
                                {
                                    "sys_id": "a8641d91d1f53110f8776589fa411fd0",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "service_contract_line": null,
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                                    "value": "5",
                                    "characteristic": "63418db7539e61106bfcddeeff7b1238",
                                    "type": "coverage_and_usage",
                                    "entitlement_usage": [
                                        {
                                            "sys_id": "a8641d91d1f53110f8776589fa411fd1",
                                            "sys_created_by": "admin",
                                            "sys_updated_by": "admin",
                                            "sys_created_on": "2023-10-09 11:27:29",
                                            "sys_updated_on": "2023-10-09 11:27:29",
                                            "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                            "service_contract_line": null,
                                            "entitlement_characteristic": "a8641d91d1f53110f8776589fa411fd0",
                                            "period_start": "2022-12-03",
                                            "period_end": "",
                                            "total_units": "5",
                                            "used_units": "3"
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "sold_products_covered": [
                        {
                            "sys_id": "98641d91d1f53110f8776589fa411fbc",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "install_base_items_covered": [
                        {
                            "sys_id": "58641d91d1f53110f8776589fa411fbd",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "install_base": "a1731551d1f53110f8776589fa411f8d",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "entitlement_characteristics": [
                        {
                            "sys_id": "e0641d91d1f53110f8776589fa411fbf",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                            "value": "5",
                            "characteristic": "63418db7539e61106bfcddeeff7b1238",
                            "type": "coverage"
                        }
                    ]
                },
                {
                    "sys_id": "e4641d91d1f53110f8776589fa411fd2",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "name": "CLI 2",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "parent_contract_line": null,
                    "sold_product": null,
                    "starts": "2022-12-03",
                    "ends": "",
                    "product_offering": null,
                    "product_model": null,
                    "child_contract_lines": [],
                    "entitlements": [],
                    "sold_products_covered": [
                        {
                            "sys_id": "e8641d91d1f53110f8776589fa411fd3",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "sold_product": "7f23995dd1b53110f8776589fa411f66",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "install_base_items_covered": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fd4",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "install_base": "a483d951d1f53110f8776589fa411fad",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "entitlement_characteristics": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fd5",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                            "value": "5",
                            "characteristic": "63418db7539e61106bfcddeeff7b1238",
                            "type": "coverage"
                        }
                    ]
                }
            ],
            "sold_products_covered": [
                {
                    "sys_id": "9c641d91d1f53110f8776589fa411fb9",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "service_contract_line": null,
                    "entitlement": null,
                    "sold_product": "0df21151d1f53110f8776589fa411f1b",
                    "added": "2023-12-03",
                    "removed": "2023-12-03"
                }
            ],
            "install_base_items_covered": [
                {
                    "sys_id": "d8641d91d1f53110f8776589fa411fba",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "service_contract_line": null,
                    "entitlement": null,
                    "install_base": "e2639951d1f53110f8776589fa411f2b",
                    "added": "2023-12-03",
                    "removed": "2023-12-03"
                }
            ]
        }
    }

    서비스 계약 - GET /sn_pss_core/servicecontract/contractline/{id}

    지정된 서비스 계약 라인 기록을 조회합니다.

    이 엔드포인트는 요청을 처리할 때 다음 테이블의 데이터를 검색합니다.
    • 특성 [sn_pss_core_entitlement_characteristic]
    • 권리 [service_entitlement]
    • 권리 사용 [sn_pss_core_entitlement_usage]
    • 판매된 제품 [sn_install_base_m2m_contract_sold_product] - 이 테이블에는 판매된 제품과 포함된 설치 기반 항목 모두에 대한 정보가 포함되어 있습니다.
    • 서비스 계약 라인 [sn_pss_core_service_contract_line]

    URL 형식

    버전이 지정된 URL: /api/sn_pss_core/v1/servicecontract/contractline/{id}

    기본 URL: /api/sn_pss_core/servicecontract/contractline/{id}

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열

    id 검색할 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    표 8. 쿼리 매개변수
    이름 설명
    display_value 반환할 데이터의 유형입니다.
    유효한 값은 다음과 같습니다.
    • false: 모든 필드의 값을 반환합니다. 예를 들어 "state":"draft"입니다.
    • true: 모든 필드에 대한 display_value 반환합니다. 예 : "state":"Draft"
    • all: 모든 필드에 대한 모든 정보를 반환합니다.
      "state": { 
        "name": "state",
        "label": "State",
        "value": "draft",
        "display_value": "Draft",
        "type": "string"
      }

    데이터 유형: 문자열

    기본값: false

    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    없음

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 10. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 11. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 12. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    403 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    child_contract_lines 서비스 계약 라인과 연결된 하위 서비스 계약 라인의 목록입니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    child_contract_lines.child_contract_lines 하위 서비스 계약 라인 아래에 생성된 하위 서비스 계약 라인 객체의 목록입니다. 이 배열의 객체에는 매개 변수의 child_contract_lines 객체와 동일한 요소가 있습니다.

    데이터 형식: 객체 배열

    child_contract_lines.계약 하위 서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.끝납니다 하위 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    child_contract_lines.권리 하위 서비스 계약 라인과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String"
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.계약 권리가 속한 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    child_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.권리.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.자격 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage 권리 특성과 연결된 권리 사용 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    cchild_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.service_contract_line 현재 권리 사용이 속한 서비스 계약 라인의 Sys_id입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.total_units 연결된 권리 특성의 총 범위 값입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage.used_units 와 사이에 계정 또는 소비자 period_start 가 사용하는 단위 수입니다 period_end.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.가족
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered 하위 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.권리.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.권리.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.권리.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.service_contract_line 권리와 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.권리.sold_products_covered.추가
    연결된 서비스 계약이 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.권리.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.제거
    연결된 서비스 계약이 연결된 제품의 적용 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.권리.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.sold_product 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_coveredsys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered.sys_updated_on 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.start_date
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.권리.상태
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    child_contract_lines.권리.sys_created_by 권리 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sys_created_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sys_id 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sys_updated_by 권리 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sys_updated_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics 권리와 연결된 특성의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.자격 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage 권리 특성과 연결된 권리 사용 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    child_contract_lines.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.entitlement_characteristics.entitlement_usage.service_contract_line 현재 권리 사용이 속한 서비스 계약 라인의 Sys_id입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.total_units 연결된 권리 특성의 총 범위 값입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage.used_units 와 사이에 계정 또는 소비자 period_start 가 사용하는 단위 수입니다 period_end.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered 하위 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.이름 하위 서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.parent_contract_line 하위 서비스 계약 라인과 연결된 상위 계약 라인 기록의 Sys_id입니다.

    데이터 유형: 문자열

    child_contract_lines.product_model 하위 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.product_offering 하위 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sold_product 하위 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.sold_products_covered.추가
    연결된 서비스 계약이 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.제거
    연결된 서비스 계약이 연결된 제품의 적용 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sold_product 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered.sys_updated_on 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.시작 하위 서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.상태
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    child_contract_lines.sys_created_by 하위 서비스 계약 라인 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.sys_created_on 하위 서비스 계약 라인 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    child_contract_lines.sys_id 하위 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sys_updated_by 하위 서비스 계약 라인 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.sys_updated_on 하위 서비스 계약 라인 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    계약
    서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    종료 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    권리 서비스 계약 라인과 연결된 권리의 목록입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.계약 권리가 속한 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    권리.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.자격 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage

    데이터 형식: 객체 배열

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": [Array],
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    권리.entitlement_characteristics.entitlement_usage.자격 권리 사용과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.entitlement_characteristic 권리 사용과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.period_end 권리 사용량을 더 이상 추적하지 않는 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    권리.entitlement_characteristics.entitlement_usage.period_start 권리 사용을 추적하는 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    권리.entitlement_characteristics.entitlement_usage.service_contract_line 현재 권리 사용량이 속한 서비스 계약 라인입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.sys_created_by 권리 사용 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.sys_created_on 권리 사용 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.sys_updated_by 권리 사용 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.sys_updated_on 권리 사용 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.total_units 연결된 권리 특성의 총 범위 값입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage.used_units 와 사이에 계정 또는 소비자 period_start 가 사용하는 단위 수입니다 period_end.

    데이터 유형: 문자열

    권리.entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    권리.entitlement_characteristics.value
    특성의 값입니다.

    데이터 유형: 문자열

    권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    권리.가족
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.service_contract_line 권리와 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    권리.sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sold_products_covered.제거됨 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    권리.sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sold_product 권리에 포함되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.sold_products_covered.sys_updated_on 판매된 제품 대상 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.start_date
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    권리.상태
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    권리.sys_created_by 권리 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.sys_created_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    권리.sys_id 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sys_updated_by 권리 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    권리.sys_updated_on 권리 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    entitlement_characteristics 서비스 계약 라인과 연결된 권리 특성의 목록입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.자격 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.service_contract_line 권리 특성과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_created_by 권리 특성 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_created_on 권리 특성 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_updated_by 권리 특성 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_updated_on 권리 특성 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    install_base_items_covered.계약 설치 기반 항목과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.자격 설치 기반 항목과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.install_base 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    install_base_items_covered.service_contract_line 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_created_by 설치 기반 항목 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_created_on 설치 기반 항목 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_updated_by 설치 기반 항목 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    install_base_items_covered.sys_updated_on 설치 기반 항목 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    이름
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    parent_contract_line 현재 서비스 계약 라인이 하위인 서비스 계약 라인의 Sys_id입니다.

    계약에 따라 생성된 계약 라인의 경우 Null입니다.

    데이터 유형: 문자열

    product_model 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    product_offering 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_product 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered 포함된 제품 목록입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    sold_products_covered.추가 판매된 관련 제품이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    sold_products_covered.계약 판매된 제품과 연결된 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.자격 판매된 제품과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.제거됨 판매된 관련 제품이 서비스 계약 라인에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    sold_products_covered.service_contract_line 판매된 제품과 연결된 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_products_covered.sold_product 권리에 포함되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered.sys_created_by 판매된 제품 대상 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_created_on 판매된 제품 대상 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_id 이 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered.sys_updated_by 판매된 제품 대상 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    sold_products_covered.sys_updated_on 판매된 제품 대상 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    시작
    서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    상태
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    sys_created_by 서비스 계약 라인 기록을 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    sys_created_on 서비스 계약 라인 기록이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sys_id 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    sys_updated_by 서비스 계약 라인 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    sys_updated_on 서비스 계약 라인 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 이 끝점을 호출하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/contractline/fc73d2de89226110f877430a4e008add" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    응답:

    {
      "result": {
        "sys_id": "16e451d1d1f53110f8776589fa411f80",
        "sys_created_by": "admin",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-10-09 11:29:47",
        "sys_updated_on": "2023-10-09 11:29:47",
        "name": "CLI",
        "contract": "a4b415d1d1f53110f8776589fa411f20",
        "parent_contract_line": null,
        "sold_product": null,
        "starts": "2022-12-03",
        "ends": "",
        "product_offering": null,
        "product_model": null,
        "child_contract_lines": [
          {
            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:27:29",
            "sys_updated_on": "2023-10-09 11:27:29",
            "name": "Child CLI",
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "parent_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "sold_product": null,
            "starts": "2022-12-03",
            "ends": "",
            "product_offering": null,
            "product_model": null,
            "child_contract_lines": [],
            "entitlements": [
              {
                "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "entitlement_name": "Child CLI - ENTL",
                "account": "4c325111d1f53110f8776589fa411f3d",
                "consumer": null,
                "household": null,
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "state": "active",
                "product_offering": null,
                "sold_entitlement": null,
                "product": null,
                "start_date": "2022-12-03",
                "end_date": "",
                "entitlement_characteristics": [],
                "sold_products_covered": [],
                "install_base_items_covered": []
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "dfb62e9c4c6843009be02a68f65b9118",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                "added": "2023-12-03",
                "removed": "2023-12-03"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "2583912e81964501b52a2e44d4797a28",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "install_base": "a1731551d1f53110f8776589fa411f8d",
                "added": "2023-12-03",
                "removed": "2023-12-03"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "3a00c975bb49412cae169200c7f6236e",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                "value": "5",
                "characteristic": "63418db7539e61106bfcddeeff7b1238",
                "type": "coverage"
              }
            ]
          }
        ],
        "entitlements": [
          {
            "sys_id": "16e419d1d1f53110f8776589fa411f3c",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:48",
            "sys_updated_on": "2023-10-09 11:29:48",
            "entitlement_name": "ENTL 2",
            "account": "4c325111d1f53110f8776589fa411f3d",
            "consumer": null,
            "household": null,
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "state": "active",
            "product_offering": null,
            "sold_entitlement": null,
            "product": null,
            "start_date": "2022-12-03",
            "end_date": "",
            "sold_products_covered": [
              {
                "sys_id": "1ae419d1d1f53110f8776589fa411f3d",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:29:48",
                "sys_updated_on": "2023-10-09 11:29:48",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
                "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                "sold_product": "da23d151d1f53110f8776589fa411f27",
                "added": "",
                "removed": ""
              }
            ],
            "install_base_items_covered": [],
            "entitlement_characteristics": [
              {
                "sys_id": "1ae419d1d1f53110f8776589fa411f3e",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:29:48",
                "sys_updated_on": "2023-10-09 11:29:48",
                "service_contract_line": null,
                "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                "value": "5",
                "characteristic": "63418db7539e61106bfcddeeff7b1238",
                "type": "coverage_and_usage",
                "entitlement_usage": [
                  {
                    "sys_id": "56e419d1d1f53110f8776589fa411f3f",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:29:48",
                    "sys_updated_on": "2023-10-09 11:29:48",
                    "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                    "service_contract_line": null,
                    "entitlement_characteristic": "1ae419d1d1f53110f8776589fa411f3e",
                    "period_start": "2022-12-03",
                    "period_end": "",
                    "total_units": "5",
                    "used_units": "2"
                  }
                ]
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "5ae451d1d1f53110f8776589fa411f81",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:47",
            "sys_updated_on": "2023-10-09 11:29:47",
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "entitlement": null,
            "sold_product": "0df21151d1f53110f8776589fa411f1b",
            "added": "2023-12-03",
            "removed": "2023-12-03"
          }
        ],
        "install_base_items_covered": [],
        "entitlement_characteristics": [
          {
            "sys_id": "dae451d1d1f53110f8776589fa411f82",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:47",
            "sys_updated_on": "2023-10-09 11:29:47",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "entitlement": null,
            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
            "value": "5",
            "characteristic": "63418db7539e61106bfcddeeff7b1238",
            "type": "coverage"
          }
        ]
      }
    }

    서비스 계약 - POST /sn_pss_core/servicecontract

    지정된 페이로드에서 서비스 계약 기록과 모든 관련 엔터티를 작성합니다.

    서비스 계약 API는 다양한 테이블에 데이터를 저장합니다. 다음은 서비스 계약을 생성할 때 이 엔드포인트에서 기록이 생성되는 테이블 목록입니다.
    • 특성 [sn_pss_core_entitlement_characteristic]
    • 권리 [service_entitlement]
    • 권리 사용 [sn_pss_core_entitlement_usage]
    • 판매된 제품 [sn_install_base_m2m_contract_sold_product] - 이 테이블에는 판매된 제품과 포함된 설치 기반 항목 모두에 대한 정보가 포함되어 있습니다.
    • 서비스 계약 [sn_pss_core_service_contract]
    • 서비스 계약 라인 [sn_pss_core_service_contract_line]

    이 엔드포인트의 요청 본문은 다음 테이블의 필드를 참조합니다. 이 API를 활용하기 전에 인스턴스에 이 정보를 추가해야 합니다. 자세한 내용은 Create service contracts 문서를 참조하십시오.

    • 계정 [customer_account]
    • 특성 옵션 [sn_prd_pm_characteristic_option]
    • 소비자 [csm_consumer]
    • 세대 [csm_household]

    URL 형식

    버전이 지정된 URL: /api/sn_pss_core/v1/servicecontract

    기본 URL: /api/sn_pss_core/servicecontract

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열

    표 14. 쿼리 매개변수
    이름 설명
    없음
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    계정 매개변수를 consumer 지정하지 않으면 필수입니다.
    서비스 계약이 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    소비자 매개변수를 account 지정하지 않으면 필수입니다.
    서비스 계약이 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    종료
    서비스 계약이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    household 소비자 서비스 계약에만 유효합니다.
    서비스 계약과 연결된 세대의 Sys_id입니다. 세대[csm_household]에 위치합니다.

    데이터 유형: 문자열

    기본값: null(세대 없음)

    install_base_items_covered 서비스 계약이 적용되는 설치 기반 항목 목록입니다. 이 매개변수의 데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    설치 기반 항목에 Configure install base대한 자세한 내용은 .

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    install_base_items_covered.추가됨
    연결된 서비스 계약이 설치 기반 항목을 포함하기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    install_base_items_covered.install_base 연결된 설치 기반 항목 기록의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.제거
    연결된 서비스 계약이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines 서비스 계약과 연결된 서비스 계약 라인의 목록입니다. 이 데이터는 서비스 계약 라인[sn_pss_core_service_contract_line] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    service_contract_lines.child_contract_lines 서비스 계약 라인 아래에 있는 하위 서비스 계약 라인의 목록입니다. 이 매개변수의 데이터는 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    service_contract_lines.child_contract_lines.child_contract_lines 하위 서비스 계약 라인 아래에 생성할 하위 서비스 계약 라인 객체의 목록입니다. 이 배열의 객체에는 매개 변수의 service_contract_lines.child_contract_lines 객체와 동일한 요소가 있습니다.

    데이터 형식: 객체 배열

    service_contract_lines.child_contract_lines.끝납니다 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.child_contract_lines.권리 하위 서비스 계약 라인과 연결할 권리의 목록입니다. 이러한 권리는 권리 [service_entitlement] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.특성 필수
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage 연결된 권리 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    entitlement_characteristics가 권리 아래에 있는 경우에만 이 매개변수를 전달합니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.entitlement_usage입니다.used_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.value 매개변수에 지정된 entitlement_characteristics.characteristic 기록에 포함된 매개변수가 input_type선택이 아닌 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_name 필수
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.가족 세대 플러그인이 활성 상태이고 consumer 매개변수가 전달된 경우에만 전달됩니다.
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered
    권리에 포함되는 설치 기반 항목의 목록입니다. 이 배열의 정보는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.install_base 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered 해당 권리가 적용되는 판매된 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.권리.sold_products_covered.제거 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.권리.start_date 필수
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.권리.상태 필수
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics 서비스 계약 라인과 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.child_contract_lines.entitlement_characteristics.특성 필수
    서비스 계약 라인과 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.characteristic_option
    서비스 계약 라인과 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.entitlement_usage 연결된 서비스 계약 라인 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.child_contract_lines.entitlement_characteristics.entitlement_usage입니다.usage_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.type 서비스 계약 라인 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • 범위 _and_usage

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.value 매개변수가 entitlement_characteristics.type 전달되지 않은 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered
    서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 이 매개변수의 데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.child_contract_lines.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.install_base_items_covered.install_base 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.이름
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.product_model 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.product_offering 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_product 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered
    서비스 계약 라인이 적용되는 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.child_contract_lines..sold_products_covered.추가 연결된 서비스 계약 라인이 연결된 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.child_contract_lines.sold_products_covered.제거 연결된 서비스 계약 라인이 연결된 제품의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.child_contract_lines.sold_products_covered.sold_product
    서비스 계약 라인과 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.시작 필수
    서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.child_contract_lines.상태 필수
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.ends 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.권리 서비스 계약 라인과 연결할 권리의 목록입니다. 이러한 권리는 권리 [service_entitlement] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    service_contract_lines.권리.계좌
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.소비자
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    service_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.권리.entitlement_characteristics.특성 필수
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.entitlement_usage 연결된 권리 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    entitlement_characteristics가 권리 아래에 있는 경우에만 이 매개변수를 전달합니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.권리.entitlement_characteristics.entitlement_usage입니다.usage_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.value 매개변수에 지정된 entitlement_characteristics.characteristic 기록에 포함된 매개변수가 input_type선택이 아닌 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_name 필수
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.가족 세대 플러그인이 활성 상태이고 consumer 매개변수가 전달된 경우에만 전달됩니다.
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered
    권리에 포함되는 설치 기반 항목의 목록입니다. 이 배열의 정보는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.권리.install_base_items_covered.install_base 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered 해당 권리가 적용되는 판매된 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.권리.sold_products_covered.제거 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.권리.sold_products_covered.sold_product 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.start_date 필수
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.권리.상태 필수
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics 서비스 계약 라인과 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.entitlement_characteristics.특성 필수
    서비스 계약 라인과 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.characteristic_option
    서비스 계약 라인과 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.entitlement_usage 연결된 서비스 계약 라인 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.entitlement_characteristics.entitlement_usage.usage_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.형 서비스 계약 라인 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • 범위 _and_usage

    데이터 유형: 문자열

    service_contract_lines.entitlement_characteristics.값 매개변수가 entitlement_characteristics.type 전달되지 않은 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered
    서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 이 매개변수의 데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.install_base_items_covered.install_base 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.이름
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.product_model 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.product_offering 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.sold_product 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.sold_products_covered
    서비스 계약 라인이 적용되는 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.sold_products_covered.추가 연결된 서비스 계약 라인이 연결된 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    service_contract_lines.sold_products_covered.제거 연결된 서비스 계약 라인이 연결된 제품의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    service_contract_lines.sold_products_covered.sold_product
    서비스 계약 라인과 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.시작 필수
    서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    service_contract_lines.상태 필수
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    short_description
    서비스 계약에 대한 간략한 설명 또는 이름입니다.

    데이터 유형: 문자열

    기본값: null(빈 문자열)

    sold_products_covered 매개변수를 install_base_items_covered 지정하지 않으면 필수입니다.
    서비스 계약이 적용되는 제품 목록입니다. 이 매개변수의 데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    sold_products_covered.추가됨
    연결된 서비스 계약이 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    sold_products_covered.제거됨
    연결된 서비스 계약이 연결된 제품의 적용 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    sold_products_covered.판매된_제품 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    시작 필수
    서비스 계약이 시작되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    상태 필수
    서비스 계약의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료

    데이터 유형: 문자열

    vendor_contract 필수
    연결된 외부 계약의 고유 식별자입니다.

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 16. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    컨텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 17. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 18. 상태 코드
    상태 코드 설명
    201 성공입니다. 요청이 성공적으로 처리되고 기록이 생성되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    403 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    install_base_items_covered 서비스 계약에 포함된 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    번호 자동 생성된 서비스 계약 번호입니다.

    데이터 유형: 문자열

    service_contract_lines 서비스 계약과 연결된 서비스 계약 라인의 목록입니다.

    데이터 형식: 객체 배열

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines 서비스 계약 라인에서 생성된 하위 서비스 계약 라인 객체의 목록입니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id" "String"
      }
    ]
    service_contract_lines.child_contract_lines.child_contract_lines 하위 서비스 계약 라인 아래에 생성된 하위 서비스 계약 라인 객체의 목록입니다. 이 배열의 객체에는 매개 변수와 service_contract_lines.child_contract_lines 동일한 요소가 있습니다.

    데이터 형식: 객체 배열

    service_contract_lines.child_contract_lines.권리 하위 서비스 계약 라인과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.entitlement_characteristics 권리 아래에 생성된 권리 특성 객체의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.entitlement_characteristics.sys_id 하위 서비스 계약 라인과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.install_base_items_covered 권리에 포함된 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.install_base_items_covered.sys_id 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sold_products_covered 권리에 포함된 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.권리.sold_products_covered.sys_id 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.권리.sys_id 하위 서비스 계약 라인과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics 칠레 계약 라인과 연결된 특성 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.entitlement_characteristics.entitlement_usage entitlement_characteristic 아래에 삽입된 권리 사용 객체입니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "sys_id": "String"
    }
    service_contract_lines.child_contract_lines.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.entitlement_characteristics.sys_id 하위 서비스 계약 라인과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.install_base_items_covered 하위 계약 라인에서 다루는 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.이름 하위 서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sold_products_covered 하위 서비스 계약 라인이 적용되는 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.child_contract_lines.sold_products_covered.sys_id 하위 서비스 계약 라인이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.child_contract_lines.sys_id 하위 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리 서비스 계약과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements" [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics 권리 아래에 생성된 권리 특성 객체의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    service_contract_lines.권리.entitlement_characteristics.entitlement_usage entitlement_characteristic 아래에 삽입된 권리 사용 객체입니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "sys_id": "String"
    }
    service_contract_lines.권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.entitlement_characteristics.sys_id 서비스 계약 라인과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    service_contract_lines.권리.install_base_items_covered 권리에 포함된 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.권리.install_base_items_covered.sys_id 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sold_products_covered 권리에 포함된 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.권리.sold_products_covered.sys_id 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    service_contract_lines.권리.sys_id 서비스 계약 라인과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    short_description
    서비스 계약에 대한 간략한 설명 또는 이름입니다.

    데이터 유형: 문자열

    sold_products_covered 서비스 계약이 적용되는 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    sold_products_covered.sys_id 서비스 계약이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sys_id 서비스 계약 기록의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    cURL 요청

    다음은 이 엔드포인트를 호출하고 판매된 제품 대상 기록 1개, 설치 기반 항목 대상 기록 1개, 서비스 계약 라인 2개로 서비스 계약을 생성하는 방법을 보여주는 코드 예제입니다.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract" \
    --request POST \
    --header "Accept:application/json" \
    --data
    {
      "state": "active",
      "account": "4c325111d1f53110f8776589fa411f3d",
      "vendor_contract": "External Reference",
      "starts": "2022-12-03",
      "service_contract_lines": [
        {
          "state": "active",
          "name": "CLI",
          "starts": "2022-12-03",
          "child_contract_lines": [
            {
              "state": "active",
              "name": "Child CLI",
              "starts": "2022-12-03",
              "entitlements": [
                {
                  "state": "active",
                  "entitlement_name": "Child CLI - ENTL",
                  "start_date": "2022-12-03"
                }
              ],
              "sold_products_covered": [
                {
                  "sold_product": "8db4258949f14ef7b90d90822dfc5800",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "install_base_items_covered": [
                {
                  "install_base": "2f270832699b46e78aa899a5a5dc6682",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "entitlement_characteristics": [
                {
                  "characteristic": "63418db7539e61106bfcddeeff7b1238",
                  "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                  "value": "20",
                  "type": "coverage"
                }
              ]
            }
          ],
          "entitlements": [
            {
              "state": "active",
              "entitlement_name": "ENTL",
              "start_date": "2022-12-03",
              "sold_products_covered": [
                {
                  "sold_product": "da23d151d1f53110f8776589fa411f27"
                }
              ],
              "install_base_items_covered": [
                {
                  "install_base": "43739151d1f53110f8776589fa411fc1",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "entitlement_characteristics": [
                {
                  "characteristic": "63418db7539e61106bfcddeeff7b1238",
                  "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                  "value": "20",
                  "type": "coverage_and_usage",
                  "entitlement_usage": {
                    "used_units": "3"
                  }
                }
              ]
            }
          ],
          "sold_products_covered": [
            {
              "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "a1731551d1f53110f8776589fa411f8d",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        },
        {
          "state": "active",
          "name": "CLI 2",
          "starts": "2022-12-03",
          "sold_products_covered": [
            {
              "sold_product": "7f23995dd1b53110f8776589fa411f66",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "a483d951d1f53110f8776589fa411fad",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        }
      ],
      "sold_products_covered": [
        {
          "sold_product": "0df21151d1f53110f8776589fa411f1b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ],
      "install_base_items_covered": [
        {
          "install_base": "e2639951d1f53110f8776589fa411f2b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ]
    } 
    --user "username":"password"

    응답:

    {
      "result": {
        "sys_id": "d8641151d1f53110f8776589fa411fde",
        "number": "CNTR0010004",
        "short_description": null,
        "service_contract_lines": [
          {
            "sys_id": "d4641d91d1f53110f8776589fa411fbb",
            "name": "CLI",
            "child_contract_lines": [
              {
                "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
                "name": "Child CLI",
                "child_contract_lines": [],
                "entitlements": [
                  {
                    "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                    "entitlement_name": "Child CLI - ENTL",
                    "sold_products_covered": [],
                    "install_base_items_covered": [],
                    "entitlement_characteristics": []
                  }
                ],
                "sold_products_covered": [
                  {
                    "sys_id": "dfb62e9c4c6843009be02a68f65b9118"
                  }
                ],
                "install_base_items_covered": [
                  {
                    "sys_id": "2583912e81964501b52a2e44d4797a28"
                  }
                ],
                "entitlement_characteristics": [
                  {
                    "sys_id": "3a00c975bb49412cae169200c7f6236e",
                    "entitlement_usage": {}
                  }
                ]
              }
            ],
            "entitlements": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fc0",
                "entitlement_name": "ENTL",
                "sold_products_covered": [
                  {
                    "sys_id": "a0641d91d1f53110f8776589fa411fc2"
                  }
                ],
                "install_base_items_covered": [
                  {
                    "sys_id": "e0641d91d1f53110f8776589fa411fc3"
                  }
                ],
                "entitlement_characteristics": [
                  {
                    "sys_id": "a8641d91d1f53110f8776589fa411fd0",
                    "entitlement_usage": {
                      "sys_id": "a8641d91d1f53110f8776589fa411fd1"
                    }
                  }
                ]
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "98641d91d1f53110f8776589fa411fbc"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "58641d91d1f53110f8776589fa411fbd"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "e0641d91d1f53110f8776589fa411fbf",
                "entitlement_usage": {}
              }
            ]
          },
          {
            "sys_id": "e4641d91d1f53110f8776589fa411fd2",
            "name": "CLI 2",
            "child_contract_lines": [],
            "entitlements": [],
            "sold_products_covered": [
              {
                "sys_id": "e8641d91d1f53110f8776589fa411fd3"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fd4"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fd5",
                "entitlement_usage": {}
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "9c641d91d1f53110f8776589fa411fb9"
          }
        ],
        "install_base_items_covered": [
          {
            "sys_id": "d8641d91d1f53110f8776589fa411fba"
          }
        ]
      }
    }

    서비스 계약 - POST /sn_pss_core/servicecontract/contractline

    계약 라인 기록과 모든 관련 엔터티를 생성합니다.

    이 엔드포인트는 요청을 처리할 때 다음 테이블에 데이터를 저장합니다.
    • 특성 [sn_pss_core_entitlement_characteristic]
    • 권리 [service_entitlement]
    • 권리 사용 [sn_pss_core_entitlement_usage]
    • 판매된 제품 [sn_install_base_m2m_contract_sold_product] - 이 테이블에는 판매된 제품과 포함된 설치 기반 항목 모두에 대한 정보가 포함되어 있습니다.
    • 서비스 계약 라인 [sn_pss_core_service_contract_line]

    URL 형식

    버전이 지정된 URL: /api/sn_pss_core/v1/servicecontract/contractline

    기본 URL: /api/sn_pss_core/servicecontract/contractline

    지원되는 요청 매개변수

    표 19. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열

    표 20. 쿼리 매개변수
    이름 설명
    없음
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    child_contract_lines 서비스 계약 라인에서 생성된 하위 서비스 계약 라인 객체의 목록입니다. 이 데이터는 서비스 계약[sn_pss_core_service_contract]에 삽입됩니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    child_contract_lines.child_contract_lines 하위 서비스 계약 라인 아래에 생성할 하위 서비스 계약 라인 객체의 목록입니다. 이 배열의 객체에는 매개 변수의 child_contract_lines 객체와 동일한 요소가 있습니다.

    데이터 형식: 객체 배열

    child_contract_lines.계약 하위 서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.끝납니다 하위 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    child_contract_lines.권리 하위 서비스 계약 라인과 연결된 권리의 목록입니다. 이러한 권리는 권리 [service_entitlement] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    child_contract_lines.권리.계좌 매개변수가 consumer 전달되지 않은 경우 필수입니다.
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.소비자 매개변수가 account 전달되지 않은 경우 필수입니다.
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    child_contract_lines.권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.권리.entitlement_characteristics.특성 필수
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.entitlement_usage 연결된 권리 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    entitlement_characteristics가 권리 아래에 있는 경우에만 이 매개변수를 전달합니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    child_contract_lines.권리.entitlement_characteristics.entitlement_usage입니다.used_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics.value 매개변수에 지정된 entitlement_characteristics.characteristic 기록에 포함된 매개변수가 input_type선택이 아닌 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_name 필수
    권리의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.가족 세대 플러그인이 활성 상태이고 consumer 매개변수가 전달된 경우에만 전달됩니다.
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered
    권리에 포함되는 설치 기반 항목의 목록입니다. 이 배열의 정보는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    child_contract_lines.권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.권리.install_base_items_covered.install_base 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered 해당 권리가 적용되는 판매된 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    child_contract_lines.권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.권리.sold_products_covered.제거 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.권리.sold_products_covered.sold_product 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.start_date 필수
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.권리.상태 필수
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.entitlement_characteristics.특성
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.entitlement_usage 연결된 권리 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    entitlement_characteristics가 권리 아래에 있는 경우에만 이 매개변수를 전달합니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    child_contract_lines.entitlement_characteristics.entitlement_usage.used_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.형 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.값
    특성의 값입니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered
    권리에 포함되는 설치 기반 항목의 목록입니다. 이 배열의 정보는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    child_contract_lines.install_base_items_covered.추가 연결된 설치 기반 항목이 하위 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.install_base_items_covered.install_base 하위 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered.제거 연결된 하위 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.이름 하위 서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.parent_contract_line 하위 서비스 계약 라인과 연결된 상위 계약 라인 기록의 Sys_id입니다.

    데이터 유형: 문자열

    child_contract_lines.product_model 하위 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.product_offering 하위 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.sold_product 하위 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered 하위 서비스 계약 라인이 적용되는 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    child_contract_lines.sold_products_covered.추가 연결된 하위 서비스 계약 라인이 연결된 제품을 포함하기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    child_contract_lines.sold_products_covered.제거 연결된 하위 서비스 계약 라인이 연결된 제품의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    child_contract_lines.sold_products_covered.sold_product 하위 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.시작 하위 서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    child_contract_lines.상태
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    계약
    서비스 계약 라인과 연결된 서비스 계약의 Sys_id입니다. 서비스 계약 [sn_pss_core_service_contract] 테이블에 있습니다.

    데이터 유형: 문자열

    종료 서비스 계약 라인이 종료되는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    권리 서비스 계약 라인과 연결할 권리의 목록입니다. 이러한 권리는 권리 [service_entitlement] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    권리.계좌 매개변수가 consumer 전달되지 않은 경우 필수입니다.
    권리가 속한 계정 기록의 Sys_id입니다. 계정 [customer_account] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.소비자 매개변수가 account 전달되지 않은 경우 필수입니다.
    권리가 속한 소비자 기록의 Sys_id입니다. 소비자 [csm_consumer] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.end_date 권리의 종료 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 수동으로 제거할 때까지 종료되지 않습니다.

    권리.entitlement_characteristics 권리와 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    권리.entitlement_characteristics.특성 필수
    권리와 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.characteristic_option 권리와 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.entitlement_usage 연결된 권리 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    entitlement_characteristics가 권리 아래에 있는 경우에만 이 매개변수를 전달합니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    권리.entitlement_characteristics.entitlement_usage입니다.used_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.type 권리 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • coverage_and_usage

    데이터 유형: 문자열

    권리.entitlement_characteristics.value 매개변수에 지정된 entitlement_characteristics.characteristic 기록에 포함된 매개변수가 input_type선택이 아닌 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    권리.entitlement_name 필수
    권리의 이름입니다.

    데이터 유형: 문자열

    권리.가족 세대 플러그인이 활성 상태이고 consumer 매개변수가 전달된 경우에만 전달됩니다.
    권리와 연결된 세대 기록의 Sys_id입니다. 세대[csm_household] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.install_base_items_covered
    권리에 포함되는 설치 기반 항목의 목록입니다. 이 배열의 정보는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    권리.install_base_items_covered.추가 연결된 설치 기반 항목이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    권리.install_base_items_covered.제거 연결된 설치 기반 항목이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    권리.제품 권리와 연결된 제품 모델 기록의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.product_offering 권리와 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.sold_entitlement 권리와 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sold_products_covered 해당 권리가 적용되는 판매된 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    권리.sold_products_covered.추가 판매된 관련 제품이 권리에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    권리.sold_products_covered.제거 판매된 관련 제품이 권리에서 제거된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    권리.sold_products_covered.sold_product 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.start_date 필수
    권리의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    권리.상태 필수
    권리의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    entitlement_characteristics 서비스 계약 라인과 연결된 특성의 목록입니다. 이 배열의 데이터는 특성 [sn_pss_core_entitlement_characteristic] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    entitlement_characteristics.특성 필수
    서비스 계약 라인과 연결된 특성 기록의 Sys_id입니다. 특성 [sn_prd_pm_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.characteristic_option 매개변수에 input_type 지정된 기록에 포함된 매개변수가 선택으로 설정된 경우 필수입니다entitlement_characteristics.characteristic.
    서비스 계약 라인과 연결된 특성 옵션 기록의 Sys_id입니다. 특성 옵션 [sn_prd_pm_characteristic_option] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.entitlement_usage 연결된 서비스 계약 라인 특성에 사용된 단위 값입니다. 이 데이터는 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 삽입됩니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "used_units": "String"
    }
    entitlement_characteristics.entitlement_usage.used_units 연결된 권리 특성의 사용입니다.

    데이터 유형: 문자열

    entitlement_characteristics.형 서비스 계약 라인 특성의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 보도
    • 범위 _and_usage

    데이터 유형: 문자열

    entitlement_characteristics.값 매개변수가 entitlement_characteristics.type 전달되지 않은 경우 필수입니다.
    특성의 값입니다.

    데이터 유형: 문자열

    install_base_items_covered 매개변수가 sold_products_covered 전달되지 않은 경우 필수입니다.
    서비스 계약 라인에서 다루는 설치 기반 항목 목록입니다. 이 매개변수의 데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 삽입됩니다.

    데이터 형식: 객체 배열

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    install_base_items_covered.추가
    연결된 설치 기반 항목이 서비스 계약 라인에 추가된 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    install_base_items_covered.install_base 서비스 계약 라인에서 다루는 설치 기반 항목의 Sys_id입니다. 설치 기반 항목 [sn_install_base_item] 테이블에 있습니다.

    데이터 유형: 문자열

    install_base_items_covered.제거
    연결된 서비스 계약 라인이 설치 기반 항목의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    이름 필수
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    parent_contract_line 현재 서비스 계약 라인이 하위인 서비스 계약 라인의 Sys_id입니다.

    계약에 따라 생성된 계약 라인의 경우 Null입니다.

    데이터 유형: 문자열

    product_model 서비스 계약 라인과 연결된 제품의 Sys_id입니다. 제품 모델 [cmdb_model] 테이블에 있습니다.

    데이터 유형: 문자열

    product_offering 서비스 계약 라인과 연결된 제품 오퍼링 기록의 Sys_id입니다. 제품 오퍼링 [sn_prd_pm_product_offering] 테이블에 있습니다.

    데이터 유형: 문자열

    sold_product 서비스 계약 라인과 연결된 판매된 제품 기록의 Sys_id입니다. 판매된 제품 [sn_install_base_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sold_products_covered 매개변수가 install_base_items_covered 전달되지 않은 경우 필수입니다.
    서비스 계약 라인이 적용되는 제품 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]

    데이터는 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 저장됩니다.

    sold_products_covered.추가 연결된 서비스 계약 라인이 연결된 제품에 포함되기 시작하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 현재 날짜

    sold_products_covered.제거 연결된 서비스 계약 라인이 연결된 제품의 범위를 종료하는 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    기본값: 종료 날짜 없음

    sold_products_covered.sold_product
    서비스 계약 라인과 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    시작 필수
    서비스 계약 라인의 시작 날짜입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd

    상태 필수
    계약 라인의 현재 상태입니다.
    유효한 값: (대/소문자 구분)
    • active
    • 취소됨
    • 초안
    • 만료
    • 일시 중단

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 22. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    컨텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 23. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 24. 상태 코드
    상태 코드 설명
    201 성공입니다. 요청이 성공적으로 처리되고 기록이 생성되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    403 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    child_contract_lines 서비스 계약 라인에서 생성된 하위 서비스 계약 라인 객체의 목록입니다.

    데이터 형식: 객체 배열

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id" "String"
      }
    ]
    child_contract_lines.child_contract_lines 하위 서비스 계약 라인 아래에 생성된 하위 서비스 계약 라인 객체의 목록입니다. 이 배열의 객체에는 매개 변수와 child_contract_lines 동일한 요소가 있습니다.

    데이터 형식: 객체 배열

    child_contract_lines.권리 하위 서비스 계약 라인과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    child_contract_lines.권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.권리.entitlement_characteristics 권리 아래에 생성된 권리 특성 객체의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.권리.entitlement_characteristics.sys_id 하위 서비스 계약 라인과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.권리.install_base_items_covered 권리에 포함된 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.권리.install_base_items_covered.sys_id 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sold_products_covered 권리에 포함된 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.권리.sold_products_covered.sys_id 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.권리.sys_id 하위 서비스 계약 라인과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics 칠레 계약 라인과 연결된 특성 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics": [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    child_contract_lines.entitlement_characteristics.entitlement_usage entitlement_characteristic 아래에 삽입된 권리 사용 객체입니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "sys_id": "String"
    }
    child_contract_lines.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.entitlement_characteristics.sys_id 하위 서비스 계약 라인과 연결된 권리 특성 기록의 Sys_id입니다. 특성 [sn_pss_core_entitlement_characteristic] 테이블에 있습니다.

    데이터 유형: 문자열

    child_contract_lines.install_base_items_covered 하위 서비스 계약 라인에서 다루는 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.이름 하위 서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    child_contract_lines.sold_products_covered 하위 서비스 계약 라인이 적용되는 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.sold_products_covered.sys_id 하위 서비스 계약 라인이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    child_contract_lines.sys_id 하위 계약 항목이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리 서비스 계약 라인과 연결된 권리의 목록입니다.

    데이터 형식: 객체 배열

    "entitlements": [
      {
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    권리.entitlement_characteristics 권리 아래에 생성된 권리 특성 객체의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    권리.entitlement_characteristics.entitlement_usage entitlement_characteristic 아래에 삽입된 권리 사용 객체입니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "sys_id": "String"
    }
    권리.entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    권리.entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    권리.entitlement_name
    권리의 이름입니다.

    데이터 유형: 문자열

    권리.install_base_items_covered 권리에 포함된 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    권리.install_base_items_covered.sys_id 권리가 적용되는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sold_products_covered 권리에 포함된 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    권리.sold_products_covered.sys_id 권리와 연결된 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    권리.sys_id 서비스 계약 라인과 연결된 권리 기록의 Sys_id입니다. 권리 [service_entitlement] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics 서비스 계약 라인에서 생성된 권리 특성 객체의 목록입니다.

    데이터 형식: 객체 배열

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    entitlement_characteristics.entitlement_usage entitlement_characteristic 아래에 삽입된 권리 사용 객체입니다.

    데이터 유형: 객체

    "entitlement_usage": {
        "sys_id": "String"
    }
    entitlement_characteristics.entitlement_usage.sys_id 권리 사용 기록의 Sys_id입니다. 권리 사용량[sn_pss_core_entitlement_usage] 테이블에 있습니다.

    데이터 유형: 문자열

    entitlement_characteristics.sys_id 권리 특성 기록의 Sys_id입니다.

    데이터 유형: 문자열

    install_base_items_covered 서비스 계약 라인에서 다루는 설치 기반 항목의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    install_base_items_covered.sys_id 다루는 설치 기반 항목의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    이름
    서비스 계약 라인의 이름입니다.

    데이터 유형: 문자열

    sold_products_covered 서비스 계약 라인이 적용되는 제품의 sys_ids 목록입니다.

    데이터 형식: 객체 배열

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    sold_products_covered.sys_id 서비스 계약 라인이 적용되는 제품의 Sys_id입니다. 판매된 제품 [sn_install_base_m2m_contract_sold_product] 테이블에 위치합니다.

    데이터 유형: 문자열

    sys_id 서비스 계약 라인 기록의 Sys_id입니다. 서비스 계약 라인 [sn_pss_core_service_contract_line] 테이블에 있습니다.

    데이터 유형: 문자열

    cURL 요청

    다음은 이 끝점을 호출하고 서비스 계약 라인 레코드를 만드는 방법을 보여 주는 코드 예제입니다.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/contractline" \
    --request POST \
    --header "Accept:application/json" \
    --data
    {
      "state": "active",
      "contract": "a4b415d1d1f53110f8776589fa411f20",
      "parent_contract_line": null,
      "name": "CLI",
      "starts": "2022-12-03",
      "child_contract_lines": [
        {
          "state": "active",
          "name": "Child CLI",
          "starts": "2022-12-03",
          "entitlements": [
            {
              "state": "active",
              "entitlement_name": "Child CLI - ENTL",
              "start_date": "2022-12-03"
            }
          ],
          "sold_products_covered": [
            {
              "sold_product": "8db4258949f14ef7b90d90822dfc5800",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "2f270832699b46e78aa899a5a5dc6682",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        }
      ],
      "entitlements": [
        {
          "state": "active",
          "entitlement_name": "ENTL 1",
          "start_date": "2022-12-03",
          "sold_products_covered": [
            {
              "sold_product": "ec235d9dd1b53110f8776589fa411fe2"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage_and_usage",
              "entitlement_usage": {
                "used_units": "3"
              }
            }
          ]
        }
      ],
      "sold_products_covered": [
        {
          "sold_product": "0df21151d1f53110f8776589fa411f1b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ],
      "entitlement_characteristics": [
        {
          "characteristic": "63418db7539e61106bfcddeeff7b1238",
          "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
          "value": "tyfy6h",
          "type": "coverage"
        }
      ]
    }

    응답:

    {
      "result": {
        "sys_id": "16e451d1d1f53110f8776589fa411f80",
        "name": "CLI",
        "child_contract_lines": [
          {
            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
            "name": "Child CLI",
            "child_contract_lines": [],
            "entitlements": [
              {
                "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                "entitlement_name": "Child CLI - ENTL",
                "sold_products_covered": [],
                "install_base_items_covered": [],
                "entitlement_characteristics": []
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "dfb62e9c4c6843009be02a68f65b9118"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "2583912e81964501b52a2e44d4797a28"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "3a00c975bb49412cae169200c7f6236e",
                "entitlement_usage": {}
              }
            ]
          }
        ],
        "entitlements": [
          {
            "sys_id": "9ee451d1d1f53110f8776589fa411f83",
            "entitlement_name": "ENTL 1",
            "sold_products_covered": [
              {
                "sys_id": "92e451d1d1f53110f8776589fa411f85"
              }
            ],
            "install_base_items_covered": [],
            "entitlement_characteristics": [
              {
                "sys_id": "92e451d1d1f53110f8776589fa411f86",
                "entitlement_usage": {
                  "sys_id": "dee451d1d1f53110f8776589fa411f86"
                }
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "5ae451d1d1f53110f8776589fa411f81"
          }
        ],
        "install_base_items_covered": [],
        "entitlement_characteristics": [
          {
            "sys_id": "dae451d1d1f53110f8776589fa411f82",
            "entitlement_usage": {}
          }
        ]
      }
    }