> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.sellercenter.pe/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.sellercenter.pe/_mcp/server.

# Detalle de orden

GET https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/{orderId}

Detalle completo de una orden.

### Campos clave

| Campo                                               | Descripción                                                                                                                                                     |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                                | Número de orden.                                                                                                                                                |
| `status`                                            | Estado actual (ver la tabla de estados en la guía [Órdenes](/guias/ordenes)).                                                                                   |
| `creationDate`                                      | Fecha de creación.                                                                                                                                              |
| `marketplace.name`                                  | Ecommerce donde se compró (Promart, Oechsle, plazaVea…).                                                                                                        |
| `items[].id`                                        | **Id del SKU** vendido.                                                                                                                                         |
| `items[].quantity` / `items[].price`                | Cantidad y precio unitario.                                                                                                                                     |
| `items[].commission`                                | Comisión referencial (la definitiva se calcula en la liquidación).                                                                                              |
| `items[].priceTags[]`                               | Descuentos aplicados. `promotionUserType`: `SELLER` (asumido por ti) o `ADMIN` (asumido por el marketplace).                                                    |
| `clientProfileData`                                 | Datos del cliente. El teléfono viene enmascarado. `isCorporate: true` si solicitó **factura** (ver `corporateName` y `corporateDocument` = RUC).                |
| `shippingData.address`                              | Dirección de entrega, **enmascarada** salvo `receiverName`. Los datos completos llegan en el webhook `ORDER_READY_FOR_HANDLING`. `postalCode` es el **ubigeo**. |
| `shippingData.logisticsInfo[].selectedSla`          | Empieza con `Envío a domicilio` o `Retiro en tienda`, seguido de un id entre paréntesis.                                                                        |
| `shippingData.logisticsInfo[].deliveryCompany`      | Tipo de despacho asignado (p. ej. `ENVIO DD LIMA`).                                                                                                             |
| `shippingData.logisticsInfo[].shippingEstimateDate` | Fecha límite de entrega.                                                                                                                                        |
| `value` / `totals[]`                                | Total pagado y su desglose (items, descuentos, envío).                                                                                                          |
| `controversies[]`                                   | Controversias abiertas (ver tipos en [Webhooks](/guias/webhooks)).                                                                                              |
| `updateHistory[]`                                   | Historial de cambios de estado.                                                                                                                                 |
| `paymentMethod`                                     | Medio de pago.                                                                                                                                                  |
| `paymentProof`                                      | Nombre del comprobante subido (`<orderId>-<AAAAMMDDHHmm>.pdf`); `null` si aún no se sube.                                                                       |

Reference: https://developers.sellercenter.pe/referencia-de-la-api/ordenes/detalle-de-orden

## Authentication

- `Authorization` header (bearer token, required) — `accessToken` obtenido en **Login**. Dura 24 horas.

## Servers

- `https://inretailqa.mysellercenter.com/sellercenter/api/v1` (QA, default)
- `https://inretail.mysellercenter.com/sellercenter/api/v1` (PRD)

## Request

### Path parameters

- `orderId` (string, required) — Número de orden.

## Response

### 200

Orden lista para atender

- `id` (string, optional)
- `marketplacePaymentValue` (double, optional)
- `items` (list of OrdersOrderIdGetResponsesContentApplicationJsonSchemaItemsItems, optional)
- `clientProfileData` (OrdersOrderIdGetResponsesContentApplicationJsonSchemaClientProfileData, optional)
- `shippingData` (OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingData, optional)
- `openTextField` (any, optional)
- `creationDate` (string, optional)
- `status` (string, optional)
- `packageAttachment` (any, optional)
- `value` (double, optional)
- `totals` (list of OrdersOrderIdGetResponsesContentApplicationJsonSchemaTotalsItems, optional)
- `accountName` (string, optional)
- `controversies` (any, optional)
- `liquidated` (any, optional)
- `punishment` (any, optional)
- `marketplace` (OrdersOrderIdGetResponsesContentApplicationJsonSchemaMarketplace, optional)
- `tags` (list of any, optional)
- `updateDate` (string, optional)
- `updateHistory` (list of OrdersOrderIdGetResponsesContentApplicationJsonSchemaUpdateHistoryItems, optional)
- `paymentMethod` (string, optional)
- `paymentProof` (any, optional)

## Errors

### 400 Bad Request Error

Orden inexistente o de otro seller

- `message` (string, optional)

## Types

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaItemsItems

