ReferenciaÓrdenesConsultar Orden
GET
Consultar Orden
Endpoint
https://sellercenter-api.falabella.com/?Action=GetOrderGetOrder. A través de un OrderId, obtiene los elementos para un solo pedido.
GETConsultar Orden
?Action=GetOrdercurl -G "https://sellercenter-api.falabella.com/" \--data-urlencode "Action=GetOrder" \--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"
Importante
Contamos con una versión 2.0 de este endpoint, puedes revisarlo Aquí
Recuerda que puedes ver los estados disponibles de las órdenes en el apartado flujos de órdenes (Aquí)
¹ - Este campo se puede utilizar para diferenciar la modalidad de fulfillment y agregar reglas de decisión para el consumo o no consumo de stocks en los sistemas de gestión de inventarios de integradores, como se muestra en los siguientes ejemplos:
Cuando el ShipmenType es Dropshipping las ordenes son fulfillment by the seller por lo que deben consumir stock ya que se arman en bodegas propias; Cuando el ShipmenType es Own Warehouse, estas órdenes son fulfillment by Falabella y no deberían con sumir stock porque este ya fue entregado a Falabella.com para que realice el fulfillment en nombre del comercio.
If it is an invoice ('Factura empresa' in Colombia), the API will return a series of fields with relevant information for generating the invoice, presented in the following table
| Campo | Aclaración | Descripción |
|---|---|---|
| ReceiverLegalName | Razón social | Corresponde al negocio al que se le debe emitir la factura empresa. |
| ReceiverAddress | Dirección | Dirección a la que se debe hacer la factura. |
| ReceiverRegion | Región (Chile) / Departamento (Perú) / Departamento (Colombia) | Locación en que se encuentra la dirección |
| ReceiverMunicipality | Comuna (Chile) / Provincia (Perú) / Ciudad o Municipio (Colombia) | corresponde a la zona en la que se encuentra la\ dirección. |
| FiscalPerson | Personal fiscal | Identificación del negocio |
| DocumentType | Tipo documento | Tipo de documento de identificación del rol\ tributario de la razón social. |
| LegalId | Identificación legal | Corresponde al número del documento identificado en el campo "Tipo de documento" con digito verificador |
| ReceiverTypeRegimen | Actividad económica | Código y nombre de la actividad o industria en la que se desempeña la razón social. |
| CustomerVerifierDigit | Digito verificador | Es el digito verificador del "identificador legal". |
| ReceiverEmail | Correo | Correo que debe asociar a la Factura |
| ReceiverPhonenumber | Teléfono | Teléfono que debe asociar a la Factura |
Parámetros
Action
string
RequeridoNombre de la función que se va a llamar. Es obligatorio y debe ser 'GetOrder' 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: Acción no válida'.
GetOrderFormat
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, para efectos de esta versión, siempre debe aplicar 1.0
1.0Los campos de respuesta proporcionados por esta API se encuentran detallados en la siguiente tabla:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| OrderId | Unsigned | Identificador de este pedido asignado por el Falabella Seller Center |
| CustomerFirstName | String | El nombre del cliente |
| CustomerLastName | String | El apellido del cliente |
| OrderNumber | Unsigned | El número de pedido |
| PaymentMethod | String | La forma de pago |
| DeliveryInfo | String | Información sobre la entrega de ese pedido |
| Price | Float | El importe total de este pedido |
| GiftOption | Boolean | 1 si el artículo es un regalo, 0 si no lo es |
| GiftMessage | String | Mensaje de regalo según lo especificado por el cliente |
| CreatedAt | DateTime | Fecha y hora en que se realizó el pedido |
| UpdatedAt | DateTime | Fecha y hora de la última modificación de la orden |
| AddressBilling | Subsection | Nodo que contiene nodos adicionales, que conforman la dirección de facturación: Nombre, Apellido, Teléfono, Teléfono2, Dirección1, Dirección2, Ciudad, Código postal, País |
| AddressShipping | Subsection | Nodo que contiene nodos adicionales, que conforman la dirección de envío: Nombre, Apellido, Teléfono, Teléfono2, Dirección1, Dirección2, Ciudad, Código postal, País |
| NationalRegistrationNumber | String | Se requiere en algunos países |
| ItemsCount | Integer | Número de artículos en orden |
| Statuses | Array | Estados únicos de los artículos del pedido. (pista: puede encontrar todos los diferentes códigos de estado en el ejemplo de respuesta) |
| PromisedShippingTime | DateTime | Corresponde a la fecha en que la orden debe ser entregada al operador logístico. Es fundamental 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 extra que fueron pasados a Falabella Seller Center en la llamada getMarketPlaceOrders. Es una cadena JSON que el cliente debe analizar. |
| ExtraBillingAttributes | String | Nodo que contiene información adicional para facturación: LegalId FiscalPerson, DocumentType, ReceiverRegion, ReceiverAddress, ReceiverPostcode, ReceiverLegalName, ReceiverMunicipality, ReceiverTypeRegimen, CustomerVerifierDigit |
| ShippingType | String | Modalidad de fulfillment y de delivery de la orden. ●Cuando es Dropshipping las ordenes son fulfillment by the seller o directo, en ambos casos es el seller quien debe preparar el pedido en sus bodegas; ●Cuando es Own Warehouse, estas órdenes son fulfillment by Falabella, por lo que son preparadas en las bodegas del seller. |
| InvoiceRequired | Boolean | Entrega valor True(“Factura empresa” en Colombia) si el documento es factura, y valor False si este es una boleta (“Factura persona natural” en Colombia). |
Boleta o Factura?
Como se muestra en la tabla anterior, el campo 'InvoiceRequired' indica si la venta se realizó mediante boleta ('Factura persona natural' en Colombia) o factura ('Factura empresa' en Colombia). Devolverá 'True' si es factura y 'False' si es boleta. Si es factura ('Factura empresa' en Colombia), el API devolverá una serie de campos con información relevante para generar la facturación, presentados en la siguiente tabla
Respuesta 200
<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
<Head>
<RequestId/>
<RequestAction>
GetOrder
</RequestAction>
<ResponseType>
Order
</ResponseType>
<Timestamp>
2025-04-03T19:51:00.348Z
</Timestamp>
</Head>
<Body>
<Orders>
<Order>
<OrderId>
1104901123
</OrderId>
<CustomerFirstName>
Fala
</CustomerFirstName>
<CustomerLastName>
Test
</CustomerLastName>
<OrderNumber>
2777001234
</OrderNumber>
<PaymentMethod>
ecommPay
</PaymentMethod>
<Price>
19990
</Price>
<GiftOption>
0
</GiftOption>
<GiftMessage/>
<VoucherCode/>
<CreatedAt>
2025-04-01 12:00:00
</CreatedAt>
<UpdatedAt>
2025-04-01 15:00:00
</UpdatedAt>
<AddressUpdatedAt>
2025-04-01 12:00:00
</AddressUpdatedAt>
<Remarks/>
<DeliveryInfo/>
<ItemsCount>
1
</ItemsCount>
<AddressBilling>
<FirstName>
Fala
</FirstName>
<LastName>
Test
</LastName>
<Address1>
Avenida Siempre Viva
</Address1>
<Address2>
742
</Address2>
<Address3>
Depto 101
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
Santiago
</City>
<Ward>
Providencia
</Ward>
<Region>
Metropolitana
</Region>
<PostCode>
7500000
</PostCode>
<Country>
CL
</Country>
<Phone/>
<Phone2/>
</AddressBilling>
<AddressShipping>
<FirstName>
Fala
</FirstName>
<LastName>
Test
</LastName>
<Address1>
Avenida Siempre Viva
</Address1>
<Address2>
742
</Address2>
<Address3>
Depto 101
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
Santiago
</City>
<Ward>
Providencia
</Ward>
<Region>
Metropolitana
</Region>
<Country>
CL
</Country>
<PostCode></PostCode>
<Phone/>
<Phone2/>
</AddressShipping>
<NationalRegistrationNumber>
12345678-9
</NationalRegistrationNumber>
<PromisedShippingTime>
2025-04-04 23:00:00
</PromisedShippingTime>
<ExtraAttributes>
{"itemId":"1","deliveryOrderGroupId":"149186887567","originNode":"e3b0ebac-cae8-4849-8ba7-d063434ccca0"}
</ExtraAttributes>
<ExtraBillingAttributes>
<LegalId>
123456789
</LegalId>
<FiscalPerson>
Natural
</FiscalPerson>
<DocumentType>
RUT
</DocumentType>
<ReceiverRegion>
Metropolitana
</ReceiverRegion>
<ReceiverAddress>
Av. Apoquindo 3200
</ReceiverAddress>
<ReceiverPostcode>
7550000
</ReceiverPostcode>
<ReceiverLegalName>
Sebastián Muñoz
</ReceiverLegalName>
<ReceiverMunicipality>
Las Condes
</ReceiverMunicipality>
<ReceiverTypeRegimen>
General
</ReceiverTypeRegimen>
<CustomerVerifierDigit>
3
</CustomerVerifierDigit>
<ReceiverPhonenumber>
+56912345678
</ReceiverPhonenumber>
<ReceiverEmail>
[email protected]
</ReceiverEmail>
<ReceiverLocality>
Santiago
</ReceiverLocality>
</ExtraBillingAttributes>
<InvoiceRequired>
false
</InvoiceRequired>
<OperatorCode>
facl
</OperatorCode>
<ShippingType>
Dropshipping
</ShippingType>
<GrandTotal>
19990
</GrandTotal>
<ProductTotal>
19990
</ProductTotal>
<TaxAmount>
0
</TaxAmount>
<ShippingFeeTotal>
0
</ShippingFeeTotal>
<ShippingTax>
0
</ShippingTax>
<Voucher>
0
</Voucher>
<Statuses>
<Status>
ready_to_ship
</Status>
</Statuses>
</Order>
</Orders>
</Body>
</SuccessResponse>Errores
| Código de error | Mensaje |
|---|---|
| 16 | E016: "%s" Invalid Order ID (ID de pedido inválido) |