Acceda al informe de costos y uso de FOCUS

La especificación abierta de costos y uso de FinOps (FOCUS) establece requisitos uniformes para los conjuntos de datos de facturación de tecnología. MongoDB Atlas proporciona datos de costos y uso de facturación en el 1 3 formato FOCUS.. Puede generar un informe FOCUS desde la Invoices página en la consola de Atlas o con la API de datos FOCUS.

Acerca de FOCUS

Históricamente, los datos de facturación de Atlas se han proporcionado en formato específico de MongoDB. Los clientes de Atlas, en particular las grandes empresas y los socios, deben realizar un esfuerzo manual para convertir las unidades de crédito de Atlas (ACU) en moneda de facturación.

FOCUS proporciona un vocabulario común y una estructura de facturación, lo que le ayuda a comprender, conciliar e integrar sus datos de facturación de Atlas con FinOps y herramientas de gestión de costos de varios proveedores.

Los resúmenes de uso de PDF y CSV presentan su factura en formato específico de MongoDB. El informe de costo y uso de FOCUS presenta el mismo período de facturación en el formato estandarizado de FOCUS. Puede descargar los tres desde la página Invoices en la consola de Atlas.

Descargue un informe FOCUS desde la consola Atlas.

Puede descargar el informe de costos y uso de FOCUS para una factura desde la página Invoices en la consola de Atlas. Seleccione CSV FOCUS Cost & Usage Report cuando elija el formato de factura.

Para descargar el informe del período de facturación actual, consulte Descargar su factura actual. Para descargar el informe de un período de facturación anterior, consulte Descargar facturas anteriores.

Nota

To view and download billing data, you must have the Organization Billing Admin, Organization Owner, or Organization Billing Viewer role.

Capacidades de la API de datos de FOCUS

La API de datos de FOCUS proporciona acceso programático a los datos de uso y costo con formato FOCUS.

Con la API de datos de FOCUS, puede:

Ver costo en la moneda de facturación: Acceda a BilledCost y EffectiveCost directamente en la moneda de facturación, sin conversión manual.
Identifique los tipos de crédito: Vea si un crédito es prepago, promocional o elástico a través del campo Contract Applied.
Analice los costos con el contexto completo: utilice campos como Region, UsageDate y ServiceCategory para un análisis de costos detallado.
Trabaje con términos estándar de la industria: utilice SubAccountName y otros términos FOCUS intuitivos en lugar de términos de API internos como groupName.

Referencia de columna de FOCUS

En la siguiente tabla se enumeran las columnas devueltas en la respuesta de la API de datos de FOCUS y sus campos de facturación heredados equivalentes:

