도매 유통 경로 청구 보고서

청구 보고서

파트너는 다음 도매 청구 API를 사용하여 사용량 및 프로비저닝 정확성을 검증하는 데 도움이 되는 청구 보고서를 생성할 수 있습니다. 도매 결제 API는 developer.webex.com을 통해 이용할 수 있습니다.

정산 - 파트너별, 고객별 또는 사용자별 사용량을 표시합니다. 파트너는 이 맞춤형 청구 보고서 정보를 사용하여 월별 청구서를 대조하고 사용량에 따라 고객과 사용자에게 요금을 청구할 수 있습니다.
특정 시점 현황 - 고객별 또는 사용자별 현재 패키지 할당량을 표시합니다. 시점별 보고서는 패키지 할당량을 실시간으로 집계하여 제공합니다. 파트너는 이 정보를 사용하여 공급 정확성을 검증하고 고객 주문과의 일치 여부를 확인할 수 있습니다.

파트너는 subPartnerOrgId 매개변수를 사용하여 하위 파트너에 대한 맞춤형 청구 보고서를 생성할 수도 있습니다.

최소 접근 권한 요건을 충족하는 파트너 관리자는 네 가지 API를 이용할 수 있습니다.

청구 API	API의 목적	파트너 관리자 액세스 요구 사항
도매 청구 보고서 생성	청구 보고서를 생성하는 데 사용됩니다.	Read/write
도매 청구 보고서를 받으세요	생성된 청구 보고서를 다운로드하는 데 사용됩니다.	읽음
도매 청구 보고서 목록	해당 파트너에 대한 청구 보고서를 나열하는 데 사용됩니다.	읽음
도매 청구 보고서 삭제	기존 청구 보고서를 삭제하는 데 사용됩니다.	Read/write

데이터 소스

청구 보고서에 사용되는 데이터는 Webex가 각 파트너에 대해 추적하는 패키지 할당 및 사용량 데이터를 기반으로 추출됩니다. Webex는 고객 및 사용자 패키지 데이터를 매일 집계하여 파트너에게 월별 청구서를 생성합니다. 청구 API는 이 데이터를 사용하여 파트너 관리자가 맞춤형 보고서를 생성할 수 있도록 합니다. 이 보고서는 파트너가 파트너, 고객 및 사용자 수준에서 월별 청구서와 사용량 간의 차이를 확인하는 데 도움이 됩니다.

Webex가 파트너에게 청구서를 발행하는 방법에 대한 자세한 내용은 서비스 제공업체 청구를 참조하세요.

도매 청구 보고서를 생성하세요

1	developer.webex.com에서 도매 청구 보고서 API 생성으로 이동합니다.
2	다음 보고서 범주 중 하나를 선택하십시오. 조정(기본값) 특정 시점 조정 보고서를 생성하려면 기본적으로 조정이 선택되어 있으므로 아무것도 변경할 필요 없이 다음 단계로 진행할 수 있습니다. 특정 시점 보고서를 생성하려면 선택 항목을 '특정 시점'으로 변경하십시오.
3	API에서 지정한 형식으로 billingStartDate 및 billingEndDate 를 입력하십시오. 최근 5년 이내의 날짜는 입력할 수 있지만, 현재 날짜는 입력할 수 없습니다. 시점 보고서의 경우 billingStartDate 및 billingEndDate 필드는 필수가 아니며 입력하더라도 무시됩니다. 이 보고서는 항상 현재 패키지 할당 현황을 반영합니다.
4	보고서 유형 을 입력하세요: 파트너(기본값) - 파트너 수준의 사용량 또는 패키지 할당량을 표시합니다. 이 유형은 특정 시점 보고서에는 지원되지 않습니다. 고객—파트너 산하 고객 조직 수준까지 세분화된 사용량 또는 패키지 할당 내역을 보여줍니다. 사용자—파트너 산하 고객 조직 및 가입자 수준별 사용량 또는 패키지 할당량을 보여줍니다.
5	포함 필드에 보고서에 표시할 추가 또는 선택적 열을 입력합니다. 각 보고서 유형에는 필수 속성 세트와 선택적 속성 세트가 있습니다. 각 보고서에 표시할 선택적 속성을 선택할 수 있습니다. 선택적 속성을 포함하지 않으면 보고서에는 필수 속성만 표시됩니다. 다음 열은 고객 및 사용자 보고서에 포함하도록 요청할 수 있는 선택적 속성입니다. 고객_그룹_ID 고객_그룹_이름 위치_ID 라이선스_ID 보고서에 이러한 속성을 표시하려면 CUSTOMER_GROUP_ID와 CUSTOMER_GROUP_NAME을 함께 포함해야 합니다. 선택적 열을 선택하면 고객 및 사용자 조정 보고서의 열 순서가 변경됩니다. 파트너사는 새로운 CSV 형식을 지원하도록 API 통합을 업데이트해야 합니다. 시점별 보고서의 열 순서는 변경되지 않습니다. 현재 열 순서를 결정할 때 기존 기능 설정이 포함 매개변수보다 우선합니다. 예를 들어, 특정 기능 설정이 고객에게 활성화된 경우, 포함 매개변수에 해당 기능을 추가하더라도 이전 보고서 형식대로 해당 기능 열이 표시됩니다. 이 설정은 곧 제거될 예정입니다. 해당 열들이 제거되면, Include 매개변수를 통해서만 선택적 열을 요청할 수 있습니다.
6	실행 을 클릭하여 보고서를 생성하세요.
7	API 출력에서 보고서 ID 를 복사합니다. 이 값을 Get API와 함께 사용하여 생성된 청구 보고서를 가져올 수 있습니다.

