Devolver todas las facturas pendientes de una organización

Obtener /api/atlas/v2/orgs/{orgId}/facturas/pendiente

Devuelve todas las facturas que acumulan cargos durante el ciclo de facturación actual de la organización especificada. Para usar este recurso, la cuenta de servicio o clave API solicitante debe tener el rol de Visor de facturación de la organización, Administrador de facturación de la organización o Propietario de la organización. Si tiene una configuración multiorganización, puede ver las facturas vinculadas si tiene el rol de Administrador de facturación de la organización o Propietario de la organización.

Parámetros de ruta

  • orgId string Requerido

    Cadena 24hexadecimal única que identifica la organización que contiene sus proyectos. Utilice el /orgs punto de conexión para recuperar todas las organizaciones a las que el usuario autenticado tiene acceso.

    El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

Parámetros de consulta

  • envolvente booleano

    Indicador que indica si la aplicación encapsula la respuesta en un objeto JSON envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como encapsulado. La aplicación añade el parámetro de estado al cuerpo de la respuesta.

    El valor predeterminado es false.

  • bonita booleano

    Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint.

    El valor predeterminado es false.

    Impresión bonita

Respuestas

  • 200 application/vnd.atlas.2023-01-01+json

    Vale

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • resultados matriz[objeto]

      Lista de documentos devueltos que MongoDB nube proporciona al completar esta solicitud.

      Ocultar atributos de resultados Mostrar atributos de resultados Objeto
      • cantidadfacturadacentavos integer(int64)

        Suma de los servicios que la organización especificada consumió durante el período cubierto por esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

      • amountPaidCents integer(int64)

        Suma que la organización especificada pagó por esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

      • creado cadena(fecha-hora)

        Fecha y hora en que MongoDB Cloud creó esta factura. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

      • créditosCentavos integer(int64)

        Suma que MongoDB abonó a la organización especificada en esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

      • fecha de finalización cadena(fecha-hora)

        Fecha y hora en que MongoDB Cloud finalizó el período de facturación que cubre esta factura. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

      • ID. string

        Cadena única de dígitos hexadecimales 24que identifica la factura enviada a la organización especificada. Los cargos suelen contabilizarse al día siguiente.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • elementos de línea matriz[objeto]

        Lista que contiene los servicios individuales incluidos en esta factura.

        Un servicio incluido en esta factura.

        Ocultar atributos de elementos de línea Mostrar atributos lineItems Objeto
        • nombre del clúster string

          Etiqueta legible por humanos que identifica el grupo que generó la carga.

          El formato debe coincidir con el siguiente patrón: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.

        • creado cadena(fecha-hora)

          Fecha y hora en que MongoDB Cloud creó esta línea de pedido. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

        • descuentoCents integer(int64)

          Suma con la que MongoDB descontó esta línea de pedido. MongoDB Cloud expresa este valor en centavos (100avos de dólar estadounidense). El recurso devuelve este parámetro cuando se aplica un descuento.

        • fecha de finalización cadena(fecha-hora)

          Fecha y hora en que MongoDB nube terminó de cobrar esta partida. Este parámetro expresa su valor en el formato de timestamp ISO 8601 en UTC.

        • ID de grupo string

          Cadena de dígitos hexadecimales 24única que identifica el proyecto asociado a esta línea de artículo.

          El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

        • nombre del grupo string

          Etiqueta legible por humanos que identifica el proyecto.

        • Nota string

          Comentario que se aplica a esta línea de artículo.

        • porcentaje de descuento número(flotante)

          Porcentaje de descuento aplicado por MongoDB a esta línea de pedido. El recurso devuelve este parámetro cuando se aplica un descuento.

        • cantidad número(doble)

          Número de unidades incluidas en la partida. Pueden ser unidades de almacenamiento (GB), tiempo (horas) u otras unidades.

        • sku string

          Descripción legible del servicio que proveyó este elemento. Esta Unidad de mantenimiento de stock (SKU) puede ser el tipo de instancia, un cargo por soporte, seguridad avanzada u otro servicio.

          Para ver cómo enumerar todos los posibles...
        • fecha de inicio cadena(fecha-hora)

          Fecha y hora en que MongoDB Cloud comenzó a cobrar por esta línea de pedido. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

        • stitchAppName string

          Etiqueta legible por humanos que identifica la aplicación Atlas App Services asociada con esta línea de pedido.

          Crear un nuevo servicio de aplicaciones Atlas
        • Etiquetas Objeto

          Un mapa de pares clave-valor correspondientes a las etiquetas asociadas con el recurso del artículo de línea.

          Hide tags attribute Show tags attribute Objeto
          • * array[string] Propiedades adicionales

            Un mapa de pares clave-valor correspondientes a las etiquetas asociadas con el recurso del artículo de línea.

        • tierLowerBound número(doble)

          Límite inferior para el rango de cantidad de uso en el nivel de SKU actual.

          NOTA: lineItems[n].tierLowerBound aparece solo si su lineItems[n].sku está escalonado.

        • tierUpperBound número(doble)

          Límite superior para el rango de cantidad de uso en el nivel de SKU actual.

          NOTA: lineItems[n].tierUpperBound aparece solo si su lineItems[n].sku está escalonado.

        • PrecioTotalCentavos integer(int64)

          Suma del costo establecido para esta partida. MongoDB Cloud expresa este valor en centavos (100avos de dólar estadounidense) y lo calcula como unitPriceDollars * quantity * 100.

        • unidad string

          Elemento utilizado para expresar la cantidad que mide esta partida. Este valor puede ser tiempo, capacidad de almacenamiento, etc.

        • PrecioUnitario en Dólares número(doble)

          Valor por unidad para este rubro expresado en dólares estadounidenses.

      • Facturas vinculadas matriz[objeto]

        Listado que contiene las facturas de organizaciones vinculadas a la organización pagadora.

      • orgId string

        Cadena de dígitos hexadecimales 24única que identifica la organización a la que se le cobra por los servicios consumidos de MongoDB Cloud.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • pagos matriz[objeto]

        Lista que contiene los fondos transferidos a MongoDB para cubrir el servicio especificado indicado en esta factura.

        Fondos transferidos a MongoDB para cubrir el servicio especificado en esta factura.

        Ocultar atributos de pagos Mostrar atributos de pagos Objeto
        • cantidadfacturadacentavos integer(int64)

          Suma de los servicios que la organización especificada consumió durante el período cubierto por esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

        • amountPaidCents integer(int64)

          Suma que la organización especificada pagó por la factura asociada. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

        • creado cadena(fecha-hora)

          Fecha y hora en que el cliente realizó este intento de pago. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

        • moneda string

          Moneda en la que se realizó el pago. Este parámetro expresa su valor en el código de moneda ISO 4217 de 3letras.

        • ID. string

          Cadena de dígitos hexadecimales 24única que identifica este pago para la factura asociada.

          El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

        • centavos de impuesto sobre las ventas integer(int64)

          Suma del impuesto sobre las ventas aplicado a esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

        • nombreDeEstado string

          Fase del procesamiento del pago de la factura asociada al momento de realizar esta solicitud. Estas fases incluyen:

          • CANCELLED:El cliente o MongoDB cancelaron el pago.
          • ERROR:El problema surgió al intentar completar el pago.
          • FAILED:MongoDB intentó cargar la tarjeta de crédito sin éxito.
          • FAILED_AUTHENTICATIONLa autenticación reforzada del cliente ha fallado. Confirme que su método de pago esté autenticado.
          • FORGIVEN:El cliente inició el pago que MongoDB luego perdonó.
          • INVOICED:MongoDB emitió una factura que incluía esta línea de artículo.
          • NEW:El cliente proporcionó un método de pago, pero MongoDB no ha intentado cobrar la tarjeta de crédito.
          • PAID:El cliente envió un pago exitoso.
          • PARTIAL_PAID:El cliente pagó parte de esta línea de artículo.

          Los valores son NEW, FORGIVEN, FAILED, PAID, PARTIAL_PAID, CANCELLED, INVOICED, FAILED_AUTHENTICATION, PROCESSING, PENDING_REVERSAL o REFUNDED.

        • subtotalCents integer(int64)

          Suma de todas las partidas de factura positivas contenidas en esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

        • unitPrice string

          El precio unitario aplicado a amountBilledCents para calcular el importe total del pago. Este valor se representa como una cadena decimal.

        • actualizado cadena(fecha-hora)

          Fecha y hora en que el cliente actualizó este intento de pago. Este parámetro expresa su valor en formato de marca de tiempo ISO 8601 en UTC.

      • reembolsos matriz[objeto]

        Lista que contiene los pagos que MongoDB devolvió a la organización por esta factura.

        Un pago que MongoDB devolvió a la organización por esta factura.

        Ocultar atributos de reembolsos Mostrar atributos de reembolsos Objeto
        • cantidadCentavos integer(int64)

          Suma de los fondos devueltos a la organización especificada expresada en centavos (100de dólar estadounidense).

        • creado cadena(fecha-hora)

          Fecha y hora en que MongoDB Cloud creó este reembolso. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

        • ID de pago string

          Cadena de dígitos hexadecimales 24única que identifica el pago que realizó la organización.

          El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

        • razón string

          Justificación de que MongoDB aceptó devolver fondos a la organización.

      • centavos de impuesto sobre las ventas integer(int64)

        Suma del impuesto sobre las ventas aplicado a esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

      • fecha de inicio cadena(fecha-hora)

        Fecha y hora en que MongoDB Cloud inició el período de facturación que cubre esta factura. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

      • saldo inicialCents integer(int64)

        Importe que la organización especificada adeudaba a MongoDB cuando MongoDB emitió esta factura. Este parámetro expresa su valor en dólares estadounidenses.

      • nombreDeEstado string

        Fase del procesamiento de pagos en la que se encuentra esta factura cuando realizaste esta solicitud. Las fases aceptadas incluyen:

        • CLOSED:MongoDB finalizó todos los cargos en el ciclo de facturación, pero aún no le ha cobrado al cliente.
        • FAILED:MongoDB intentó cargar la tarjeta de crédito proporcionada, pero el cargo por ese monto falló.
        • FORGIVEN:El cliente inició el pago que MongoDB luego perdonó.
        • FREE:Todos los cargos totalizan cero por lo que no se le cobrará al cliente.
        • INVOICED:MongoDB gestionó estos cargos mediante facturación elástica.
        • PAID:MongoDB logró cargar la tarjeta de crédito proporcionada.
        • PENDING:La factura incluye los cargos del ciclo de facturación actual.
        • PREPAID:El cliente tiene un plan prepago por lo que no se le cobrará nada.

        Los valores son PENDING, CLOSED, FORGIVEN, FAILED, PAID, FREE, PREPAID o INVOICED.

      • subtotalCents integer(int64)

        Suma de todas las partidas de factura positivas contenidas en esta factura. Este parámetro expresa su valor en centavos (100avos de dólar estadounidense).

      • actualizado cadena(fecha-hora)

        Fecha y hora de la última actualización de MongoDB Cloud del valor de este pago. Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC.

    • recuento total integer(int32)

      Número total de documentos disponibles. MongoDB Cloud omite este valor si includeCount se establece en false. El número total es una estimación y puede no ser exacto.

      El valor mínimo es 0.

  • 401 aplicación/json

    No autorizado.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 403 aplicación/json

    Forbidden.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 404 aplicación/json

    No se encontró.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 500 aplicación/json

    Error Interno del Servidor.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

