피드백을 보내 주셔서 감사합니다.
피드백이 있습니까?결제 보고서
파트너는 다음 도매 결제 API를 사용하여 사용 및 프로비저닝의 정확성을 검증하는 데 도움이 되는 결제 보고서를 생성할 수 있어요. 도매 청구 API는 developer.webex.com을 통해 액세스할 수 있어요.
-
조정—파트너당, 고객당 또는 사용자당 사용 사용량을 표시합니다. 파트너는 이 사용자 지정 결제 보고서 정보를 사용하여 월별 청구서를 조정하여 사용량에 따라 고객과 사용자에게 청구할 수 있어요.
-
특정 시점—고객별 또는 사용자별 현재 패키지 할당량을 표시합니다. 특정 시점 보고서는 패키지 할당의 실시간 수를 제공해요. 파트너는 이 정보를 사용하여 프로비저닝의 정확성을 검증하고 고객 주문에 맞춰 조정할 수 있어요.
파트너는 subPartnerOrgID 파라미터를 사용하여 하위 파트너를 위한 사용자 지정 결제 보고서를 생성할 수도 있어요.
최소 접근 요건을 충족하는 파트너 관리자가 사용할 수 있는 API가 4개 있어요.
|
빌링 API |
API의 목적 |
파트너 관리자 접근 요구 사항 |
|---|---|---|
|
도매 청구 보고서 생성하세요. |
결제 보고서를 생성하는 데 사용돼요. |
읽기/쓰기 |
|
도매 청구 보고서 받기 |
생성된 결제 보고서를 다운로드용으로 가져오는 데 사용해요. |
읽었어요 |
|
도매 청구 보고서 목록 |
그 파트너의 결제 보고서를 나열하는 데 사용돼요. |
읽었어요 |
|
도매 청구 보고서 삭제해요 |
기존 결제 보고서 삭제하는 데 사용돼요. |
읽기/쓰기 |
데이터 소스
결제 보고서 데이터는 Webex가 각 파트너에 대해 추적하는 패키지 할당 및 사용 데이터에서 가져왔어요. 웹엑스는 매일 고객과 사용자 패키지 데이터를 집계하여 파트너의 월별 청구서를 생성해요. 결제 API가 이 데이터를 사용해서 파트너 관리자가 맞춤 보고서를 생성할 수 있어요. 이 보고서는 파트너가 파트너, 고객, 사용자 수준에서 월 청구서의 사용 소비를 조정하는 데 도움이 돼요.
Webex가 파트너에게 청구서를 청구하는 방법에 대한 자세한 내용은 서비스 제공업체 결제를 참조하십시오.
도매 결제 보고서 생성해요
| 1 |
개발자.webex.com에서, 도매 청구 보고서 생성 API로 가세요. |
| 2 |
다음 보고서 카테고리 중 하나를 선택해 주세요.
조정 보고서를 생성하려는 경우 아무것도 변경할 필요가 없어요. 기본적으로 조정이 선택되어 있어서 다음 단계로 진행하면 돼요. 특정 시점 보고서를 생성하려면 선택을 특정 시점으로 변경하세요. |
| 3 |
API가 지정하는 형식으로 청구 시작일과 청구 종료일을 입력하세요. 최근 5년의 날짜는 아무거나 입력할 수 있지만 오늘 날짜는 입력할 수 없어요. 특정 시점 보고서의 경우 청구 시작일과 청구 종료일 필드는 필수 사항이 아니며 입력하면 무시돼요. 보고서는 항상 현재 패키지 할당량을 반영해요. |
| 4 |
신고 유형을 입력하세요.
|
| 5 |
보고서에 표시하려는 추가 또는 선택 열을 포함 필드에 입력하세요. 각 보고서 유형에는 필수 속성 세트와 선택적 속성 세트가 있어요. 각 보고서에 표시할 선택적 속성을 결정할 수 있어요. 선택적 속성을 포함하지 않으면 보고서에는 필수 속성만 표시돼요. 다음 열은 고객 및 사용자 보고서에 포함하도록 요청할 수 있는 선택적 속성이에요.
보고서에 이러한 속성을 보려면 반드시 포함해야 CUSTOMER_GROUP_ID 하고 CUSTOMER_GROUP_NAME 함께 포함해야 해요. 선택적 열을 선택하면 고객 및 사용자 조정 보고서의 열 순서가 변경돼요. 파트너는 새로운 csv 형식을 받아들이려면 API 통합을 업데이트해야 해요. 특정 시점 보고서의 열 순서는 변하지 않아요. 현재는 열 순서를 결정할 때 기존 기능 설정이 Include 매개변수보다 우선해요. 예를 들어 고객에 대해 특정 기능 설정을 활성화하면 Include 매개변수에 추가해도 해당 기능 열이 이전 보고서 형식에 따라 표시돼요. 이 설정들은 곧 제거될 거예요. 일단 제거되면 Include 매개 변수를 통해서만 선택적 열을 요청할 수 있어요. |
| 6 |
보고서를 생성하려면 실행을 클릭해요. |
| 7 |
API 출력에서 보고서 ID를 복사해요. 이 값을 Get API와 함께 사용하여 생성된 결제 보고서를 가져올 수 있어요. |
다음에 뭘 해야 돼요?
도매 청구 보고서 받기 섹션으로 이동하여 보고서 사본을 다운로드하세요.
도매 청구 보고서 받아봐요
결제 보고서가 생성되면 이 API를 사용하여 구체적인 결제 보고서를 받아보세요. 보고서는 GET 요청 완료 후 30분 동안 다운로드할 수 있는 URL로 출력돼요.
| 1 |
개발자.webex.com에서, 도매 청구 보고서 받기 API로 가세요. |
| 2 |
보고서의 고유 ID 값을 입력하고 실행을 클릭해요. API가 보고서 상태를 출력해요. 출력에는 보고서를 다운로드할 수 있는 URL을 제공하는 tempDownloadURL 매개변수가 포함돼요. |
| 3 |
보고서에 액세스하고 다운로드하려면 임시 다운로드 URL을 브라우저에 복사하세요. |
도매 청구 보고서 목록
파트너 조직에 대해 생성된 결제 보고서 목록을 가져오려면 이 API를 사용하세요. 기존 보고서를 모두 나열하거나 청구 기간 및 청구 유형 (파트너, 고객, 사용자) 과 같은 지정된 매개변수를 충족하는 보고서로 목록을 제한할 수 있어요.
선택적 매개변수를 입력하면 API는 지정한 매개변수와 정확히 일치하는 보고서만 반환해요. 예를 들어 청구 기간을 지정하면 해당 청구 기간을 사용한 보고서만 반환돼요. 기간에 속하지만 날짜와 정확히 일치하지 않는 보고서는 반환되지 않아요.
| 1 |
개발자.webex.com에서, 리스트 도매 청구 보고서 API로 가세요. |
| 2 |
쿼리 매개변수에 사용하려는 검색 매개변수를 입력하세요 (예: 시작일, 종료일, 유형, 정렬 기준). |
| 3 |
실행 클릭. API가 고유한 보고서 ID 및 상태 (COMPLETED,IN_PROGRESS) 와 함께 보고서 목록을 출력해요.
|
다음에 뭘 해야 돼요?
다운로드하려는 보고서의 ID를 기록해 두세요. 보고서를 다운로드하려면 도매 청구 보고서 받기로 이동해요.
도매 청구 보고서 삭제해요
보고서 ID를 기반으로 생성된 결제 보고서를 삭제하려면 이 절차를 사용하세요. 보고서를 삭제하고 싶은 몇 가지 예는 다음과 같습니다.
-
기존 조정 청구 보고서를 다시 생성하려면 먼저 기존 보고서를 삭제해야 해요. 기존 보고서를 삭제한 후 해당 기간 동안 새 보고서를 만들 수 있어요. 보고서 생성이 실패했거나 아직 진행 중이면 보고서를 삭제할 수 없어요.
특정 시점 보고서의 경우 시스템에서 기존 보고서를 다시 생성하지 않으므로 삭제할 필요가 없어요. 각 보고서는 항상 현재 타임스탬프 기준의 데이터를 반영해요.
-
생성된 보고서 URL을 엉뚱한 사람에게 보내면 보고서를 삭제해서 그 사람이 접근하지 못하게 할 수 있어요.
| 1 |
개발자.webex.com에서, 도매 결제 보고서 삭제 API로 가세요. |
| 2 |
보고서 ID를 입력하고 실행을 클릭해요. |
결제 보고서 필드
결제 보고서에는 다음 필드가 포함돼요.
|
필드 |
설명 |
지원되는 보고서 유형이에요. |
지원되는 보고서 카테고리 |
필수 또는 선택적 속성 |
|---|---|---|---|---|
|
PARTNER_NAME |
파트너 이름 |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
PARTNER_ORG_ID |
고유 파트너 식별자 |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
SUBSCRIPTION_ID |
고유 구독 식별자예요 |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
CUSTOMER_GROUP_ID | 고객이 속한 그룹의 고유 식별자예요. 청구 기간 중에 고객이 그룹 간에 이동한 경우, 사용량은 그 기간 동안 고객이 속했던 그룹을 기준으로 분할돼요. |
CUSTOMER, USER |
조정, 특정 시점 |
선택사항이요 |
|
CUSTOMER_GROUP_NAME | 고객 그룹의 표시 이름이에요. 청구 기간 중에 그룹 이름이 변경되면 최신 이름이 사용돼요. |
CUSTOMER, USER |
조정, 특정 시점 |
선택사항이요 |
|
CUSTOMER_ORG_ID |
내부 고객 고유 식별자 |
CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
CUSTOMER_EXTERNAL_ID |
파트너가 제공한 고객 고유 식별자예요 |
CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
TYPE |
사용자 또는 작업 공간 유형이에요. |
CUSTOMER, USER |
포인트-인-타임이에요 |
필수예요 |
|
SUBSCRIBER_ID |
구독자 고유 식별자예요 |
USER |
조정, 특정 시점 |
필수예요 |
|
USER_ID |
구독자의 웹엑스 사용자 ID |
USER |
조정, 특정 시점 |
필수예요 |
|
WORKSPACE_ID |
고유 작업 공간 식별자예요 |
USER |
조정, 특정 시점 |
필수예요 |
|
SERVICE_NAME |
서비스 이름 (예:,COMMON_AREA_CALLING, WEBEX_CALLINGWEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
SKU |
서비스 SKU |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
DESCRIPTION |
서비스에 대한 설명이에요. |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
CONSUMPTION_START_DATE |
서비스 소비의 시작이에요. 다음 필드와 함께 이 값은 사용 기간을 정의해요. |
PARTNER, CUSTOMER, USER |
화해 |
필수예요 |
|
CONSUMPTION_END_DATE |
서비스 소비 끝났어요. 이전 필드와 함께 이 값은 사용 소비 기간을 정의해요. |
PARTNER, CUSTOMER, USER |
화해 |
필수예요 |
|
REPORT_DATE |
보고서 생성 날짜 및 시간이에요. |
CUSTOMER, USER |
포인트-인-타임이에요 |
필수예요 |
|
QUANTITY |
파트너당, 고객당 또는 사용자당 총 사용자 사용 소비를 나타냅니다 (데이터를 보는 보고서와 수준에 따라 다름). 계산: 시스템이 각 사용자의 하루 수량을 그 날에 비례 배분해서 계산해요. 종일 사용량 = 1 반나절 사용량 = 0.5 그런 다음 청구 기간 내 전체 날짜의 일일 총계를 합산하여 해당 청구 기간 내 해당 사용자의 총 수량을 계산해요. 고객 및 파트너 수준 보고서의 경우 모든 사용자의 총계를 집계하여 해당 고객 또는 파트너의 총 수량을 제공해요. 특정 시점: 고객 보고서에는 고객당 패키지 할당량이 나열돼요. 각 행은 특정 고객 조직 내 사용자 또는 작업공간에 할당된 특정 패키지의 총 수량을 나타냅니다. 할당된 패키지가 없으면 수량이 “0"으로 표시돼요. 사용자 보고서에는 사용자나 작업공간에 할당된 패키지가 나열돼요. 각 행에는 사용자 또는 작업 공간과 개별 패키지 또는 애드온을 나타내는 수량 1이 표시돼요. 사용자나 작업 공간에 패키지나 애드온이 여러 개 할당되면 보고서에 항목이 여러 개 표시되고 각 항목의 수량이 1개예요. |
PARTNER, CUSTOMER, USER |
조정, 특정 시점 |
필수예요 |
|
LOCATION_ID |
고유 위치 식별자 |
CUSTOMER, USER |
조정, 특정 시점 고객 특정 시점 보고서에는 위치 ID가 포함되지 않아요. |
선택사항이요 |
|
LICENSE_ID |
라이선스 식별자 이 필드는 도매 패키지에만 보여요. 조정 보고서의 경우, 이 필드 도입 전에 할당된 License_ID 라이선스는 공란으로 표시돼요. 결제 보고서에는 동일한 도매 패키지가 LOCATION_ID 및 의 다른 조합과 연결된 경우 해당 행이 여러 개 표시돼요LICENSE_ID. |
CUSTOMER, USER |
조정, 특정 시점 |
선택사항이요 |
선택적 열을 선택하면 고객 및 사용자 조정 보고서의 열 순서가 수정돼요. 다음 주문은 구독에 도매 SKU만 보유한 파트너에게 적용돼요.
사용자 레벨 보고서— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID, CUSTOMER_EXTERNAL_IDLOCATION_ID,LICENSE_ID,SUBSCRIBER_ID,USER_ID, WORKSPACE_IDSERVICE_NAME, SKU, 설명, CONSUMPTION_START_DATECONSUMPTION_END_DATE, 수량
고객 수준 보고서— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME, CUSTOMER_ORG_IDCUSTOMER_EXTERNAL_ID,LOCATION_ID, LICENSE_IDSERVICE_NAME, SKU, 설명, CONSUMPTION_START_DATECONSUMPTION_END_DATE, 수량
패키지를 사용자에게 제공하면 Webex Wholesale 청구가 트리거되고, 패키지 할당을 제거하면 청구가 중지돼요.
고객 조직은 한 번에 하나의 고객 그룹에만 속할 수 있어요. 조직당 여러 고객 그룹에 대한 지원은 현재 제공되지 않아요.