다음에 수행할 작업

도매 청구 보고서 받기 섹션으로 이동하여 보고서 사본을 다운로드하십시오.

도매 청구 보고서를 받으세요

청구 보고서가 생성되면 이 API를 사용하여 특정 청구 보고서를 얻을 수 있습니다. 보고서는 GET 요청 완료 후 30분 동안 다운로드할 수 있는 URL로 출력됩니다.

1	developer.webex.com에서 도매 청구 보고서 API 가져오기로 이동합니다.
2	보고서에 대한 고유한 id 값을 입력하고 실행을 클릭합니다. API는 보고서 상태를 출력합니다. 출력에는 보고서를 다운로드할 수 있는 URL을 제공하는 tempDownloadURL 매개변수가 포함됩니다.
3	tempDownloadURL 을 브라우저에 복사하여 보고서에 접속하고 다운로드하세요.

도매 청구 보고서 목록

이 API를 사용하여 파트너 조직에 대해 생성된 청구 보고서 목록을 가져올 수 있습니다. 모든 기존 보고서를 나열하거나, 청구 기간 및 청구 유형(파트너, 고객, 사용자)과 같은 지정된 매개변수를 충족하는 보고서로 목록을 제한할 수 있습니다.

선택적 매개변수를 입력하면 API는 사용자가 지정한 매개변수와 정확히 일치하는 보고서만 반환합니다. 예를 들어, 청구 기간을 지정하면 해당 특정 청구 기간을 사용하는 보고서만 반환됩니다. 해당 기간 내에 제출되었지만 날짜가 정확히 일치하지 않는 보고서는 반환되지 않습니다.

1	developer.webex.com에서 도매 청구 보고서 API 목록으로 이동합니다.
2	쿼리 매개변수아래에 사용하려는 검색 매개변수(예: startDate, endDate, Type, sortBy on)를 입력합니다.
3	클릭 하십시오. 실행. API는 고유 한 보고서 ID 와 상태(COMPLETED, IN_PROGRESS)를 포함한 보고서 목록을 출력합니다.

다음에 수행할 작업

다운로드하려는 보고서의 id 를 기록해 두세요. 도매 청구 보고서 받기 로 이동하여 보고서를 다운로드하십시오.

도매 청구 보고서를 삭제합니다

이 절차를 사용하여 보고서 ID를 기준으로 생성된 청구 보고서를 삭제하십시오. 보고서를 삭제하고 싶을 수 있는 몇 가지 예는 다음과 같습니다.

기존 정산 청구 보고서를 다시 생성하려면 먼저 기존 보고서를 삭제해야 합니다. 기존 보고서를 삭제한 후 해당 기간에 대한 새 보고서를 만들 수 있습니다. 보고서 생성이 실패했거나 아직 진행 중인 경우에는 보고서를 삭제할 수 없습니다.

특정 시점 보고서의 경우 시스템에서 해당 보고서를 다시 생성하지 않으므로 기존 보고서를 삭제할 필요가 없습니다. 각 보고서는 항상 현재 시점의 데이터를 반영합니다.
생성된 보고서 URL을 잘못된 사람에게 보낸 경우, 해당 보고서를 삭제하여 그 사람이 접근할 수 없도록 할 수 있습니다.

1	developer.webex.com에서 도매 청구 보고서 API 삭제로 이동합니다.
2	보고서 ID 를 입력하고실행 을 클릭합니다.

청구 보고서 필드

청구 보고서에는 다음과 같은 항목이 포함됩니다.