ENFOQUE 1.3 ID de columna	Definición	Campo equivalente de CSV actual	Campo equivalente de JSON actual
`BilledCost`	El costo, en moneda de facturación, cobrado durante el período de facturación actual.	N/A	N/A
`BillingAccountId`	El Identificador de la Organización de Atlas para esta factura.	identificador de la organización	N/A
`BillingAccountName`	El nombre de la organización de Atlas para esta factura.	Nombre de la organización	N/A
`BillingCurrency`	La moneda de facturación de este cargo.	N/A	N/A
`BillingPeriodEnd`	La fecha de finalización del período de facturación. El período de facturación excluye la fecha de finalización.	N/A	"endDate" (factura)
`BillingPeriodStart`	La fecha de inicio del período de facturación. El período de facturación incluye la fecha de inicio.	N/A	"creado" (factura)
`ChargeCategory`	Clasificación de un cargo en función de la naturaleza de cómo se factura. Por ejemplo, "uso" denota un cargo basado en la cantidad del servicio o recurso consumido.	N/A	N/A
`ChargeDescription`	Contexto de alto nivel sobre el cargo.	Descripción	N/A
`ChargePeriodEnd`	El final del período en que se incurrió el cargo. El período de facturación excluye la fecha de finalización.	N/A	"endDate" (lineItems)
`ChargePeriodStart`	El inicio del período en el que se incurrió en el cargo. El período de facturación incluye la fecha de inicio.	Fecha de uso	"startDate" (lineItems)
`ConsumedQuantity`	El volumen de un SKU determinado asociado a un recurso o servicio utilizado, en función de la unidad consumida.	Cantidad	"cantidad"
`ConsumedUnit`	La unidad utilizada para medir un SKU determinado.	unidad	"unit"
`ContractApplied`	Un conjunto de propiedades que asocian un cargo con uno o más compromisos contractuales. Identifica el nombre del crédito de Atlas utilizado para cubrir el uso consumido.	N/A	N/A
`ContractedCost`	Representa el costo calculado multiplicando el precio unitario contratado y la cantidad de precios correspondiente. Este campo está denominado en moneda de facturación.	N/A	N/A
`ContractedUnitPrice`	El precio unitario acordado para una única unidad de precio de la SKU asociada, incluidos los descuentos. Este precio se expresa en la moneda de facturación.	N/A	N/A
`EffectiveCost`	Representa el costo amortizado de un cargo después de aplicar todas las tarifas reducidas y los descuentos. Este campo está denominado en moneda de facturación.	N/A	N/A
`HostProviderName`	El nombre de la entidad que proporciona la infraestructura subyacente donde el proveedor de servicios implementa sus recursos y servicios. Por ejemplo, Amazon Web Services, Azure, GCP.	N/A	N/A
`InvoiceIssuer`	La entidad responsable de la facturación de los recursos o servicios consumidos. Por ejemplo, MongoDB para clientes que realizan transacciones directamente con MongoDB, o marketplace para clientes que realizan transacciones con Atlas a través de un marketplace.	N/A	N/A
`ListCost`	Representa el costo calculado multiplicando el precio unitario de la lista y la cantidad de precios correspondiente. Este campo está denominado en moneda de facturación.	N/A	N/A
`ListUnitPrice`	El precio unitario sugerido publicado por el proveedor para una sola unidad de precio del SKU asociado, excluidos los descuentos. Este precio se expresa en la moneda de facturación.	N/A	N/A
`PricingCurrency`	La moneda de medición para este cargo, por ejemplo, los créditos de Atlas.	N/A	N/A
`PricingCurrencyContractedUnitPrice`	El precio unitario acordado para una única unidad de precio de la SKU asociada, incluidos los descuentos. Este precio se denomina en la moneda de precio.	N/A	N/A
`PricingCurrencyEffectiveCost`	Representa el costo amortizado de un cargo después de aplicar todas las tarifas reducidas y los descuentos. Este campo está denominado en moneda de precios.	Importe	"totalPriceCents"
`PricingCurrencyListUnitPrice`	Representa el costo calculado multiplicando el precio unitario de la lista y la cantidad de precios correspondiente. Este campo está denominado en moneda de precios.	Precio unitario	"unitPriceDollars"
`PricingQuantity`	Representa el volumen de un SKU determinado asociado a un recurso o servicio utilizado o comprado, en función de la unidad de precios.	N/A	N/A
`PricingUnit`	Representa una unidad para determinar los precios unitarios, por ejemplo, GB-Horas.	N/A	N/A
`RegionId`	Un identificador para un área geográfica aislada donde se aprovisiona un recurso o se proporciona un servicio. Por ejemplo, `us-east-1`.	N/A	N/A
`RegionName`	Un nombre para un área geográfica aislada donde se aprovisiona un recurso o se proporciona un servicio. Por ejemplo, `N. Virginia`.	Región	N/A
`ResourceName`	Para Atlas, este es el nombre del clúster.	clúster	"clusterName"
`ServiceCategory`	Clasificación de nivel más alto según lo define FOCUS. Esto es "Bases de datos" para MongoDB Atlas.	N/A	N/A
`ServiceName`	Representa una oferta que se puede comprar a un proveedor de servicios, por ejemplo, MongoDB Atlas.	N/A	N/A
`ServiceProviderName`	Nombre de la entidad que proporciona los recursos o servicios disponibles para su uso o compra. Por ejemplo, MongoDB.	N/A	N/A
`SkuId`	Un identificador único para una unidad de mantenimiento de existencias (SKU), que representa una configuración facturable distinta.	N/A	N/A
`SkuMeter`	La unidad de medida para el SKU asociado, que indica lo que se está midiendo, por ejemplo, `GB`, tiempo de cómputo o solicitudes.	N/A	N/A
`SkuPriceDetails`	Las dimensiones de precio del punto de precio en el que se facturó el cargo, como pares clave-valor en JSON. Esta columna está vacía cuando el cargo no tiene un punto de precio o el punto de precio no especifica dimensiones.	N/A	N/A
`SkuPriceId`	Un identificador único para el punto de precio al que se facturó el cargo.	N/A	N/A
`SubAccountId`	Un identificador asignado a una subcuenta, que es una agrupación basada en construcciones organizativas. Esto equivale a un Proyecto en MongoDB Atlas.	ID del proyecto	"groupId"
`SubAccountName`	El nombre para mostrar de la subcuenta. Esto equivale a un Proyecto en MongoDB Atlas.	Proyecto	"groupName"
`Tags`	Etiquetas asignadas a los recursos asociados.	Etiquetas/aplicación	"tags"
`x_AtlasSku`	La SKU de Atlas que se está facturando.	SKU	"sku"
`x_BilledDateEnd`	El final del período en que MongoDB facturó el cargo.	fecha	"created" (lineItems)
`x_BilledDateStart`	El inicio del período en que MongoDB facturó el cargo.	N/A	N/A
`x_PricingCurrencyRate`	El "precio" de un crédito de Atlas. Aplique esta tasa para encontrar el costo de un crédito de Atlas en la moneda de facturación.	N/A	N/A
`x_SkuCategory`	Clasificación de nivel más alto para el SKU de Atlas asociado. Por ejemplo, `Clusters` o `Backup`.	N/A	N/A