- `id` (string, optional)
- `productId` (string, optional)
- `categoryId` (string, optional)
- `quantity` (double, optional)
- `seller` (string, optional)
- `price` (double, optional)
- `measurementUnit` (string, optional)
- `unitMultiplier` (double, optional)
- `isGift` (boolean, optional)
- `name` (string, optional)
- `commission` (double, optional)
- `priceTags` (list of any, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaClientProfileData

- `id` (any, optional)
- `email` (string, optional)
- `firstName` (string, optional)
- `lastName` (string, optional)
- `documentType` (string, optional)
- `document` (string, optional)
- `phone` (string, optional)
- `corporateName` (any, optional)
- `tradeName` (any, optional)
- `corporateDocument` (any, optional)
- `stateInscription` (any, optional)
- `corporatePhone` (any, optional)
- `isCorporate` (boolean, optional)
- `userProfileId` (any, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingData

- `id` (any, optional)
- `address` (OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingDataAddress, optional)
- `logisticsInfo` (list of OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingDataLogisticsInfoItems, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaTotalsItems

- `id` (string, optional)
- `name` (string, optional)
- `value` (double, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaMarketplace

- `id` (string, optional)
- `name` (string, optional)
- `accountName` (string, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaUpdateHistoryItems

- `id` (string, optional)
- `user` (any, optional)
- `date` (string, optional)
- `status` (string, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingDataAddress

- `addressType` (string, optional)
- `receiverName` (string, optional)
- `addressId` (string, optional)
- `postalCode` (string, optional)
- `city` (string, optional)
- `state` (string, optional)
- `country` (string, optional)
- `street` (string, optional)
- `number` (string, optional)
- `neighborhood` (string, optional)
- `complement` (string, optional)
- `reference` (string, optional)

### OrdersOrderIdGetResponsesContentApplicationJsonSchemaShippingDataLogisticsInfoItems

- `itemIndex` (double, optional)
- `selectedSla` (string, optional)
- `lockTTL` (string, optional)
- `shippingEstimate` (string, optional)
- `price` (double, optional)
- `deliveryWindow` (any, optional)
- `deliveryCompany` (string, optional)
- `shippingEstimateDate` (string, optional)
- `selectedDeliveryChannel` (string, optional)
- `collectionDate` (any, optional)
- `sellerType` (any, optional)

## Examples

**Response**

```json
{
  "id": "1671730516377-01",
  "marketplacePaymentValue": 504.9,
  "items": [
    {
      "id": "1791571082273",
      "productId": "1791571080770",
      "categoryId": "YbC223HTMKzUKWRI95_a",
      "quantity": 1,
      "seller": "1",
      "price": 489.9,
      "measurementUnit": "un",
      "unitMultiplier": 1,
      "isGift": false,
      "name": "Zapatillas Running Nike Air Winflo 12 Azul Nike Air Winflo 12 Azul - Talla 7",
      "commission": 0,
      "priceTags": []
    }
  ],
  "clientProfileData": {
    "email": "cliente@correo.com",
    "firstName": "Juan",
    "lastName": "Pérez",
    "documentType": "dni",
    "document": "77777777",
    "phone": "+51999999999",
    "isCorporate": false
  },
  "shippingData": {
    "address": {
      "addressType": "residential",
      "receiverName": "Juan Pérez",
      "addressId": "casa",
      "postalCode": "150122",
      "city": "Lima",
      "state": "Lima",
      "country": "PER",
      "street": "Av. Ejemplo",
      "number": "123",
      "neighborhood": "Miraflores",
      "complement": "Dpto. 401",
      "reference": "Frente al parque"
    },
    "logisticsInfo": [
      {
        "itemIndex": 0,
        "selectedSla": "Envío a domicilio(wG8uy4QBU0PKXr-ggChM)",
        "lockTTL": "15d",
        "shippingEstimate": "7bd",
        "price": 15,
        "deliveryCompany": "ENVIO DD LIMA",
        "shippingEstimateDate": "2026-11-04T16:12:28",
        "selectedDeliveryChannel": "delivery"
      }
    ]
  },
  "creationDate": "2026-10-26T16:12:28",
  "status": "ready-for-handling",
  "value": 504.9,
  "totals": [
    {
      "id": "Items",
      "name": "Total de los items",
      "value": 489.9
    },
    {
      "id": "Discounts",
      "name": "Total de descuentos",
      "value": 0
    },
    {
      "id": "Shipping",
      "name": "Costo total del envío",
      "value": 15
    },
    {
      "id": "Tax",
      "name": "Costo total del cambio",
      "value": 0
    }
  ],
  "accountName": "TRIATHLON",
  "marketplace": {
    "id": "qaoechsle",
    "name": "Oechsle QA",
    "accountName": "qaoechsle"
  },
  "tags": [],
  "updateDate": "2026-10-26T16:13:08",
  "updateHistory": [
    {
      "id": "1671730516377-01",
      "date": "2026-10-26T16:12:28",
      "status": "payment-pending"
    },
    {
      "id": "1671730516377-01",
      "date": "2026-10-26T16:13:08",
      "status": "ready-for-handling"
    }
  ],
  "paymentMethod": "Contra Entrega - TARJETA OH"
}
```

**SDK Code**

```python Ordenes_detalleDeOrden_example
import requests

url = "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Ordenes_detalleDeOrden_example
const url = 'https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Ordenes_detalleDeOrden_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Ordenes_detalleDeOrden_example
require 'uri'
require 'net/http'

url = URI("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Ordenes_detalleDeOrden_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Ordenes_detalleDeOrden_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Ordenes_detalleDeOrden_example
using RestSharp;

var client = new RestClient("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Ordenes_detalleDeOrden_example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders/1673830516396-01")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```