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 formatos específicos 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) a la moneda de facturación.

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

Los resúmenes de uso en formato PDF y CSV presentan su factura en formatos específicos de MongoDB. El informe de costos 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.

Capacidades de la API de datos de FOCUS

La API de datos de FOCUS proporciona acceso programático a sus datos de costes y uso en formato FOCUS.

Con la API de datos de FOCUS, usted puede:

Visualice los costos en la moneda de facturación: acceda a BilledCost y EffectiveCost directamente en la moneda de facturación, sin conversión manual.
Identificar tipos de crédito: Vea si un crédito es prepago, promocional o elástico a través del Contract Applied campo.
Analice los costos con todo el contexto: utilice campos Region como, 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 intuitivos de FOCUS en lugar de términos internos de la API groupName como.

Referencia de la columna FOCUS

La siguiente tabla enumera 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 CSV actual	Campo equivalente JSON actual
`BilledCost`	El coste, en la moneda de facturación, cobrado durante el período de facturación actual.	N/A	N/A
`BillingAccountId`	El ID de la organización Atlas para esta factura.	identificador de la organización	N/A
`BillingAccountName`	Nombre de la organización Atlas para esta factura.	Nombre de la organización	N/A
`BillingCurrency`	La moneda de facturación para este cargo.	N/A	N/A
`BillingPeriodEnd`	La fecha de finalización del período de facturación. El período de facturación no incluye la fecha de finalización.	N/A	"FechaFin" (factura)
`BillingPeriodStart`	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 según la forma en que se factura. Por ejemplo, "uso" indica un cargo basado en la cantidad de servicio o recurso consumido.	N/A	N/A
`ChargeDescription`	Contexto general sobre la acusación.	Descripción	N/A
`ChargePeriodEnd`	El final del período en que se generó el cargo. El período de facturación no incluye la fecha de finalización.	N/A	"FechaFin" (elementos de línea)
`ChargePeriodStart`	El inicio del período en el que se generó el cargo. El período de facturación incluye la fecha de inicio.	Fecha de uso	"FechaInicio" (elementos de línea)
`ConsumedQuantity`	El volumen de una SKU determinada asociada a un recurso o servicio utilizado, basado en la unidad consumida.	Cantidad	"Cantidad"
`ConsumedUnit`	La unidad utilizada para medir un SKU determinado.	unidad	"unit"
`ContractApplied`	Conjunto de propiedades que asocian un cargo con uno o más compromisos contractuales. Identifica el nombre del crédito Atlas utilizado para cubrir el consumo.	N/A	N/A
`ContractedCost`	Representa el costo calculado multiplicando el precio unitario contratado por la cantidad de precio correspondiente. Este campo se expresa en la moneda de facturación.	N/A	N/A
`ContractedUnitPrice`	El precio unitario acordado para una sola unidad de precio del SKU correspondiente, incluyendo 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 se expresa en la 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, AWS, Azure, GCP.	N/A	N/A
`InvoiceIssuer`	La entidad responsable de facturar los recursos o servicios consumidos. Por ejemplo, MongoDB para los clientes que realizan transacciones directamente con MongoDB, o marketplace para los 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 lista por la cantidad de precio correspondiente. Este campo se expresa en la moneda de facturación.	N/A	N/A
`ListUnitPrice`	Precio unitario sugerido por el proveedor para una sola unidad de precio del SKU correspondiente, sin incluir descuentos. Este precio está expresado en la moneda de facturación.	N/A	N/A
`PricingCurrency`	La moneda de medición para este cargo, por ejemplo, Créditos Atlas.	N/A	N/A
`PricingCurrencyContractedUnitPrice`	El precio unitario acordado para una sola unidad de precio del SKU correspondiente, incluyendo los descuentos. Este precio se expresa en la moneda de fijación de precios.	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 se expresa en la moneda de precios.	Importe	"Precio total en centavos"
`PricingCurrencyListUnitPrice`	Representa el costo calculado multiplicando el precio unitario de lista por la cantidad de precio correspondiente. Este campo se expresa en la moneda de precio.	Precio unitario	"PrecioUnitarioEnDólares"
`PricingQuantity`	Representa el volumen de una SKU determinada asociada a un recurso o servicio utilizado o adquirido, en función de la unidad de precio.	N/A	N/A
`PricingUnit`	Representa una unidad para determinar precios unitarios, por ejemplo, GB-Horas.	N/A	N/A
`RegionId`	Un identificador para un área geográfica aislada donde se proporciona un recurso o un servicio. Por ejemplo, `us-east-1`.	N/A	N/A
`RegionName`	Nombre para un área geográfica aislada donde se proporciona un recurso o un servicio. Por ejemplo, `N. Virginia`.	Región	N/A
`ResourceName`	Para Atlas, este es el nombre del clúster.	clúster	"Nombre del clúster"
`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 adquirir de 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 del precio del punto de precio al que se facturó el cargo, como pares clave-valor en formato JSON. Esta columna está vacía cuando el cargo no tiene un punto de precio o cuando el punto de precio no especifica dimensiones.	N/A	N/A
`SkuPriceId`	Un identificador único para el 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 estructuras 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	"nombre del grupo"
`Tags`	Etiquetas asignadas a los recursos asociados.	Etiquetas/aplicación	"tags"
`x_AtlasSku`	El código SKU de Atlas que se está facturando.	SKU	"sku"
`x_BilledDateEnd`	El final del período en el que MongoDB facturó el cargo.	fecha	"creado" (elementos de línea)
`x_BilledDateStart`	El inicio del período en el que MongoDB facturó el cargo.	N/A	N/A
`x_PricingCurrencyRate`	El "precio" de un Crédito Atlas. Aplique esta tasa para calcular el costo de un Crédito 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 API de administración de Atlas 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 Organization Billing Viewer o.

Listado de facturas para una organización

Recupera una lista de identificadores de factura disponibles. Para la facturación entre organizaciones, este punto final 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 a recuperar. Debe ser >= 2000.	Año corriente
`includeLinkedOrgs`	booleano	Opcional	Indicador que especifica si se deben incluir las facturas de las 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 durante el período especificado.
`associatedInvoices[n].invoiceId`	string	Identificador único de dígitos hexadecimales 24para una factura.
`associatedInvoices[n].orgId`	string	Identificador único de dígitos hexadecimales 24para 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`.