Extremos

La API de datos de FOCUS amplía la Atlas Administration API con tres puntos finales:

La función "Listar facturas de una organización" muestra las facturas disponibles de una organización.
La opción "Solicitar un informe FOCUS" solicita la generación de un informe de facturación con formato FOCUS.
La opciónRecuperar un informe FOCUS devuelve el estado de dicho informe y, cuando el informe está listo, la URL para descargarlo.

Nota

Todos los puntos finales requieren el rol Organization Billing Admin, Organization Owner o Organization Billing Viewer.

Listar facturas de una organización

Recupera una lista de ID de factura disponibles. Para la facturación entre organizaciones, este endpoint identifica las facturas de todas las organizaciones vinculadas.

URL base: /api/atlas/v2/orgs/{orgId}/associatedInvoices

GET /api/atlas/v2/orgs/{orgId}/associatedInvoices

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
`orgId`	string	Requerido	string única de 24 dígitos hexadecimales que identifica a la organización.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
`month`	entero	Opcional	El mes de las facturas a recuperar (1-12).	Mes actual
`year`	entero	Opcional	El año de las facturas que se recuperarán. Debe ser >= 2000.	Año actual
`includeLinkedOrgs`	booleano	Opcional	Indicador que señala si se deben incluir facturas de organizaciones vinculadas.	`false`

Solicitud de ejemplo

curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  --request GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/associatedInvoices"

Respuesta

{
  "associatedInvoices": [
    {
      "invoiceId": "string",
      "orgId": "string"
    }
  ],
  "month": "06",
  "year": "2026"
}

Elementos de respuesta

Nombre	Tipo	Descripción
`associatedInvoices`	arreglo	Lista de facturas asociadas a la organización para el período especificado.
`associatedInvoices[n].invoiceId`	string	Identificador único de 24dígitos hexadecimales para una factura.
`associatedInvoices[n].orgId`	string	Identificador único de 24dígitos hexadecimales para una organización.
`month`	string	Número de dos dígitos que representa el mes de las facturas asociadas, por ejemplo, `06`.
`year`	string	Número de cuatro dígitos que representa el año de las facturas asociadas, por ejemplo, `2026`.

Solicitar un informe FOCUS

Solicita la generación de un informe de facturación en el formato estándar FOCUS. Atlas genera el informe de forma asincrónica y devuelve un ID de informe que se utiliza para sondear el estado del informe.

URL base: /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports

POST /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
`orgId`	string	Requerido	string única de 24 dígitos hexadecimales que identifica a la organización.
`invoiceId`	string	Requerido	string de dígitos hexadecimales 24única que identifica la factura.

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
`reportType`	string	Requerido	Tipo de informe a generar. Debe establecerse en `FOCUS`.
`reportFormat`	string	Requerido	Formato del informe. Valores permitidos: `CSV`.
`formatSpecVersion`	string	Opcional	Versión de la especificación del formato del informe, por ejemplo, `1.3`.

Solicitud de ejemplo

curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  --header "Content-Type: application/json" \
  --request POST "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports" \
  --data '{
    "reportType": "FOCUS",
    "reportFormat": "CSV",
    "formatSpecVersion": "1.3"
  }'

Respuesta

Si tiene éxito, devuelve 201 Created con el ID del informe y el estado inicial del informe:

{
  "invoiceId": "32b6e34b3d91647abb20e7b8",
  "reportFormat": "CSV",
  "reportId": "5f5f4c9e2b8f4b3a1c2d3e4f",
  "reportType": "FOCUS",
  "state": "PENDING"
}

Para descargar el informe, pase el valor devuelto reportId al punto final de recuperación.

Recuperar un informe FOCUS

Devuelve el estado y los detalles de un informe FOCUS que solicitó. Sondee este punto final hasta que state sea SUCCEEDED o FAILED.

No sondee más de una vez cada cinco segundos. Si un informe tarda más en generarse, aumente el intervalo entre las solicitudes de forma exponencial. La mayoría de los informes se completan en segundos, pero los informes de facturas grandes pueden tardar unos minutos.

URL base: /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}

