Obrigado pelos seus comentários.
Relatórios de faturamento de rotas de atacado para o mercado
Comentários?Relatórios de faturamento
Os parceiros podem usar as seguintes APIs de faturamento por atacado para gerar relatórios de faturamento que os ajudam a validar o uso e a precisão do provisionamento. As APIs de faturamento por atacado podem ser acessadas através do developer.webex.com.
-
Conciliação — Exibe o consumo de uso por parceiro, por cliente ou por usuário. Os parceiros podem usar essas informações de relatório de faturamento personalizado para conciliar suas faturas mensais e, assim, cobrar de seus clientes e usuários de acordo com o consumo de uso.
-
Ponto no Tempo — Exibe as alocações de pacotes atuais por cliente ou por usuário. O relatório Point-In-Time fornece uma contagem em tempo real das alocações de pacotes. Os parceiros podem usar essas informações para validar a precisão do provisionamento e garantir o alinhamento com os pedidos dos clientes.
Os parceiros também podem gerar relatórios de faturamento personalizados para subparceiros usando o parâmetro subPartnerOrgId.
Existem quatro APIs disponíveis para administradores parceiros que atendam aos requisitos mínimos de acesso.
|
API de faturamento |
Finalidade da API |
Requisito de acesso administrativo de parceiros |
|---|---|---|
|
Criar um relatório de faturamento por atacado |
Utilizado para gerar um relatório de faturamento. |
Read/write |
|
Obtenha um relatório de faturamento por atacado. |
Utilizado para gerar um relatório de faturamento para download. |
Ler |
|
Lista de relatórios de faturamento por atacado |
Utilizado para listar os relatórios de faturamento existentes para esse parceiro. |
Ler |
|
Excluir um relatório de faturamento por atacado |
Utilizado para excluir um relatório de faturamento existente. |
Read/write |
Fonte de dados
Os dados para os relatórios de faturamento são extraídos das atribuições de pacotes e dos dados de uso que a Webex rastreia para cada parceiro. A Webex agrega diariamente os dados dos pacotes de clientes e usuários para gerar a fatura mensal do parceiro. As APIs de faturamento utilizam esses dados, permitindo que os administradores parceiros gerem relatórios personalizados. Esses relatórios ajudam os parceiros a conciliar o consumo de uso de sua fatura mensal nos níveis de parceiro, cliente e usuário.
Para obter informações mais detalhadas sobre como a Webex fatura os parceiros, consulte Faturamento do provedor de serviços.
Criar um relatório de faturamento de atacado
| 1 |
A partir de developer.webex.com, acesse Criar uma API de relatório de faturamento por atacado. |
| 2 |
Selecione uma das seguintes categorias de relatório:
Se você deseja gerar um relatório de reconciliação, não precisa alterar nada, pois a opção Reconciliação está selecionada por padrão. Portanto, você pode prosseguir para a próxima etapa. Se você deseja gerar um relatório de ponto específico no tempo, altere a seleção para "Ponto específico no tempo". |
| 3 |
Insira billingStartDate e billingEndDate no formato especificado pela API. Você pode inserir qualquer data dos últimos cinco anos, mas não o dia atual. Para o relatório Point-In-Time, os campos billingStartDate e billingEndDate não são obrigatórios e são ignorados se preenchidos. O relatório sempre reflete a alocação atual dos pacotes. |
| 4 |
Digite o tipo de relatório:
|
| 5 |
Clique em Executar para gerar o relatório. |
| 6 |
Copie o relatório id da saída da API. Você pode usar esse valor com a API Get para obter o relatório de faturamento gerado. |
O que fazer em seguida
Vá para a seção Obter um relatório de faturamento de atacado para baixar uma cópia do relatório.
Obtenha um relatório de faturamento no atacado.
Após a geração de um relatório de faturamento, utilize esta API para obter um relatório de faturamento específico. O relatório é gerado em um URL onde fica disponível para download por 30 minutos após a conclusão da solicitação GET.
| 1 |
A partir de developer.webex.com, acesse Obter uma API de relatório de faturamento por atacado. |
| 2 |
Insira o valor único id para o relatório e clique em Executar. A API gera relatórios de status. A saída inclui o parâmetro tempDownloadURL, que fornece um URL a partir do qual você pode baixar o relatório. |
| 3 |
Copie o tempDownloadURL para um navegador para acessar e baixar o relatório. |
Liste os relatórios de faturamento de atacado.
Utilize esta API para obter uma lista dos relatórios de faturamento gerados para a organização parceira. Você pode listar todos os relatórios existentes ou limitar a lista àqueles que atendem aos parâmetros especificados, como seu período de faturamento e tipo de faturamento (Parceiro, cliente, usuário).
Se você inserir parâmetros opcionais, a API retornará apenas os relatórios que corresponderem exatamente aos parâmetros especificados. Por exemplo, se você especificar um período de faturamento, somente os relatórios que utilizam esse período de faturamento específico serão retornados. Relatórios que se enquadram no período, mas que não correspondem exatamente às datas, não são retornados.
| 1 |
A partir de developer.webex.com, acesse List Wholesale Billing Report API. |
| 2 |
Em Parâmetros de consulta, insira quaisquer parâmetros de pesquisa que você queira usar (por exemplo, startDate, endDate, Type, sortBy on). |
| 3 |
Clique em Executar. A API gera a lista de relatórios juntamente com o id exclusivo do relatório e o status (CONCLUÍDO, EM ANDAMENTO_).
|
O que fazer em seguida
Anote o id de todos os relatórios que você deseja baixar. Acesse Obter um relatório de faturamento de atacado para baixar o relatório.
Excluir um relatório de faturamento de atacado
Utilize este procedimento para excluir um relatório de faturamento gerado com base no ID do relatório. Alguns exemplos de situações em que você pode querer excluir um relatório incluem:
-
Se você deseja gerar novamente um relatório de faturamento de reconciliação existente, primeiro precisa excluir o relatório existente. Após excluir o relatório existente, você pode criar um novo relatório para esse período. Não é possível excluir um relatório se a sua geração tiver falhado ou ainda estiver em andamento.
Para um relatório de ponto específico no tempo, não é necessário excluir um relatório existente, pois o sistema não regenera esses relatórios. Cada relatório sempre reflete os dados até o momento atual.
-
Se você enviar o URL de um relatório gerado para a pessoa errada, poderá excluir o relatório para que ela não tenha acesso a ele.
| 1 |
A partir de developer.webex.com, acesse Excluir API de relatório de faturamento de atacado. |
| 2 |
Insira o relatório Id e clique em Executar. |
Campos do relatório de faturamento
Os relatórios de faturamento contêm os seguintes campos:
|
Campo |
Descrição |
Tipo de relatório suportado |
Categoria de relatório suportada |
|---|---|---|---|
|
NOME DO PARCEIRO_ |
Nome do parceiro |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
PARCEIRO_ORG_ID |
Identificador único do parceiro |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
ASSINATURA_ID |
Identificador de assinatura exclusivo |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
SERVIÇO_NOME |
Nome do serviço _( ex: CHAMADAS DE ÁREA COMUM___CHAMADAS DE_... |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
SKU |
Código SKU do serviço |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
DESCRIÇÃO |
Descrição do serviço |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
CONSUMO_INÍCIO_DATA |
Início do consumo do serviço. Juntamente com o campo seguinte, este valor define o período de utilização. |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação |
|
CONSUMO_FIM_DATA |
Fim do consumo do serviço. Juntamente com o campo anterior, este valor define o período de consumo de utilização. |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação |
|
QUANTIDADE |
Representa o consumo agregado de uso por parceiro, por cliente ou por usuário (dependendo do relatório e do nível em que você está visualizando os dados). Cálculo: O sistema calcula a quantidade diária para cada usuário de forma proporcional para aquele dia. Uso durante um dia inteiro = 1 Utilização por meio dia = 0,5 Em seguida, soma os totais diários de todos os dias dentro do período de faturamento para calcular a quantidade total para aquele usuário dentro desse período de faturamento. Para relatórios de clientes e parceiros, os totais de todos os usuários são agregados para fornecer a quantidade total para esse cliente ou parceiro. Ponto no tempo: O relatório do cliente lista a alocação de pacotes por cliente. Cada linha representa a quantidade total de um pacote específico atribuído a usuários ou espaços de trabalho dentro de uma determinada organização do cliente. A quantidade mostra “0” se não houver pacotes alocados. O relatório do usuário lista os pacotes atribuídos a usuários ou espaços de trabalho. Cada linha mostra uma quantidade de 1, representando um usuário ou espaço de trabalho e seu pacote ou complemento individual. Se vários pacotes ou complementos forem alocados a um usuário ou espaço de trabalho, o relatório exibirá várias entradas, cada uma com uma quantidade de 1. |
PARCEIRO, CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
CLIENTE_ORG_ID |
Identificador exclusivo do cliente interno |
CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
CLIENTE_EXTERNO_ID |
Identificador único do cliente, conforme fornecido por um parceiro. |
CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
ID DO ASSINANTE_ |
Identificador único para o assinante |
USUÁRIO |
Reconciliação, Ponto no Tempo |
|
ID do usuário._ |
ID de usuário do Webex do assinante |
USUÁRIO |
Reconciliação, Ponto no Tempo |
|
ID DO ESPAÇO DE TRABALHO_ |
Identificador único do espaço de trabalho |
USUÁRIO |
Reconciliação, Ponto no Tempo |
|
LOCALIZAÇÃO_ID |
Identificador de localização único |
CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
LICENÇA_ID |
Identificador de licença Este campo só é visível para pacotes de atacado. Para o relatório de reconciliação, o ID License_está em branco para licenças atribuídas antes da introdução deste campo. O relatório de faturamento mostra várias linhas para o mesmo pacote de atacado se ele estiver associado a diferentes combinações de ID de LOCALIZAÇÃO_e ID de LICENÇA_. |
CLIENTE, USUÁRIO |
Reconciliação, Ponto no Tempo |
|
RELATÓRIO_DATA |
A data e a hora em que o relatório é gerado. |
CLIENTE, USUÁRIO |
Ponto no tempo |
O provisionamento de um pacote para um usuário aciona a cobrança do Webex Wholesale, enquanto a remoção da atribuição do pacote a interrompe.
