청구 조정

파트너 관리자는 도매 청구 API를 사용하여 파트너별, 고객별 또는 사용자별 수준에서 사용량을 표시하는 사용자 지정 청구 보고서를 생성할 수 있습니다. 파트너는 이 정보를 사용하여 월별 청구서를 조정하고 사용량에 따라 고객과 사용자에게 청구할 수 있습니다.

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

최소 액세스 요구 사항을 충족하는 파트너 관리자가 사용할 수 있는 API는 4가지가 있습니다.

청구 API

API의 목적

파트너 관리자 액세스 요구 사항

도매 청구 보고서 만들기

청구 보고서를 생성하는 데 사용됩니다.

읽다 / 쓰다

도매 청구 보고서 받기

생성된 청구 보고서를 다운로드하는 데 사용됩니다.

읽음

도매 청구 보고서 목록

해당 파트너에 대한 청구 보고서를 나열하는 데 사용됩니다.

읽음

도매 청구 보고서 삭제

기존 청구 보고서를 삭제하는 데 사용됩니다.

읽다 / 쓰다

데이터 소스

청구 보고서의 데이터는 Webex가 각 파트너에 대해 추적하는 사용 소비 데이터에서 가져옵니다. Webex는 매일 모든 파트너, 고객 및 사용자의 전날 사용량을 추적하고 데이터를 집계하여 파트너의 월별 청구서를 생성하는 데 사용할 수 있습니다. 청구 API는 이러한 데이터를 활용하여 파트너 관리자가 사용자 정의 보고서를 생성할 수 있도록 하여 파트너, 고객 및 사용자 수준에서 월별 청구서에서 사용량을 조정할 수 있습니다.

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

도매 청구 보고서 만들기

이 절차를 사용하면 청구를 조정하는 데 사용할 수 있는 사용자 지정 청구 보고서를 생성할 수 있습니다.
1

도매 청구 보고서 API 만들기로 이동합니다.

2

API가 지정하는 형식으로 billingStartDate 및 billingEndDate 값을 입력하여 청구 기간을 입력합니다. 지난 5년 이내의 날짜를 입력할 수 있지만, 현재 날짜는 입력할 수 없습니다.

3

보고서의 유형 을 입력하세요:

  • PARTNER(기본값)—파트너 수준에서 사용량 소비량을 표시합니다.
  • 고객—파트너 산하의 고객 조직 수준별로 세분화된 총 사용량을 보여줍니다.
  • 사용자—파트너의 고객 조직 및 구독자 수준으로 세분화된 총 사용량을 보여줍니다.
4

실행 을 클릭하여 보고서를 생성하세요.

5

API 출력에서 보고서 id 를 복사합니다. Get API와 함께 이 값을 사용하면 생성된 청구 보고서를 얻을 수 있습니다.

다음에 수행할 작업

보고서 사본을 다운로드하려면 도매 청구 보고서 받기 로 이동하세요.

도매 청구 보고서 받기

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

도매 청구 보고서 API로 이동하세요.

2

GET 줄에서 id 버튼을 클릭하고 보고서의 고유 id 값을 입력합니다.

3

클릭 하십시오. 실행.

4

API는 보고서 상태를 출력합니다. 출력에는 보고서를 다운로드할 수 있는 URL을 제공하는 tempDownloadURL 매개변수가 포함됩니다.

5

보고서에 접근하고 다운로드하려면 tempDownloadURL 을 브라우저에 복사하세요.

도매 청구 보고서 목록

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

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

도매 청구 보고서 API 목록으로 이동

2

쿼리 매개변수아래에 사용하려는 검색 매개변수(예: 시작 날짜, 종료 날짜, 유형, 정렬 기준)를 입력합니다. 이러한 매개변수에 대한 자세한 내용은 API에 대한 개발자 도움말을 참조하세요.

3

클릭 하십시오. 실행.

API는 고유 보고서 id 및 상태(완료, 진행 중_)와 함께 보고서 목록을 출력합니다.

다음에 수행할 작업

다운로드하려는 보고서에 대한 id 를 기록해 두세요. 보고서를 다운로드하려면 도매 청구 보고서 받기 로 이동하세요.

도매 청구 보고서 삭제

보고서 ID를 기준으로 생성된 청구 보고서를 삭제하려면 다음 절차를 사용하세요. 보고서를 삭제해야 할 수 있는 몇 가지 예는 다음과 같습니다.

  • 기존 청구 보고서를 다시 생성하려면 먼저 기존 보고서를 삭제해야 합니다. 기존 보고서를 삭제한 후 해당 기간에 대한 새 보고서를 만들 수 있습니다. 보고서가 실패하거나 진행 중인 경우 삭제 요구 사항이 존재하지 않습니다.

  • 보고서가 생성되고 URL을 잘못된 사람에게 보내면 보고서를 삭제하면 해당 사람이 보고서에 액세스할 수 없게 됩니다.

1

도매 청구 보고서 삭제 API로 이동합니다.

2

보고서 ID를 입력하세요.

3

클릭 하십시오. 실행.

청구 보고서 필드

청구 보고서에는 다음 필드가 포함되어 있습니다.

필드

추가 정보

다음 유형의 보고서에 나타납니다.

파트너_이름

파트너 이름

파트너, 고객, 사용자

파트너_ORG_ID

고유 파트너 식별자

파트너, 고객, 사용자

구독_ID

고유 구독 식별자

파트너, 고객, 사용자

서비스_이름

서비스 이름

(예: COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

파트너, 고객, 사용자

SKU

서비스에 대한 SKU

파트너, 고객, 사용자

설명

서비스 설명

파트너, 고객, 사용자

소비_시작_날짜

서비스 소비 시작. 다음 필드와 함께 이 값은 사용 기간을 정의합니다.

파트너, 고객, 사용자

소비_종료_날짜

서비스 소비 종료. 이 값은 이전 필드와 함께 사용 소비 기간을 정의합니다.

파트너, 고객, 사용자

수량

파트너당, 고객당 또는 사용자당 집계된 사용자 사용량 소비량을 나타냅니다(보고서 및 데이터를 보는 수준에 따라 다름).

계산:

그들은 그날을 기준으로 각 사용자에 대한 일일 수량을 비례적으로 계산합니다.

하루 종일 사용 가능 = 1

반나절 사용 = 0.5

이들은 청구 기간 내의 모든 날짜에 대한 일일 총액을 합산하여 해당 청구 기간 내 해당 사용자의 총 수량을 계산합니다.

고객 및 파트너 수준 보고서의 경우 모든 사용자의 총액이 집계되어 해당 고객 또는 파트너의 총 수량이 제공됩니다.

파트너, 고객, 사용자

고객_조직_ID

내부 고객 고유 식별자

고객, 사용자

고객_외부_ID

파트너가 제공한 고객 고유 식별자

고객, 사용자

구독자_ID

구독자의 고유 식별자

사용자

USER_ID

가입자의 Webex 사용자 ID

사용자

작업공간_ID

고유 작업 공간 식별자

사용자

위치_ID

고유 위치 식별자

고객, 사용자

라이센스_ID

라이센스 식별자

이 필드는 도매 패키지에만 표시됩니다. 이 필드가 도입되기 전에 할당된 라이센스의 경우 License_ID는 비어 있습니다.

청구 보고서에는 동일한 도매 패키지에 대해 여러 행이 표시될 수 있으며 각 행은 고유한 것을 나타냅니다. package/license ID 조합.

LICENSE_ID 필드가 있는 경우 각 행은 고유한 것을 나타냅니다. package/location/license ID 조합.

고객, 사용자

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