Solicite 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 asíncrona y devuelve un ID de informe que usted utiliza para consultar el estado del mismo.

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	Cadena única de dígitos hexadecimales 24que 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

En caso de éxito, devuelve 201 Created con el ID del informe y el estado inicial del mismo:

{
  "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 usted solicitó. Consultar este punto final hasta que state sea SUCCEEDED o FAILED.

Realice consultas como máximo 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	Cadena única de dígitos hexadecimales 24que identifica la factura.
`reportId`	string	Requerido	Cadena única de dígitos hexadecimales 24que 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

En caso de é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 que informan

Estado	Descripción
`PENDING`	Atlas aceptó la solicitud, pero aún 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 expira `downloadUrl`, 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	Cadena única de dígitos hexadecimales 24que identifica la factura.
`reportFormat`	string	Formato del informe generado.
`reportId`	string	Cadena única de dígitos hexadecimales 24que identifica el informe.
`reportType`	string	Tipo de informe generado.
`state`	string	Estado actual de la generación de informes.

Disponibilidad del informe

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

El informe permanece disponible durante siete días después de su solicitud. Transcurridos siete días, solicite un nuevo informe para descargar los mismos datos de facturación.

Comportamiento y rendimiento de los datos

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

Puedes consultar los datos del mes actual («Pendiente»). Si bien Atlas asocia el uso con los créditos en tiempo real para ofrecer estimaciones de costos, estos valores permanecen en not final hasta que se cierre la factura. Vuelve a consultar los datos al finalizar el mes para confirmar los valores de facturación finales.

Manejo de archivos para grandes cantidades de datos

La API de datos de FOCUS genera y entrega informes de una manera diseñada para manejar grandes volúmenes de datos de facturación:

Generación asíncrona: La generación del informe no bloquea la solicitud. El punto final de la solicitud devuelve un reportId inmediatamente, y se consulta el punto final de recuperación para obtener 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.
Ámbito de una sola organización: Cada solicitud devuelve datos para una sola organización. Si utiliza facturación entre organizaciones, solicite un informe por cada invoiceId devuelto por el punto final de la lista.

Limitaciones

El punto final cubre únicamente los costos basados en el uso. Actualmente no incluye:
- Cargos por diferencia (diferencias entre el compromiso mensual y el flexible).
- Partidas de impuestos.
- Ajustes o reembolsos.

Para ver la factura completa en la consola de Atlas, consulte la sección 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

Uso internacional e impuestos

Explore sus datos