> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Extracto de uso

> La factura con detalle del período: cada instancia, el número, los días y los importes

Esta página documenta el **extracto de uso**, la factura con detalle de un período. Donde el [Consumo](/es/enterprise/usage) muestra el total del ciclo en curso, el extracto lo desglosa línea por línea: cada instancia que tuvo período facturable en la ventana, el número que estuvo conectado, cuántos días contaron, el precio unitario y el importe, más los totales de uso, crédito y cobro.

## Extracto detallado

**`GET /api/account/billing/statement?from=<rfc3339>&to=<rfc3339>`**

Devuelve el extracto de una ventana. Autentique con el **TokenAccount** de la cuenta, o con el token global pasando `?account=<nombre-de-la-cuenta>`. Los parámetros `from` y `to` son obligatorios, en formato RFC3339.

<ParamField query="from" type="string" required>
  Inicio de la ventana, en RFC3339 (ej. `2026-08-01T00:00:00Z`).
</ParamField>

<ParamField query="to" type="string" required>
  Fin de la ventana, en RFC3339 (ej. `2026-09-01T00:00:00Z`).
</ParamField>

<ParamField query="account" type="string">
  Nombre de la cuenta. Obligatorio solo cuando usa el token global. Con el TokenAccount, la cuenta ya viene del propio token.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://ryzeapi.cloud/api/account/billing/statement?from=2026-08-01T00:00:00Z&to=2026-09-01T00:00:00Z" \
    -H "token: $Token_Account"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    from: "2026-08-01T00:00:00Z",
    to: "2026-09-01T00:00:00Z"
  });

  await fetch(`https://ryzeapi.cloud/api/account/billing/statement?${params}`, {
    headers: { "token": process.env.Token_Account }
  });
  ```

  ```python Python theme={null}
  import os, requests

  requests.get(
      "https://ryzeapi.cloud/api/account/billing/statement",
      headers={"token": os.environ["Token_Account"]},
      params={"from": "2026-08-01T00:00:00Z", "to": "2026-09-01T00:00:00Z"}
  )
  ```
</CodeGroup>

```json 200 OK theme={null}
{
  "items": [
    {
      "instanceName": "cliente-acme",
      "numberJid": "5511999998888@s.whatsapp.net",
      "billableFrom": "2026-08-01T00:00:00Z",
      "billableTo": "2026-09-01T00:00:00Z",
      "days": 31,
      "unitPriceCents": 5000,
      "amountCents": 5000
    },
    {
      "instanceName": "cliente-beta",
      "numberJid": "5511988887777@s.whatsapp.net",
      "billableFrom": "2026-08-15T00:00:00Z",
      "billableTo": "2026-09-01T00:00:00Z",
      "days": 17,
      "unitPriceCents": 5000,
      "amountCents": 2741
    }
  ],
  "peakInstances": 2,
  "usageCents": 7741,
  "creditCents": 50000,
  "overageCents": 0,
  "totalChargedCents": 50000,
  "cycleStart": "2026-08-01T00:00:00Z",
  "cycleEnd": "2026-09-01T00:00:00Z"
}
```

## Campos de la respuesta

<ResponseField name="items" type="array">
  Los detalles del período, una línea por instancia que tuvo período facturable en la ventana. Una instancia eliminada a mitad del período sigue apareciendo, con el nombre y el número que tenía, porque el registro sobrevive a la eliminación. Vea [Cómo funciona el cobro](/es/enterprise/how-billing-works).

  <Expandable title="campos de cada ítem">
    <ResponseField name="instanceName" type="string">
      Nombre de la instancia en el período.
    </ResponseField>

    <ResponseField name="numberJid" type="string">
      El número de WhatsApp que estuvo conectado a la instancia en el período.
    </ResponseField>

    <ResponseField name="billableFrom" type="string">
      Inicio del período facturable dentro de la ventana.
    </ResponseField>

    <ResponseField name="billableTo" type="string">
      Fin del período facturable dentro de la ventana.
    </ResponseField>

    <ResponseField name="days" type="integer">
      Días facturables del ítem en la ventana.
    </ResponseField>

    <ResponseField name="unitPriceCents" type="integer">
      Precio unitario mensual aplicado, en centavos. Definido por el tramo de volumen de su contrato en el pico de instancias del período.
    </ResponseField>

    <ResponseField name="amountCents" type="integer">
      El importe del ítem, en centavos, proporcional a los días: `unitPriceCents` por `days` dividido por los días del período.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="peakInstances" type="integer">
  Pico de instancias simultáneas en cobro en la ventana. Es lo que define el tramo de precio unitario.
</ResponseField>

<ResponseField name="usageCents" type="integer">
  La suma de los `amountCents` de todos los ítems, en centavos. El uso del período.
</ResponseField>

<ResponseField name="creditCents" type="integer">
  El crédito incluido en su contrato para el período, en centavos. Es el piso de la factura.
</ResponseField>

<ResponseField name="overageCents" type="integer">
  Cuánto pasó el uso del crédito, en centavos: el mayor entre `0` y `usageCents` menos `creditCents`. Queda `0` cuando el uso cabe en el crédito.
</ResponseField>

<ResponseField name="totalChargedCents" type="integer">
  El total cobrado en el período, en centavos: el mayor entre `creditCents` y `usageCents`. Es decir, nunca paga por debajo del crédito, y paga el uso cuando supera el crédito.
</ResponseField>

<ResponseField name="cycleStart" type="string">
  Inicio de la ventana consultada.
</ResponseField>

<ResponseField name="cycleEnd" type="string">
  Fin de la ventana consultada.
</ResponseField>

<Note>
  ¿Necesita un documento listo para enviar a su cliente? En el panel, en **`/settings`**, pestaña **Facturas y uso**, descarga el extracto del período formateado en PDF, y también sus facturas en PDF.
</Note>

## Siguiente

<CardGroup cols={2}>
  <Card title="Historial de conexiones" icon="link" href="/es/enterprise/connections">
    La línea de tiempo de cuándo estuvo conectado cada número.
  </Card>

  <Card title="Cómo funciona el cobro" icon="calculator" href="/es/enterprise/how-billing-works">
    Crédito, prueba y el modelo comprometido en detalle.
  </Card>
</CardGroup>