Nombre	Tipo	Necesidad	Descripción	predeterminado
Num. de pág.	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
elementosPorPágina	Número	Opcional	Número de elementos a devolver por página, hasta un máximo de 500.	`100`
bonito	booleano	Opcional	Indicador que indica si el cuerpo de la respuesta debe estar en un prettyprint formato.	`false`
envelope	booleano	Opcional	Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes de 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. Para los endpoints que devuelven una lista de resultados, el objeto `content` es un sobre. Cloud Manager añade el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir los demonios que no están habilitados para hacer copias de seguridad de bases de datos de la respuesta. Establece esto en `false` para incluir las configuraciones del demonio con la bandera `backupJobsEnabled` establecida en `false`.	`true`

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

Respuesta

Cada documento en el arreglo result representa una factura. Los cargos suelen publicarse al día siguiente.

Nombre

Tipo

Descripción

amountBilledCents

Número

Importe facturado en esta factura, calculado como subtotalCents + salesTaxCents - startingBalanceCents.

amountPaidCents

Número

Cantidad pagada por esta factura, en centavos de dólar estadounidenses.

created

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se creó esta factura.

creditsCents

Número

Cantidad acreditada por MongoDB, en centavos de dólar estadounidenses.

endDate

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando finalizó el período de facturación de esta factura.

id

string

Identificador único de esta factura.

links

objeto arreglo

Uno o más enlaces a subrecursos y/o recursos relacionados. Los tipos de relación entre las URLs se explican en la Especificación de Enlace Web.

groupId

string

Identificador único del proyecto con el que se asocia la factura. No aparece en todas las facturas.

orgId

string

Identificador único para la organización que recibió esta factura.

salesTaxCents

Número

Cantidad de impuestos cobrados sobre subtotalCents.

startDate

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC de la fecha de inicio de esta factura.

statusName

string

Estado de esta factura. Los valores aceptados son:

Estado	Descripción
`CLOSED`	Se han finalizado todos los cargos del ciclo de suscripción, el saldo es superior a cero y al cliente aún no se le ha cobrado.
`FAILED`	No se pudo realizar el cobro a la tarjeta de crédito por el monto adeudado.
`FORGIVEN`	Se ha cobrado al cliente, pero se ha perdonado el cargo.
`FREE`	El monto resultó ser cero, por lo que no se cobra al cliente.
`PAID`	Los fondos han sido transferidos a MongoDB, Inc.
`PENDING`	Incluye cargos para el ciclo de suscripción actual. Un cliente nunca debe tener más de una factura en este estado.
`PREPAID`	El cliente tiene un plan prepago, por lo que no se le cobra nada.

subtotalCents

Número

Suma de todas las partidas de facturas positivas en centavos de USD.

updated

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se actualizó por última vez la factura.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true"

Respuesta de ejemplo

{
   "links" : [ {
     "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true&pageNum=1&itemsPerPage=100",
     "rel" : "self"
   } ],
   "results" : [ {
     "amountBilledCents" : 0,
     "amountPaidCents" : 0,
     "created" : "2018-06-01T04:05:10Z",
     "endDate" : "2018-07-01T00:00:00Z",
     "id" : "{INVOICE-ID}",
     "links" : [ {
       "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}",
       "rel" : "self"
     } ],
     "orgId" : "{ORG-ID}",
     "salesTaxCents" : 0,
     "startDate" : "2018-06-01T00:00:00Z",
     "startingBalanceCents" : 0,
     "statusName" : "PENDING",
     "subtotalCents" : 0,
     "updated" : "2018-06-01T04:05:10Z"
   }, {
     "amountBilledCents" : 726,
     "amountPaidCents" : 726,
     "created" : "2018-02-01T06:05:04Z",
     "endDate" : "2018-03-01T00:00:00Z",
     "id" : "{INVOICE-ID}",
     "links" : [ {
       "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}",
       "rel" : "self"
     } ],
     "orgId" : "{ORG-ID}",
     "salesTaxCents" : 57,
     "startDate" : "2018-02-01T00:00:00Z",
     "startingBalanceCents" : 0,
     "statusName" : "PAID",
     "subtotalCents" : 669,
     "updated" : "2018-03-01T07:00:54Z"
   } ],
   "totalCount" : 16
}

Volver

Facturas

Obtenga uno