> ## Documentation Index > Fetch the complete documentation index at: https://docs.roofkit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Exportar reporte > Genera una exportación de reporte desde la revisión solicitada, o desde la revisión fallback aprobada/actual cuando se omite revision_id. Las exportaciones PDF requieren `reports.export_pdf`; los formatos técnicos requieren `reports.export_technical`. **Scope requerido por formato:** `pdf`: `reports.export_pdf`, `technical`: `reports.export_technical` ## OpenAPI ````yaml /es/api-reference/openapi.yaml post /api/v1/reports/{report_id}/export openapi: 3.1.0 info: title: RoofKit Partner API version: 1.0.0 summary: API REST JSON para integraciones externas de socios de RoofKit. contact: name: RoofKit Engineering description: >- RoofKit Partner API v1 autentica solicitudes con API keys del workspace. Las API keys vinculan cada solicitud exactamente a un workspace; las rutas de Partner API no aceptan roofer_id, workspace_id ni identificadores de tenant. Los endpoints autenticados están limitados a 60 solicitudes por minuto por API key, método y plantilla de ruta; los intentos de autenticación inválidos se limitan por separado a 20 solicitudes por minuto por cliente y endpoint. Los parámetros y campos de fecha/hora aceptan ISO 8601 con Z o un desfase ±HH:MM, por ejemplo 2026-09-07T04:00:00Z o 2026-09-07T00:00:00-04:00. Ambos indican el mismo instante y devuelven el mismo resultado. Codifica + como %2B en una query string. Las respuestas usan UTC. Una fecha/hora sin desfase, por ejemplo 2026-09-07T04:00:00, está obsoleta. Hasta la fecha de retiro, 2027-01-10T00:00:00Z, se interpreta como UTC, y la respuesta incluye un header `Deprecation` (RFC 9745) y un header `Sunset` (RFC 8594). A partir de la fecha de retiro, se requiere Z o un desfase ±HH:MM. Desde entonces, una fecha/hora sin desfase devuelve 400 con el código `VALIDATION_ERROR`, y la respuesta no incluye ningún header `Deprecation` ni `Sunset`. Cada API key tiene solo los scopes que un propietario o administrador del workspace eligió al crear la key, y sus scopes nunca cambian. Cada operación indica los scopes que requiere en `x-required-scopes`. Una key nueva en Configuración empieza con el nivel predefinido Solo lectura: `leads.read`, `analytics.read`, `reports.read` y `data_objects.read`. Una key de Solo lectura puede llamar a todas las operaciones de lectura excepto las exportaciones, las lecturas de Sales Visualizer y los Data Objects en papelera, y no puede llamar a ninguna operación de escritura. Una llamada que necesita un scope que la key no tiene devuelve 403 `FORBIDDEN`, y `error.details.required_scope` indica un scope faltante. servers: - url: https://api.roofkit.ai description: Origen canónico de RoofKit Partner API security: - ApiKeyBearer: [] tags: - name: Foundation description: Endpoints base de autenticación y contrato. - name: Leads description: Endpoints de sincronización de leads para CRM de socios. - name: Attribution description: >- Endpoints de atribución de marketing, analíticas de campañas e ingesta de eventos para socios. - name: Pipeline description: Metadatos del pipeline de leads legibles para socios. - name: Reports description: >- Endpoints para importar, listar, obtener, exportar y descargar reportes de socios. - name: Visualizer description: >- Endpoints de Partner para crear Sales Visualizer, generar visualizaciones, crear enlaces alojados de subida de fotos, leer imágenes, consultar el historial de sesión y crear enlaces compartidos. - name: Estimates description: >- Creación y lectura de Budget Estimates de Partner para el workspace vinculado a la key. - name: Objects description: >- Endpoints de Partner para descubrimiento, esquema, registros, relaciones, vistas y administración de Data Objects. paths: /api/v1/reports/{report_id}/export: post: tags: - Reports summary: Exportar reporte description: >- Genera una exportación de reporte desde la revisión solicitada, o desde la revisión fallback aprobada/actual cuando se omite revision_id. Las exportaciones PDF requieren `reports.export_pdf`; los formatos técnicos requieren `reports.export_technical`. operationId: Export report parameters: - $ref: '#/components/parameters/ReportId' - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ReportExportRequest' responses: '201': description: Artefactos de exportación creados. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Idempotency-Replayed: $ref: '#/components/headers/IdempotencyReplayed' content: application/json: schema: $ref: '#/components/schemas/ReportExportResponse' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/ReportExportConflict' '422': $ref: '#/components/responses/ReportSnapshotInvalid' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: ReportId: name: report_id in: path required: true x-docs-test-value: report_123 schema: type: string minLength: 1 maxLength: 200 IdempotencyKey: name: Idempotency-Key in: header required: true description: >- Un valor único para cada solicitud nueva, como un UUID. Envíe el mismo valor para reintentar una solicitud de forma segura. La misma clave y el mismo payload repiten la primera respuesta con `Idempotency-Replayed: true`. schema: type: string minLength: 1 maxLength: 160 schemas: ReportExportRequest: type: object additionalProperties: false required: - format properties: revision_id: type: string maxLength: 200 format: type: string enum: - pdf - dxf - csv - xlsx - xml - zip audience: type: string description: >- Para quién es el PDF. Elige el conjunto de hojas de Entregar de la app y da nombre al archivo. Solo PDF. enum: - client - insurer - supplier - crew pdf_profile: type: string description: >- Anula el perfil de PDF del workspace para esta exportación. Solo PDF. enum: - client - production - custom csv_layout: type: string description: >- El CSV listo para estimados, con las cantidades agrupadas como las leen los estimados de seguros. Solo CSV. enum: - estimate ReportExportResponse: type: object additionalProperties: false required: - revision_id - exports properties: revision_id: type: string exports: type: array items: $ref: '#/components/schemas/ReportExportArtifact' ReportExportArtifact: type: object additionalProperties: false required: - export_id - report_id - revision_id - format - file_name - mime_type - size_bytes - checksum properties: export_id: type: string report_id: type: string revision_id: type: - string - 'null' format: $ref: '#/components/schemas/ReportArtifactFormat' role: type: string enum: - export - manifest file_name: type: string mime_type: type: string size_bytes: type: integer minimum: 0 checksum: type: string metadata: type: object additionalProperties: true created_at: type: string format: date-time download_url: type: string format: uri ErrorResponse: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message - request_id properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string request_id: type: string details: type: object additionalProperties: true ReportArtifactFormat: type: string enum: - xml - csv - xlsx - dxf - pdf - json - zip - manifest - tif - png - jpg - jpeg - webp - gif ErrorCode: type: string enum: - UNAUTHORIZED - FORBIDDEN - RATE_LIMITED - VALIDATION_ERROR - NOT_FOUND - CONFLICT - INSUFFICIENT_CREDITS - INTERNAL_ERROR headers: RateLimitLimit: description: Cantidad máxima de solicitudes permitidas en la ventana actual. schema: type: string RateLimitRemaining: description: Solicitudes restantes en la ventana actual. schema: type: string RateLimitReset: description: Timestamp ISO cuando se reinicia la ventana actual de rate limit. schema: type: string format: date-time IdempotencyReplayed: description: >- Presente y true cuando se reprodujo una respuesta de escritura exitosa almacenada. schema: type: string enum: - 'true' RetryAfter: description: Segundos hasta que el llamador debería reintentar. schema: type: string responses: ValidationError: description: El payload, query o header requerido de la solicitud no es válido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: API key ausente, malformada, revocada, eliminada o desconocida. headers: WWW-Authenticate: schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: >- La API key no tiene un scope requerido, o el workspace no está activo. Un fallo de scope indica un scope faltante en `details.required_scope`. Cuando la búsqueda de la key rechaza la llamada, `details.missing_scopes` lista cada scope requerido que la key no tiene. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_scope: summary: Una key de Solo lectura llama a una operación de escritura value: error: code: FORBIDDEN message: 'API key does not include the required scope: leads.write.' request_id: req_123 details: required_scope: leads.write missing_scopes: - leads.write NotFound: description: Recurso no encontrado en el workspace vinculado a la key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ReportExportConflict: description: >- La Idempotency-Key ya se usó con una solicitud diferente, o la revisión todavía no puede producir el archivo solicitado. El código es `CONFLICT`. Para un archivo bloqueado, `details.report_export_code` indica el motivo y `details.plane_ids` lista las caras de techo que se deben corregir. `technical_layout_orientation_unresolved` bloquea un formato técnico de un techo metálico mientras una cara no tenga dirección de corrida de paneles. `REPORT_PDF_FACE_PITCH_MISSING` bloquea un PDF para cliente o aseguradora mientras una cara no tenga pendiente. Corrige las caras en el editor de RoofKit y luego vuelve a exportar. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: pdf_face_pitch_missing: summary: Un PDF para cliente tiene una cara sin pendiente value: error: code: CONFLICT message: >- Face F3 has no pitch. Set a pitch on every face before you make a client or insurer PDF. request_id: req_123 details: report_export_code: REPORT_PDF_FACE_PITCH_MISSING plane_ids: - plane_3 technical_orientation_unresolved: summary: >- Una cara de techo metálico no tiene dirección de corrida de paneles value: error: code: CONFLICT message: >- Set the panel direction on every face before the technical export. request_id: req_123 details: report_export_code: technical_layout_orientation_unresolved plane_ids: - plane_1 - plane_2 ReportSnapshotInvalid: description: >- El snapshot almacenado de la revisión no coincide con el formato de reporte actual y no se puede leer. El código es `VALIDATION_ERROR`, y `details.report_export_code` es `REPORT_SNAPSHOT_INVALID`. Repara la revisión en el editor de RoofKit y luego vuelve a exportar. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimited: description: >- Rate limit excedido para esta key y endpoint o para el bucket de autenticación inválida. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalError: description: Error interno de autenticación o del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyBearer: type: http scheme: bearer bearerFormat: RoofKit API key description: 'Usa `Authorization: Bearer rk_live_...`.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.