--- sourceDocument: 호주 API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 제품 카탈로그 개방형 API # 제품 카탈로그 개방형 API {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 320분 제품 카탈로그 Open API는 제품 카탈로그, 제품 오퍼링 및 제품 사양을 생성하고 검색할 수 있는 엔드포인트를 제공합니다. 이 API를 사용하여 외부 시스템과 ServiceNow AI Platform. 제품 카탈로그 오픈 API는 TM Forum 제품 카탈로그 관리 API REST 사양의 구현입니다ServiceNow®. 이 구현은 [TMF620 제품 카탈로그 관리 API 사용자 가이드 v5.0.0](https://www.tmforum.org/resources/specifications/tmf620-product-catalog-management-api-user-guide-v5-0-0/), 2024년 9월을 기반으로 합니다. 이 API는 에서 사용할 수 ServiceNow Store있는 제품 카탈로그 고급 애플리케이션에 포함되어 있습니다. 이 API는 `sn_tmf_api` 네임스페이스 내에서 제공됩니다. 호출 사용자에게 sn_prd_pm_adv.catalog_integrator 역할이 있어야 합니다. 이 API는 다음 테이블에서 데이터를 생성하고 업데이트합니다. * 특성 \[sn_prd_pm_characteristic\] * 특성 옵션 \[sn_prd_pm_characteristic_option\] * 제품 오퍼링 \[sn_prd_pm_product_offering\] * 제품 오퍼링 카탈로그 \[sn_prd_pm_product_offering_catalog\] * 제품 오퍼링 특성 \[sn_prd_pm_product_offering_characteristic\] * 제품 사양 \[sn_prd_pm_product_specification\] * 사양 관계 \[sn_prd_pm_specification_relationship\] {#product-catalog-open-api__ul_fhn_pjj_hsb} ## 제품 카탈로그 개방형 API - DELETE /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title2} 지정된 제품 오퍼링을 삭제합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-DELETE-prodOffer-id__entry__2} | 이름 | 설명 | |-|-| | ID | 삭제할 제품 오퍼링의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | [표 1. 경로 매개변수] {#tmf_prod_cat-DELETE-prodOffer-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 2. 쿼리 매개변수] {#tmf_prod_cat-DELETE-prodOffer-id__entry__10} | 이름 | 설명 | |-|-| | 안 함 | | [표 3. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-DELETE-prodOffer-id__entry__14}{#tmf_prod_cat-DELETE-prodOffer-id__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 4. 요청 헤더] {#tmf_prod_cat-DELETE-prodOffer-id__entry__18} | 머리글 | 설명 | |-|-| | 안 함 | | [표 5. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-DELETE-prodOffer-id__table_tmr_dgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodOffer-id__entry-200-status-code}{#tmf_prod_cat-DELETE-prodOffer-id__entry-400-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | [표 6. 상태 코드] {#tmf_prod_cat-DELETE-prodOffer-id__table_tmr_dgq_mbc} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_cat-DELETE-prodOffer-id__entry__28} | 이름 | 설명 | |-|-| | 메시지 | 제품 사양의 삭제 또는 보관에 대한 실패 또는 성공 메시지입니다. | [ ] ### cURL 요청 다음 예에서는 ID가 d6f8d9995b020210235d85cced81c7eb인 제품 오퍼링을 삭제합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb" \ --request DELETE\ --header "Accept:application/json" \ --user 'username':'password' 응답 본문은 성공적인 삭제 메시지를 반환합니다. "The product offering (d6f8d9995b020210235d85cced81c7eb) is successfully deleted" ## 제품 카탈로그 개방형 API - 삭제 /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title3} 특정 sys_id이 있는 가격 목록 라인을 비활성화하지만 삭제하지는 않습니다. 가격 목록 라인을 비활성 상태로 설정하기 위해 이 DELETE 메서드는 가격 목록 라인의 종료 날짜를 오늘 날짜로 업데이트합니다. 종료 날짜가 오늘 날짜 이전인 가격 목록 라인도 비활성으로 간주됩니다. 비활성 가격 목록 라인은 관련 GET 메서드에서 검색할 수 없습니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### 지원되는 요청 매개변수 {#tmf_prod_order-DEL-prodoffprice-id__entry__2} | 이름 | 설명 | |-|-| | ID | 삭제할 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | [표 7. 경로 매개변수] {#tmf_prod_order-DEL-prodoffprice-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 8. 쿼리 매개변수] {#tmf_prod_order-DEL-prodoffprice-id__entry__10} | 이름 | 설명 | |-|-| | 안 함 | | [표 9. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-DEL-prodoffprice-id__entry__14}{#tmf_prod_order-DEL-prodoffprice-id__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 10. 요청 헤더] {#tmf_prod_order-DEL-prodoffprice-id__entry__18} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 11. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-DEL-prodoffprice-id__entry-200-status-code}{#tmf_prod_order-DEL-prodoffprice-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_order-DEL-prodoffprice-id__ul_qkg_2rv_22c} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 12. 상태 코드] {#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_order-DEL-prodoffprice-id__entry__30} | 이름 | 설명 | |-|-| | 메시지 | 가격 목록 라인의 성공 또는 실패에 대한 메시지가 포함된 상태 코드입니다. | [ ] ### cURL 요청 다음 예는 지정된 sys_id의 가격 목록을 성공적으로 비활성화하거나 삭제하는 방법을 보여줍니다. 994일... curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \ --request DELETE\ --user 'username':'password' 응답. 응답은 성공적인 비활성화에 대한 상세 정보와 함께 200 상태 코드를 반환합니다. Status: 200 OK "The price list line (994d5d364f8b5210f899f61d20ce0b7c) is inactive successfully" ## 제품 카탈로그 개방형 API - 삭제 /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title4} 지정된 제품 사양을 삭제하거나 보관합니다. 이 DELETE 메서드를 호출하면 제품 사양은 상태에 따라 삭제되거나 보관될 수 있습니다. * 초안 상태의 제품 사양이 성공적으로 삭제되었습니다. 응답은 성공 메시지를 반환합니다. * 보관된 상태의 제품 사양은 삭제할 수 없습니다. 응답은 사양이 이미 보관되었다는 메시지를 반환합니다. * 초안 상태가 아니며 다른 제품 사양 또는 오퍼링과 연결된 제품 사양은 보관되지만 삭제되지는 않습니다. 응답은 사양이 활성 상태에서 보관된 상태로 이동되었다는 메시지를 반환합니다. * 활성 제품 사양 또는 오퍼링과 연결된 제품 사양은 삭제할 수 없습니다. 응답은 오류 메시지를 반환합니다. {#tmf_prod_cat-DELETE-prodSpec-id__ul_rmw_mw4_4bc} ### URL 형식 기본 URL: /sn_tmf_api/catalogmanagement/productSpecification/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-DELETE-prodSpec-id__entry__2} | 이름 | 설명 | |-|-| | ID | 삭제할 제품 사양의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] | [표 13. 경로 매개변수] {#tmf_prod_cat-DELETE-prodSpec-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 14. 쿼리 매개변수] {#tmf_prod_cat-DELETE-prodSpec-id__entry__10} | 이름 | 설명 | |-|-| | 안 함 | | [표 15. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodSpec-id__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 16. 요청 헤더] {#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc} {#tmf_prod_cat-DELETE-prodSpec-id__entry__18} | 머리글 | 설명 | |-|-| | 안 함 | | [표 17. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-DELETE-prodSpec-id__table_tmr_dgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodSpec-id__entry-200-status-code}{#tmf_prod_cat-DELETE-prodSpec-id__entry-400-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | [표 18. 상태 코드] {#tmf_prod_cat-DELETE-prodSpec-id__table_tmr_dgq_mbc} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_cat-DELETE-prodSpec-id__entry__28} | 이름 | 설명 | |-|-| | 메시지 | 제품 사양의 삭제 또는 보관에 대한 실패 또는 성공 메시지입니다. | [ ] ### cURL 요청 다음 예에서는 ID가 8ef57fa05b308210235d85cced81c7d8인 제품 사양을 삭제합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/8ef57fa05b308210235d85cced81c7d8" \ --request DELETE\ --header "Accept:application/json" \ --user 'username':'password' 응답 본문은 성공 또는 실패 메시지를 반환합니다. "The product specification (8ef57fa05b308210235d85cced81c7d8) is successfully deleted" ## 제품 카탈로그 Open API - GET /sn_tmf_api/catalogmanagement/catalog {#ariaid-title5} 모든 제품 오퍼링 카탈로그의 목록을 조회합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/catalog ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 19. 경로 매개변수] {#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 데이터 유형: 문자열 기본값: 모든 필드가 반환됩니다. | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 데이터 유형: 숫자 기본값: 0 | [표 20. 쿼리 매개변수] {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb} {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 21. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-catalog__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 22. 요청 헤더] {#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb__entry__2}{#tmf_prod_cat-GET-catalog__content-range-row}{#tmf_prod_cat-GET-catalog__content-type-row}{#tmf_prod_cat-GET-catalog__links-pagination-row}{#tmf_prod_cat-GET-catalog__x-total-count-descr} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예를 들어, `offset=2` 및 `limit=3`인 경우 헤더의 Content-Range 값은 `항목 3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#tmf_prod_cat-GET-catalog__ul_zzk_sdm_lsb} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. | [표 23. 응답 헤더] {#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-catalog__table_v1h_tcm_lsb__entry__2}{#tmf_prod_cat-GET-catalog__tmf-get-status-200-p}{#tmf_prod_cat-GET-catalog__tmf-get-status-206-entry}{#tmf_prod_cat-GET-catalog__tmf-get-status-400-entry}{#tmf_prod_cat-GET-catalog__tmf-get-status-404-entry} | 상태 코드 | 설명 | |-|-| | 200 | 요청이 성공적으로 처리되었습니다. 응답에서 전체 자원이 반환되었습니다(페이지 매김 없음). | | 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-catalog__ul_rys_1gy_fsb} | | 404 | 기록 없음 쿼리 매개변수와 일치하는 기록을 테이블에서 찾을 수 없습니다. | [표 24. 상태 코드] {#tmf_prod_cat-GET-catalog__table_v1h_tcm_lsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-GET-catalog__section_g2r_kmz_gsb} {#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb__entry__2} | 이름 | 설명 | |-|-| | 설명 | 제품 오퍼링 카탈로그에 대한 설명입니다. 필드에 값이 포함된 경우에만 반환됩니다. 데이터 유형: 문자열 | | externalSystem | `TMF620`이 추가된 제품 오퍼링 카탈로그의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | ID | 제품 오퍼링 카탈로그의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 카탈로그 \[sn_prd_pm_product_offering_catalog\] | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | 이름 | 제품 오퍼링 카탈로그의 이름입니다. 데이터 유형: 문자열 | | 상태 | 제품 오퍼링 카탈로그의 상태입니다. 가능한 값: 게시됨 데이터 유형: 문자열 | [ ] {#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb} ### cURL 요청 이 예에서는 모든 제품 오퍼링 카탈로그를 검색합니다. curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \ --user 'username':'password' 응답 본문. [ { "id": "341f4953b71a9910ff00f203ae11a9bb", "name": "Home Internet Plan", "lifecycleStatus": "Active", "status": "published", "externalSystem": "Salesforce-TMF641" }, { "id": "69f494792b11525047f3f3e30391bf66", "name": "Chemical Processing", "lifecycleStatus": "Active", "description": " Catalog for Chemical Processing Industry", "status": "published", "externalSystem": "Salesforce-TMF620" } ] ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/catalog/{id} {#ariaid-title6} 제품 오퍼링 카탈로그를 조회합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/catalog/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 제품 오퍼링 카탈로그의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 카탈로그 \[sn_prd_pm_product_offering_catalog\] | [표 25. 경로 매개변수] {#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 데이터 유형: 문자열 기본값: 모든 필드. | [표 26. 쿼리 매개변수] {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 27. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-catalog-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 28. 요청 헤더] {#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-catalog-id__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 29. 응답 헤더] {#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-catalog-id__entry-200-status-code}{#tmf_prod_cat-GET-catalog-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 다음과 같은 이유 중 하나일 수 있습니다. * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-catalog-id__ul_rys_1gy_fsb} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 30. 상태 코드] {#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb__entry__2} | 이름 | 설명 | |-|-| | 설명 | 제품 오퍼링 카탈로그에 대한 설명입니다. 데이터 유형: 문자열 | | externalSystem | `TMF620`이 추가된 제품 오퍼링 카탈로그의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | ID | 제품 오퍼링 카탈로그의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 카탈로그 \[sn_prd_pm_product_offering_catalog\] | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | 이름 | 제품 오퍼링 카탈로그의 이름입니다. 데이터 유형: 문자열 | [ ] {#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb} ### cURL 요청 이 예에서는 엔터프라이즈 모바일 플랜에 대한 제품 오퍼링 카탈로그를 검색합니다. curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog/69f494792b11525047f3f3e30391bf66" \ --user 'username':'password' 응답 본문. { "id": "69f494792b11525047f3f3e30391bf66", "name": "Chemical Processing", "lifecycleStatus": "Active", "description": " Catalog for Chemical Processing Industry", "externalSystem": "Salesforce-TMF620" } ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title7} 지정된 필터 설정에 따라 모든 제품 오퍼링 또는 제품 오퍼링의 하위 집합을 검색합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOffering ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-prodoffering__section_fcz_2t1_jsb} {#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 31. 경로 매개변수] {#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * 범주 * 채널 * 설명 * externalId * ID * internalId * 내부 버전 * 마지막 업데이트 * 이름 * 제품 특성 * productOfferingPrice * productOfferingTerm * 제품 사양 * prodSpecCharValueUse * 유효한대상 * 버전 {#tmf_prod_cat-GET-prodoffering__ul_irb_sdg_5tb} 데이터 유형: 문자열 기본값: 모든 필드가 반환됩니다. | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 데이터 유형: 숫자 기본값: 0 | | 사양 | 제품 사양 sys_id별로 제품 오퍼링을 필터링합니다. 지정된 제품 사양 sys_id가 있는 제품 오퍼링만 응답에 반환됩니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] | | 상태 | 상태별로 제품 오퍼링을 필터링합니다. 지정된 상태의 제품 오퍼링만 응답에 반환됩니다. 유효한 값은 다음과 같습니다. * 보관됨 * 초안 * 게시 날짜: * 폐기됨 {#tmf_prod_cat-GET-prodoffering__ul_ndy_pcb_ccc} 데이터 유형: 문자열 | [표 32. 쿼리 매개변수] {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 33. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodoffering__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 34. 요청 헤더] {#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb__entry__2}{#tmf_prod_cat-GET-prodoffering__content-range-row}{#tmf_prod_cat-GET-prodoffering__content-type-row}{#tmf_prod_cat-GET-prodoffering__links-pagination-row}{#tmf_prod_cat-GET-prodoffering__x-total-count-descr} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예를 들어, `offset=2` 및 `limit=3`인 경우 헤더의 Content-Range 값은 `항목 3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#tmf_prod_cat-GET-prodoffering__ul_zzk_sdm_lsb} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. | [표 35. 응답 헤더] {#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb__entry__2}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-200-p}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-206-entry}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-400-entry}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-404-entry} | 상태 코드 | 설명 | |-|-| | 200 | 요청이 성공적으로 처리되었습니다. 응답에서 전체 자원이 반환되었습니다(페이지 매김 없음). | | 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-prodoffering__ul_rys_1gy_fsb} | | 404 | 기록 없음 쿼리 매개변수와 일치하는 기록을 테이블에서 찾을 수 없습니다. | [표 36. 상태 코드] {#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb} ### 응답 본문 매개변수 {#tmf_prod_cat-GET-prodoffering__section_qqr_2s1_jsb} {#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb__entry__2}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-displayName-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-isBundle-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-isSellable-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-status-entry} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.href | 연결된 제품 오퍼링에 대한 상대 링크입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] | | category.id | 범주의 ID입니다. 데이터 유형: 문자열 | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 | | 채널 | 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.설명 | 채널에 대한 설명입니다. 데이터 유형: 문자열 | | channel.id | 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 | | 설명 | 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 오퍼링의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 오퍼링의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, external_id 필드 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 또는 external_id 필드 | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 | | 수명주기상태 | 제품 오퍼링의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-GET-prodoffering__ul_fhv_2jw_xfc} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productCharacteristic입니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-GET-prodoffering__ul_jpt_fjw_xfc} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice를 사용합니다.값 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice를 사용합니다.가격.세금 포함 금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice.price.taxIncludedAmount.unit | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 | | productOfferingPrice.price.taxIncludedAmount.value | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.priceType | 제품 오퍼링 가격의 유형으로, 일회성 또는 정기 결제입니다. 가능한 값: * 비반복(일회성) * 반복 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링에 유효한 계약 기간입니다. 데이터 유형: 문자열 | | 제품 사양 | 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecification입니다.아이디 | 제품 사양 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.이름 | 제품 사양의 이름입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 이름 필드 | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 상태 | 제품 오퍼링의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 제품 오퍼링의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYY-MM-DD | | validFor.startDateTime | 제품 오퍼링의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYY-MM-DD | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [ ] {#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb} 다음 코드 예에서는 처음 두 개의 제품 오퍼링 기록을 조회합니다. curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering?limit=2" \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문: [ { "id": "7b012c4d41ea7910f8771355f12634a4", "externalId": "7b012c4d41ea7910f8771355f12634a4", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/0361dd9fd0a63110f8770dbf976be16f", "externalSystem": "Salesforce-TMF620", "name": "Ultimate internet - 1Gbps Plan", "displayName": "Ultimate internet - 1Gbps Plan", "description": "Ultimate internet - 1Gbps Plan", "isSellable": true, "lifecycleStatus": "Active", "isBundle": false, "lastUpdate": "2025-03-08 02:07:04", "version": "", "internalVersion": "1", "internalId": "0361dd9fd0a63110f8770dbf976be16f", "validFor": { "startDateTime": "2023-11-14", "endDateTime": "" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": "", "bundledProductOffering": [], "bundledGroupProductOffering": [], "productSpecification": {}, "prodSpecCharValueUse": [], "channel": "", "category": [ { "id": "e6f0159fd0a63110f8770dbf976be18c", "name": "Internet" } ], "status": "published" }, { "id": "313b917843235210a82ed6085bb8f2c7", "externalId": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "internalId": "03c99cb53bf066509b48d69a04e45a11", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": [ { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": false, "value": "When in use" } ] }, { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": true, "value": "Premium" } ] } ], "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17", "id": "0f61dd9fd0a63110f8770dbf976be168", "externalId": "EXT-123", "name": "Solana Sports streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a", "id": "62619d9fd0a63110f8770dbf976be180", "externalId": "EXT-345", "name": "Solana Movie streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2025-02-27 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "Base (10 site)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ] ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title8} 특정 제품 오퍼링을 조회합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-prodoffering-id__section_jjg_dr1_jsb} {#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 제품 오퍼링의 초기 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | [표 37. 경로 매개변수] {#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * 범주 * 채널 * 설명 * externalId * ID * internalId * 내부 버전 * 마지막 업데이트 * 이름 * 제품 특성 * productOfferingPrice * productOfferingTerm * 제품 사양 * prodSpecCharValueUse * 유효한대상 * 버전 {#tmf_prod_cat-GET-prodoffering-id__ul_irb_sdg_5tb} 데이터 유형: 문자열 기본값: 모든 필드가 반환됩니다. | | 사양 | 제품 사양 sys_id별로 제품 오퍼링을 필터링합니다. 지정된 제품 사양 sys_id가 있는 제품 오퍼링만 응답에 반환됩니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] | | 상태 | 상태별로 제품 오퍼링을 필터링합니다. 지정된 상태의 제품 오퍼링만 응답에 반환됩니다. 유효한 값은 다음과 같습니다. * 보관됨 * 초안 * 게시 날짜: * 폐기됨 {#tmf_prod_cat-GET-prodoffering-id__ul_ndy_pcb_ccc} 데이터 유형: 문자열 | [표 38. 쿼리 매개변수] {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 39. 요청 본문 매개변수] {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 40. 요청 헤더] {#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 41. 응답 헤더] {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__entry-200-status-code}{#tmf_prod_cat-GET-prodoffering-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-prodoffering-id__ul_rys_1gy_fsb} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 42. 상태 코드] {#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb} ### 응답 본문 매개변수 {#tmf_prod_cat-GET-prodoffering-id__section_qqr_2s1_jsb} {#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-displayName-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-isBundle-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-isSellable-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-status-entry} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.href | 연결된 제품 오퍼링에 대한 상대 링크입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] | | category.id | 범주의 Sys_id입니다. 데이터 유형: 문자열 | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 | | 채널 | 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.묘사 | 채널에 대한 설명입니다. 데이터 유형: 문자열 | | channel.id | 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 | | 설명 | 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 오퍼링의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 오퍼링의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, external_id 필드 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 또는 external_id 필드 | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH-mm-SS | | 수명주기상태 | 제품 오퍼링의 현재 수명주기 상태입니다. 가능한 값: * 활성 * 비활성 * 초안 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-GET-prodoffering-id__ul_fhv_2jw_xfc} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productCharacteristic입니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-GET-prodoffering-id__ul_jpt_fjw_xfc} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice를 사용합니다.값 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice를 사용합니다.값.세금 포함 금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice를 사용합니다.값.taxIncludedAmount입니다.단위 | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.값.taxIncludedAmount입니다.값 | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.priceType | 제품 오퍼링 가격이 일회성 지불인지 반복되는 지불인지 식별합니다. 가능한 값: * 되풀이 * 반복 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링에 유효한 계약 기간입니다. 데이터 유형: 문자열 | | 제품 사양 | 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecification입니다.아이디 | 제품 사양 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.이름 | 제품 사양의 이름입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 이름 필드 | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 상태 | 제품 오퍼링의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 제품 오퍼링의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | validFor입니다.시작 날짜/시간 | 제품 오퍼링의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [ ] {#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb} ### cURL 요청 이 예에서는 지정된 제품 오퍼링을 조회합니다. curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11" --user 'username':'password' 응답 본문: { "id": "313b917843235210a82ed6085bb8f2c7", "externalId": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11", "externalSystem": "Salesforce-TMF620", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "internalId": "03c99cb53bf066509b48d69a04e45a11", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": [ { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": false, "value": "When in use" } ] }, { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": true, "value": "Premium" } ] } ], "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17", "id": "0f61dd9fd0a63110f8770dbf976be168", "externalId": "EXT-123", "name": "Solana Sports streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a", "id": "62619d9fd0a63110f8770dbf976be180", "externalId": "EXT-345", "name": "Solana Movie streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2025-02-27 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "Base (10 site)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice {#ariaid-title9} 인스턴스의 모든 가격 목록 라인 기록을 검색합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice ### 지원되는 요청 매개변수 {#tmf_prod_order-GET-prodOfferPrice__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 43. 경로 매개변수] {#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c__entry__2} | 이름 | 설명 | |-|-| | 마지막 업데이트 | 가격 라인이 마지막으로 업데이트된 날짜를 기준으로 결과를 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 이름 | 지정된 가격 목록의 이름에 속하는 가격 목록 라인을 필터링합니다. 테이블: 가격 목록 \[sn_csm_pricing_price_list\] 데이터 유형: 문자열 | | 가격.가치 | 특정 목록 가격 값을 기준으로 결과를 필터링합니다. 데이터 유형: 문자열 | | priceList.id | 지정된 sys_id의 가격 목록만 반환하도록 결과를 필터링합니다. 테이블: 가격 목록 \[sn_csm_pricing_price_list\] 데이터 유형: 문자열 | | 가격 유형 | 제품 오퍼링의 가격 책정 방법을 기준으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다. * 반복: 기업이 지정된 빈도로 반복되는 가격 책정 금액을 청구할 수 있습니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료를 지원합니다. 데이터 유형: 문자열 | | productOffering.아이디 | 제품 오퍼링의 sys_id 기준으로 가격 목록 라인을 필터링합니다. 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 데이터 유형: 문자열 | | unitOfMeasure입니다.아이디 | 측정 단위의 sys_id 기준으로 가격 목록 라인을 필터링합니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | validFor입니다.종료 날짜/시간 | 지정된 종료 날짜 및 시간을 기준으로 가격 목록 라인을 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 지정된 시작 날짜 및 시간을 기준으로 가격 목록 라인을 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | [표 44. 쿼리 매개변수] {#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c} {#tmf_prod_order-GET-prodOfferPrice__entry__26} | 이름 | 설명 | |-|-| | 안 함 | | [표 45. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 {#tmf_prod_order-GET-prodOfferPrice__section_opp_j5w_22c} 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 46. 요청 헤더] {#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c} {#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 47. 응답 헤더] {#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__entry-200-status-code}{#tmf_prod_order-GET-prodOfferPrice__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_order-GET-prodOfferPrice__ul_qkg_2rv_22c} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 48. 상태 코드] {#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-href}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-isBundle}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lastUpdate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.value}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.startDate} | 이름 | 설명 | |-|-| | @type | 가격 목록 라인의 유형입니다. 항상 `ProductOfferingPrice` 값입니다. 데이터 유형: 문자열 | | href | 인스턴스의 가격 목록 라인 기록에 대한 URL입니다. 데이터 유형: 문자열 | | ID | 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 | | 마지막 업데이트 | 가격 목록 라인이 마지막으로 업데이트된 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | 가격 | 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "units": "String", "value": "String" } | | 가격.단위 | 가격의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 데이터 유형: 문자열 | | 가격.가치 | 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시) | | priceList | 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 가격 목록 \[sn_csm_pricing_price_list\] 테이블의 가격 목록 Sys_id입니다. 데이터 유형: 문자열 | | priceList.name | 가격 목록의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 항상 `priceList`의 값을 가집니다. 데이터 유형: 문자열 | | 가격 유형 | 이 가격 목록 라인과 연결된 제품 오퍼링의 가격 책정 방법입니다. 가능한 값: * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 의 recurringChargePeriodType 값은 충전의 빈도를 나타냅니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료입니다. 데이터 유형: 문자열 | | productOffering | 가격 목록 라인과 연결된 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 제품 오퍼링의 Sys_id입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 예를 들면 `PRDOF01024`입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.이름 | 제품 오퍼링의 이름입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 이 가격 목록 라인과 연결된 제품 오퍼링의 주기 또는 빈도입니다. `반복`으로 설정된 경우 priceType 빈도 유형을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. 가능한 값: * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.금액 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure.id | 측정 단위의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어 `연도` 또는 `번들`입니다. 데이터 유형: 문자열 | | 유효한대상 | 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | [ ] {#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c} ### cURL 요청 다음 예제에서는 인스턴스에 있는 두 가격 목록 라인을 모두 반환합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/ catalogmanagement/productOfferingPrice " \ --request GET\ --user 'username':'password' 응답 본문. [ { "id": "2c4628ac7f4f9e50f8994fa63c86653c", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:28", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/2c4628ac7f4f9e50f8994fa63c86653c", "validFor": { "startDateTime": "2027-03-22 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "9a7a119953020110286eddeeff7b1238", "amount": 1, "units": "Month" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" }, { "id": "dfb7ec607f8f9e50f8994fa63c866569", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:46", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569", "validFor": { "startDateTime": "2026-05-28 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" } ] ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title10} 특정 가격 목록 라인에 대한 상세 정보를 검색합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-prodofferprice-id__entry__2} | 이름 | 설명 | |-|-| | ID | 필수 검색할 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | [표 49. 경로 매개변수] {#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c__entry__2} | 이름 | 설명 | |-|-| | 마지막 업데이트 | 가격 라인이 마지막으로 업데이트된 날짜를 기준으로 결과를 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 이름 | 지정된 가격 목록의 이름에 속하는 가격 목록 라인을 필터링합니다. 테이블: 가격 목록 \[sn_csm_pricing_price_list\] 데이터 유형: 문자열 | | 가격.가치 | 특정 목록 가격 값을 기준으로 결과를 필터링합니다. 데이터 유형: 문자열 | | priceList.id | 지정된 sys_id의 가격 목록만 반환하도록 결과를 필터링합니다. 테이블: 가격 목록 \[sn_csm_pricing_price_list\] 데이터 유형: 문자열 | | 가격 유형 | 제품 오퍼링의 가격 책정 방법을 기준으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다. * 반복: 기업이 지정된 빈도로 반복되는 가격 책정 금액을 청구할 수 있습니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료를 지원합니다. 데이터 유형: 문자열 | | productOffering.아이디 | 제품 오퍼링의 sys_id 기준으로 가격 목록 라인을 필터링합니다. 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 데이터 유형: 문자열 | | unitOfMeasure입니다.아이디 | 측정 단위의 sys_id 기준으로 가격 목록 라인을 필터링합니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | validFor입니다.종료 날짜/시간 | 지정된 종료 날짜 및 시간을 기준으로 가격 목록 라인을 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 지정된 시작 날짜 및 시간을 기준으로 가격 목록 라인을 필터링합니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | [표 50. 쿼리 매개변수] {#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c} {#tmf_prod_cat-GET-prodofferprice-id__entry__26} | 이름 | 설명 | |-|-| | 안 함 | | [표 51. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 {#tmf_prod_cat-GET-prodofferprice-id__section_ert_35w_22c} 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 52. 요청 헤더] {#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c} {#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 53. 응답 헤더] {#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodofferprice-id__entry__38}{#tmf_prod_cat-GET-prodofferprice-id__entry-200-status-code}{#tmf_prod_cat-GET-prodofferprice-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-prodofferprice-id__ul_qkg_2rv_22c} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 54. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-href}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-isBundle}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lastUpdate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.value}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.startDate} | 이름 | 설명 | |-|-| | @type | 가격 목록 라인의 유형입니다. 항상 `ProductOfferingPrice` 값입니다. 데이터 유형: 문자열 | | href | 인스턴스의 가격 목록 라인 기록에 대한 URL입니다. 데이터 유형: 문자열 | | ID | 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 | | 마지막 업데이트 | 가격 목록 라인이 마지막으로 업데이트된 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | 가격 | 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "units": "String", "value": "String" } | | 가격.단위 | 가격의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 데이터 유형: 문자열 | | 가격.가치 | 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시) | | priceList | 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 가격 목록 \[sn_csm_pricing_price_list\] 테이블의 가격 목록 Sys_id입니다. 데이터 유형: 문자열 | | priceList.name | 가격 목록의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 항상 `priceList`의 값을 가집니다. 데이터 유형: 문자열 | | 가격 유형 | 이 가격 목록 라인과 연결된 제품 오퍼링의 가격 책정 방법입니다. 가능한 값: * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 의 recurringChargePeriodType 값은 충전의 빈도를 나타냅니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료입니다. 데이터 유형: 문자열 | | productOffering | 가격 목록 라인과 연결된 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 제품 오퍼링의 Sys_id입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 예를 들면 `PRDOF01024`입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.이름 | 제품 오퍼링의 이름입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 이 가격 목록 라인과 연결된 제품 오퍼링의 주기 또는 빈도입니다. `반복`으로 설정된 경우 priceType 빈도 유형을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. 가능한 값: * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.금액 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure.id | 측정 단위의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어 `연도` 또는 `번들`입니다. 데이터 유형: 문자열 | | 유효한대상 | 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | [ ] {#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c} ### cURL 요청 다음 예시에서는 제품 오퍼링 가격의 상세 정보를 ID가 dfb7ec60인 값으로 반환합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569" \ --request GET\ --user 'username':'password' 응답. { "id": "dfb7ec607f8f9e50f8994fa63c866569", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:46", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569", "validFor": { "startDateTime": "2026-05-28 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" } ## 제품 카탈로그 개방형 API - GET /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title11} 모든 제품 사양 기록을 검색합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productSpecification ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-prodspec__section_fcz_2t1_jsb} {#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 55. 경로 매개변수] {#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * 설명 * externalId * ID * internalId * 내부 버전 * 마지막 업데이트 * 이름 * productSpecCharacteristic * productSpecificationRelationship * 자원 사양 * 서비스 사양 * 유효한대상 * 버전 {#tmf_prod_cat-GET-prodspec__ul_n1h_htz_54b} 데이터 유형: 문자열 기본값: 모든 필드가 반환됩니다. | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 데이터 유형: 숫자 기본값: 0 | | 상태 | 상태별로 제품 사양을 필터링합니다. 지정된 상태의 제품 사양만 응답에 반환됩니다. 허용되는 값: * 보관됨 * 초안 * 게시 날짜: * 폐기됨 {#tmf_prod_cat-GET-prodspec__ul_ngb_qcb_ccc} 데이터 유형: 문자열 | [표 56. 쿼리 매개변수] {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 57. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodspec__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 58. 요청 헤더] {#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb__entry__2}{#tmf_prod_cat-GET-prodspec__content-range-row}{#tmf_prod_cat-GET-prodspec__content-type-row}{#tmf_prod_cat-GET-prodspec__links-pagination-row}{#tmf_prod_cat-GET-prodspec__x-total-count-descr} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예를 들어, `offset=2` 및 `limit=3`인 경우 헤더의 Content-Range 값은 `항목 3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#tmf_prod_cat-GET-prodspec__ul_zzk_sdm_lsb} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. | [표 59. 응답 헤더] {#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodspec__table_xss_rcm_lsb__entry__2}{#tmf_prod_cat-GET-prodspec__tmf-get-status-200-p}{#tmf_prod_cat-GET-prodspec__tmf-get-status-206-entry}{#tmf_prod_cat-GET-prodspec__tmf-get-status-400-entry}{#tmf_prod_cat-GET-prodspec__tmf-get-status-404-entry} | 상태 코드 | 설명 | |-|-| | 200 | 요청이 성공적으로 처리되었습니다. 응답에서 전체 자원이 반환되었습니다(페이지 매김 없음). | | 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-prodspec__ul_rys_1gy_fsb} | | 404 | 기록 없음 쿼리 매개변수와 일치하는 기록을 테이블에서 찾을 수 없습니다. | [표 60. 상태 코드] {#tmf_prod_cat-GET-prodspec__table_xss_rcm_lsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-GET-prodspec__section_ymb_ccb_jsb} {#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb__entry__2}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_compatibilityRelationshipType-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_id-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_internalId-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_internalVersion-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_name-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelDefault-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelLowerLimit-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelUpperLimit-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_type-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_endDateTime-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_version-entry} | 이름 | 설명 | |-|-| | 설명 | 사양에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 사양의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 사양의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_id 필드에 있습니다. | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | externalSystem | `TMF620`이 추가된 제품 사양의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | ID | 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 external_id 필드 | | internalId | 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | is번들 | 단일 제품 또는 제품 번들을 나타내는지 여부를 productSpecification 나타내는 플래그입니다. 가능한 값: * true: 제품 사양이 제품 번들이며 여러 제품을 포함합니다. * 아니오: 제품 사양에 단일 제품이 포함되어 있습니다. 데이터 유형: 부울 | | 마지막 업데이트 | 사양이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 | | 수명주기상태 | 제품 사양의 현재 수명주기 상태입니다. 가능한 값: * 활성 * 비활성 * 초안 데이터 유형: 문자열 | | 이름 | 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 제품 사양 특성. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형(예: 선택 또는 이메일)입니다. 복합 또는 비복합 형식일 수 있습니다. 데이터 유형: 문자열 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 {#tmf_prod_cat-GET-prodspec__ul_khq_trk_tfc} | | productSpecificationRelationship | 이 사양과 다른 제품 사양의 관계입니다. 데이터 유형: 객체 배열 "productSpecificationRelationship": [ { "compatibilityRelationshipType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "prodSpecRelationshipOption": {Object}, "type": "String", "validFor": {Object}, "version": "String" ] | | productSpecificationRelationship입니다.compatibilityRelationshipType | 제품 사양의 호환성 관계 유형 예상 값입니다. 호환성 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Configuring compatibility rules for horizontal relationships](https://www.servicenow.com/docs/access?context=order-mgt-compatibility-management&version=australia&pubname=australia-order-management&ft:locale=en-US). 표: 호환 가능 \[sn_compt_mgmt_compatibles\] | | productSpecificationRelationship.id | 관련 사양의 Sys_id입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.internalId | 제품 사양 관계의 Sys_id(내부 ID)입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.내부 버전 | 제품 사양 관계의 버전입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.이름 | 제품 사양 관계의 이름입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption | 제품 사양 관계의 카디널리티입니다. 데이터 유형: 객체 "prodSpecRelationshipOption": { "numberSpecRelDefault": "String", "numberSpecRelLowerLimit": "String", "numberSpecRelUpperLimit": "String" } | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelDefault | 제품 사양의 기본값입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelLowerLimit | 구매할 수 있는 최소 주문 수입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelUpperLimit | 구매할 수 있는 최대 주문 수입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.형 | 제품 사양 관계의 유형입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 제품 사양 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.버전 | 제품 사양 관계의 버전입니다. 데이터 유형: 문자열 | | 자원 사양 | 이 제품 사양과 관련된 자원 사양의 목록입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 자원 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 상태 | 제품 사양의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [ ] {#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb} ### cURL 요청 이 예에서는 처음 두 개의 제품 사양 기록을 조회합니다. curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification?limit=2" \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문: [ { "id": "0435b48a742e4a10f877468e695efa3c", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/0435b48a742e4a10f877468e695efa3c", "externalSystem": "Salesforce-TMF620", "name": "Managed PoS PS", "displayName": "Managed PoS PS", "version": "", "internalVersion": "1", "internalId": "0435b48a742e4a10f877468e695efa3c", "description": "Managed PoS PS", "lastUpdate": "2032-09-26 20:07:12", "lifecycleStatus": "Active", "isBundle": false, "validFor": { "startDateTime": "2032-09-26", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "4", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "2", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "1", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true } ], "name": "Number of POS Terminals", "description": "Number of POS Terminals", "valueType": "choice", "validFor": { "startDatetime": "2024-05-31 21:43:14" } }, { "productSpecCharacteristicValue": [ { "value": "Gold", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "Bronze", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "Silver", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true } ], "name": "Managed Service Level", "description": "Managed Service Level", "valueType": "choice", "validFor": { "startDatetime": "2024-05-31 21:15:24" } } ], "status": "published" }, { "id": "1a0936f840102610f87798b149fd435d", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/1a0936f840102610f87798b149fd435d", "name": "Wi-Fi Configuration Setup Service PS", "displayName": "Wi-Fi Configuration Setup Service PS", "version": "", "internalVersion": "1", "internalId": "1a0936f840102610f87798b149fd435d", "description": "Wi-Fi Configuration Setup Service PS", "lastUpdate": "2025-03-13 21:01:14", "lifecycleStatus": "Active", "isBundle": false, "validFor": { "startDateTime": "2025-03-12", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [], "resourceSpecification": [], "productSpecCharacteristic": [], "status": "published" } ] ## 제품 카탈로그 오픈 API - GET /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title12} 지정된 제품 사양 기록을 조회합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-GET-prodspec-id__section_jjg_dr1_jsb} {#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 제품 사양의 Sys_id 또는 초기 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 initial_version 필드 | [표 61. 경로 매개변수] {#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb__entry__2} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * 설명 * externalId * ID * internalId * 내부 버전 * 마지막 업데이트 * 이름 * productSpecCharacteristic * productSpecificationRelationship * 자원 사양 * 서비스 사양 * 유효한대상 * 버전 {#tmf_prod_cat-GET-prodspec-id__ul_n1h_htz_54b} 데이터 유형: 문자열 기본값: 모든 필드가 반환됩니다. | | 상태 | 상태별로 제품 사양을 필터링합니다. 지정된 상태의 제품 사양만 응답에 반환됩니다. 허용되는 값: * 보관됨 * 초안 * 게시 날짜: * 폐기됨 {#tmf_prod_cat-GET-prodspec-id__ul_ngb_qcb_ccc} 데이터 유형: 문자열 | [표 62. 쿼리 매개변수] {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 63. 요청 본문 매개변수] {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodspec-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 64. 요청 헤더] {#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 65. 응답 헤더] {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-GET-prodspec-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-prodspec-id__entry-200-status-code}{#tmf_prod_cat-GET-prodspec-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_cat-GET-prodspec-id__ul_rys_1gy_fsb} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 66. 상태 코드] {#tmf_prod_cat-GET-prodspec-id__table_nxj_ykz_gsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-GET-prodspec-id__section_ymb_ccb_jsb} {#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb__entry__2}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_compatibilityRelationshipType-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_id-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_internalId-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_internalVersion-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_name-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelDefault-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelLowerLimit-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelUpperLimit-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_type-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_endDateTime-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_version-entry} | 이름 | 설명 | |-|-| | 설명 | 사양에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 사양의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 사양의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_id 필드에 있습니다. | | externalSystem | `TMF620`이 추가된 제품 사양의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 external_id 필드 | | internalId | 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | is번들 | 단일 제품 또는 제품 번들을 나타내는지 여부를 productSpecification 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 제품 사양이 제품 번들이며 여러 제품을 포함합니다. * 아니오: 제품 사양에 단일 제품이 포함되어 있습니다. {#tmf_prod_cat-GET-prodspec-id__ul_rry_rz4_4bc} 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 사양이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 | | 수명주기상태 | 제품 사양의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 제품 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 제품 사양 특성입니다. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형입니다. 선택 항목 또는 이메일과 같은 복잡하거나 복잡하지 않은 유형일 수 있습니다. 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 {#tmf_prod_cat-GET-prodspec-id__ul_khq_trk_tfc} 데이터 유형: 문자열 | | productSpecificationRelationship | 이 사양과 다른 제품 사양의 관계입니다. 데이터 유형: 객체 배열 "productSpecificationRelationship": [ { "compatibilityRelationshipType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "prodSpecRelationshipOption": {Object}, "type": "String", "validFor": {Object}, "version": "String" ] | | productSpecificationRelationship입니다.compatibilityRelationshipType | 제품 사양의 호환성 관계 유형 예상 값입니다. 호환성 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Configuring compatibility rules for horizontal relationships](https://www.servicenow.com/docs/access?context=order-mgt-compatibility-management&version=australia&pubname=australia-order-management&ft:locale=en-US). 표: 호환 가능 \[sn_compt_mgmt_compatibles\] | | productSpecificationRelationship.id | 관련 사양의 Sys_id입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.internalId | 제품 사양 관계의 Sys_id(내부 ID)입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.내부 버전 | 제품 사양 관계의 버전입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.이름 | 제품 사양 관계의 이름입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption | 제품 사양 관계의 카디널리티입니다. 데이터 유형: 객체 "prodSpecRelationshipOption": { "numberSpecRelDefault": "String", "numberSpecRelLowerLimit": "String", "numberSpecRelUpperLimit": "String" } | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelDefault | 제품 사양의 기본값입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelLowerLimit | 구매할 수 있는 최소 주문 수입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.prodSpecRelationshipOption을 사용합니다.numberSpecRelUpperLimit | 구매할 수 있는 최대 주문 수입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.형 | 제품 사양 관계의 유형입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 제품 사양 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.버전 | 제품 사양 관계의 버전입니다. 데이터 유형: 문자열 | | 자원 사양 | 이 제품 사양과 관련된 자원 사양의 목록입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 자원 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 상태 | 제품 사양의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜입니다. 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜입니다. 데이터 유형: 문자열 | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [ ] {#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb} 이 예에서는 지정된 제품 사양 기록을 조회합니다. curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6" \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문: { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/497a39a7c3d312105acc9e62b540dd14",, "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v4", "version": "", "internalVersion": "4", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2029-04-15 20:05:37", "lifecycleStatus": "Active", "isBundle": true, "validFor": { "startDateTime": "2033-04-15", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2030-09-25", "endDateTime": "2035-10-27" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2030-09-27", "endDateTime": "2035-10-27" } }, { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "2", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2029-04-03", "endDateTime": "" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "0.01", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "0.25", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "0.5", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "1", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "4 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "4 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "99.50", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.99", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.00", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.75", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "5 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "1 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "500 Mbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "Yes", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "No", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-12-13 02:29:08" } }, { "productSpecCharacteristicValue": [ { "value": "Yes", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "No", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-12-13 02:30:39" } } ], "status": "published" } ## 제품 카탈로그 개방형 API - 패치 /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title13} 지정된 제품 오퍼링을 업데이트합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id} ### 지원되는 요청 매개변수 {#tmf_prod_cat-PATCH-prodOffering-id__entry__2} | 이름 | 설명 | |-|-| | ID | 업데이트할 제품 오퍼링의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | [표 67. 경로 매개변수] {#tmf_prod_cat-PATCH-prodOffering-id__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 68. 쿼리 매개변수] {#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb__entry__2}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-displayName-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-isBundle-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-isSellable-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-status-entry} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] 테이블: 범주 \[sc_category\] | | category.id | 매개변수를 사용하는 경우 필수입니다 category . 범주의 ID입니다. 데이터 유형: 문자열 테이블: 범주 \[sc_category\] | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 채널 | 필수 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.설명 | 채널에 대한 설명입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | channel.id | 필수 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 설명 | 필수 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | displayName | 제품 오퍼링의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 오퍼링의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, external_id 필드 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 또는 external_id 필드 | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS 기본값: 빈 문자열 | | 수명주기상태 | 제품 오퍼링의 현재 수명주기 상태입니다. 가능한 값: * 활성 * 비활성 * 초안 데이터 유형: 문자열 | | 이름 | 필수 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse.name | 필수 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-PATCH-prodOffering-id__ul_fhv_2jw_xfc} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 제품 특성.값 | 특성의 값입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-PATCH-prodOffering-id__ul_jpt_fjw_xfc} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice.price | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | product오퍼링가격.가격.세금포함금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | product오퍼링가격.가격.세금포함금액.단위 | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | productOfferingPrice.price.taxIncludedAmount.value | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | productOfferingPrice.priceType | 제품 오퍼링 유형의 유형입니다. 매개변수를 사용하는 경우 필수입니다 productOfferingPrice . 유효한 값은 다음과 같습니다. * 비반복(일회성) * 반복 {#tmf_prod_cat-PATCH-prodOffering-id__ul_g3z_bcj_4bc} 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링에 유효한 계약 기간입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 제품 사양 | 필수 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecification.id | 필수 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양의 sys_id 또는 external_id 필드 \[sn_prd_pm_product_specification\] | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.이름 | 제품 사양의 이름입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 이름 필드 | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 상태 | 제품 오퍼링의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 필수 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 필수 제품 오퍼링의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | validFor.startDateTime | 필수 제품 오퍼링의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [표 69. 요청 본문 매개변수] {#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-PATCH-prodOffering-id__section_cjr_vbj_4bc} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-PATCH-prodOffering-id__entry__162}{#tmf_prod_cat-PATCH-prodOffering-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-PATCH-prodOffering-id__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 70. 요청 헤더] {#tmf_prod_cat-PATCH-prodOffering-id__entry__168}{#tmf_prod_cat-PATCH-prodOffering-id__d3014e217} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 71. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-PATCH-prodOffering-id__entry__172}{#tmf_prod_cat-PATCH-prodOffering-id__entry-200-status-code}{#tmf_prod_cat-PATCH-prodOffering-id__entry-400-status-code}{#tmf_prod_cat-PATCH-prodOffering-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 72. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc__entry__2}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e285}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e298}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e311}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e322}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e333}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e387}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e400}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e425}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e438}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e451}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e464}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e477}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e505}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e518}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e529}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e542}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e619}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e642}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e692}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e705}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e730}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e746}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e767}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e789}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e802}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e815}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e829}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e842}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e855}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e918}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e936}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e949}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e972}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e995}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1010}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1022}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1163} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] | | category.id | 범주의 ID입니다. 데이터 유형: 문자열 | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 | | 채널 | 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.설명 | 채널에 대한 설명입니다. 데이터 유형: 문자열 | | channel.id | 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 | | 설명 | 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 오퍼링의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 제품 오퍼링의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, external_id 필드 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 또는 external_id 필드 | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 | | liftcycle상태 | 현재 수명주기 상태입니다. 허용되는 값: * 활성 * 초안 * 비활성 {#tmf_prod_cat-PATCH-prodOffering-id__ul_lj5_gg4_4bc} 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-PATCH-prodOffering-id__d3125e862} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productCharacteristic입니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-PATCH-prodOffering-id__d3125e1029} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice를 사용합니다.값 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice를 사용합니다.값.세금 포함 금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice를 사용합니다.값.taxIncludedAmount.unit | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.값.taxIncludedAmount입니다.값 | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.priceType | 제품 오퍼링 가격 유형, 일회성 또는 반복 지불입니다. 가능한 값: * 비반복(일회성) * 반복 {#tmf_prod_cat-PATCH-prodOffering-id__ul_cts_ybj_4bc} 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링에 유효한 계약 기간입니다. 데이터 유형: 문자열 | | 제품 사양 | 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "status": "String", "sys_id": "String", "version": "String" } | | productSpecification입니다.아이디 | 제품 사양 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.상태 | 제품 사양의 상태(예: 게시됨 또는 초안)입니다. 데이터 유형: 문자열 | | productSpecification입니다.sys_id | 제품 사양의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 상태 | 제품 오퍼링의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 제품 오퍼링의 종료 날짜입니다. 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 제품 오퍼링의 시작 날짜입니다. 데이터 유형: 문자열 | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [ ] {#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc} 다음 예제에서는 요청 본문에 제공된 정보를 사용하여 sys_id 313b917843235210a82ed6085bb8f2c7로 제품 오퍼링을 업데이트합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7" \ --request PATCH\ --header "Accept:application/json" \ --user 'username':'password' --data '{ "id": "313b917843235210a82ed6085bb8f2c7", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "externalSystem": "Salesforce-TMF620", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" }' 응답 본문: { "id": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7", "externalSystem": "Salesforce-TMF620" "name": "Internet", "displayName": "Internet", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } }, { "id": "0f61dd9fd0a63110f8770dbf976be16c", "name": "Solana TV shows streaming channel", "version": "1", "externalId": "EXT-456", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "name": "Internet", "version": "1", "externalId": "EXT-678", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "3" } }, { "id": "313b917843235210a82ed6085bb8f2c7", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "1161a4f8436b1210a82ed6085bb8f216", "name": "Internet", "version": "1", "externalId": "EXT-910", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Advance (50 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ## 제품 카탈로그 개방형 API - PATCH /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title14} 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 테이블의 지정된 sys_id으로 가격 목록 라인 기록을 업데이트합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### 지원되는 요청 매개변수 {#tmf_prod_order-PATCH-prodoffprce-id__entry__2} | 이름 | 설명 | |-|-| | ID | 필수 검색할 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | [표 73. 경로 매개변수] {#tmf_prod_order-PATCH-prodoffprce-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 74. 쿼리 매개변수] {#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c__entry__2} | 이름 | 설명 | |-|-| | @type | 필수 가격 목록 라인의 유형입니다. 항상 `ProductOfferingPrice` 값입니다. 데이터 유형: 문자열 | | externalId | 가격 목록 라인의 외부 ID입니다. 데이터 유형: 문자열 | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 필수 가격 라인이 마지막으로 업데이트된 날짜입니다. 형식: YYYY-MM-DD 데이터 유형: 문자열 | | 수명주기상태 | 필수 제품 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 기본값: 초안 | | 이름 | 필수 가격 목록 라인을 지정하는 이름입니다. 데이터 유형: 문자열 | | 가격 | 필수 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "unit": "String", "value": "String" } | | 가격.단위 | 필수 가격 목록 라인의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 테이블입니다. 데이터 유형: 문자열 | | 가격.가치 | 필수 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시됨. 예: `"800"`.) | | priceList | 필수 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 필수 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | priceList.name | 가격 목록 라인의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록 라인의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 값은 항상 `priceList`입니다. 데이터 유형: 문자열 | | 가격 유형 | 필수 제품 오퍼링의 가격 책정 방법을 기준으로 가격 목록 라인을 필터링합니다. 유효한 값은 다음과 같습니다. * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 빈도는 매개변수에 설정되어 있습니다.recurringChargePeriodType * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료를 지원합니다. 데이터 유형: 문자열 기본값: 반복 | | productOffering | 필수 가격 목록 라인의 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.아이디 | 필수 제품 오퍼링의 Sys_id입니다. 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 데이터 유형: 문자열(숫자로 표시됨. 예를 들어 `"1"`입니다.) | | productOffering.이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 반복되는 경우 priceType 필요합니다. 제품 오퍼링이 생성될 때 선택된 약정 기간입니다. 유효한 값은 다음과 같습니다. * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 필수 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure입니다.분량 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure입니다.아이디 | 필수 가격 라인 목록 테이블의 측정 단위 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어, `each` 또는 `번들`입니다. 데이터 유형: 문자열 | | 유효한대상 | 필수 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.endDateTime | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열(glide_date) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDateTime | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열(glide_date) | [표 75. 요청 본문 매개변수(XML 또는 JSON)] {#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c} ### 헤더 {#tmf_prod_order-PATCH-prodoffprce-id__section_q1h_tvw_22c} 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 76. 요청 헤더] {#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c} {#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 77. 응답 헤더] {#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c} ### 상태 코드 {#tmf_prod_order-PATCH-prodoffprce-id__section_t1h_tvw_22c} 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__entry-200-status-code}{#tmf_prod_order-PATCH-prodoffprce-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_order-PATCH-prodoffprce-id__ul_qkg_2rv_22c} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 78. 상태 코드] {#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_order-PATCH-prodoffprce-id__section_q3r_rvw_22c} {#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c__entry__2} | 이름 | 설명 | |-|-| | ID | 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | href | 인스턴스의 가격 목록 라인 기록에 대한 URL입니다. 데이터 유형: 문자열 | | 마지막 업데이트 | 가격 목록 라인이 마지막으로 업데이트된 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 유효한대상 | 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | productOffering | 가격 목록 라인과 연결된 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 제품 오퍼링의 Sys_id입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 예를 들면 `PRDOF01024`입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.이름 | 제품 오퍼링의 이름입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | 가격 유형 | 이 가격 목록 라인과 연결된 제품 오퍼링의 가격 책정 방법입니다. 가능한 값: * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 의 recurringChargePeriodType 값은 충전의 빈도를 나타냅니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료입니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 이 가격 목록 라인과 연결된 제품 오퍼링의 주기 또는 빈도입니다. `반복`으로 설정된 경우 priceType 빈도 유형을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. 가능한 값: * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.금액 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure.id | 측정 단위의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어 `연도` 또는 `번들`입니다. 데이터 유형: 문자열 | | 가격 | 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "units": "String", "value": "String" } | | 가격.단위 | 가격의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 데이터 유형: 문자열 | | 가격.가치 | 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시) | | priceList | 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 가격 목록 \[sn_csm_pricing_price_list\] 테이블의 가격 목록 Sys_id입니다. 데이터 유형: 문자열 | | priceList.name | 가격 목록의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 항상 `priceList`의 값을 가집니다. 데이터 유형: 문자열 | | @type | 항상 `ProductOfferingPrice` 값입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 데이터 유형: 문자열 | | 상태 | 이 가격 목록 라인과 연결된 가격 목록의 상태입니다. 데이터 유형: 문자열 | | externalId | 이 가격 목록 라인의 외부 ID입니다. 데이터 유형: 문자열 | [ ] {#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c} ### cURL 요청 다음 예에서는 제품 오퍼링 가격이 ID가 3ddd0인 날짜를 업데이트합니다... 유효한 대상입니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \ --request patch\ --user 'username':'password' --data { "validFor": { "endDateTime": "2024-06-25 15:15:58" } } 응답 본문: { "validFor": { "endDateTime": "2024-06-25 15:15:58" }, "id": "994d5d364f8b5210f899f61d20ce0b7c", "name": "new Price list", "lastUpdate": "2025-01-16 00:15:32", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c", "lifecycleStatus": "Draft" } ## 제품 카탈로그 개방형 API - 패치 /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title15} 지정된 제품 사양을 업데이트합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id} ### 지원되는 요청 매개변수 {#tmf_prod_order-PATCH-productSpec-id__entry__2} | 이름 | 설명 | |-|-| | ID | 업데이트할 제품 오퍼링의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] | [표 79. 경로 매개변수] {#tmf_prod_order-PATCH-productSpec-id__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 80. 쿼리 매개변수] {#tmf_prod_order-PATCH-productSpec-id__entry__10} | 이름 | 설명 | |-|-| | 설명 | 필수 사양에 대한 설명입니다. 데이터 유형: 문자열 | | externalId | 필수 제품 사양의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_id 필드에 있습니다. | | ID | 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 external_id 필드 | | internalId | 필수 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | is번들 | 단일 제품 또는 제품 번들을 나타내는지 여부를 productSpecification 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 제품 사양이 제품 번들이며 여러 제품을 포함합니다. * 아니오: 제품 사양에 단일 제품이 포함되어 있습니다. {#tmf_prod_order-PATCH-productSpec-id__ul_rry_rz4_4bc} 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 사양이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 필수 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 사양 특성입니다. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.이름 | 필수 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.종료 날짜/시간 | 특성의 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형(예: 선택 또는 이메일)입니다. 복합 또는 비복합 형식일 수 있습니다. 데이터 유형: 문자열 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 {#tmf_prod_order-PATCH-productSpec-id__ul_khq_trk_tfc} 기본값: 빈 문자열 | | productSpecificationRelationship | 사양과 다른 제품 사양의 관계에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] | | productSpecificationRelationship입니다.아이디 | 관련 사양의 ID입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.형 | 매개변수를 사용하는 경우 필수입니다 productSpecificationRelationship . 관계의 유형입니다. 유효한 값은 다음과 같습니다. * 번들 * composed_of {#tmf_prod_order-PATCH-productSpec-id__ul_kjr_xnx_fsb} 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜입니다. 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | 자원 사양 | 필수 이 제품 사양과 관련된 자원 사양의 상세 정보입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 필수 자원 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 유효한대상 | 필수 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [표 81. 요청 본문 매개변수(JSON)] ### 헤더 {#tmf_prod_order-PATCH-productSpec-id__section_rbn_cdj_4bc} 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 82. 요청 헤더] {#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb} {#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 83. 응답 헤더] {#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_order-PATCH-productSpec-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 빈 페이로드입니다. * 잘못된 페이로드입니다. 필수 필드 누락됨: \<필드 이름\> {#tmf_prod_order-PATCH-productSpec-id__ul_rys_1gy_fsb} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 84. 상태 코드] {#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb} ### 응답 본문 매개변수 {#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc__entry__2} | 이름 | 설명 | |-|-| | 설명 | 사양에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 external_id 필드 | | internalId | 필수 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | 마지막 업데이트 | 사양이 마지막으로 업데이트된 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 데이터 유형: 문자열 | | 이름 | 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 사양의 특성입니다. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.종료 날짜/시간 | 특성의 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD 00:00:00. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD 00:00:00. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형(예: 선택 또는 이메일)입니다. 복합 또는 비복합 형식일 수 있습니다. 데이터 유형: 문자열 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 | | productSpecificationRelationship | 이 사양과 다른 제품 사양의 관계입니다. 데이터 유형: 객체 배열 "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] | | productSpecificationRelationship입니다.아이디 | 관련 사양의 Sys_id입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.형 | 관계의 유형입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜 및 유형입니다. 형식: YYYY-MM-DD 데이터 유형: 문자열 | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜 및 유형입니다. 형식: YYYY-MM-DD 데이터 유형: 문자열 | | 자원 사양 | 이 제품 사양과 관련된 자원 사양의 목록입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 자원 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 유효한대상 | 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:SS. 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:SS. 데이터 유형: 문자열 | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [ ] {#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc} 다음 예제에서는 제품 사양 ID d6f8d9995b020210235d85cced81c7eb를 요청 본문에 제공된 정보로 업데이트합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/d6f8d9995b020210235d85cced81c7eb" \ --request PATCH\ --header "Accept:application/json" \ --user 'username':'password' --data '{ "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' 응답 본문: { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' ## 제품 카탈로그 개방형 API - POST /sn_tmf_api/catalogmanagement/catalog {#ariaid-title16} 제품 오퍼링 카탈로그를 생성합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/catalog ### 지원되는 요청 매개변수 {#tmf_prod_cat-POST-catalog__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 85. 경로 매개변수] {#tmf_prod_cat-POST-catalog__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 86. 쿼리 매개변수] {#tmf_prod_cat-POST-catalog__entry__10} | 이름 | 설명 | |-|-| | 설명 | 제품 오퍼링 카탈로그에 대한 설명입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | externalId | 외부 시스템의 제품 오퍼링 카탈로그에 대한 고유 식별자입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 필수 제품 오퍼링 카탈로그의 이름입니다. 데이터 유형: 문자열 | [표 87. 요청 본문 매개변수(JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-catalog__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-POST-catalog__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 88. 요청 헤더] {#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb} {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | [표 89. 응답 헤더] {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb__entry__2} | 상태 코드 | 설명 | |-|-| | 201 | 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 다음과 같은 이유 중 하나일 수 있습니다. * 빈 페이로드입니다. * 잘못된 페이로드입니다. 필수 필드 누락됨: \<필드 이름\> {#tmf_prod_cat-POST-catalog__ul_nc5_myx_fsb} | [표 90. 상태 코드] {#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb} ### 응답 본문 매개변수(JSON) {#tmf_prod_cat-POST-catalog__entry__34} | 이름 | 설명 | |-|-| | 설명 | 제품 오퍼링 카탈로그에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 제품 오퍼링 카탈로그의 Sys_id 데이터 유형: 문자열 테이블: 제품 오퍼링 카탈로그 \[sn_prd_pm_product_offering_catalog\] | | 이름 | 제품 오퍼링 카탈로그의 이름입니다. 데이터 유형: 문자열 | [ ] ### cURL 요청 이 예에서는 제품 오퍼링 카탈로그를 만듭니다. curl --location --request POST "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \ --header "Content-Type: application/json" \ --data-raw '{ "id": "testId", "name": "Catalog", "description": "Description" }' --user 'username':'password' 응답 본문: { "id": "45715d02c3510110bc0526083c40dd6b", "description": "Description", "name": "Catalog1" } ## 제품 카탈로그 개방형 API - POST /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title17} 제품 오퍼링 및 관련 제품 오퍼링 번들을 생성합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOffering ### 지원되는 요청 매개변수 {#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 91. 경로 매개변수] {#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb} {#tmf_prod_cat-POST-prodoffering__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 92. 쿼리 매개변수] {#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb__entry__2}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-displayName-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-isBundle-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-isSellable-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_valueType-entry} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] | | category.id | 매개변수를 사용하는 경우 필수입니다 category . 범주의 ID입니다. 데이터 유형: 문자열 테이블: 범주 \[sc_category\] | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 테이블: 범주 \[sc_category\] | | 채널 | 필수 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.설명 | 채널에 대한 설명입니다. 데이터 유형: 문자열 | | channel.id | 필수 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 | | 설명 | 필수 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | displayName | 제품 오퍼링의 표시 이름입니다. 데이터 유형: 문자열 | | externalId | 외부 시스템의 제품 오퍼링에 대한 고유 식별자입니다. 데이터 유형: 문자열 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 또는 external_id 필드. | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | 수명주기상태 | 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 {#tmf_prod_cat-POST-prodoffering__ul_lj5_gg4_4bc} 데이터 유형: 문자열 | | 이름 | 필수 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-POST-prodoffering__ul_fhv_2jw_xfc} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 제품 특성.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-POST-prodoffering__ul_jpt_fjw_xfc} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice.price | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | product오퍼링가격.가격.세금포함금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | product오퍼링가격.가격.세금포함금액.단위 | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 형식: ISO 4217 | | productOfferingPrice.price.taxIncludedAmount.value | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 | | productOfferingPrice.priceType | 매개변수를 사용하는 경우 필수입니다 productOfferingPrice . 제품 오퍼링 가격 유형, 일회성 또는 반복 지불입니다. 유효한 값은 다음과 같습니다. * 비반복(일회성) * 반복 {#tmf_prod_cat-POST-prodoffering__ul_gdl_4ty_1hc} 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링의 유효한 계약 기간입니다(예: 12개월, 24개월 또는 not_applicable). 데이터 유형: 문자열 | | 제품 사양 | 필수 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name" "version": "String" } | | productSpecification.id | 필수 제품 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 또는 externa_id 필드 | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.이름 | 제품 사양의 이름입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 이름 필드 | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 유효한대상 | 필수 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 제품 오퍼링의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | validFor.startDateTime | 제품 오퍼링의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [표 93. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-prodoffering__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-POST-prodoffering__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 94. 요청 헤더] {#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-POST-prodoffering__d3014e217} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 95. 응답 헤더] {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb__entry__2} | 상태 코드 | 설명 | |-|-| | 201 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 빈 페이로드입니다. * 잘못된 페이로드입니다. 필수 필드 누락됨: \<필드 이름\> {#tmf_prod_cat-POST-prodoffering__ul_nc5_myx_fsb} | [표 96. 상태 코드] {#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb} ### 응답 본문 매개변수 {#tmf_prod_cat-POST-prodoffering__entry__178}{#tmf_prod_cat-POST-prodoffering__d3125e285}{#tmf_prod_cat-POST-prodoffering__d3125e298}{#tmf_prod_cat-POST-prodoffering__d3125e311}{#tmf_prod_cat-POST-prodoffering__d3125e322}{#tmf_prod_cat-POST-prodoffering__d3125e333}{#tmf_prod_cat-POST-prodoffering__d3125e387}{#tmf_prod_cat-POST-prodoffering__d3125e400}{#tmf_prod_cat-POST-prodoffering__d3125e411}{#tmf_prod_cat-POST-prodoffering__d3125e425}{#tmf_prod_cat-POST-prodoffering__d3125e438}{#tmf_prod_cat-POST-prodoffering__d3125e451}{#tmf_prod_cat-POST-prodoffering__d3125e464}{#tmf_prod_cat-POST-prodoffering__d3125e477}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-POST-prodoffering__d3125e505}{#tmf_prod_cat-POST-prodoffering__d3125e518}{#tmf_prod_cat-POST-prodoffering__d3125e529}{#tmf_prod_cat-POST-prodoffering__d3125e619}{#tmf_prod_cat-POST-prodoffering__d3125e642}{#tmf_prod_cat-POST-prodoffering__d3125e692}{#tmf_prod_cat-POST-prodoffering__d3125e705}{#tmf_prod_cat-POST-prodoffering__d3125e716}{#tmf_prod_cat-POST-prodoffering__d3125e730}{#tmf_prod_cat-POST-prodoffering__d3125e746}{#tmf_prod_cat-POST-prodoffering__d3125e767}{#tmf_prod_cat-POST-prodoffering__d3125e789}{#tmf_prod_cat-POST-prodoffering__d3125e802}{#tmf_prod_cat-POST-prodoffering__d3125e815}{#tmf_prod_cat-POST-prodoffering__d3125e829}{#tmf_prod_cat-POST-prodoffering__d3125e842}{#tmf_prod_cat-POST-prodoffering__d3125e855}{#tmf_prod_cat-POST-prodoffering__d3125e918}{#tmf_prod_cat-POST-prodoffering__d3125e936}{#tmf_prod_cat-POST-prodoffering__d3125e949}{#tmf_prod_cat-POST-prodoffering__d3125e972}{#tmf_prod_cat-POST-prodoffering__d3125e995}{#tmf_prod_cat-POST-prodoffering__d3125e1010}{#tmf_prod_cat-POST-prodoffering__d3125e1022}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-status-entry} | 이름 | 설명 | |-|-| | 번들그룹제품오퍼링 | 제품 오퍼링의 하위 그룹입니다. 이는 계층적 하위 그룹화를 보여줍니다. 데이터 유형: 객체 배열 "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 관련 제품 오퍼링 수의 하한과 상한을 지정하는 숫자 범위입니다. 데이터 유형: 객체 "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 하한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.bundledGroupProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 제품 오퍼링의 상한입니다. 데이터 유형: 문자열 | | bundledGroupProductOffering입니다.번들제품오퍼링 | 번들과 연결된 제품 오퍼링의 하위 그룹입니다. 아래에 지정된 것과 bundledProductOffering 동일한 형식입니다. 데이터 유형: 객체 배열 | | bundledGroupProductOffering입니다.아이디 | 번들 그룹 기록의 Sys_id입니다. 상위 제품, 오퍼링 또는 그룹에 여러 그룹이 포함된 경우에 유용합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 관계 그룹 \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering입니다.이름 | 하위 제품 오퍼링 그룹의 이름입니다. 데이터 유형: 문자열 | | 번들제품오퍼링 | 제품 오퍼링 번들에 포함된 제품 오퍼링 목록입니다. 제품 오퍼링 번들은 포함된 제품 오퍼링의 모든 속성을 상속합니다. 데이터 유형: 객체 배열 "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering입니다.번들 제품 오퍼링 옵션 | 기본 제품 오퍼링 수, 상위 및 하위 제품 오퍼링 구매 제약 조건과 같은 제품 번들 옵션입니다. 데이터 유형: 객체 "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferDefault | 관련 번들 제품 오퍼링의 일부로 구매해야 하는 기본 제품 오퍼링 수입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferLowerLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 하한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.bundledProductOfferingOption입니다.numberRelOfferUpperLimit | 관련 번들 제품 오퍼링의 일부로 구매할 수 있는 연결된 제품 오퍼링 수의 상한입니다. 데이터 유형: 문자열 가능한 값: 0 - 언바운드. | | bundledProductOffering입니다.외부 ID | 제품 오퍼링 관계의 외부 ID입니다. 제품 오퍼링 관계에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 문자열 | | bundledProductOffering입니다.href | 연결된 제품 오퍼링에 대한 상대 링크입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.아이디 | 번들 제품 오퍼링의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링\[sn_prd_pm_product_offering\] | | bundledProductOffering입니다.이름 | 제품 오퍼링 번들의 이름입니다. 데이터 유형: 문자열 | | bundledProductOffering입니다.버전 | 제품 오퍼링의 카탈로그 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 범주 | 제품이 속한 범주 목록입니다. 데이터 유형: 객체 배열 "category:" [ { "id": "String", "name": "String" } ] | | category.id | 범주의 ID입니다. 데이터 유형: 문자열 | | category.name | 범주의 이름입니다. 데이터 유형: 문자열 | | 채널 | 제품 오퍼링 판매에 사용할 채널입니다. 데이터 유형: 객체 배열 "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | 채널.묘사 | 채널에 대한 설명입니다. 데이터 유형: 문자열 | | channel.id | 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 유통 채널 \[sn_prd_pm_distribution_channel\] | | channel.name | 채널의 이름입니다. 데이터 유형: 문자열 | | 설명 | 제품 오퍼링에 대한 설명입니다. 데이터 유형: 문자열 | | externalId | 제품 오퍼링의 외부 ID입니다. 여러 버전이 게시된 경우 그 중 가장 높은 게시된 버전을 반환합니다. 게시된 버전이 없으면 상태에 관계없이 가장 높은 버전을 반환합니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, external_id 필드 | | externalSystem | `TMF620`이 추가된 제품 오퍼링의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 필수 제품 오퍼링의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 또는 external_id 필드 | | internalId | 제품 오퍼링 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블, initial_version 필드 | | 내부 버전 | 제품 오퍼링의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | is번들 | 제품 오퍼링이 번들인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 제품 오퍼링이 번들입니다. * false: 단일 제품 오퍼링입니다. 데이터 유형: 부울 기본값: false | | isSellable | 연결된 제품 오퍼링이 자체적으로 판매될 수 있는지 또는 제품 오퍼링 번들의 일부여야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 별도로 판매할 수 있습니다. * false: 번들의 일부로만 판매됩니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 제품 오퍼링이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 | | 수명주기상태 | 제품 오퍼링의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse | 제품 오퍼링 특성입니다. 데이터 유형: 객체 배열 "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse를 사용합니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | prodSpecCharValueUse를 사용합니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse를 사용합니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse를 사용합니다.값 유형 | 매개변수의 prodSpecCharValueUse.productSpecCharacteristicValue.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-POST-prodoffering__d3125e862} 데이터 유형: 문자열 | | 제품 특성 | 제품 특성 목록입니다. 데이터 유형: 객체 배열 "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productCharacteristic입니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic | 제품 오퍼링의 특징적인 품질 또는 고유한 기능입니다. 특성은 모바일 계획 순위와 같이 디자인 타임(카탈로그 제작)에 고정되는 불연속 값을 가질 수 있습니다. 이러한 특성은 일반적으로 인벤토리 수준에서 수정할 수 없습니다. 제품 오퍼링 특성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US). 데이터 유형: 객체 배열 productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic.characteristicValueSpecification | 제품 오퍼링 특성과 연결된 특성 값 목록입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.기본값 | 연결된 특성 값이 연결된 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.isMandatory | 연결된 특성 값이 연결된 특성에 필수인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수입니다. * false: 필수가 아닙니다. 데이터 유형: 부울 기본값: false | | productOfferingCharacteristic.characteristicValueSpecification을 사용합니다.값 | 연결된 제품 사양 특성에 할당된 번호 또는 텍스트입니다. 예: "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] 데이터 유형: 문자열 | | productOfferingCharacteristic.이름 | 연결된 제품 오퍼링 특성의 이름입니다. 데이터 유형: 문자열 | | productOfferingCharacteristic.값 유형 | 매개변수의 productOfferingCharacteristic.characteristicValueSpecification.value 데이터 형식입니다. 가능한 값: * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line 테스트 * 확인란 * 선택 * 날짜, 주소 * 이메일 * 정수, 날짜/시간 * 객체 * 1줄 텍스트 * 예/아니요 {#tmf_prod_cat-POST-prodoffering__d3125e1029} 데이터 유형: 문자열 | | productOfferingPrice | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 배열 "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice를 사용합니다.값 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice를 사용합니다.값.세금 포함 금액 | 제품 오퍼링에 대한 가격 정보입니다. 데이터 유형: 객체 "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice를 사용합니다.값.taxIncludedAmount.unit | 제품 오퍼링 가격의 통화 코드입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.값.taxIncludedAmount입니다.값 | 세금이 포함된 제품 오퍼링의 가격입니다. 데이터 유형: 문자열 | | productOfferingPrice를 사용합니다.priceType | 제품 오퍼링 가격 유형, 일회성 또는 반복 지불입니다. 가능한 값: * 비반복(일회성) * 반복 {#tmf_prod_cat-POST-prodoffering__ul_lwl_pty_1hc} 데이터 유형: 문자열 | | productOfferingTerm | 제품 오퍼링에 유효한 계약 기간입니다. 데이터 유형: 문자열 | | 제품 사양 | 제품의 제품 사양입니다. 데이터 유형: 객체 "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecification입니다.아이디 | 제품 사양 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.internalId | 제품 사양 기록의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 initial_version 필드 | | productSpecification입니다.내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 버전 필드 | | productSpecification입니다.버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | | 상태 | 제품 오퍼링의 상태입니다. 가능한 값: * 초안 * 게시됨 데이터 유형: 문자열 | | 유효한대상 | 제품 오퍼링이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 제품 오퍼링의 종료 날짜입니다. 데이터 유형: 문자열 | | validFor입니다.시작 날짜/시간 | 제품 오퍼링의 시작 날짜입니다. 데이터 유형: 문자열 | | 버전 | 제품 오퍼링의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블의 external_version 필드 | [ ] 이 예에서는 제품 오퍼링을 만듭니다. curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \ --header "Content-Type: application/json" \ --header "Accept:application/json" \ --data-raw '{ "id": "313b917843235210a82ed6085bb8f2c7",, "externalSystem": "Salesforce-TMF620", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-345", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" }' --user 'username':'password' 응답 본문: { "id": "313b917843235210a82ed6085bb8f2c7", "name": "Internet bundle", "externalSystem": "Salesforce-TMF620", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-345", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft", "externalId": "313b917843235210a82ed6085bb8f2c7", "internalId": "03c99cb53bf066509b48d69a04e45a11", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11" } ## 제품 카탈로그 개방형 API - POST /sn_tmf_api/catalogmanagement/productOfferingPrice {#ariaid-title18} 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 테이블에 새 가격 목록 라인 기록을 생성합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice ### 지원되는 요청 매개변수 {#tmf_prod_order-POST-prodofferprice__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 97. 경로 매개변수] {#tmf_prod_order-POST-prodofferprice__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 98. 쿼리 매개변수] {#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c__entry__2} | 이름 | 설명 | |-|-| | @type | 필수 가격 목록 라인의 유형입니다. 항상 `ProductOfferingPrice` 값입니다. 데이터 유형: 문자열 | | externalId | 가격 목록 라인의 외부 ID입니다. 데이터 유형: 문자열 | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 필수 가격 라인이 마지막으로 업데이트된 날짜입니다. 형식: YYYY-MM-DD 데이터 유형: 문자열 | | 수명주기상태 | 필수 제품 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 기본값: 초안 | | 이름 | 필수 가격 목록 라인을 지정하는 이름입니다. 데이터 유형: 문자열 | | 가격 | 필수 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "unit": "String", "value": "String" } | | 가격.단위 | 필수 가격 목록 라인의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 테이블입니다. 데이터 유형: 문자열 | | 가격.가치 | 필수 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시됨. 예: `"800"`.) | | priceList | 필수 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 필수 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | priceList.name | 가격 목록 라인의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록 라인의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 값은 항상 `priceList`입니다. 데이터 유형: 문자열 | | 가격 유형 | 필수 제품 오퍼링의 가격 책정 방법을 기준으로 가격 목록 라인을 필터링합니다. 유효한 값은 다음과 같습니다. * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 빈도는 매개변수에 설정되어 있습니다.recurringChargePeriodType * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료를 지원합니다. 데이터 유형: 문자열 기본값: 반복 | | productOffering | 필수 가격 목록 라인의 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.아이디 | 필수 제품 오퍼링의 Sys_id입니다. 테이블: 제품 오퍼링 \[sn_prd_pm_product_offering\] 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 데이터 유형: 문자열(숫자로 표시됨. 예를 들어 `"1"`입니다.) | | productOffering.이름 | 제품 오퍼링의 이름입니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 반복되는 경우 priceType 필요합니다. 제품 오퍼링이 생성될 때 선택된 약정 기간입니다. 유효한 값은 다음과 같습니다. * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 필수 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure입니다.분량 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure입니다.아이디 | 필수 가격 라인 목록 테이블의 측정 단위 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어, `each` 또는 `번들`입니다. 데이터 유형: 문자열 | | 유효한대상 | 필수 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.endDateTime | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열(glide_date) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDateTime | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열(glide_date) | [표 99. 요청 본문 매개변수(XML 또는 JSON)] {#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-POST-prodofferprice__entry__68}{#tmf_prod_order-POST-prodofferprice__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 100. 요청 헤더] {#tmf_prod_order-POST-prodofferprice__entry__72} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 101. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c__entry__2}{#tmf_prod_order-POST-prodofferprice__entry-200-status-code}{#tmf_prod_order-POST-prodofferprice__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#tmf_prod_order-POST-prodofferprice__ul_qkg_2rv_22c} | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 102. 상태 코드] {#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c} ### 응답 본문 매개변수(JSON 또는 XML) {#tmf_prod_order-POST-prodofferprice__entry__84} | 이름 | 설명 | |-|-| | ID | 가격 목록 라인의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | href | 인스턴스의 가격 목록 라인 기록에 대한 URL입니다. 데이터 유형: 문자열 | | 마지막 업데이트 | 가격 목록 라인이 마지막으로 업데이트된 날짜 및 시간입니다. 형식: YYYY-MM-DD HH:mm:ss 데이터 유형: 문자열 | | 유효한대상 | 가격 목록 라인이 유효한 기간입니다. 데이터 유형: 객체 "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 가격 목록 라인이 유효한 종료 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | validFor.startDate | 가격 목록 라인이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열(glide_date_time) | | is번들 | 가격 목록 라인이 단일 제품의 일부인지 제품 번들의 일부인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 가격 목록 라인이 번들의 일부입니다. * false: 가격 목록 라인이 번들의 일부가 아닙니다. 데이터 유형: 부울 | | 수명주기상태 | 가격 목록 라인의 현재 수명주기 상태입니다. 유효한 값은 다음과 같습니다. * 활성 * 초안 * 비활성 데이터 유형: 문자열 | | productOffering | 가격 목록 라인과 연결된 제품 오퍼링입니다. 데이터 유형: 객체 "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 제품 오퍼링의 Sys_id입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.내부 버전 | 제품 오퍼링의 내부 버전 번호입니다. 예를 들면 `PRDOF01024`입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | productOffering.이름 | 제품 오퍼링의 이름입니다. 제품 오퍼링 \[sn_prd_pm_product_offering\] 테이블에 있습니다. 데이터 유형: 문자열 | | 가격 유형 | 이 가격 목록 라인과 연결된 제품 오퍼링의 가격 책정 방법입니다. 가능한 값: * 반복: 지정된 빈도로 반복되는 가격 책정 금액을 청구합니다. 의 recurringChargePeriodType 값은 충전의 빈도를 나타냅니다. * one_time: 제품 오퍼링에 대한 일회성 또는 반복 추가 과금 및 수수료입니다. 데이터 유형: 문자열 | | recurringChargePeriodType | 이 가격 목록 라인과 연결된 제품 오퍼링의 주기 또는 빈도입니다. `반복`으로 설정된 경우 priceType 빈도 유형을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. 가능한 값: * 매년 * 월별 데이터 유형: 문자열 | | 측정 단위 | 가격 목록 라인과 연결된 측정 단위에 대한 상세 정보입니다. 데이터 유형: 객체 "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.금액 | 측정 단위의 금액입니다. 데이터 유형: 숫자 | | unitOfMeasure.id | 측정 단위의 Sys_id입니다. 테이블: 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 데이터 유형: 문자열 | | unitOfMeasure입니다.단위 | 가격 목록 라인과 연결된 측정 단위의 유형입니다. 예를 들어 `연도` 또는 `번들`입니다. 데이터 유형: 문자열 | | 가격 | 가격 목록 라인의 목록 가격 상세 정보입니다. 데이터 유형: 객체 "price": { "units": "String", "value": "String" } | | 가격.단위 | 가격의 통화 코드입니다. 예: `USD` 또는 `EUR.` 테이블: 통화 \[fx_currency\] 데이터 유형: 문자열 | | 가격.가치 | 가격의 값입니다. 데이터 유형: 문자열(숫자로 표시) | | priceList | 가격 목록 라인과 연결된 가격 목록 정보입니다. 데이터 유형: 객체 "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 가격 목록 \[sn_csm_pricing_price_list\] 테이블의 가격 목록 Sys_id입니다. 데이터 유형: 문자열 | | priceList.name | 가격 목록의 이름입니다. 데이터 유형: 문자열 | | priceList.@type | 가격 목록의 유형입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 항상 `priceList`의 값을 가집니다. 데이터 유형: 문자열 | | @type | 항상 `ProductOfferingPrice` 값입니다. 하위 클래스화 시 하위 클래스 확장 가능한 이름을 정의합니다. 데이터 유형: 문자열 | | 상태 | 이 가격 목록 라인과 연결된 가격 목록의 상태입니다. 데이터 유형: 문자열 | | externalId | 이 가격 목록 라인의 외부 ID입니다. 데이터 유형: 문자열 | [ ] ### cURL 요청 다음 예제에서는 요청 본문에 지정된 데이터에 따라 새 가격 목록 라인 기록을 만들고 가격 목록 라인 \[sn_csm_pricing_price_list_line\] 테이블에 삽입합니다. curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice " \ --request POST\ --user 'username':'password' --data { "name": "new Price list", "validFor": { "startDateTime": "2024-05-28 15:15:58", "endDateTime": "2025-06-28 15:15:58" }, "priceType": "recurring", "recurringChargePeriodType": "monthly", "lastUpdate": "2023-09-23 00:00:00", "isBundle": false, "lifecycleStatus": "Draft", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "unit": "USD", "value": "800" }, "productOffering": { "id": "9e3dd57a4fcb5210f899f61d20ce0bf2", "name": "Maintenance Fee", "internalVersion": "1" }, "priceList": { "name": "new price list", "@type": "priceList" }, "externalId": "test123", "@type": "ProductOfferingPrice" } 응답 본문. 이 새 가격 목록 라인 기록에는 고유 ID가 할당됩니다. 응답 본문은 응답 매개변수를 사용하여 새 기록에 대한 URL과 함께 이 정보를 반환합니다 href . { "name": "new Price list", "validFor": { "startDateTime": "2024-05-28 15:15:58", "endDateTime": "2025-06-28 15:15:58" }, "priceType": "recurring", "recurringChargePeriodType": "monthly", "lastUpdate": "2023-09-23 00:00:00", "isBundle": false, "lifecycleStatus": "Draft", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "unit": "USD", "value": "800" }, "productOffering": { "id": "9e3dd57a4fcb5210f899f61d20ce0bf2", "name": "Maintenance Fee", "internalVersion": "1" }, "priceList": { "id": "194d5d364f8b5210f899f61d20ce0b7a", "name": "new Price list", "@type": "priceList" }, "externalId": "test123", "@type": "ProductOfferingPrice", "id": "994d5d364f8b5210f899f61d20ce0b7c", "state": "draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" } ## 제품 카탈로그 개방형 API - POST /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title19} 지정된 값을 사용하여 제품 사양 기록을 작성합니다. ### URL 형식 기본 URL: /api/sn_tmf_api/catalogmanagement/productSpecification ### 지원되는 요청 매개변수 {#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 103. 경로 매개변수] {#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb} {#tmf_prod_cat-POST-prodspec__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 104. 쿼리 매개변수] {#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb__entry__2} | 이름 | 설명 | |-|-| | 설명 | 필수 사양에 대한 설명입니다. 데이터 유형: 문자열 | | externalId | 외부 시스템의 제품 사양에 대한 고유 식별자입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | externalSystem | `TMF620`이 추가된 제품 사양의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | ID | 필수 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 또는 external_id에 있습니다. | | internalId | 필수 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | 마지막 업데이트 | 사양이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | 이름 | 필수 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 사양 특성입니다. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | productSpecCharacteristic입니다.이름 | 필수 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 필수 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 필수 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.종료 날짜/시간 | 특성의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형(예: 선택 또는 이메일)입니다. 복합 또는 비복합 형식일 수 있습니다. 데이터 유형: 문자열 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 {#tmf_prod_cat-POST-prodspec__ul_qrv_rrk_tfc} 기본값: 빈 문자열 | | productSpecificationRelationship | 이 사양과 다른 제품 사양의 관계입니다. 데이터 유형: 배열 "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] | | productSpecificationRelationship입니다.아이디 | 관련 사양의 ID입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | productSpecificationRelationship입니다.형 | 매개변수를 사용하는 경우 필수입니다 productSpecificationRelationship . 관계의 유형입니다. 유효한 값은 다음과 같습니다. * 번들 * composed_of {#tmf_prod_cat-POST-prodspec__ul_kjr_xnx_fsb} 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | 자원 사양 | 필수 이 제품 사양과 관련된 자원 사양입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 필수 자원 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 유효한대상 | 필수 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS. 예: `2025-01-31 09:35:43`. 기본값: 빈 문자열 | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [표 105. 요청 본문 매개변수(JSON)] {#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-prodspec__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 106. 요청 헤더] {#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 107. 응답 헤더] {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb__entry__2} | 상태 코드 | 설명 | |-|-| | 201 | 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청. 가능한 이유: * 빈 페이로드입니다. * 잘못된 페이로드입니다. 필수 필드 누락됨: \<필드 이름\> {#tmf_prod_cat-POST-prodspec__ul_nc5_myx_fsb} | [표 108. 상태 코드] {#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb} ### 응답 본문 매개변수 {#tmf_prod_cat-POST-prodspec__entry__116} | 이름 | 설명 | |-|-| | 설명 | 사양에 대한 설명입니다. 데이터 유형: 문자열 | | externalSystem | `TMF620`이 추가된 제품 사양의 외부 시스템입니다. 예를 들어 외부 시스템이 ABC이면 값은 `ABC-TMF620`입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 기본값: 빈 문자열 | | ID | 제품 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 sys_id 또는 external_id 필드 | | internalId | 필수 제품 사양의 Sys_id 또는 내부 ID입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 initial_version 필드에 있습니다. | | 내부 버전 | 제품 사양의 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 버전 필드 | | is번들 | 단일 제품 또는 제품 번들을 나타내는지 여부를 productSpecification 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 제품 사양이 제품 번들이며 여러 제품을 포함합니다. * 아니오: 제품 사양에 단일 제품이 포함되어 있습니다. {#tmf_prod_cat-POST-prodspec__ul_rry_rz4_4bc} 데이터 유형: 부울 기본값: false | | 마지막 업데이트 | 사양이 마지막으로 업데이트된 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | 수명주기상태 | 제품 사양의 현재 수명주기 상태입니다. 가능한 값: * 활성 * 초안 * 비활성 {#tmf_prod_cat-POST-prodspec__ul_lj5_gg4_4bc} 데이터 유형: 문자열 기본값: 빈 문자열 | | 이름 | 사양의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic | 사양 특성입니다. 데이터 유형: 객체 배열 "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristic입니다.묘사 | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.이름 | 특성의 이름입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.productSpecCharacteristicValue | 특성의 가능한 값 목록입니다. 데이터 유형: 객체 배열 "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.기본값 | 연결된 특성 값이 특성의 기본값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 기본값. * false: 기본값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.isMandatory | 연결된 특성 값이 특성에 대한 필수 값인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 필수 값입니다. * false: 필수 값이 아닙니다. 기본값: false | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.유효한대상 | 특성이 유효한 날짜 및 시간입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String" } | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.validFor입니다.시작 날짜/시간 | 특성 값이 유효한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.productSpecCharacteristicValue를 사용합니다.값 | 특성의 값입니다. 데이터 유형: 문자열 | | productSpecCharacteristic입니다.유효한대상 | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristic입니다.validFor입니다.종료 날짜/시간 | 특성의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.validFor입니다.시작 날짜/시간 | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecCharacteristic입니다.값 유형 | 특성의 값 유형(예: 선택 또는 이메일)입니다. 복합 또는 비복합 형식일 수 있습니다. 데이터 유형: 문자열 허용되는 값: * 날짜, 주소 * 정수, 날짜/시간 * Array.Integer * Array.Single Line 테스트 * 단일 라인 테스트 * Array.Object * Array.Date * Array.Decimal * 예/아니요 * 객체 * Array.Datetime * 확인란 * 이메일 * 선택 {#tmf_prod_cat-POST-prodspec__ul_khq_trk_tfc} | | productSpecificationRelationship | 이 사양과 다른 제품 사양의 관계입니다. 데이터 유형: 객체 배열 "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] | | productSpecificationRelationship입니다.아이디 | 관련 사양의 Sys_id입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.형 | 관계의 유형입니다. 데이터 유형: 문자열 | | productSpecificationRelationship입니다.유효한대상 | 관계가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship입니다.validFor입니다.종료 날짜/시간 | 관계의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | productSpecificationRelationship입니다.validFor입니다.시작 날짜/시간 | 관계의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | 자원 사양 | 이 제품 사양과 관련된 자원 사양의 목록입니다. 데이터 유형: 객체 배열 "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification입니다.아이디 | 자원 사양의 Sys_id 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 sys_id 또는 external_id 필드 | | resourceSpecification입니다.internalId | 자원 사양 기록의 초기 버전(sys_id)입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 initial_version 필드 | | resourceSpecification입니다.내부 버전 | 자원 사양의 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 버전 필드 | | resourceSpecification입니다.이름 | 자원 사양의 이름입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] | | resourceSpecification입니다.버전 | 자원 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 자원 사양 \[sn_prd_pm_resource_specification\] 테이블의 external_version 필드에 있습니다. | | 서비스 사양 | 이 제품 사양과 관련된 서비스 사양 목록입니다. 데이터 유형: 객체 배열 "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecification을 사용합니다.아이디 | 서비스 사양의 초기 버전 또는 외부 ID입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 sys_id 또는 external_id 필드 | | serviceSpecification을 사용합니다.internalId | 서비스 사양의 초기 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 initial_version 필드 | | serviceSpecification을 사용합니다.내부 버전 | 서비스 사양의 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 버전 필드 | | serviceSpecification을 사용합니다.이름 | 서비스 사양의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] | | serviceSpecification을 사용합니다.버전 | 서비스 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 서비스 사양 \[sn_prd_pm_service_specification\] 테이블의 external_version 필드 | | 유효한대상 | 사양이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor입니다.종료 날짜/시간 | 사양의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | validFor입니다.시작 날짜/시간 | 사양의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:mm:SS | | 버전 | 제품 사양의 외부 버전입니다. 데이터 유형: 문자열 테이블: 제품 사양 \[sn_prd_pm_product_specification\] 테이블의 external_version 필드 | [ ] 이 예에서는 지정된 값을 사용하여 제품 사양 기록을 생성합니다. curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \ --header "Content-Type: application/json" \ --data-raw '{ "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' --user 'username':'password' 응답 본문. { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }'