---
title: "Obtener pedido"
method: GET
path: "/api/v1/orders/{order_id}"
tags: ["API"]
---

# Obtener pedido

`GET /api/v1/orders/{order_id}`

Devuelve el detalle persistido de un pedido de comercio.

## Path parameters

- `order_id` string, uuid, required

## Response `200`

Pedido obtenido exitosamente

- ApiOrderDetailResponse
  - `request_id` string, required
  - `data` ApiSharedObject1cf33bb430, required
    - `object` 'order', required
    - `id` string, uuid, required
    - `order_number` string, required
    - `raw_order_number` integer, required
    - `order_date` string, date-time, required
    - `customer_id` string, uuid, required
    - `customer_name` string, required
    - `customer_tax_id` string, nullable, required
    - `items_count` integer, required
    - `total_units` integer, required
    - `discount_amount` integer, required
    - `subtotal` integer, required
    - `tax_amount` integer, required
    - `total` integer, required
    - `currency` 'PES' | 'DOL', required
    - `order_status` 'open' | 'completed' | 'cancelled', required
    - `preparation_status` 'unfulfilled' | 'in_progress' | 'partially_fulfilled' | 'fulfilled' | 'cancelled', required
    - `invoicing_status` 'pending' | 'partially_invoiced' | 'invoiced', required
    - `notes` string, nullable, required
    - `created_at` string, date-time, required
    - `created_by_name` string, required
    - `created_by` string, uuid, required
    - `line_items` ApiSharedObject57439fd94e[], required
      - `id` string, uuid, required
      - `line_number` integer, required
      - `product_id` string, uuid, nullable, required
      - `product_name` string, required
      - `sku` string, required
      - `ordered_quantity` integer, required
      - `allocated_quantity` integer, required
      - `fulfilled_quantity` integer, required
      - `invoiced_quantity` integer, required
      - `cancelled_quantity` integer, required
      - `unit_price` integer, required
      - `tax_rate_id` integer, required
      - `discount_amount` integer, nullable, required
      - `discount_percentage` number, nullable, required
      - `subtotal` integer, required
    - `active_warehouses` ApiSharedObject6e2450633e[], required
      - `id` string, uuid, required
      - `name` string, required
      - `is_default` boolean, required
    - `pending_preparation_warehouse_id` string, uuid, nullable, required
    - `preparations` ApiSharedObjectc7aa334b79[], required
      - `object` 'order_preparation', required
      - `id` string, uuid, required
      - `prepared_at` string, date-time, required
      - `warehouse_name` string, required
      - `delivery_method` 'shipping' | 'local_delivery' | 'pickup', required
      - `remito_delivery_id` string, uuid, nullable, required
      - `formatted_remito_number` string, nullable, required
      - `lines` ApiSharedObjectb1bb980a27[], required
        - `id` string, uuid, required
        - `order_line_id` string, uuid, required
        - `product_id` string, uuid, nullable, required
        - `product_name` string, required
        - `sku` string, required
        - `variant_options` object, nullable, required
        - `option_names` string[], nullable, required
        - `quantity` integer, required
        - `ordered_quantity` integer, required
        - `unit_price` integer, required
        - `discount_percentage` number, nullable, required
    - `invoices` ApiSharedObject4fb237ae51[], required
      - `object` 'order_invoice', required
      - `id` string, uuid, required
      - `formatted_invoice_number` string, nullable, required
      - `invoice_date` string, required
      - `created_at` string, date-time, required
      - `invoice_status` 'not_required' | 'pending' | 'issued', required
      - `items_count` integer, required
      - `total_units` integer, required
      - `total` integer, required

## Other responses

- `400` — Solicitud inválida
- `401` — API key faltante o inválida
- `403` — Scopes insuficientes
- `404` — Pedido no encontrado
- `409` — Conflicto de idempotencia o de negocio
- `429` — Límite de solicitudes excedido para la organización
- `500` — Error interno del servidor

---

[API](https://skmtc.net/lapyme/apis/la-pyme-api.md) · [All operations](https://skmtc.net/lapyme/apis/la-pyme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lapyme/la-pyme-api/versions/414f57f28498/schema)