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

# Top receptores

> Ranking de receptores con más facturación en el mes en curso.

`GET /v1/de/top-receptores`

Devuelve el ranking de receptores (clientes) con mayor facturación en el mes en curso, ordenado descendente por monto total. Útil para dashboards de negocio.

## Cuándo usarlo

* Widget "Top clientes" en la pantalla principal.
* Reportes de concentración de facturación por cliente.

## Query params

| Parámetro | Tipo | Default | Descripción |
| - | - | - | - |
| `sit` | `H / P` | Ambos | Ambiente: homologación o producción. Sin valor, incluye ambos. |
| `limit` | `integer` (1-50) | `5` | Cantidad de receptores a devolver. |

El rango es fijo: desde el 1ro del mes en curso (hora paraguaya) hasta hoy. Sólo cuenta documentos aprobados (`estado='A'`).

## Ejemplo

```bash theme={null}
curl "https://api.emiti.fravelabs.com/v1/de/top-receptores?limit=5" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Respuesta `200`

```json theme={null}
{
  "receptores": [
    { "nombre": "ACME S.A.", "ruc": "80012345-6", "cantidad": 12, "monto_total": "4500000.00" },
    { "nombre": "Beta S.R.L.", "ruc": "80099999-1", "cantidad": 7, "monto_total": "2100000.00" }
  ]
}
```

## Campos de la respuesta

| Campo | Tipo | Descripción |
| - | - | - |
| `receptores` | `array` | Lista ordenada descendente por `monto_total`, tamaño máximo `limit`. |
| `receptores[].nombre` | `string` | Razón social del receptor (snapshot del DE). |
| `receptores[].ruc` | `string \| null` | RUC del receptor. `null` si el receptor no es contribuyente. |
| `receptores[].cantidad` | `integer` | Cantidad de DEs aprobados emitidos a ese receptor en el rango. |
| `receptores[].monto_total` | `string` (decimal) | Suma de totales de los DEs aprobados a ese receptor. |

<Note>
  Sólo cuenta DEs en estado `A` (aprobados) — mismo criterio que `/v1/de/summary`.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.