도매 유통 경로 청구 보고서

청구 보고서

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

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

Cisco AI Assistant

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