Top receptores - e-Miti

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

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

Respuesta `200`

{
  "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.

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