# Obtener la lista de pedidos del periodo especificado

Recupera la lista de pedidos, ordenados de la fecha de creación más antigua a la más reciente.

Endpoint: POST /v3/project/{project_id}/admin/order/search
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
    Example: 44056

## Request fields (application/json):

  - `created_date_from` (string)
    Fecha de inicio o fecha-hora del periodo de creación de pedidos de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-15T18:16:00+05:00"

  - `created_date_until` (string)
    Fecha final o fecha-hora del periodo de creación de pedidos de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-16T18:16:00+05:00"

  - `limit` (integer)
    Un límite en la cantidad de pedidos incluidos en la respuesta.

  - `offset` (integer)
    Número del pedido a partir del cual se genera la lista (el conteo empieza desde el 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Si hay páginas adicionales.
    Example: true

  - `orders` (array)
    Lista de pedidos.

  - `orders.coupons` (array,null)
    Lista de cupones aplicada al pedido.

  - `orders.coupons.code` (string)
    Código de cupón utilizado. Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.

  - `orders.coupons.coupon_id` (integer)
    ID del cupón, generado por Xsolla al crear una promoción con un cupón.

  - `orders.coupons.sku` (string)
    SKU del cupón, generado por Xsolla al crear una promoción con un cupón.

  - `orders.coupons.type` (string)
    Tipo de cupón.
    Enum: "unique_catalog_offer", "coupon", "promocode"

  - `orders.date_created` (string)
    Fecha de creación del pedido o código fecha-hora de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-08-11T10:00:00+03:00"

  - `orders.invoice_id` (string)
    ID de factura.

  - `orders.is_free` (boolean)
    Si el pedido es gratuito.

  - `orders.items` (array)
    Lista de artículos.

  - `orders.items.description` (object,null)
    Objeto con información sobre el artículo.

  - `orders.items.description.description` (string)
    Descripción del artículo.

  - `orders.items.description.image_url` (string)
    URL de la imagen del artículo.

  - `orders.items.description.name` (string)
    Nombre del artículo.

  - `orders.items.is_bonus` (boolean)
    Si el artículo es una bonificación.

  - `orders.items.is_free` (boolean)
    Si el artículo es gratuito.

  - `orders.items.item_id` (integer)
    ID del artículo. Lo genera Xsolla al crear un artículo.
    Example: 1

  - `orders.items.order_item_id` (integer)
    ID del artículo en el pedido. Lo genera Xsolla durante la creación del pedido.

  - `orders.items.price` (object,null)
    Precio del artículo.

  - `orders.items.price.amount` (string)
    Precio del artículo con descuento.
    Example: "30"

  - `orders.items.price.amount_without_discount` (string)
    Precio del artículo sin descuentos.
    Example: "30"

  - `orders.items.price.currency` (string)
    SKU de moneda virtual o código de tres letras conforme a la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) Consulte la documentación para obtener información detallada sobre las [monedas admitidas por Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `orders.items.price.is_virtual_currency` (boolean)
    Si la moneda es virtual.

  - `orders.items.quantity` (integer)
    Cantidad del artículo.
    Example: 1

  - `orders.items.region_id` (integer,null)
    ID de la región en la que está disponible el artículo. Consulte la [documentación](https://developers.xsolla.com/es/doc/shop-builder/features/regional-restrictions/) para obtener más información sobre las restricciones de venta regionales.

  - `orders.items.sku` (string)
    ID del artículo especificado durante su creación. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "elven_shield"

  - `orders.items.tax_category` (string)
    Categoría fiscal.
    Example: "DG00002"

  - `orders.items.type` (string)
    Tipo de artículo.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good", "value_point"

  - `orders.mode` (string)
    Modo de creación de pedidos.
    Enum: "default", "sandbox"

  - `orders.order_id` (integer)
    ID del pedido.
    Example: 1

  - `orders.price` (object,null)
    Precio del pedido.

  - `orders.price.amount` (string)
    Precio final del pedido.
    Example: "30"

  - `orders.price.amount_without_discount` (string)
    Precio de pedido sin descuentos.
    Example: "30"

  - `orders.price.currency` (string)
    SKU de moneda virtual o código de tres letras de moneda real conforme a la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) Consulte la documentación para obtener información detallada sobre [monedas admitidas por Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/) .
    Example: "USD"

  - `orders.project_id` (integer)
    ID del proyecto. Encontrará este parámetro en su [Cuenta del editor](https://publisher.xsolla.com/) junto al nombre del proyecto.
    Example: 44056

  - `orders.promotions` (array,null)
    Lista de promociones aplicada al pedido.

  - `orders.promotions.promotion_id` (integer)
    ID de promoción dentro del proyecto.
    Example: 111425

  - `orders.status` (string)
    Estado del pedido.
    Enum: "new", "paid", "done", "canceled", "expired"

  - `orders.user` (object)

  - `orders.user.country` (string)
    Código de país de dos letras mayúsculas de conformidad con la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Consulte la documentación para obtener información detallada sobre los [países que admite Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).
    Example: "US"

  - `orders.user.email` (string)
    Correo electrónico del usuario formateado conforme al protocolo [RFC 822](https://www.w3.org/Protocols/rfc822/#z8).
    Example: "user@xsolla.com"

  - `orders.user.id` (string)
    ID de usuario transmitido al crear el pedido.
    Example: "07e653a2b15011e6818f005056a54369"

  - `orders.user.region_id` (integer,null)
    ID de región del usuario. Se devuelve si se han establecido restricciones regionales de venta. El país del usuario, transmitido al crear el pedido, se coteja con la lista de países especificada al [crear la región](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-region/). Consulte la [documentación](https://developers.xsolla.com/es/doc/shop-builder/features/regional-restrictions/) para obtener más información sobre las restricciones de ventas regionales.
    Example: 12

  - `total_items_count` (integer)
    El número total de pedidos durante el periodo de tiempo especificado.
    Example: 1

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401