ReferenciaÓrdenesConsultar Items
GET
Consultar Items
Endpoint
https://sellercenter-api.falabella.com/?Action=GetOrderItemsGetOrderItems. A través de un OrderId devuelve en detalle los artículos asociados de una orden.
GETConsultar Items
?Action=GetOrderItemscurl -G "https://sellercenter-api.falabella.com/" \--data-urlencode "Action=GetOrderItems" \--data-urlencode "OrderId=1" \--data-urlencode "Format=XML" \--data-urlencode "Timestamp=2015-07-01T11:11:00+0000" \--data-urlencode "[email protected]" \--data-urlencode "Version=1.0" \--data-urlencode "Signature=YOUR_SIGNATURE"
El endpoint GetOrderItems de la API de Falabella Seller Center permite a los vendedores recuperar información detallada sobre los artículos asociados a una orden específica. Al proporcionar un OrderId, este endpoint devuelve detalles como el identificador del artículo, nombre del producto, cantidad, precio y otros atributos relevantes. Esta funcionalidad es esencial para la gestión eficiente de pedidos, permitiendo a los vendedores acceder a información precisa y actualizada sobre los productos comprados por los clientes
Parámetros
Action
string
RequeridoNombre de la función que se va a llamar. Es obligatorio y debe ser 'GetOrderItems' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory'. Si se suministra una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action'.
GetOrderItemsFormat
string
RequeridoSi se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML".
XMLTimestamp
date
RequeridoLa hora actual en formato ISO8601 relativo a UTC (por ejemplo, Timestamp=2015-04-01T10:00:00+02:00 para Berlín), para que las llamadas no puedan ser reproducidas por un tercero que las escuche (es decir, las llamadas demasiado lejanas en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se suministra, aparece el mensaje de error "E001: Parameter Timestamp is mandatory". Si la marca de tiempo es demasiado antigua o está en el futuro, aparece un mensaje de error "E003: Timestamp has expired'.
UserID
string
RequeridoEl ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web de Seller Center en Configuración/Gestión de usuarios.
Version
string
RequeridoLa versión de la API contra la que se va a ejecutar esta llamada, en formato mayor-punto-menor. Debe ser actualmente 1.0, aunque la versión real de la API sea 2.6.20. Si se omite, se devuelve un mensaje de error 'E001: Parameter Version is mandatory'.
Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| OrderNumber | String | Número de pedido mostrado al cliente final |
| OrderItemId | String | Identificador único para cada artículo del pedido |
| ShopId | String | Identificador único de la tienda que vendió el artículo (Falabella o Sodimac) |
| OrderId | String | El mismo ID de pedido al que pertenece el artículo |
| Name | String | Nombre del producto |
| Sku | String | Stock-keeping Unit del producto |
| Variation | String | Variaciones del producto (como tamaño, color, etc.) |
| ShopSku | String | SKU específico de la tienda para el producto |
| ShippingType | String | Método de envío utilizado, puede tener dos valores Dropshipping (Fulfiillment by Seller) y Fulfillment (FulFillment by Falabella) |
| Currency | String | Moneda utilizada para la transacción. Depende de país Chile: CLP, Perú: PEN, Colombia: COP |
| VoucherCode | String | Código de cupón aplicado al artículo (solo si aplica) |
| Status | String | Estado actual del artículo del pedido, posibles valores: pending, ready\to\ship, shipped, delivered, canceled, failed\delivery, return\shipped\by\customer, return\waiting\for\approval, return\rejected, returned |
| isProcessable | String | Indica si el artículo puede ser procesado (0 o 1) |
| ShipmentProvider | String | Nombre del proveedor de envío |
| IsDigital | String | Indica si el artículo es un producto digital (0 o 1) |
| DigitalDeliveryInfo | String | Información sobre el método de entrega digital (si aplica) |
| TrackingCode | String | Código de seguimiento para rastreo del envío |
| TrackingCodePre | String | Código de seguimiento pre-generado antes de iniciar el envío |
| Reason | String | Motivo de cancelación o devolución (si aplica) |
| ReasonDetail | String | Razón detallada para la cancelación o devolución (si aplica) |
| PurchaseOrderId | String | ID de orden de compra generado por la plataforma |
| PurchaseOrderNumber | String | Número de orden de compra proporcionado al vendedor |
| PackageId | String | ID de paquete único que contiene los artículos |
| PromisedShippingTime | String | Corresponde a la fecha en que la orden debe ser entregada al operador logístico. Esfundamental cumplir con este plazo para evitar adelantos o retrasos en el envío, ya que cualquier desviación podría generar penalizaciones. |
| ExtraAttributes | String | Atributos adicionales relacionados con el artículo del pedido |
| ShippingProviderType | String | indica el nivel de servicio según la velocidad de entrega. Los valores posibles son: Same day, Direct, Click & Collect, Next Day, Home Delivery y Regular. |
| CreatedAt | String | Marca de tiempo cuando se creó el artículo del pedido (formato ISO) |
| UpdatedAt | String | Marca de tiempo cuando se actualizó por última vez el artículo del pedido (formato ISO) |
| Vouchers | String | Lista de cupones aplicados al artículo |
| SalesType | String | Tipo de venta, por ahora solo puede tener valor TDR. |
| ReturnStatus | String | Estado de la solicitud de devolución, si la hay (por ejemplo, Pendiente, Aprobada) |
| RequiresDeviceIdentifiers | Boolean | Indica si el ítem requiere cargar identificadores del dispositivo antes de generar el PackageId, el TrackingCode y la etiqueta. Para productos con SIM del modelo internacional en Perú se requieren IMEI y número de serie; en Colombia, solo IMEI. true: la carga está pendiente. false: no se requiere acción o los identificadores requeridos ya fueron cargados. |
| WalletCredits | String | Cantidad de créditos de billetera utilizados para este pedido |
| ItemPrice | String | Precio original del artículo antes de descuentos o cupones |
| PaidPrice | String | Precio pagado por el cliente final después de descuentos |
| TaxAmount | String | Importe del impuesto aplicado al artículo |
| CodCollectableAmount | String | Monto a cobrar en caso de pago contra entrega (COD) |
| ShippingAmount | String | Importe total de envío cobrado por el artículo |
| ShippingServiceCost | String | Costo real del servicio de envío |
| ShippingTax | String | Importe del impuesto cobrado sobre el envío |
| VoucherAmount | String | Descuento total aplicado a través de cupones |
Respuesta 200
<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
<Head>
<RequestId/>
<RequestAction>GetOrderItems</RequestAction>
<ResponseType>OrderItems</ResponseType>
<Timestamp>2026-09-23T15:35:29-03:00</Timestamp>
</Head>
<Body>
<OrderItems>
<OrderItem>
<OrderItemId>59302656</OrderItemId>
<ShopId>7c437a63-3a05-4d6e-9761-db32cdb016a4</ShopId>
<OrderId>5005819247</OrderId>
<Name>PRUEBA PRODUCTO NO REAL NO COMPRAR</Name>
<Sku>234567892</Sku>
<Variation>{}</Variation>
<ShopSku>157987100</ShopSku>
<ShippingType>Dropshipping</ShippingType>
<Currency>PEN</Currency>
<VoucherCode/>
<Status>pending</Status>
<IsProcessable>1</IsProcessable>
<ShipmentProvider>mailamericas</ShipmentProvider>
<DeliveryMethod>Home_delivery</DeliveryMethod>
<IsDigital>0</IsDigital>
<DigitalDeliveryInfo/>
<TrackingCode/>
<TrackingCodePre/>
<Reason/>
<ReasonDetail/>
<PurchaseOrderId/>
<PurchaseOrderNumber/>
<PackageId/>
<PromisedShippingTime>2026-09-29 23:30:00</PromisedShippingTime>
<ExtraAttributes>{"itemId":"1","originNode":"944f3e34-084f-4a51-9031-65d9b3386d3b","originNodeType":"SELLER","deliveryOrderGroupId":"149247243779"}</ExtraAttributes>
<ShippingProviderType>regular</ShippingProviderType>
<CreatedAt>2026-09-23 13:49:58</CreatedAt>
<UpdatedAt>2026-09-23 13:50:03</UpdatedAt>
<Vouchers/>
<SalesType>TDR</SalesType>
<ReturnStatus/>
<RequiresDeviceIdentifiers>false</RequiresDeviceIdentifiers>
<WalletCredits>0.00</WalletCredits>
<ItemPrice>100.00</ItemPrice>
<PaidPrice>100.00</PaidPrice>
<TaxAmount>0.00</TaxAmount>
<CodCollectableAmount>0.00</CodCollectableAmount>
<ShippingAmount>0.00</ShippingAmount>
<ShippingServiceCost>0.00</ShippingServiceCost>
<ShippingTax>0.00</ShippingTax>
<VoucherAmount>0.00</VoucherAmount>
<VoucherAmountDetails>
<CmrDiscount>0.00</CmrDiscount>
<CmrDiscountSellerFundedPct>0</CmrDiscountSellerFundedPct>
<OtherDiscount>0.00</OtherDiscount>
</VoucherAmountDetails>
</OrderItem>
<OrderItem>
<OrderItemId>59302655</OrderItemId>
<ShopId>9e41a9b0-4a7b-4b35-9486-62661e4460e8</ShopId>
<OrderId>5005819247</OrderId>
<Name>Iphone 16 pro max Prueba FBS 2 China NO COMPRAR</Name>
<Sku>cellphonechinafbs2</Sku>
<Variation>{"color":{"name":"Negro","code":"#000000"},"size":"32 GB"}</Variation>
<ShopSku>157898368</ShopSku>
<ShippingType>Dropshipping</ShippingType>
<Currency>PEN</Currency>
<VoucherCode/>
<Status>pending</Status>
<IsProcessable>1</IsProcessable>
<ShipmentProvider>mailamericas</ShipmentProvider>
<DeliveryMethod>Home_delivery</DeliveryMethod>
<IsDigital>0</IsDigital>
<DigitalDeliveryInfo/>
<TrackingCode/>
<TrackingCodePre/>
<Reason/>
<ReasonDetail/>
<PurchaseOrderId/>
<PurchaseOrderNumber/>
<PackageId/>
<PromisedShippingTime>2026-09-29 23:30:00</PromisedShippingTime>
<ExtraAttributes>{"itemId":"1","originNode":"944f3e34-084f-4a51-9031-65d9b3386d3b","originNodeType":"SELLER","deliveryOrderGroupId":"149247243779"}</ExtraAttributes>
<ShippingProviderType>regular</ShippingProviderType>
<CreatedAt>2026-09-23 13:49:58</CreatedAt>
<UpdatedAt>2026-09-23 13:50:03</UpdatedAt>
<Vouchers/>
<SalesType>TDR</SalesType>
<ReturnStatus/>
<RequiresDeviceIdentifiers>true</RequiresDeviceIdentifiers>
<WalletCredits>0.00</WalletCredits>
<ItemPrice>200.00</ItemPrice>
<PaidPrice>200.00</PaidPrice>
<TaxAmount>0.00</TaxAmount>
<CodCollectableAmount>0.00</CodCollectableAmount>
<ShippingAmount>0.00</ShippingAmount>
<ShippingServiceCost>0.00</ShippingServiceCost>
<ShippingTax>0.00</ShippingTax>
<VoucherAmount>0.00</VoucherAmount>
<VoucherAmountDetails>
<CmrDiscount>0.00</CmrDiscount>
<CmrDiscountSellerFundedPct>0</CmrDiscountSellerFundedPct>
<OtherDiscount>0.00</OtherDiscount>
</VoucherAmountDetails>
</OrderItem>
</OrderItems>
</Body>
</SuccessResponse>
Errores
| Código de Error | Mensaje |
|---|---|
| 16 | E016: "%s" Invalid Order ID (ID de pedido inválido) |