GET /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
`orgId`	string	Requerido	string única de 24 dígitos hexadecimales que identifica a la organización.
`invoiceId`	string	Requerido	string de dígitos hexadecimales 24única que identifica la factura.
`reportId`	string	Requerido	String de dígitos hexadecimales 24único que identifica el informe.

Solicitud de ejemplo

curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  --request GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}"

Respuesta

Si tiene éxito, devuelve 200 OK con el estado actual del informe. Cuando state es SUCCEEDED, la respuesta también incluye la URL de descarga y su tiempo de caducidad:

{
  "downloadUrl": "https://<presigned-url>",
  "expiresAt": "2026-08-17T18:30:00Z",
  "formatSpecVersion": "1.3",
  "invoiceId": "32b6e34b3d91647abb20e7b8",
  "reportFormat": "CSV",
  "reportId": "5f5f4c9e2b8f4b3a1c2d3e4f",
  "reportType": "FOCUS",
  "state": "SUCCEEDED"
}

Estados del informe

Estado	Descripción
`PENDING`	Atlas aceptó la solicitud, pero no ha comenzado a generar el informe.
`RUNNING`	Atlas está generando el informe.
`SUCCEEDED`	El informe está listo. La respuesta incluye `downloadUrl` y `expiresAt`.
`FAILED`	Atlas no pudo generar el informe. La respuesta incluye `failureReason`.

Elementos de respuesta

Nombre	Tipo	Descripción
`downloadUrl`	string	URL para descargar el informe. La respuesta incluye este parámetro solo cuando `state` es `SUCCEEDED`.
`expiresAt`	string	Fecha y hora en que `downloadUrl` caduca, en formato ISO 8601 en UTC. Cada URL de descarga es válida durante 15 minutos. La respuesta incluye este parámetro solo cuando `state` es `SUCCEEDED`.
`failureReason`	string	Motivo por el que falló el informe. La respuesta incluye este parámetro solo cuando `state` es `FAILED`.
`formatSpecVersion`	string	Versión de la especificación del formato del informe.
`invoiceId`	string	string de dígitos hexadecimales 24única que identifica la factura.
`reportFormat`	string	Formato del informe generado.
`reportId`	string	String de dígitos hexadecimales 24único que identifica el informe.
`reportType`	string	Tipo de informe generado.
`state`	string	Estado actual de la generación de informes.

Disponibilidad de informes

Cada downloadUrl es válido durante 15 minutos. Para descargar un informe después de que caduque su URL, vuelva a llamar a este endpoint con el mismo reportId. Atlas devuelve un nuevo downloadUrl y una nueva hora expiresAt.

Un informe permanece disponible durante siete días después de solicitarlo. Después de siete días, solicite un nuevo informe para descargar los mismos datos de la factura.

Comportamiento de los datos y rendimiento

Las siguientes secciones describen cómo la API de datos de FOCUS gestiona los datos pendientes y la generación de informes a gran escala.

Visibilidad del mes pendiente

Puede consultar datos para el mes "Pendiente" (actual). Si bien Atlas asocia el uso con créditos en tiempo real para ofrecer estimaciones de costos, estos valores son not final hasta que se cierre la factura. Vuelva a extraer los datos después de que finalice el mes para confirmar los valores de facturación finales.

Manejo de archivos para datos grandes

La API de datos de FOCUS genera y entrega informes de una manera diseñada para gestionar datos de facturación a gran escala:

Generación asíncrona: la generación de informes no bloquea su solicitud. El endpoint de solicitud devuelve un reportId inmediatamente, y usted consulta el endpoint de recuperación para el estado del informe.
Formato CSV: los informes se generan como archivos CSV.
URL de descarga con tiempo limitado: Cuando un informe se descarga correctamente, el punto final de recuperación devuelve un válido downloadUrl durante 15 minutos. Los informes permanecen disponibles durante siete días. Para saber cómo actualizar una URL caducada, consulte Disponibilidad de informes.
Alcance de una sola organización: cada solicitud devuelve datos para una organización. Si utiliza la facturación entre organizaciones, solicite un informe para cada invoiceId devuelto por el endpoint de la lista.

Limitaciones

El endpoint solo cubre los costos basados en el uso. Actualmente no incluye:
- Cargos por déficit (diferencias de compromiso mensual/flexible).
- Líneas de impuestos.
- Ajustes o reembolsos.

Para ver su factura completa en la consola de Atlas, consulte Gestionar facturas.

Soporte y comentarios

Si tiene preguntas sobre la API de datos de FOCUS, póngase en contacto con su equipo de cuenta de MongoDB. Para hacer preguntas y participar en debates con otros desarrolladores, consulte las comunidades de MongoDB en Stack Overflow o Reddit.

Volver

Desglose de la factura

Suscripciones