필드	설명	지원되는 보고서 유형	지원되는 보고서 카테고리	필수 속성 또는 선택적 속성
파트너_이름	파트너 이름	파트너, 고객, 사용자	조정, 특정 시점	필수
파트너_조직_ID	고유 파트너 식별자	파트너, 고객, 사용자	조정, 특정 시점	필수
구독_ID	고유 구독 식별자	파트너, 고객, 사용자	조정, 특정 시점	필수
고객_그룹_ID	고객이 속한 그룹의 고유 식별자입니다. 고객이 청구 기간 중에 그룹 간에 이동하는 경우, 사용량은 해당 기간 동안 고객이 속했던 그룹을 기준으로 분할됩니다.	고객, 사용자	조정, 특정 시점	선택 사항
고객_그룹_이름	고객 그룹의 표시 이름입니다. 청구 기간 중에 그룹 이름이 변경된 경우, 최신 이름이 사용됩니다.	고객, 사용자	조정, 특정 시점	선택 사항
고객_조직_ID	내부 고객 고유 식별자	고객, 사용자	조정, 특정 시점	필수
고객_외부_ID	파트너가 제공한 고객 고유 식별자	고객, 사용자	조정, 특정 시점	필수
유형	사용자 또는 작업 공간 유형	고객, 사용자	특정 시점	필수
구독자_ID	가입자 고유 식별자	사용자	조정, 특정 시점	필수
USER_ID	구독자의 Webex 사용자 ID	사용자	조정, 특정 시점	필수
작업 공간_ID	고유 작업 공간 식별자	사용자	조정, 특정 시점	필수
서비스_이름	서비스명 (예: 공용_영역_통화 ,_Webex 통화_,_Webex 스위트, Webex 회의)	파트너, 고객, 사용자	조정, 특정 시점	필수
SKU	서비스용 SKU	파트너, 고객, 사용자	조정, 특정 시점	필수
설명	서비스 설명	파트너, 고객, 사용자	조정, 특정 시점	필수
소비_시작_날짜	서비스 이용 시작. 다음 필드와 함께 이 값은 사용 기간을 정의합니다.	파트너, 고객, 사용자	조정	필수
소비_종료_날짜	서비스 이용이 종료되었습니다. 이 값은 앞의 항목과 함께 사용 기간을 정의합니다.	파트너, 고객, 사용자	조정	필수
보고서_날짜	보고서가 생성된 날짜 및 시간.	고객, 사용자	특정 시점	필수
수량	파트너별, 고객별 또는 사용자별(보고서 및 데이터 보기 수준에 따라 다름) 집계된 사용자 사용량을 나타냅니다. 계산: 이 시스템은 각 사용자의 일일 사용량을 해당 일수를 기준으로 비례 배분하여 계산합니다. 하루 종일 사용량 = 1 반나절 사용량 = 0.5 그런 다음, 청구 기간 내 모든 날짜의 일별 합계를 계산하여 해당 사용자의 해당 청구 기간 내 총 사용량을 계산합니다. 고객 및 파트너 수준 보고서의 경우 모든 사용자의 합계가 집계되어 해당 고객 또는 파트너의 총 수량을 제공합니다. 특정 시점: 고객 보고서에는 고객별 패키지 할당 내역이 나와 있습니다. 각 행은 특정 고객 조직 내 사용자 또는 작업 공간에 할당된 특정 패키지의 총 수량을 나타냅니다. 할당된 패키지가 없으면 수량은 "0"으로 표시됩니다. 사용자 보고서에는 사용자 또는 작업 공간에 할당된 패키지 목록이 표시됩니다. 각 행은 수량 1을 나타내며, 이는 사용자 또는 작업 공간과 해당 개별 패키지 또는 추가 기능을 의미합니다. 사용자 또는 작업 공간에 여러 패키지 또는 추가 기능이 할당된 경우 보고서에는 수량이 각각 1인 여러 항목이 표시됩니다.	파트너, 고객, 사용자	조정, 특정 시점	필수
위치_ID	고유 위치 식별자	고객, 사용자	조정, 특정 시점 고객 시점별 보고서에는 위치 ID가 포함되지 않습니다.	선택 사항
라이선스_ID	라이선스 식별자 이 항목은 도매 패키지에만 표시됩니다. 조정 보고서의 경우, 이 필드가 도입되기 전에 할당된 라이선스의 경우 License_ID는 비어 있습니다. 청구 보고서에는 LOCATION_ID와 LICENSE_ID의 서로 다른 조합과 연결된 경우 동일한 도매 패키지에 대해 여러 행이 표시됩니다.	고객, 사용자	조정, 특정 시점	선택 사항

선택적 열을 선택하면 고객 및 사용자 조정 보고서의 열 순서가 변경됩니다. 다음 순서는 구독에 도매 SKU만 포함된 파트너에게 적용됩니다.

사용자 수준 보고서—파트너_이름 ,_파트너 조직_ID , 구독 ID, 고객_그룹_ID ,_고객_그룹 이름, 고객 조직 ID,_외부 고객_ID , 위치_ID , 라이선스_ID ,_가입자_ID ,_사용자_ID ,_작업 공간 ID,_서비스_이름_, SKU, 설명,_사용량_시작일 ,_사용량 종료일, 수량

고객 수준_보고서 —파트너_이름 ,_파트너 조직 ID,_구독 ID_,_고객 그룹 ID,_고객_그룹 이름,_고객 조직 ID,_외부_고객 ID, 위치 ID,_라이선스_ID ,_서비스 이름,_SKU , 설명,_사용량_시작일_, 사용량 종료일,_수량

사용자에게 패키지를 할당하면 Webex Wholesale에서 요금이 청구되고, 패키지 할당을 제거하면 요금 청구가 중지됩니다.

고객 조직은 특정 시점에 하나의 고객 그룹에만 속할 수 있습니다. 현재 조직당 여러 고객 그룹을 지원하는 기능은 제공되지 않습니다.

Cisco AI Assistant

피드백을 보내 주셔서 감사합니다.