Relatórios de faturamento de parceiros

Os parceiros recebem relatórios de faturamento resumidos que fornecem contagens diárias agregadas de eventos faturáveis, agrupados por agente, tipo de evento e operadora. Isso serve como um resumo de alto nível de todo o tráfego faturável, oferecendo análises valiosas e a visibilidade necessária dos dados de tráfego.

Geração e acesso a arquivos

Os relatórios são gerados diariamente no formato CSV e entregues usando o serviço SFTP do Google.

Acesso ao SFTP

O acesso aos relatórios é protegido por pares de chaves pública/privada. As credenciais do SFTP garantem acesso seguro e isolado.

Como ter acesso ao SFTP

Para receber relatórios de faturamento, primeiro configure suas credenciais do SFTP:

1. Gerar um par de chaves SSH: siga as instruções para gerar um par de chaves Secure Shell (SSH) para uma caixa de depósito SFTP.
2. Iniciar a integração:se você tiver interesse em receber relatórios de parceiros, entre em contato com seu representante comercial do Google ou com o contato principal do Google. Eles vão orientar você na configuração inicial e no registro da sua conta de parceiro para relatórios de faturamento.
3. Enviar sua chave pública:forneça sua chave pública (arquivo PUB) ao seu contato do Google. O Google vai provisionar sua conta, atribuir seu <partner_id> exclusivo e notificar quando o acesso estiver pronto.

4. Acessar o servidor:depois de receber a notificação, você poderá acessar seus relatórios no servidor SFTP em partnerupload.google.com usando a porta 19321. Use o comando a seguir para se conectar:

   sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
   

Convenção de nomenclatura de arquivos

Todos os relatórios de operadora são divididos por operadora.

As estruturas de nomenclatura de diretórios e arquivos são as seguintes:

rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

O <prefix> identifica o tipo específico de relatório que está sendo entregue.

Os prefixos padrão incluem:

Tipo de relatório	Prefixo do nome de arquivo
Relatório do resumo	summary

Um prefixo de nome de arquivo personalizado adicional poderá ser adicionado opcionalmente se houver vários relatórios para a mesma operadora e parceiro (por exemplo, durante migrações de formato). Você sempre deve verificar todos os arquivos recursivamente no diretório datado.

Estrutura do relatório CSV

As seções a seguir definem os campos, formatos de dados e definições de coluna usados nos relatórios de faturamento de parceiros.

Se tiver outras dúvidas, entre em contato com sua operadora.

Formato do relatório do resumo

Campo	Formato	Descrição	Exemplo
type	string	Tipo de evento de faturamento	a2p_session
agent_id	string	ID exclusivo do agente	[e-mail]
agent_name	string	Nome do agente que participou do evento	ACME Brand
carrier_id	string	ID da operadora para o tráfego	super-carrier
carrier_name	string	Nome da transportadora	Super Carrier
carrier_country	string	Código do país de acordo com a norma ISO 3166-1 alfa-2	US
start_date	string	Data de início do evento (formato AAAA-MM-DD)	2026-05-07
billing_date	string	Data em que o relatório de faturamento foi gerado	2026-05-08
event_count	número	Número de eventos agregados por tipo (SOMA)	150
segment_count*	número	A contagem de segmentos calculada para eventos do modelo de faturamento dos EUA (SOMA) *Somente nos EUA	5