> ## Documentation Index > Fetch the complete documentation index at: https://muveya.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Solicitar una exportación del resumen gerencial > Solicita una exportación CSV asíncrona del resumen gerencial, sin datos sensibles. Requiere analytics:read. Devuelve 202 con el trabajo en `pending` (o ya en `ready` cuando la exportación se ejecuta en el momento); consulta GET /v1/analytics/exports/{exportId} para obtener la URL de descarga firmada. El archivo solo trae conteos, cantidades y duraciones (sin costo, valor ni referencia de paciente) y es auditable (tenant, actor, período, instante, checksum). ## OpenAPI ````yaml /openapi.es.json post /v1/analytics/exports openapi: 3.1.0 info: description: >- La API pública para desarrolladores de Muveya: recursos /v1 de solo lectura, limitados a un tenant y autenticados con una clave de API opaca. Un presupuesto de solicitudes por clave. title: API para desarrolladores de Muveya version: 0.1.0 servers: - description: Producción url: https://api.muveya.com security: [] tags: - name: Clave de API - name: Clínicas - name: Bodegas - name: Catálogo - name: Inventario - name: Pedidos - name: Entregas - name: Analítica paths: /v1/analytics/exports: post: tags: - Analítica summary: Solicitar una exportación del resumen gerencial description: >- Solicita una exportación CSV asíncrona del resumen gerencial, sin datos sensibles. Requiere analytics:read. Devuelve 202 con el trabajo en `pending` (o ya en `ready` cuando la exportación se ejecuta en el momento); consulta GET /v1/analytics/exports/{exportId} para obtener la URL de descarga firmada. El archivo solo trae conteos, cantidades y duraciones (sin costo, valor ni referencia de paciente) y es auditable (tenant, actor, período, instante, checksum). operationId: requestAnalyticsExport parameters: - name: Accept-Language in: header required: false description: >- El idioma de las etiquetas de las cifras del CSV: en, es o pt (por defecto en), fijado al solicitar la exportación. Las claves de métrica, dimensiones, unidades, valores e ids de evidencia nunca cambian con él. schema: type: string requestBody: required: false content: application/json: schema: type: object additionalProperties: false properties: period: type: string enum: - daily - weekly description: >- La frecuencia del resumen gerencial que se exporta; por defecto daily. responses: '202': description: Se aceptó el trabajo de exportación. content: application/json: schema: $ref: '#/components/schemas/AnalyticsExport' headers: X-RateLimit-Limit: description: El presupuesto de solicitudes por clave en la ventana actual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitudes restantes en la ventana actual (0 cuando se agotan). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos hasta que se reinicie la ventana actual. schema: type: integer minimum: 1 RateLimit: description: >- Estado del presupuesto de solicitudes según el borrador de la IETF, por ejemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política según el borrador de la IETF, por ejemplo "120;w=60" (límite;segundos de la ventana). schema: type: string '400': description: El período no es daily ni weekly. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' headers: X-RateLimit-Limit: description: El presupuesto de solicitudes por clave en la ventana actual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitudes restantes en la ventana actual (0 cuando se agotan). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos hasta que se reinicie la ventana actual. schema: type: integer minimum: 1 RateLimit: description: >- Estado del presupuesto de solicitudes según el borrador de la IETF, por ejemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política según el borrador de la IETF, por ejemplo "120;w=60" (límite;segundos de la ventana). schema: type: string '401': description: >- La clave de API falta, no es válida, fue revocada, expiró o está vinculada a una clínica dental suspendida. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: La clave de API no tiene el scope que requiere esta ruta. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '429': description: >- La clave de API superó su límite de solicitudes en la ventana actual. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' headers: Retry-After: description: Segundos (valor positivo) hasta que se permita otra solicitud. schema: type: integer minimum: 1 X-RateLimit-Limit: description: El presupuesto de solicitudes por clave en la ventana actual. schema: type: integer minimum: 1 X-RateLimit-Remaining: description: Solicitudes restantes en la ventana actual (0 cuando se agotan). schema: type: integer minimum: 0 X-RateLimit-Reset: description: Segundos hasta que se reinicie la ventana actual. schema: type: integer minimum: 1 RateLimit: description: >- Estado del presupuesto de solicitudes según el borrador de la IETF, por ejemplo "limit=120, remaining=119, reset=60". schema: type: string RateLimit-Policy: description: >- Política según el borrador de la IETF, por ejemplo "120;w=60" (límite;segundos de la ventana). schema: type: string security: - apiKeyBearer: [] components: schemas: AnalyticsExport: type: object additionalProperties: false required: - exportId - status - reportType - period properties: exportId: type: string description: El identificador opaco para consultar el trabajo de exportación. status: type: string enum: - pending - building - ready - failed reportType: type: string enum: - briefing period: type: string enum: - daily - weekly byteSize: type: integer description: Tamaño del archivo generado en bytes; aparece cuando está listo. checksum: type: string description: >- SHA-256 en hexadecimal del archivo sin datos sensibles, el checksum de FR-AUD-02; aparece cuando está listo. error: type: string description: >- Un código de motivo legible por máquina y no sensible; solo aparece cuando el trabajo falló. downloadUrl: type: string description: >- Una URL de descarga firmada de corta duración; solo aparece cuando está lista y se genera de nuevo en cada consulta. downloadExpiresAt: type: string format: date-time description: Cuándo deja de funcionar la URL de descarga actual. ProblemDetails: type: object additionalProperties: false required: - type - title - status - detail - instance - code - requestId properties: type: type: string format: uri title: type: string status: type: integer minimum: 400 maximum: 599 detail: type: string instance: type: string code: type: string requestId: type: string securitySchemes: apiKeyBearer: type: http scheme: bearer bearerFormat: opaque description: >- Clave de API opaca mvy_test_ enviada como token Bearer. El servidor deriva de ella exactamente una clínica dental; la ruta nunca lleva un selector de clínica dental. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.