Informes de facturación para socios

Los socios reciben informes de facturación resumidos que proporcionan recuentos diarios agregados de eventos facturables, agrupados por agente, tipo de evento y operador. Esto sirve como un resumen general de todo el tráfico facturable, lo que te proporciona estadísticas valiosas y la visibilidad necesaria de tus datos de tráfico.

Generación y acceso a archivos

Los informes se generan diariamente en formato CSV y se entregan a través del servicio SFTP de Google.

Acceso a SFTP

El acceso a los informes está protegido por pares de claves pública/privada. Las credenciales de SFTP garantizan un acceso seguro y aislado.

Cómo obtener acceso a SFTP

Para recibir informes de facturación, primero debes configurar tus credenciales de SFTP:

1. Genera un par de claves SSH: Sigue las instrucciones para generar un par de claves Secure Shell (SSH) para un buzón SFTP.
2. Inicia la incorporación: Si te interesa recibir informes de socios, comunícate con tu representante comercial de Google o con tu contacto principal de Google. Te guiarán en la configuración inicial y el registro de tu cuenta de socio para la generación de informes de facturación.
3. Envía tu clave pública: Proporciona tu clave pública (archivo PUB) a tu contacto de Google. Luego, Google aprovisionará tu cuenta, te asignará tu <partner_id> único y te notificará cuando el acceso esté listo.

4. Accede al servidor: Una vez que recibas la notificación, podrás acceder a tus informes en el servidor SFTP en partnerupload.google.com con el puerto 19321. Usa el siguiente comando para conectarte:

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

Convención para los nombres de archivos

Todos los informes de operadores se dividen por operador.

Las estructuras de nombres de archivos y directorios son las siguientes:

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

El <prefix> identifica el tipo específico de informe que se entrega.

Los prefijos estándar incluyen lo siguiente:

Tipo de informe	Prefijo del nombre de archivo
Informe de resumen	summary

De manera opcional, se puede agregar un prefijo de nombre de archivo personalizado adicional si existen varios informes para el mismo operador y socio (por ejemplo, durante las migraciones de formato). Siempre debes analizar todos los archivos de forma recursiva en el directorio con fecha.

Estructura del informe en CSV

En las siguientes secciones, se definen los campos, los formatos de datos y las definiciones de columnas que se usan en los informes de facturación de socios.

Si tienes más preguntas, comunícate con tu operador.

Formato del informe de resumen

Campo	Formato	Descripción	Ejemplo
type	string	Tipo de evento de facturación	a2p_session
agent_id	string	ID único del agente	[e-mail]
agent_name	string	Nombre del agente que participó en el evento	ACME Brand
carrier_id	string	ID del operador para el tráfico	super-carrier
carrier_name	string	Nombre de la empresa de transporte	Super Carrier
carrier_country	string	Código de país ISO 3166-1 alpha-2	US
start_date	string	Fecha en la que comenzó el evento (formato AAAA-MM-DD)	2026-05-07
billing_date	string	Fecha en la que se generó el informe de facturación	2026-05-08
event_count	número	Cantidad de eventos agregados por tipo (SUM)	150
segment_count*	número	Es la cantidad de segmentos calculada para los eventos del modelo de facturación de EE.UU. (SUM). *Solo en EE.UU.	5