OBTENER /api/atlas/v2/orgs/{orgId}/facturas/pendiente
atlas api invoices listInvoicePending --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20231115001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.ListOrgInvoicePendingApiParams{}
	sdkResp, httpResp, err := client.InvoicesApi.
		ListOrgInvoicePendingWithParams(ctx, params).
		Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2023-11-15+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/pending?pretty=true"
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2023-11-15+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/pending?pretty=true"
Ejemplos de respuestas (200)
{
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "results": [
    {
      "amountBilledCents": 42,
      "amountPaidCents": 42,
      "created": "2026-05-04T09:42:00Z",
      "creditsCents": 42,
      "endDate": "2026-05-04T09:42:00Z",
      "id": "32b6e34b3d91647abb20e7b8",
      "lineItems": [
        {
          "clusterName": "string",
          "created": "2026-05-04T09:42:00Z",
          "discountCents": 42,
          "endDate": "2026-05-04T09:42:00Z",
          "groupId": "32b6e34b3d91647abb20e7b8",
          "groupName": "string",
          "note": "string",
          "percentDiscount": 42.0,
          "quantity": 42.0,
          "sku": "string",
          "startDate": "2026-05-04T09:42:00Z",
          "stitchAppName": "string",
          "tags": {
            "additionalProperty1": [
              "string"
            ],
            "additionalProperty2": [
              "string"
            ]
          },
          "tierLowerBound": 42.0,
          "tierUpperBound": 42.0,
          "totalPriceCents": 42,
          "unit": "string",
          "unitPriceDollars": 42.0
        }
      ],
      "linkedInvoices": [
        {}
      ],
      "links": [
        {
          "href": "https://cloud.mongodb.com/api/atlas",
          "rel": "self"
        }
      ],
      "orgId": "32b6e34b3d91647abb20e7b8",
      "payments": [
        {
          "amountBilledCents": 42,
          "amountPaidCents": 42,
          "created": "2026-05-04T09:42:00Z",
          "currency": "string",
          "id": "32b6e34b3d91647abb20e7b8",
          "salesTaxCents": 42,
          "statusName": "NEW",
          "subtotalCents": 42,
          "unitPrice": "string",
          "updated": "2026-05-04T09:42:00Z"
        }
      ],
      "refunds": [
        {
          "amountCents": 42,
          "created": "2026-05-04T09:42:00Z",
          "paymentId": "32b6e34b3d91647abb20e7b8",
          "reason": "string"
        }
      ],
      "salesTaxCents": 42,
      "startDate": "2026-05-04T09:42:00Z",
      "startingBalanceCents": 42,
      "statusName": "PENDING",
      "subtotalCents": 42,
      "updated": "2026-05-04T09:42:00Z"
    }
  ],
  "totalCount": 42
}
Ejemplos de respuestas (401)
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
Ejemplos de respuestas (403)
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
Ejemplos de respuestas (404)
{
  "error": 404,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "reason": "Not Found",
  "errorCode": "RESOURCE_NOT_FOUND"
}
Ejemplos de respuestas (500)
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}