> ## 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. # Obtener un pedido > Lee un pedido con sus líneas. Requiere orders:read. El valor del pedido y la referencia de paciente se omiten; el costo de las líneas requiere catalog.cost:read. 404 cuando no existe o pertenece a otra clínica dental. ## OpenAPI ````yaml /openapi.es.json get /v1/orders/{orderId} 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/orders/{orderId}: get: tags: - Pedidos summary: Obtener un pedido description: >- Lee un pedido con sus líneas. Requiere orders:read. El valor del pedido y la referencia de paciente se omiten; el costo de las líneas requiere catalog.cost:read. 404 cuando no existe o pertenece a otra clínica dental. operationId: getOrder parameters: - name: orderId in: path required: true description: El id opaco del pedido. schema: type: string responses: '200': description: El recurso solicitado. content: application/json: schema: $ref: '#/components/schemas/Order' 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' '404': description: El recurso no existe en esta clínica dental. 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: Order: type: object additionalProperties: false required: - orderId - number - type - status - requesterId - clinicId - destinationWarehouseId - lines - version properties: orderId: type: string number: type: integer type: type: string enum: - general - clinical status: type: string enum: - draft - submitted - pending_approval - approved - rejected - cancelled - allocated - picking - dispatched - delivered - exception - received - partially_fulfilled - closed requesterId: type: string clinicId: type: string destinationWarehouseId: type: string preferredSourceWarehouseId: type: string justification: type: string patientRef: type: string description: >- Se omite (no aparece) salvo que la clave tenga orders.patient_ref:read (nunca en /v1). lines: type: array items: $ref: '#/components/schemas/OrderLine' value: type: integer description: >- Total del pedido en unidades menores de la moneda. Solo aparece con orders.value:read (nunca en /v1). currency: type: string approvalPlan: $ref: '#/components/schemas/OrderApprovalPlan' version: type: integer 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 OrderLine: type: object additionalProperties: false required: - lineId - catalogItemId - sku - name - requestedQty - unitOfMeasure - category - highValue properties: lineId: type: string catalogItemId: type: string sku: type: string name: type: string requestedQty: type: integer unitOfMeasure: type: string category: type: string highValue: type: boolean unitCost: type: integer description: Solo aparece con el scope catalog.cost:read. currency: type: string OrderApprovalPlan: type: object additionalProperties: false required: - policyVersion - requiresApproval - steps properties: policyVersion: type: integer requiresApproval: type: boolean steps: type: array items: type: object additionalProperties: false required: - stage - requiredScope - minApprovers properties: stage: type: string requiredScope: type: string minApprovers: type: integer evaluatedValue: type: integer description: Solo aparece con el scope orders.value:read. currency: 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.